Documentation/kbuild: add info that 'choice' can have a symbol name
Yann E. MORIN [Wed, 15 Dec 2010 23:19:00 +0000 (00:19 +0100)]
Changeset 5a1aa8a1 added the possibility to name a choice,
and to have the same choice be defined multiple times.
But the documentation was forgotten, so this updates it accordingly.

Thanks to Arnaud Lacombe for pointing it to me in the first place:
  http://www.spinics.net/lists/linux-kbuild/msg03940.html

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Cc: Roman Zippel <zippel@linux-m68k.org>
Cc: Arnaud Lacombe <lacombar@gmail.com>
Signed-off-by: Michal Marek <mmarek@suse.cz>

Documentation/kbuild/kconfig-language.txt

index 2fe93ca..a4bbaaf 100644 (file)
@@ -268,7 +268,7 @@ separate list of options.
 
 choices:
 
-       "choice"
+       "choice" [symbol]
        <choice options>
        <choice block>
        "endchoice"
@@ -282,6 +282,10 @@ single driver can be compiled/loaded into the kernel, but all drivers
 can be compiled as modules.
 A choice accepts another option "optional", which allows to set the
 choice to 'n' and no entry needs to be selected.
+If no [symbol] is associated with a choice, then you can not have multiple
+definitions of that choice. If a [symbol] is associated to the choice,
+then you may define the same choice (ie. with the same entries) in another
+place.
 
 comment: