From 1e7c0ed2794cfb82a59e0c748fd1f86135a5a30b Mon Sep 17 00:00:00 2001
From: "Glenn Y. Rolland" <glenux@glenux.net>
Date: Sun, 27 Jun 2021 21:34:12 +0200
Subject: [PATCH] doc: improve update-toc output

---
 scripts/update-toc | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/scripts/update-toc b/scripts/update-toc
index 554a355..456a925 100755
--- a/scripts/update-toc
+++ b/scripts/update-toc
@@ -31,6 +31,7 @@ class TocBuilder:
     def is_masked(self, rel_path):
         parts = rel_path.split('/')[::-1]
         for part in parts:
+          # print("  * Testing for '_' {}".format(part))
           if part[0] == '_':
             return True
 
@@ -40,7 +41,7 @@ class TocBuilder:
         md_files = []
         for root, dirs, files in os.walk(self.root_path):
             for fn in files:
-                print("Found {}".format(fn))
+                print("Found {}".format(fn), end='\r')
                 # compute absolute and relative path
                 abs_path = os.path.join(root, fn)
                 rel_path = os.path.relpath(abs_path, self.root_path)
@@ -50,17 +51,19 @@ class TocBuilder:
                 bname_split = os.path.splitext(bname)
                 dname = os.path.dirname(rel_path)
                 
-                # skip files in docs/ root
-                if dname == "":
-                    continue
-                
                 # skip files starting with '_'
                 #if bname_split[0][0] == '_':
                 if self.is_masked(rel_path):
+                    print("Found {} which is masked. Ignoring".format(fn))
                     continue
+                
+                # skip files in docs/ root
+                # if dname == "":
+                #   continue
 
                 # skip index files
                 if bname_split[0] == 'index':
+                    print("Found {} which is an index file. Ignoring".format(fn))
                     continue
                 
                 # keep only .md files
@@ -68,6 +71,8 @@ class TocBuilder:
                 if bname_split[1] == '.md':
                     md_files.append(rel_path)
 
+                print("Found {}. Keeping".format(fn))
+
         return md_files
 
     def format(self, md_files):