cli: author-mode: Fix make clean and touch source

Good side-effect: will also trigger a full rebuild. Signed-off-by: Jorge Marques <[email protected]>
analogdevicesinc · Dec 1, 2024 · 160113d · 160113d
1 parent c6b38ea
commit 160113d
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 5 deletions.
diff --git a/adi_doctools/cli/author_mode.py b/adi_doctools/cli/author_mode.py
@@ -395,6 +395,10 @@ def check_files(scheduler):
                 update_page = True
                 watch_file_src[file] = ctime
 
+        if not path.isdir(builddir):
+            # User did make clean
+            update_sphinx = True
+
         if first_run is True:
             first_run = False
             update_page = False

diff --git a/docs/cli.rst b/docs/cli.rst
@@ -50,11 +50,7 @@ All options can be listed with:
 How can I rebuild the whole documentation within Author Mode?
 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
-Run ``make clean`` in another tab and then touch any file, for example:
-
-.. shell::
-
-   $make clean ; touch conf.rst
+Run ``make clean`` in another tab, it will trigger a full rebuild.
 
 Do **not** do ``make clean html`` since it will generate a build without the
 proper Author Mode environment and live reload won't work properly.