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, 9 insertions, 7 deletions

diff --git a/olddefconfig.py b/olddefconfig.py
index 7edb76f..5c400de 100755
--- a/olddefconfig.py
+++ b/olddefconfig.py
@@ -3,13 +3,15 @@
 # Copyright (c) 2018-2019, Ulf Magnusson
 # SPDX-License-Identifier: ISC
 
-# Works like 'make olddefconfig', updating an old .config file or creating a
-# new one by filing in default values for all new symbols. This is the same as
-# picking the default selection for all symbols in oldconfig, or entering the
-# menuconfig interface and immediately saving.
-#
-# The default output filename is '.config'. A different filename can be passed
-# in the KCONFIG_CONFIG environment variable.
+"""
+Updates an old .config file or creates a new one, by filing in default values
+for all new symbols. This is the same as picking the default selection for all
+symbols in oldconfig, or entering the menuconfig interface and immediately
+saving.
+
+The default input/output filename is '.config'. A different filename can be
+passed in the KCONFIG_CONFIG environment variable.
+"""
 
 import kconfiglib