Skip to contentSkip to conversation

scripts : config : Added example use when run without argument,extend help

PATCH In review Bhaskar Chowdhury 2 participants 3 messages Sep 11, 2020 Kbuild

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 scripts : config : Added example use when run without argument,extend help

This patch extends the help section by adding an explicit example of use.

---
 scripts/config | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
scripts/config +17 -0
index eee5b7f3a092..d905dccabb94 100755
@@ -45,6 +45,23 @@ make time.
 By default, $myname will upper-case the given symbol. Use --keep-case to keep
 the case of all following symbols unchanged.
 
+The concrete example, say, you want to change any particular config,like
+GCOV for profiling, you can simply use this command
+
+To enable:
+
+#scripts/config --enable GCOV_KERNEL  && grep GCOV .config
+
+ and the output will be like this:
+
+  CONFIG_GCOV_KERNEL=y
+
+To disable:
+
+#scripts/config --disable GCOV_KERNEL  && grep GCOV .config
+
+# CONFIG_GCOV_KERNEL is not set
+
 $myname uses 'CONFIG_' as the default symbol prefix. Set the environment
 variable CONFIG_ to the prefix to use. Eg.: CONFIG_="FOO_" $myname ...
 EOL
Signature · 1 line
2.26.2
#1 lore raw
Quoted 4 lines · Bhaskar Chowdhury

This patch extends the help section by adding an explicit example of use.

---

Difference between versions goes here.

scripts/config make time. · line 48

Quoted 12 lines
 scripts/config | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
scripts/config +1 -0
index eee5b7f3a092..d905dccabb94 100755
@@ -45,6 +45,23 @@ make time.
 By default, $myname will upper-case the given symbol. Use --keep-case to keep
 the case of all following symbols unchanged.
 
+The concrete example, say, you want to change any particular config,like

config, like

scripts/config make time. · line 49

Quoted 1 line
scripts/config +1 -0
+GCOV for profiling, you can simply use this command

command.

Quoted 9 lines
scripts/config +8 -0
+
+To enable:
+
+#scripts/config --enable GCOV_KERNEL  && grep GCOV .config
+
+ and the output will be like this:
+
+  CONFIG_GCOV_KERNEL=y

scripts/config make time. · line 67

Quoted 10 lines
scripts/config +7 -0
+
+To disable:
+
+#scripts/config --disable GCOV_KERNEL  && grep GCOV .config
+
+# CONFIG_GCOV_KERNEL is not set
+
 $myname uses 'CONFIG_' as the default symbol prefix. Set the environment
 variable CONFIG_ to the prefix to use. Eg.: CONFIG_="FOO_" $myname ...
 EOL

I don't know why we need this extra help text.

Signature · 1 line
~Randy
#2 lore raw
Quoted 40 lines · Randy Dunlap
Quoted 4 lines · Bhaskar Chowdhury

This patch extends the help section by adding an explicit example of use.

---

Difference between versions goes here.

scripts/config make time. · line 48

Quoted 12 lines
 scripts/config | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
scripts/config +1 -0
index eee5b7f3a092..d905dccabb94 100755
@@ -45,6 +45,23 @@ make time.
 By default, $myname will upper-case the given symbol. Use --keep-case to keep
 the case of all following symbols unchanged.
 
+The concrete example, say, you want to change any particular config,like

config, like

scripts/config make time. · line 49

Quoted 1 line
scripts/config +1 -0
+GCOV for profiling, you can simply use this command

command.

Quoted 13 lines
scripts/config +13 -0
+
+To enable:
+
+#scripts/config --enable GCOV_KERNEL  && grep GCOV .config
+
+ and the output will be like this:
+
+  CONFIG_GCOV_KERNEL=y
+
+To disable:
+
+#scripts/config --disable GCOV_KERNEL  && grep GCOV .config
+
Quoted 8 lines

scripts/config make time. · line 67

Quoted 6 lines
scripts/config +2 -0
+# CONFIG_GCOV_KERNEL is not set
+
 $myname uses 'CONFIG_' as the default symbol prefix. Set the environment
 variable CONFIG_ to the prefix to use. Eg.: CONFIG_="FOO_" $myname ...
 EOL

I don't know why we need this extra help text.

I am not sure I get you ...should have mentioned in the first place, so it save some of my time ....moreover, I was doing it because I felt it necessary to let the user of this script to know what/how easily things can be done.Period.

Look like decision making is badly bugged.

~Bhaskar

Quoted 3 lines
Signature · 1 line
~Randy