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

diff --git a/listnewconfig.py b/listnewconfig.py
index 975b716..45f6a57 100755
--- a/listnewconfig.py
+++ b/listnewconfig.py
@@ -3,11 +3,13 @@
 # Copyright (c) 2018-2019, Ulf Magnusson
 # SPDX-License-Identifier: ISC
 
-# Works like 'make listnewconfig', listing all modifiable symbols that are not
-# assigned in the configuration file.
-#
-# The default output filename is '.config'. A different filename can be passed
-# in the KCONFIG_CONFIG environment variable.
+"""
+List all user-modifiable symbols that are not given a value in the configuration
+file. Usually, these are new symbols that have been added to the Kconfig files.
+
+The default configuration filename is '.config'. A different filename can be
+passed in the KCONFIG_CONFIG environment variable.
+"""
 
 import sys