1 files changed, 9 insertions, 8 deletions
diff --git a/Documentation/kbuild/kconfig-language.txt b/Documentation/kbuild/kconfig-language.txt
index 649cb8799890..00b950d1c193 100644
--- a/Documentation/kbuild/kconfig-language.txt
+++ b/Documentation/kbuild/kconfig-language.txt
@@ -104,14 +104,15 @@ applicable everywhere (see syntax).
  Reverse dependencies can only be used with boolean or tristate
  symbols.
  Note:
-        select is evil.... select will by brute force set a symbol
+        select should be used with care. select will force
-        equal to 'y' without visiting the dependencies. So abusing
+        a symbol to a value without visiting the dependencies.
-        select you are able to select a symbol FOO even if FOO depends
+        By abusing select you are able to select a symbol FOO even
-        on BAR that is not set. In general use select only for
+        if FOO depends on BAR that is not set.
-        non-visible symbols (no prompts anywhere) and for symbols with
+        In general use select only for non-visible symbols
-        no dependencies. That will limit the usefulness but on the
+        (no prompts anywhere) and for symbols with no dependencies.
-        other hand avoid the illegal configurations all over. kconfig
+        That will limit the usefulness but on the other hand avoid
-        should one day warn about such things.
+        the illegal configurations all over.
+        kconfig should one day warn about such things.
 - numerical ranges: "range" <symbol> <symbol> ["if" <expr>]
  This allows to limit the range of possible input values for int

diff --git a/Documentation/kbuild/kconfig-language.txt b/Documentation/kbuild/kconfig-language.txt index 649cb8799890..00b950d1c193 100644 --- a/Documentation/kbuild/kconfig-language.txt +++ b/Documentation/kbuild/kconfig-language.txt
@@ -104,14 +104,15 @@ applicable everywhere (see syntax).
104	Reverse dependencies can only be used with boolean or tristate	104	Reverse dependencies can only be used with boolean or tristate
105	symbols.	105	symbols.
106	Note:	106	Note:
107	select is evil.... select will by brute force set a symbol	107	select should be used with care. select will force
108	equal to 'y' without visiting the dependencies. So abusing	108	a symbol to a value without visiting the dependencies.
109	select you are able to select a symbol FOO even if FOO depends	109	By abusing select you are able to select a symbol FOO even
110	on BAR that is not set. In general use select only for	110	if FOO depends on BAR that is not set.
111	non-visible symbols (no prompts anywhere) and for symbols with	111	In general use select only for non-visible symbols
112	no dependencies. That will limit the usefulness but on the	112	(no prompts anywhere) and for symbols with no dependencies.
113	other hand avoid the illegal configurations all over. kconfig	113	That will limit the usefulness but on the other hand avoid
114	should one day warn about such things.	114	the illegal configurations all over.
		115	kconfig should one day warn about such things.
115		116
116	- numerical ranges: "range" <symbol> <symbol> ["if" <expr>]	117	- numerical ranges: "range" <symbol> <symbol> ["if" <expr>]
117	This allows to limit the range of possible input values for int	118	This allows to limit the range of possible input values for int