Don't update Makefile.am by default

Author: edwardchalstrey1

doc/developer.catalog.rst

@@ -24,11 +24,11 @@ Add new games
 
 3. **Update the catalog:**
 
-   Use the ``update_catalog.py`` script to update the Gambit's documentation & build files.
+   Use the ``update_catalog.py`` script to update Gambit's documentation & build files.
 
    .. code-block:: bash
 
-       python src/pygambit/update_catalog.py
+       python src/pygambit/update_catalog.py --build
 
    .. note::
 

src/pygambit/update_catalog.py

@@ -1,3 +1,4 @@
+import argparse
 from pathlib import Path
 
 import pygambit as gbt
@@ -46,13 +47,20 @@ def update_makefile():
 
     if content != updated_content:
         print(f"Updated {str(MAKEFILE_AM)}")
+    else:
+        print(f"No changes to add to {str(MAKEFILE_AM)}")
 
 
 if __name__ == "__main__":
 
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--build", action="store_true")
+    args = parser.parse_args()
+
     # Create CSV used by RST docs page
     gbt.catalog.games().to_csv(CATALOG_CSV, index=False)
-    print(f"Generated {CATALOG_CSV} for use in docs build.")
+    print(f"Generated {CATALOG_CSV} for use in local docs build. DO NOT COMMIT.")
 
     # Update the Makefile.am with the current list of catalog files
-    update_makefile()
+    if args.build:
+        update_makefile()