docs-v4: update format_raddb script so the .dotfiles are not included in the search...

diff --git a/scripts/asciidoc/format_raddb.md b/scripts/asciidoc/format_raddb.md
index f89b69d9f2ace1da3e79ceb49f9b4648d4599edd..c9170a4af4a374369ed245c936ee1d58c78769a3 100644 (file)
--- a/scripts/asciidoc/format_raddb.md
+++ b/scripts/asciidoc/format_raddb.md
@@ -19,6 +19,10 @@ should not be formatted.  The list of files to ignore is below:
 
 * ignore files in the `raddb/certs` directory
 
+* ignore dotfiles, i.e. files whose name begins with a `.`, e.g.
+  `.gitignore` or `.DS_Store`.  These are not configuration files, and
+  some (such as `.DS_Store`) are binary and cannot be read as text.
+
 ## Whitespace
 
 The configuration files should use tabs for indentation, not spaces.

diff --git a/scripts/asciidoc/format_raddb.py b/scripts/asciidoc/format_raddb.py
index 743f3e219bd8b932eda18636c9c0ce6ee115a56c..620e3744fcfb4d3d994afda162036c17c25329bb 100755 (executable)
--- a/scripts/asciidoc/format_raddb.py
+++ b/scripts/asciidoc/format_raddb.py
@@ -110,6 +110,9 @@ def should_format(path, raddb_root):
 
     name = path.name
 
+    if name.startswith("."):
+        return False
+
     if "certs" in parts:
         return False
 
@@ -833,7 +836,7 @@ def main(argv=None):
     for fp in files:
         try:
             sources[fp] = fp.read_text(encoding="utf-8")
-        except OSError as e:
+        except (OSError, UnicodeDecodeError) as e:
             print(f"format_raddb: {fp}: {e}", file=sys.stderr)
             sources[fp] = None