From c70a45eb935dc536ce59ec860c17b4c1c531a663 Mon Sep 17 00:00:00 2001 From: Ulf Magnusson Date: Fri, 22 Mar 2019 15:42:45 +0100 Subject: 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. --- listnewconfig.py | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'listnewconfig.py') 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 -- cgit v1.2.3