module docstring cleanups [134 files]

examples/halving-calculator.py

@@ -1,7 +1,16 @@
 #!/usr/bin/env python3
+#
+# mmgen = Multi-Mode GENerator, a command-line cryptocurrency wallet
+# Copyright (C)2013-2022 The MMGen Project <mmgen@tuta.io>
+# Licensed under the GNU General Public License, Version 3:
+#   https://www.gnu.org/licenses
+# Public project repositories:
+#   https://github.com/mmgen/mmgen
+#   https://gitlab.com/mmgen/mmgen
 
-# Demonstrates use of the MMGen asyncio/aiohttp JSON-RPC interface
-# https://github.com/mmgen/mmgen
+"""
+examples.halving-calculator.py: Demonstrate use of the MMGen asyncio/aiohttp JSON-RPC interface
+"""
 
 import time
 from decimal import Decimal

mmgen/addr.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-addr.py: MMGen address-related types
+addr: MMGen address-related types
 """
 
 from collections import namedtuple

mmgen/addrdata.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-addrdata.py: MMGen AddrData and related classes
+addrdata: MMGen AddrData and related classes
 """
 
 from .util import vmsg,fmt,die

mmgen/addrfile.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-addrfile.py:  Address and password file classes for the MMGen suite
+addrfile: Address and password file classes for the MMGen suite
 """
 
 from .util import msg,qmsg,qmsg_r,die,capfirst

mmgen/addrgen.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-addrgen.py: Address generation initialization code for the MMGen suite
+addrgen: Address generation initialization code for the MMGen suite
 """
 
 from .keygen import KeyGenerator # convenience import

mmgen/addrlist.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-addrlist.py: Address list classes for the MMGen suite
+addrlist: Address list classes for the MMGen suite
 """
 
 from .util import qmsg,qmsg_r,suf,make_chksum_N,Msg,die

mmgen/amt.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-amt.py: MMGen CoinAmt and related classes
+amt: MMGen CoinAmt and related classes
 """
 
 from decimal import Decimal

mmgen/base_obj.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-base_obj.py: base objects with no internal imports for the MMGen suite
+base_obj: base objects with no internal imports for the MMGen suite
 """
 
 class AsyncInit(type):

mmgen/baseconv.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-baseconv.py:  base conversion class for the MMGen suite
+baseconv: base conversion class for the MMGen suite
 """
 
 from collections import namedtuple

mmgen/cfg.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-cfg.py: API for the MMGen runtime configuration file and related files
+cfg: API for the MMGen runtime configuration file and related files
 """
 
 # NB: This module is used by override_globals_from_cfg_file(), which is called before

mmgen/color.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-color.py:  color handling for the MMGen suite
+color: color handling for the MMGen suite
 """
 
 _colors = {

mmgen/common.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-common.py:  Common imports for all MMGen scripts
+common: Common imports for all MMGen scripts
 """
 
 import sys,os

mmgen/contrib/license.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-license.py:  Copyright notice and text of GPLv3
+contrib.license: Copyright notice and text of GPLv3
 """
 
 from ..globalvars import g

mmgen/crypto.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-crypto.py: Random number, password hashing and symmetric encryption routines for the MMGen suite
+crypto: Random number, password hashing and symmetric encryption routines for the MMGen suite
 """
 
 import os

mmgen/daemon.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-daemon.py:  Daemon control interface for the MMGen suite
+daemon: Daemon control interface for the MMGen suite
 """
 
 import os,time,importlib

mmgen/derive.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-derive.py: coin private key secret derivation for the MMGen suite
+derive: coin private key secret derivation for the MMGen suite
 """
 
 from collections import namedtuple

mmgen/devinit.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-devinit.py: Developer tools init/launch code for the MMGen suite
+devinit: Developer tools init/launch code for the MMGen suite
 """
 
 devtools_funcs = {

mmgen/devtools.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-devtools.py: Developer tools for the MMGen suite
+devtools: Developer tools for the MMGen suite
 """
 
 import sys

mmgen/exception.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-mmgen.exception: Exception classes for the MMGen suite
+exception: Exception classes for the MMGen suite
 """
 
 class MMGenError(Exception):

mmgen/filename.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-filename.py:  File and MMGenFile classes and methods for the MMGen suite
+filename: File and MMGenFile classes and methods for the MMGen suite
 """
 
 import sys,os

mmgen/fileutil.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-fileutil.py: Routines that read, write, execute or stat files
+fileutil: Routines that read, write, execute or stat files
 """
 
 import sys,os

mmgen/flags.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-flags.py:  Class flags and opts for the MMGen suite
+flags: Class flags and opts for the MMGen suite
 """
 
 from .base_obj import AttrCtrl,Lockable

mmgen/globalvars.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-globalvars.py:  Constants and configuration options for the MMGen suite
+globalvars: Constants and configuration options for the MMGen suite
 """
 
 import sys,os

mmgen/help.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-help.py:  help notes for MMGen suite commands
+help: help notes for MMGen suite commands
 """
 
 def help_notes_func(proto,po,k):

mmgen/key.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-key.py: MMGen public and private key objects
+key: MMGen public and private key objects
 """
 
 from .objmethods import Hilite,InitErrors,MMGenObject

mmgen/keygen.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-keygen.py: Public key generation initialization code for the MMGen suite
+keygen: Public key generation initialization code for the MMGen suite
 """
 
 from collections import namedtuple

mmgen/main.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-main.py - Script launcher for the MMGen project
+main: Script launcher for the MMGen project
 """
 
 def launch(mod,package='mmgen'):

mmgen/main_msg.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-mmgen.main_msg: Message signing operations for the MMGen suite
+mmgen-msg: Message signing operations for the MMGen suite
 """
 
 from .base_obj import AsyncInit

mmgen/main_seedjoin.py

@@ -17,8 +17,8 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-mmgen/main_seedjoin: Regenerate an MMGen deterministic wallet from seed shares
-                     created by 'mmgen-seedsplit'
+mmgen-seedjoin: Regenerate an MMGen deterministic wallet from seed shares
+                created by 'mmgen-seedsplit'
 """
 
 from .common import *

mmgen/main_wallet.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-mmgen/main_wallet:  Entry point for MMGen wallet-related scripts
+main_wallet: Entry point for MMGen wallet-related scripts
 """
 
 import os

mmgen/main_xmrwallet.py

@@ -17,8 +17,8 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-mmgen/main_xmrwallet: Perform various Monero wallet operations for addresses
-                      in an MMGen XMR key-address file
+mmgen-xmrwallet: Perform various Monero wallet operations for addresses
+                 in an MMGen XMR key-address file
 """
 
 from .common import *

mmgen/obj.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-obj.py: MMGen native classes
+obj: MMGen native classes
 """
 
 import sys,os,re,unicodedata

mmgen/objmethods.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-objmethods.py: Mixin classes for MMGen data objects
+objmethods: Mixin classes for MMGen data objects
 """
 
 import unicodedata

mmgen/opts.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-opts.py:  MMGen-specific options processing after generic processing by share.Opts
+opts: MMGen-specific options processing after generic processing by share.Opts
 """
 import sys,os,stat
 

mmgen/passwdlist.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-passwdlist.py: Password list class for the MMGen suite
+passwdlist: Password list class for the MMGen suite
 """
 
 from collections import namedtuple

mmgen/proto/bch/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Bitcoin Cash protocol
+proto.bch.params: Bitcoin Cash protocol
 """
 
 from ..btc.params import mainnet,_finfo

mmgen/proto/btc/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Bitcoin protocol
+proto.btc.params: Bitcoin protocol
 """
 
 from ...protocol import CoinProtocol,decoded_wif,decoded_addr,_finfo,_nw

mmgen/proto/btc/tw/bal.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-proto.btc.twbal: Bitcoin base protocol tracking wallet balance class
+proto.btc.tw.bal: Bitcoin base protocol tracking wallet balance class
 """
 
 from ....tw.bal import TwGetBalance

mmgen/proto/etc/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Ethereum Classic protocol
+proto.etc.params: Ethereum Classic protocol
 """
 
 from ..eth.params import mainnet

mmgen/proto/eth/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Ethereum protocol
+proto.eth.params: Ethereum protocol
 """
 
 from ...globalvars import g

mmgen/proto/eth/tw/bal.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-proto.eth.twbal: Ethereum tracking wallet getbalance class
+proto.eth.tw.bal: Ethereum tracking wallet getbalance class
 """
 
 from ....tw.ctl import TwCtl

mmgen/proto/eth/tw/ctl.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-proto.eth.twctl: Ethereum tracking wallet control class
+proto.eth.tw.ctl: Ethereum tracking wallet control class
 """
 
 from ....util import msg,ymsg,die

mmgen/proto/ltc/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Litecoin protocol
+proto.ltc.params: Litecoin protocol
 """
 
 from ..btc.params import mainnet

mmgen/proto/xmr/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Monero protocol
+proto.xmr.params: Monero protocol
 """
 
 from collections import namedtuple

mmgen/proto/zec/params.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-Zcash protocol
+proto.zec.params: Zcash protocol
 """
 
 from ..btc.params import mainnet

mmgen/protocol.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-protocol.py: Coin protocol base classes and initializer
+protocol: Coin protocol base classes and initializer
 """
 
 from collections import namedtuple

mmgen/rpc.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-rpc.py:  Cryptocoin RPC library for the MMGen suite
+rpc: Cryptocoin RPC library for the MMGen suite
 """
 
 import base64,json,asyncio,importlib

mmgen/seed.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-seed.py:  Seed-related classes and methods for the MMGen suite
+seed: Seed-related classes and methods for the MMGen suite
 """
 
 from .util import make_chksum_8,hexdigits_uc

mmgen/seedsplit.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-seedsplit.py: Seed split classes and methods for the MMGen suite
+seedsplit: Seed split classes and methods for the MMGen suite
 """
 
 from .globalvars import g

mmgen/sha2.py

@@ -17,9 +17,9 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-sha2.py: A non-optimized but very compact implementation of the SHA2 hash
-         algorithm for the MMGen suite.  Implements SHA256, SHA512 and
-         SHA256Compress (unpadded SHA256, required for Zcash addresses)
+sha2: A non-optimized but very compact implementation of the SHA2 hash
+      algorithm for the MMGen suite.  Implements SHA256, SHA512 and
+      SHA256Compress (unpadded SHA256, required for Zcash addresses)
 """
 
 # IMPORTANT NOTE: Since GMP precision is platform-dependent, generated constants

mmgen/share/Opts.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-Opts.py:  Generic options parsing
+share.Opts: Generic options parsing
 """
 
 import sys,re

mmgen/subseed.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-subseed.py:  Subseed classes and methods for the MMGen suite
+subseed: Subseed classes and methods for the MMGen suite
 """
 
 from .color import green

mmgen/term.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-term.py:  Terminal classes for the MMGen suite
+term: Terminal classes for the MMGen suite
 """
 
 import sys,os,time

mmgen/test.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-test.py: functions required by the MMGen test suite
+test: functions required by the MMGen test suite
 """
 
 import sys

mmgen/tool/api.py

@@ -17,8 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/api.py:
-    Python interface to selected commands from the 'mmgen-tool' utility
+tool.api: Python interface to selected commands from the 'mmgen-tool' utility
 """
 
 from .common import tool_cmd_base

mmgen/tool/coin.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/coin.py: Cryptocoin routines for the 'mmgen-tool' utility
+tool.coin: Cryptocoin routines for the 'mmgen-tool' utility
 """
 
 from collections import namedtuple

mmgen/tool/common.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/common.py: Base class and shared routines for the 'mmgen-tool' utility
+tool.common: Base class and shared routines for the 'mmgen-tool' utility
 """
 
 from ..objmethods import MMGenObject

mmgen/tool/file.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/file.py: Address and transaction file routines for the 'mmgen-tool' utility
+tool.file: Address and transaction file routines for the 'mmgen-tool' utility
 """
 
 from .common import tool_cmd_base,options_annot_str

mmgen/tool/filecrypt.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/filecrypt.py: File encryption/decryption routines for the 'mmgen-tool' utility
+tool.filecrypt: File encryption/decryption routines for the 'mmgen-tool' utility
 """
 
 import os

mmgen/tool/fileutil.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/fileutil.py: File routines for the 'mmgen-tool' utility
+tool.fileutil: File routines for the 'mmgen-tool' utility
 """
 
 import os

mmgen/tool/help.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/help.py: Help screen routines for the 'mmgen-tool' utility
+tool.help: Help screen routines for the 'mmgen-tool' utility
 """
 
 from .common import tool_cmd_base

mmgen/tool/mnemonic.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/mnemonic.py: Mnemonic routines for the 'mmgen-tool' utility
+tool.mnemonic: Mnemonic routines for the 'mmgen-tool' utility
 """
 
 from collections import namedtuple

mmgen/tool/rpc.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/rpc.py: JSON/RPC routines for the 'mmgen-tool' utility
+tool.rpc: JSON/RPC routines for the 'mmgen-tool' utility
 """
 
 from .common import tool_cmd_base,options_annot_str

mmgen/tool/util.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/util.py: Utility commands for the 'mmgen-tool' utility
+tool.util: Utility commands for the 'mmgen-tool' utility
 """
 
 from .common import tool_cmd_base

mmgen/tool/wallet.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tool/wallet.py: Wallet routines for the 'mmgen-tool' utility
+tool.wallet: Wallet routines for the 'mmgen-tool' utility
 """
 
 from .common import tool_cmd_base

mmgen/tw/bal.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-twbal: Tracking wallet getbalance class for the MMGen suite
+tw.bal: Tracking wallet getbalance class for the MMGen suite
 """
 
 from collections import namedtuple

mmgen/tw/ctl.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-twctl: Tracking wallet control class for the MMGen suite
+tw.ctl: Tracking wallet control class for the MMGen suite
 """
 
 import json

mmgen/tx/file.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-tx.file:  Transaction file operations for the MMGen suite
+tx.file: Transaction file operations for the MMGen suite
 """
 
 from ..common import *

mmgen/ui.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-ui.py: Interactive user interface functions for the MMGen suite
+ui: Interactive user interface functions for the MMGen suite
 """
 
 import sys,os

mmgen/util.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-util.py: Frequently-used variables, classes and utility functions for the MMGen suite
+util: Frequently-used variables, classes and utility functions for the MMGen suite
 """
 
 import sys,os,time,re

mmgen/util2.py

@@ -9,7 +9,7 @@
 #   https://gitlab.com/mmgen/mmgen
 
 """
-util2.py: Less frequently-used variables, classes and utility functions for the MMGen suite
+util2: Less frequently-used variables, classes and utility functions for the MMGen suite
 """
 
 import re,time

mmgen/xmrseed.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-xmrseed.py: Monero mnemonic conversion class for the MMGen suite
+xmrseed: Monero mnemonic conversion class for the MMGen suite
 """
 
 from .baseconv import baseconv

scripts/gendiff.py

@@ -1,6 +1,8 @@
 #!/usr/bin/env python3
 
 """
+scripts/gendiff.py:
+
 Clean up control characters and trailing whitespace in the listed source files
 and create a unified diff between them.
 

scripts/uninstall-mmgen.py

@@ -16,10 +16,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-"""
-uninstall-mmgen.py - Uninstall MMGen from a system
-"""
-
 import sys,os
 
 def normalize_path(p):

test/colortest.py

@@ -4,7 +4,7 @@
 # Copyright (C)2013-2022 The MMGen Project <mmgen@tuta.io>
 
 """
-colortest.py:  test color handling for the MMGen suite
+test/colortest.py: test color handling for the MMGen suite
 """
 
 import include.tests_header

test/gentest.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/gentest.py:  Cryptocoin key/address generation tests for the MMGen suite
+test/gentest.py: Cryptocoin key/address generation tests for the MMGen suite
 """
 
 import sys,os

test/hashfunc.py

@@ -15,6 +15,7 @@
 #
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
 """
 test/hashfunc.py: Test internal implementations of SHA256, SHA512 and Keccak256
 """

test/include/coin_daemon_control.py

@@ -1,4 +1,16 @@
 #!/usr/bin/env python3
+#
+# mmgen = Multi-Mode GENerator, a command-line cryptocurrency wallet
+# Copyright (C)2013-2022 The MMGen Project <mmgen@tuta.io>
+# Licensed under the GNU General Public License, Version 3:
+#   https://www.gnu.org/licenses
+# Public project repositories:
+#   https://github.com/mmgen/mmgen
+#   https://gitlab.com/mmgen/mmgen
+
+"""
+test.include.coin_daemon_control: Start and stop daemons for the MMGen test suite
+"""
 
 from .tests_header import repo_root
 from mmgen.common import *

test/include/common.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-common.py: Shared routines and data for the MMGen test suites
+test.include.common: Shared routines and data for the MMGen test suites
 """
 
 import os

test/include/pexpect.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/pexpect.py: pexpect implementation for MMGen test suites
+test.include.pexpect: pexpect implementation for MMGen test suites
 """
 
 import sys,os,time

test/misc/tool_api_test.py

@@ -4,7 +4,7 @@
 # Copyright (C)2013-2022 The MMGen Project <mmgen@tuta.io>
 
 """
-tool_api_test.py: test the MMGen suite tool API
+test.misc.tool_api_test: test the MMGen suite tool API
 """
 
 import sys,os

test/objattrtest.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/objattrtest.py:  Test immutable attributes of MMGen data objects
+test/objattrtest.py: Test immutable attributes of MMGen data objects
 """
 
 # TODO: test 'typeconv' during instance creation

test/objattrtest_py_d/oat_btc_mainnet.py

@@ -4,8 +4,7 @@
 # Copyright (C)2013-2022 The MMGen Project <mmgen@tuta.io>
 
 """
-test.objattrtest_py_d.oat_btc_mainnet:
-    BTC mainnet test vectors for MMGen data objects
+test.objattrtest_py_d.oat_btc_mainnet: BTC mainnet test vectors for MMGen data objects
 """
 
 from .oat_common import *

test/objtest.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/objtest.py:  Test MMGen data objects
+test/objtest.py: Test MMGen data objects
 """
 
 import sys,os,re

test/overlay/__init__.py

@@ -1,3 +1,17 @@
+#!/usr/bin/env python3
+#
+# mmgen = Multi-Mode GENerator, a command-line cryptocurrency wallet
+# Copyright (C)2013-2022 The MMGen Project <mmgen@tuta.io>
+# Licensed under the GNU General Public License, Version 3:
+#   https://www.gnu.org/licenses
+# Public project repositories:
+#   https://github.com/mmgen/mmgen
+#   https://gitlab.com/mmgen/mmgen
+
+"""
+test.overlay.__init__: Initialize the MMGen test suite overlay tree
+"""
+
 import sys,os,shutil
 
 def get_overlay_tree_dir(repo_root):

test/scrambletest.py

@@ -18,7 +18,7 @@
 
 """
 test/scrambletest.py: seed scrambling and addrlist data generation tests for all
-supported coins + passwords
+                      supported coins + passwords
 """
 
 import sys,os

test/start-coin-daemons.py

@@ -1,3 +1,7 @@
 #!/usr/bin/env python3
 
+"""
+test/start-coin-daemons.py: Start daemons for the MMGen test suite
+"""
+
 import include.coin_daemon_control

test/stop-coin-daemons.py

@@ -1,3 +1,7 @@
 #!/usr/bin/env python3
 
+"""
+test/stop-coin-daemons.py: Stop daemons for the MMGen test suite
+"""
+
 import include.coin_daemon_control

test/test_py_d/common.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-common.py: Shared routines and data for the test.py test suite
+test.test_py_d.common: Shared routines and data for the test.py test suite
 """
 
 import os

test/test_py_d/input.py

@@ -7,7 +7,7 @@
 # Licensed according to the terms of GPL Version 3.  See LICENSE for details.
 
 """
-input.py: Shared input routines for the test.py test suite
+test.test_py_d.input: Shared input routines for the test.py test suite
 """
 
 import os,time

test/test_py_d/ts_autosign.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_autosign.py: Autosign tests for the test.py test suite
+test.test_py_d.ts_autosign: Autosign tests for the test.py test suite
 """
 
 import os,shutil

test/test_py_d/ts_base.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_base.py: Base class for the test.py test suite
+test.test_py_d.ts_base: Base class for the test.py test suite
 """
 
 import os

test/test_py_d/ts_cfg.py

@@ -7,7 +7,7 @@
 # Licensed according to the terms of GPL Version 3.  See LICENSE for details.
 
 """
-ts_cfg.py: CfgFile tests for the MMGen test.py test suite
+test.test_py_d.ts_cfg: CfgFile tests for the MMGen test.py test suite
 """
 
 import shutil

test/test_py_d/ts_chainsplit.py

@@ -17,8 +17,8 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_chainsplit.py: Forking scenario tests for the test.py test suite
-This module is currently non-functional
+test.test_py_d.ts_chainsplit: Forking scenario tests for the test.py test suite
+This module is unmaintained and currently non-functional
 """
 import os
 from mmgen.globalvars import g

test/test_py_d/ts_ethdev.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_ethdev.py: Ethdev tests for the test.py test suite
+test.test_py_d.ts_ethdev: Ethdev tests for the test.py test suite
 """
 
 import sys,os,re,shutil,asyncio,json

test/test_py_d/ts_input.py

@@ -7,7 +7,7 @@
 # Licensed according to the terms of GPL Version 3.  See LICENSE for details.
 
 """
-ts_input.py: user input tests for the MMGen test.py test suite
+test.test_py_d.ts_input: user input tests for the MMGen test.py test suite
 """
 
 import time

test/test_py_d/ts_main.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_main.py: Basic operations tests for the test.py test suite
+test.test_py_d.ts_main: Basic operations tests for the test.py test suite
 """
 
 from mmgen.globalvars import g

test/test_py_d/ts_misc.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_misc.py: Miscellaneous test groups for the test.py test suite
+test.test_py_d.ts_misc: Miscellaneous test groups for the test.py test suite
 """
 
 from mmgen.globalvars import g

test/test_py_d/ts_opts.py

@@ -7,7 +7,7 @@
 # Licensed according to the terms of GPL Version 3.  See LICENSE for details.
 
 """
-ts_opts.py: options processing tests for the MMGen test.py test suite
+test.test_py_d.ts_opts: options processing tests for the MMGen test.py test suite
 """
 
 from ..include.common import *

test/test_py_d/ts_ref.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_ref.py: Reference file tests for the test.py test suite
+test.test_py_d.ts_ref: Reference file tests for the test.py test suite
 """
 
 import os

test/test_py_d/ts_ref_3seed.py

@@ -17,8 +17,8 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_ref_3seed.py: Saved and generated reference file tests for 128, 192 and
-                 256-bit seeds for the test.py test suite
+test.test_py_d.ts_ref_3seed: Saved and generated reference file tests for 128,
+                             192 and 256-bit seeds for the test.py test suite
 """
 
 from mmgen.globalvars import g

test/test_py_d/ts_ref_altcoin.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_ref_altcoin.py: Altcoin reference file tests for the test.py test suite
+test.test_py_d.ts_ref_altcoin: Altcoin reference file tests for the test.py test suite
 """
 
 import os

test/test_py_d/ts_regtest.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_regtest.py: Regtest tests for the test.py test suite
+test.test_py_d.ts_regtest: Regtest tests for the test.py test suite
 """
 
 import os,json,time

test/test_py_d/ts_seedsplit.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_seedsplit.py: Seed split/join tests for the test.py test suite
+test.test_py_d.ts_seedsplit: Seed split/join tests for the test.py test suite
 """
 
 from mmgen.globalvars import g

test/test_py_d/ts_shared.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_shared.py: Shared methods for the test.py test suite
+test.test_py_d.ts_shared: Shared methods for the test.py test suite
 """
 
 import os

test/test_py_d/ts_tool.py

@@ -7,7 +7,7 @@
 # Licensed according to the terms of GPL Version 3.  See LICENSE for details.
 
 """
-ts_tool.py: tool tests for the MMGen test.py test suite
+test.test_py_d.ts_tool: tool tests for the MMGen test.py test suite
 """
 
 from ..include.common import *

test/test_py_d/ts_wallet.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_wallet.py: Wallet conversion tests for the test.py test suite
+test.test_py_d.ts_wallet: Wallet conversion tests for the test.py test suite
 """
 
 import os

test/test_py_d/ts_xmrwallet.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-ts_xmrwallet.py: xmrwallet tests for the test.py test suite
+test.test_py_d.ts_xmrwallet: xmrwallet tests for the test.py test suite
 """
 
 import sys,os,atexit,asyncio,shutil

test/tooltest.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/tooltest.py:  Tests for the 'mmgen-tool' utility
+test/tooltest.py: Tests for the 'mmgen-tool' utility
 """
 
 import sys,os,binascii

test/tooltest2.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/tooltest2.py:  Simple tests for the 'mmgen-tool' utility
+test/tooltest2.py: Simple tests for the 'mmgen-tool' utility
 """
 
 # TODO: move all non-interactive 'mmgen-tool' tests in 'test.py' here

test/unit_tests.py

@@ -17,7 +17,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
-test/unit_tests.py:  Unit tests for the MMGen suite
+test/unit_tests.py: Unit tests for the MMGen suite
 """
 
 import sys,os,time,importlib,platform

test/unit_tests_d/__init__.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.__init__: shared data for unit tests for the MMGen suite
 """

test/unit_tests_d/ut_addrlist.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_addrlist: address list unit tests for the MMGen suite
 """

test/unit_tests_d/ut_addrparse.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_addrparse: address parsing tests for the MMGen suite
 """

test/unit_tests_d/ut_baseconv.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
+
 """
-test/unit_tests_d/ut_baseconv.py: Base conversion unit test for the MMGen suite
+test.unit_tests_d.ut_baseconv: Base conversion unit test for the MMGen suite
 """
 
 from mmgen.common import *

test/unit_tests_d/ut_bip39.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_bip39: BIP39 unit test for the MMGen suite
 """

test/unit_tests_d/ut_daemon.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
+
 """
-test/unit_tests_d/ut_daemon.py: unit test for the MMGen suite's Daemon class
+test.unit_tests_d.ut_daemon: unit test for the MMGen suite's Daemon class
 """
 
 from subprocess import run,DEVNULL

test/unit_tests_d/ut_dep.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_dep: dependency unit tests for the MMGen suite
 

test/unit_tests_d/ut_devtools.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_devtools: devtools unit tests for the MMGen suite
 """

test/unit_tests_d/ut_flags.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
+
 """
-test/unit_tests_d/ut_flags.py: unit test for the MMGen suite's ClassFlags class
+test.unit_tests_d.ut_flags: unit test for the MMGen suite's ClassFlags class
 """
 
 from mmgen.common import *

test/unit_tests_d/ut_gen.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_gen: key/address generation unit tests for the MMGen suite
 """

test/unit_tests_d/ut_indexed_dict.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_indexed_dict: IndexedDict class unit test for the MMGen suite
 """

test/unit_tests_d/ut_lockable.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
+
 """
-test/unit_tests_d/ut_lockable.py: unit test for the MMGen suite's Lockable class
+test.unit_tests_d.ut_lockable: unit test for the MMGen suite's Lockable class
 """
 
 from mmgen.common import *

test/unit_tests_d/ut_mn_entry.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
+
 """
-test/unit_tests_d/ut_mn_entry.py: Mnemonic user entry unit test for the MMGen suite
+test.unit_tests_d.ut_mn_entry: Mnemonic user entry unit test for the MMGen suite
 """
 
 from mmgen.util import msg,msg_r,qmsg,qmsg_r

test/unit_tests_d/ut_msg.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_msg: message signing unit tests for the MMGen suite
 """

test/unit_tests_d/ut_obj.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_obj: data object unit tests for the MMGen suite
 """

test/unit_tests_d/ut_rpc.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_rpc: RPC unit test for the MMGen suite
 """

test/unit_tests_d/ut_scrypt.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
+
 """
-test/unit_tests_d/ut_scrypt.py: password hashing unit test for the MMGen suite
+test.unit_tests_d.ut_scrypt: password hashing unit test for the MMGen suite
 """
 
 from ..include.common import *

test/unit_tests_d/ut_seedsplit.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_seedsplit: seed splitting unit test for the MMGen suite
 """

test/unit_tests_d/ut_subseed.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_subseed: subseed unit test for the MMGen suite
 """

test/unit_tests_d/ut_testdep.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_testdep: test dependency unit tests for the MMGen suite
 """

test/unit_tests_d/ut_tx.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test.unit_tests_d.ut_tx: TX unit tests for the MMGen suite
 """

test/unit_tests_d/ut_tx_deserialize.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_tx_deserialize: TX deserialization unit tests for the MMGen suite
 """

test/unit_tests_d/ut_xmrseed.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """
 test/unit_tests_d/ut_xmrseed: Monero mnemonic unit test for the MMGen suite
 """