Cr8-xyz/blender
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

convenience targets for make doc_py, doc_dna, doc_man

Browse Source
This commit is contained in:
Campbell Barton
2011-10-16 11:09:15 +00:00
parent 3fd8a914b8
commit 92bc72dca1
2 changed files with 18 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
GNUmakefile
View File

@@ -147,6 +147,8 @@ help:
@echo "" @echo ""
@echo "Documentation Targets" @echo "Documentation Targets"
@echo " * doc_py - generate sphinx python api docs" @echo " * doc_py - generate sphinx python api docs"
@echo " * doc_dna - generate blender file format reference"
@echo " * doc_man - generate manpage"
@echo "" @echo ""
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
@@ -235,6 +237,13 @@ doc_py:
cd doc/python_api ; sphinx-build -n -b html sphinx-in sphinx-out cd doc/python_api ; sphinx-build -n -b html sphinx-in sphinx-out
@echo "docs written into: '$(BLENDER_DIR)/doc/python_api/sphinx-out/contents.html'" @echo "docs written into: '$(BLENDER_DIR)/doc/python_api/sphinx-out/contents.html'"
doc_dna:
$(BUILD_DIR)/bin/blender --background --factory-startup --python doc/blender_file_format/BlendFileDnaExporter_25.py
@echo "docs written into: '$(BLENDER_DIR)/doc/blender_file_format/dna.html'"
doc_man:
python3 doc/manpage/blender.1.py $(BUILD_DIR)/bin/blender
clean: clean:
$(MAKE) -C $(BUILD_DIR) clean $(MAKE) -C $(BUILD_DIR) clean

12
doc/manpage/blender.1.py
View File

@@ -22,6 +22,7 @@
import subprocess import subprocess
import os import os
import sys
import time import time
import datetime import datetime
@@ -43,10 +44,15 @@ def man_format(data):
return data return data
# allow passing blender as argument
if sys.argv[-1].endswith(os.sep + "blender"):
blender_bin = sys.argv[-1]
else:
blender_bin = os.path.join(os.path.dirname(__file__), "../../blender.bin")
blender_bin = os.path.join(os.path.dirname(__file__), "../../blender.bin") cmd = [blender_bin, "--help"]
print(" executing:", " ".join(cmd))
blender_help = subprocess.Popen([blender_bin, "--help"], stdout=subprocess.PIPE).communicate()[0].decode() blender_help = subprocess.Popen(cmd, stdout=subprocess.PIPE).communicate()[0].decode()
blender_version = subprocess.Popen([blender_bin, "--version"], stdout=subprocess.PIPE).communicate()[0].decode().strip() blender_version = subprocess.Popen([blender_bin, "--version"], stdout=subprocess.PIPE).communicate()[0].decode().strip()
blender_version = blender_version.split("Build")[0] blender_version = blender_version.split("Build")[0]