From: Otto Moerbeek <otto.moerbeek@open-xchange.com>
Date: Mon, 17 Feb 2025 14:47:46 +0000 (+0100)
Subject: And also do html-docs, tarball and pdf for auth
X-Git-Tag: dnsdist-2.0.0-alpha1~48^2~6
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=379b8d71dd8dfe04b4c6177bfe4296e8946398d4;p=thirdparty%2Fpdns.git

And also do html-docs, tarball and pdf for auth
---

diff --git a/docs/generate-docs.py b/docs/generate-docs.py
index 871dd19b86..839e4c7f44 100755
--- a/docs/generate-docs.py
+++ b/docs/generate-docs.py
@@ -40,7 +40,7 @@ def main():
     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",
@@ -60,8 +60,8 @@ def main():
         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."""
@@ -105,10 +105,10 @@ def create_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",
diff --git a/meson.build b/meson.build
index f914ed4540..bd5ff45c33 100644
--- a/meson.build
+++ b/meson.build
@@ -1123,3 +1123,48 @@ if get_option('unit-tests-backends')
     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],
+)
+
diff --git a/pdns/dnsdistdist/meson.build b/pdns/dnsdistdist/meson.build
index 63b651bf70..ddf86963d2 100644
--- a/pdns/dnsdistdist/meson.build
+++ b/pdns/dnsdistdist/meson.build
@@ -712,7 +712,7 @@ docs_tarball = custom_target(
   output: 'html-docs.tar.bz2',
 )
 
-latex_docs = custom_target(
+pdf_docs = custom_target(
   command: [
       python,
       product_source_dir / docs_dir / 'generate-docs.py',
@@ -722,7 +722,7 @@ latex_docs = custom_target(
       '--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,
@@ -730,5 +730,6 @@ latex_docs = custom_target(
 
 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],
 )
diff --git a/pdns/recursordist/meson.build b/pdns/recursordist/meson.build
index 1e0b8cb680..7ddded8306 100644
--- a/pdns/recursordist/meson.build
+++ b/pdns/recursordist/meson.build
@@ -756,7 +756,7 @@ docs_tarball = custom_target(
   output: 'html-docs.tar.bz2',
 )
 
-latex_docs = custom_target(
+pdf_docs = custom_target(
   command: [
       python,
       product_source_dir / docs_dir / 'generate-docs.py',
@@ -766,7 +766,7 @@ latex_docs = custom_target(
       '--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,
@@ -774,6 +774,7 @@ latex_docs = custom_target(
 
 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],
 )