From: Scott Gasch <scott@gasch.org>
Date: Sat, 28 May 2022 19:58:51 +0000 (-0700)
Subject: Allowances for getting sphinx docs set up.
X-Git-Url: https://wannabe.guru.org/gitweb/?a=commitdiff_plain;h=56bc30dfecdf11d477c97afe0ebef234a18ee258;p=python_utils.git

Allowances for getting sphinx docs set up.
---

diff --git a/argparse_utils.py b/argparse_utils.py
index 83a3aa4..6055f1a 100644
--- a/argparse_utils.py
+++ b/argparse_utils.py
@@ -33,6 +33,8 @@ class ActionNoYes(argparse.Action):
         --enable_the_thing
         --no_enable_the_thing
 
+    These arguments can be used to indicate the inclusion or exclusion of
+    binary exclusive behaviors.
     """
 
     def __init__(self, option_strings, dest, default=None, required=False, help=None):
diff --git a/config.py b/config.py
index bea7018..599026c 100644
--- a/config.py
+++ b/config.py
@@ -106,6 +106,11 @@ ARGS = argparse.ArgumentParser(
     formatter_class=OptionalRawFormatter,
     fromfile_prefix_chars="@",
     epilog=f'{PROGRAM_NAME} uses config.py ({__file__}) for global, cross-module configuration setup and parsing.',
+    # I don't fully understand why but when loaded by sphinx sometimes
+    # the same module is loaded many times causing any arguments it
+    # registers via module-level code to be redefined.  Work around
+    # this iff the program is 'sphinx-build'
+    conflict_handler='resolve' if PROGRAM_NAME == 'sphinx-build' else 'error',
 )
 
 # Keep track of if we've been called and prevent being called more