summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJan Alexander Steffens (heftig) <heftig@archlinux.org>2022-02-15 21:37:56 +0000
committerJan Alexander Steffens (heftig) <heftig@archlinux.org>2022-02-15 22:36:12 +0000
commita87b93ef283866cd001945a684e02a4a3e5f989a (patch)
tree968b8a56312fea9095db815a07f121196f38b77d /docs
parent26064a9e7c523443939b0ff386ff10dcc0bc069b (diff)
downloadtracker-a87b93ef283866cd001945a684e02a4a3e5f989a.tar.gz
manpages: Fix generation of manpages with asciidoc 10
We should use asciidoc's `a2x` driver instead of running xsltproc ourselves. asciidoc 10 ships its stylesheets in a private directory. Fixes: https://gitlab.gnome.org/GNOME/tracker/-/issues/347
Diffstat (limited to 'docs')
-rw-r--r--docs/manpages/meson.build47
-rw-r--r--docs/manpages/tracker-xdg-portal-3.1.txt (renamed from docs/manpages/tracker-xdg-portal.1.txt)0
-rw-r--r--docs/manpages/tracker3-endpoint.1.txt (renamed from docs/manpages/tracker-endpoint.1.txt)0
-rw-r--r--docs/manpages/tracker3-export.1.txt (renamed from docs/manpages/tracker-export.1.txt)0
-rw-r--r--docs/manpages/tracker3-import.1.txt (renamed from docs/manpages/tracker-import.1.txt)0
-rw-r--r--docs/manpages/tracker3-sparql.1.txt (renamed from docs/manpages/tracker-sparql.1.txt)0
-rw-r--r--docs/manpages/tracker3-sql.1.txt (renamed from docs/manpages/tracker-sql.1.txt)0
7 files changed, 20 insertions, 27 deletions
diff --git a/docs/manpages/meson.build b/docs/manpages/meson.build
index f90c757cf..74afe3a71 100644
--- a/docs/manpages/meson.build
+++ b/docs/manpages/meson.build
@@ -1,39 +1,32 @@
manpages = [
- ['endpoint', 'tracker3-endpoint', 1],
- ['export', 'tracker3-export', 1],
- ['import', 'tracker3-import', 1],
- ['sparql', 'tracker3-sparql', 1],
- ['sql', 'tracker3-sql', 1],
- ['xdg-portal', 'tracker-xdg-portal-3', 1],
+ ['tracker3-endpoint', 1],
+ ['tracker3-export', 1],
+ ['tracker3-import', 1],
+ ['tracker3-sparql', 1],
+ ['tracker3-sql', 1],
+ ['tracker-xdg-portal-3', 1],
]
foreach m : manpages
- src = m[0]
- dst = m[1]
- section = m[2]
+ name = m[0]
+ section = m[1]
- manpage_src = 'tracker-@0@.@1@.txt'.format(src, section)
- manpage_xml = '@0@.@1@.xml'.format(dst, section)
- manpage = '@0@.@1@'.format(dst, section)
+ manpage = '@0@.@1@'.format(name, section)
- xml = custom_target(manpage_xml,
- command: [asciidoc,
+ custom_target(manpage,
+ command: [a2x,
'--attribute=author=The Tracker developers',
'--attribute=manversion=@0@'.format(meson.project_version()),
'--attribute=manmanual=Tracker manual',
- '--backend', 'docbook',
- '--doctype', 'manpage',
- '--out-file', '@OUTPUT@', '@INPUT@'],
- input: manpage_src,
- output: manpage_xml
- )
-
- custom_target(manpage,
- command: [xsltproc,
- '--output', '@OUTPUT@',
- '--stringparam', 'man.authors.section.enabled', '0',
- '/etc/asciidoc/docbook-xsl/manpage.xsl', '@INPUT@'],
- input: xml,
+ '--doctype=manpage',
+ '--format=manpage',
+ '--no-xmllint',
+ '--xsltproc-opts=' + ' '.join([
+ '--stringparam', 'man.authors.section.enabled', '0',
+ ]),
+ '-D', '@OUTDIR@',
+ '@INPUT@'],
+ input: manpage + '.txt',
output: manpage,
install: true,
install_dir: get_option('mandir') / 'man@0@'.format(section),
diff --git a/docs/manpages/tracker-xdg-portal.1.txt b/docs/manpages/tracker-xdg-portal-3.1.txt
index 664db5b77..664db5b77 100644
--- a/docs/manpages/tracker-xdg-portal.1.txt
+++ b/docs/manpages/tracker-xdg-portal-3.1.txt
diff --git a/docs/manpages/tracker-endpoint.1.txt b/docs/manpages/tracker3-endpoint.1.txt
index 6671ca8c4..6671ca8c4 100644
--- a/docs/manpages/tracker-endpoint.1.txt
+++ b/docs/manpages/tracker3-endpoint.1.txt
diff --git a/docs/manpages/tracker-export.1.txt b/docs/manpages/tracker3-export.1.txt
index 83e83a7e0..83e83a7e0 100644
--- a/docs/manpages/tracker-export.1.txt
+++ b/docs/manpages/tracker3-export.1.txt
diff --git a/docs/manpages/tracker-import.1.txt b/docs/manpages/tracker3-import.1.txt
index d1d5d07df..d1d5d07df 100644
--- a/docs/manpages/tracker-import.1.txt
+++ b/docs/manpages/tracker3-import.1.txt
diff --git a/docs/manpages/tracker-sparql.1.txt b/docs/manpages/tracker3-sparql.1.txt
index 304b0feb1..304b0feb1 100644
--- a/docs/manpages/tracker-sparql.1.txt
+++ b/docs/manpages/tracker3-sparql.1.txt
diff --git a/docs/manpages/tracker-sql.1.txt b/docs/manpages/tracker3-sql.1.txt
index 83e58ac21..83e58ac21 100644
--- a/docs/manpages/tracker-sql.1.txt
+++ b/docs/manpages/tracker3-sql.1.txt