chg: dev: cleanup doc examples and script output !minor

Signed-off-by: Stephen L Arnold <[email protected]>

README.rst

@@ -376,7 +376,8 @@ Additional ``tox`` commands:
 To build/lint the api docs, use the following tox commands:
 
 * ``tox -e docs`` build the documentation using sphinx and the api-doc plugin
-* ``tox -e docs-lint`` build the docs and run the sphinx link checking
+* ``tox -e ldocs`` build the docs and run the sphinx link checking
+* ``tox -e cdocs`` clean all the generated doc files
 
 Local Tox upgrade
 -----------------

scripts/analyze_ssg_controls.py

@@ -66,7 +66,7 @@ def set_unique(sequence):
 else:
     up_ids = input_ids
 
-in_set = set(up_ids)
+in_set = set_unique(up_ids)
 
 if DEBUG:
     print(f'Input Ids: {input_ids}')

scripts/xform_idchk.py

@@ -7,14 +7,15 @@
 from yaml_tools.templates import xform_id
 from yaml_tools.utils import text_file_reader
 
+FILE = os.getenv('ID_FILE', default='tests/data/OE-expanded-profile-all-ids.txt')
 OPTS = {
     'file_encoding': 'utf-8',
     'output_format': 'raw',
     'default_csv_hdr': None,
 }
 
 # read in some json "column data"
-data = text_file_reader('tests/data/OE-expanded-profile-all-ids.txt', OPTS)
+data = text_file_reader(FILE, OPTS)
 if data[0].isupper():
     lc_ids = [xform_id(x) for x in data]