From 31be5ce8b94183e4f248cd379b4862028bed74bd Mon Sep 17 00:00:00 2001
From: Campbell Barton <campbell@blender.org>
Date: Mon, 14 Feb 2022 16:20:16 +1100
Subject: GNUmakefile: update arguments for 'doc_man' target

Add '--verbose' argument to the script so the destination is printed.
Otherwise there is no hint to where the man page was written.
---
 GNUmakefile              |  2 +-
 doc/manpage/blender.1.py | 16 ++++++++++++++--
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/GNUmakefile b/GNUmakefile
index e94ad1839e6..b100bf9290e 100644
--- a/GNUmakefile
+++ b/GNUmakefile
@@ -560,7 +560,7 @@ doc_dna: .FORCE
 	@echo "docs written into: '$(BLENDER_DIR)/doc/blender_file_format/dna.html'"
 
 doc_man: .FORCE
-	@$(PYTHON) doc/manpage/blender.1.py $(BLENDER_BIN) blender.1
+	@$(PYTHON) doc/manpage/blender.1.py --blender="$(BLENDER_BIN)" --output=blender.1 --verbose
 
 help_features: .FORCE
 	@$(PYTHON) "$(BLENDER_DIR)/build_files/cmake/cmake_print_build_options.py" $(BLENDER_DIR)"/CMakeLists.txt"
diff --git a/doc/manpage/blender.1.py b/doc/manpage/blender.1.py
index ef62e0e4206..325b4c2653b 100755
--- a/doc/manpage/blender.1.py
+++ b/doc/manpage/blender.1.py
@@ -79,7 +79,9 @@ def blender_extract_info(blender_bin: str) -> Dict[str, str]:
     }
 
 
-def man_page_from_blender_help(fh: TextIO, blender_bin: str) -> None:
+def man_page_from_blender_help(fh: TextIO, blender_bin: str, verbose: bool) -> None:
+    if verbose:
+        print("Extracting help text:", blender_bin)
     blender_info = blender_extract_info(blender_bin)
 
     # Header Content.
@@ -178,6 +180,13 @@ def create_argparse() -> argparse.ArgumentParser:
         required=True,
         help="Path to the blender binary."
     )
+    parser.add_argument(
+        "--verbose",
+        default=False,
+        required=False,
+        action='store_true',
+        help="Print additional progress."
+    )
 
     return parser
 
@@ -188,9 +197,12 @@ def main() -> None:
 
     blender_bin = args.blender
     output_filename = args.output
+    verbose = args.verbose
 
     with open(output_filename, "w", encoding="utf-8") as fh:
-        man_page_from_blender_help(fh, blender_bin)
+        man_page_from_blender_help(fh, blender_bin, verbose)
+        if verbose:
+            print("Written:", output_filename)
 
 
 if __name__ == "__main__":
-- 
cgit v1.2.3