Convert some comments to module docstrings in utilities

This makes running pydoc(3) on the utilities helpful.

Reuse the module docstring for the --help text for utilities that use
argparse.

Also fix some copy-paste errors in the all*config.py descriptions and
clean up the language a bit.

Piggyback removal of an optimization in allmodconfig.py that's pretty
irrelevant now.

1 files changed, 12 insertions, 10 deletions

diff --git a/savedefconfig.py b/savedefconfig.py
index 19a403b..9408633 100755
--- a/savedefconfig.py
+++ b/savedefconfig.py
@@ -3,15 +3,7 @@
 # Copyright (c) 2019, Ulf Magnusson
 # SPDX-License-Identifier: ISC
 
-import argparse
-
-import kconfiglib
-
-
-def main():
-    parser = argparse.ArgumentParser(
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        description="""
+"""
 Saves a minimal configuration file that only lists symbols that differ in value
 their defaults. Loading such a configuration file is equivalent to loading the
 "full" configuration file.
@@ -24,7 +16,17 @@ can be passed in the KCONFIG_CONFIG environment variable.
 
 Note: Minimal configurations can also be generated from within the menuconfig
 interface.
-""")
+"""
+
+import argparse
+
+import kconfiglib
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        description=__doc__)
 
     parser.add_argument(
         "--kconfig",