diff options
author | Campbell Barton <campbell@blender.org> | 2022-02-14 08:20:16 +0300 |
---|---|---|
committer | Campbell Barton <campbell@blender.org> | 2022-02-14 08:20:16 +0300 |
commit | 31be5ce8b94183e4f248cd379b4862028bed74bd (patch) | |
tree | e8e61f8682291b1ff03ac0f90c75ea3ea4d1e404 | |
parent | 47b783bbe97c7cbca421aa1042dea203af167f63 (diff) |
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.
-rw-r--r-- | GNUmakefile | 2 | ||||
-rwxr-xr-x | 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__": |