Rewrite the help descriptions for clarity, accuracy and consistency.

Kernel config options affected:

  - SLUB_DEBUG
  - SLAB
  - SLUB
  - SLOB

Signed-off-by: Nick Andrew <[EMAIL PROTECTED]>
---
Try #3.

--- a/init/Kconfig      2008-02-20 09:34:48.000000000 +1100
+++ b/init/Kconfig      2008-02-20 09:50:54.000000000 +1100
@@ -683,31 +683,48 @@ config SLUB_DEBUG
        bool "Enable SLUB debugging support" if EMBEDDED
        depends on SLUB
        help
+         Enable debugging on the "SLUB" slab allocator.
+
          SLUB has extensive debug support features. Disabling these can
          result in significant savings in code size. This also disables
          SLUB sysfs support. /sys/slab will not exist and there will be
          no support for cache validation etc.
 
+         If unsure, say N.
+
 choice
        prompt "Choose SLAB allocator"
        default SLUB
        help
-          This option allows to select a slab allocator.
+          This option selects a slab allocator.
+
+          A slab is a contiguous area of kernel memory. Slabs are of
+          fixed size (1 or more times the page size) and are used as
+          the container for allocation of kernel data structures. This
+          reduces memory fragmentation and makes allocation very fast,
+          improving kernel performance.
+
+          "SLUB" is the default slab allocator.
+
+          See wikipedia:Slab_allocation for more details.
 
 config SLAB
        bool "SLAB"
        help
-         The regular slab allocator that is established and known to work
-         well in all environments. It organizes cache hot objects in
-         per cpu and per node queues. SLAB is the default choice for
-         a slab allocator.
+         SLAB is the original slab allocator that is established and
+         known to work well in all environments. It organizes cache
+         hot objects in per-CPU and per-node queues.
+
+         SLAB has been superseded by SLUB.
 
 config SLUB
        bool "SLUB (Unqueued Allocator)"
        help
           SLUB is a slab allocator that minimizes cache line usage
-          instead of managing queues of cached objects (SLAB approach).
-          Per cpu caching is realized using slabs of objects instead
+          instead of managing queues of cached objects (the SLAB
+          approach).
+
+          Per-CPU caching is realized using slabs of objects instead
           of queues of objects. SLUB can use memory efficiently
           and has enhanced diagnostics.
 
@@ -715,9 +732,11 @@ config SLOB
        depends on EMBEDDED
        bool "SLOB (Simple Allocator)"
        help
-          SLOB replaces the stock allocator with a drastically simpler
-          allocator. SLOB is generally more space efficient but
-          does not perform as well on large systems.
+          SLOB is a drastically simpler allocator for use in embedded
+          systems.
+
+          SLOB is generally more space efficient but does not perform
+          as well on large systems.
 
 endchoice
 
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Reply via email to