files = list(itertools.chain.from_iterable(files))
sphinx_build = venv_directory.joinpath("bin").joinpath("sphinx-build")
- if args.latex_name:
+ if args.pdf_name:
buildargs = [
sphinx_build,
"-M",
buildargs + files, # default is to do all
check=True
)
- if args.latex_name:
- os.rename(build_root.joinpath('latex').joinpath(args.latex_name), args.latex_name)
+ if args.pdf_name:
+ os.rename(build_root.joinpath('latex').joinpath(args.pdf_name), args.pdf_name)
def create_argument_parser():
"""Create command-line argument parser."""
help="Target directory for man-pages relative to the build root",
)
parser.add_argument(
- "--latex-name",
+ "--pdf-name",
type=Path,
required=False,
- help="Generate latex instead of html",
+ help="Generate pdf instead of html",
)
parser.add_argument(
"files",
endif
endforeach
endif
+
+html_docs = custom_target(
+ 'html-docs',
+ command: [
+ python,
+ product_source_dir / docs_dir / 'generate-docs.py',
+ '--build-root', '@BUILD_ROOT@',
+ '--source-root', '@SOURCE_ROOT@',
+ '--venv-name', 'venv-docs',
+ '--requirements-file', docs_dir / 'requirements.txt',
+ '--source-directory', docs_dir,
+ '--target-directory', '@BUILD_ROOT@' / 'html-docs',
+ ],
+ output: 'html-docs',
+ console: true,
+)
+
+docs_tarball = custom_target(
+ 'html-docs.tar.bz2',
+ command: ['tar', 'cjf', 'html-docs.tar.bz2', html_docs],
+ output: 'html-docs.tar.bz2',
+)
+
+pdf_docs = custom_target(
+ command: [
+ python,
+ product_source_dir / docs_dir / 'generate-docs.py',
+ '--build-root', '@BUILD_ROOT@',
+ '--source-root', '@SOURCE_ROOT@',
+ '--venv-name', 'venv-docs',
+ '--requirements-file', docs_dir / 'requirements.txt',
+ '--source-directory', docs_dir,
+ '--target-directory', '@BUILD_ROOT@',
+ '--pdf-name', 'PowerDNS-Authoritative.pdf',
+ ],
+ output: 'PowerDNS-Authoritative.pdf',
+ console: true,
+)
+
+run_target(
+ 'all-docs',
+ # args mentioned in command line become auto-dependency
+ command: ['echo', 'Generated', html_docs, docs_tarball, pdf_docs],
+)
+
output: 'html-docs.tar.bz2',
)
-latex_docs = custom_target(
+pdf_docs = custom_target(
command: [
python,
product_source_dir / docs_dir / 'generate-docs.py',
'--requirements-file', docs_dir / 'requirements.txt',
'--source-directory', docs_dir,
'--target-directory', '@BUILD_ROOT@',
- '--latex-name', 'dnsdist.pdf',
+ '--pdf-name', 'dnsdist.pdf',
],
output: 'dnsdist.pdf',
console: true,
run_target(
'all-docs',
- command: ['echo', html_docs, docs_tarball, latex_docs],
+ # args mentioned in command line become auto-dependency
+ command: ['echo', 'Generated', html_docs, docs_tarball, pdf_docs],
)
output: 'html-docs.tar.bz2',
)
-latex_docs = custom_target(
+pdf_docs = custom_target(
command: [
python,
product_source_dir / docs_dir / 'generate-docs.py',
'--requirements-file', docs_dir / 'requirements.txt',
'--source-directory', docs_dir,
'--target-directory', '@BUILD_ROOT@',
- '--latex-name', 'PowerDNS-Recursor.pdf',
+ '--pdf-name', 'PowerDNS-Recursor.pdf',
],
output: 'PowerDNS-Recursor.pdf',
console: true,
run_target(
'all-docs',
- command: ['echo', 'Generated', html_docs, docs_tarball, latex_docs],
+ # args mentioned in command line become auto-dependency
+ command: ['echo', 'Generated', html_docs, docs_tarball, pdf_docs],
)