On Wed, Mar 24, 2021 at 08:37:35PM +0100, Mario Blättermann wrote:
> I found the problem, at least partially. A backslash was missing in
> Makefile.am, and now "make gen-man" creates *roff man pages, as
> expected. However, it stops here:
OK.
> GEN sys-utils/swapoff.8
> asciidoctor: FAILED: input file ./sys-utils/swapoff.8.adoc is missing
> make: *** [Makefile:15942: sys-utils/swapoff.8] Fehler 1
>
> But I'm wondering why it doesn't complain about the other symlinks in
> libuuid etc, and it didn't stop until the sys-utils directory has been
> reached.
It seems asciidoctor generates also the man page links (see below for
more details). It's safe to remove the man page link files from the
tree at all.
The issue is that we have the link pages in the dist_man_MANS=
and 'make' tries to verify the link file *before* the original
man page. It means
dist_man_MANS += sys-utils/swapon.8 sys-utils/swapoff.8
is no problem, but:
dist_man_MANS += sys-utils/swapoff.8 sys-utils/swapon.8
ends with error ;-)
I'll send you pull request to your topic/asciidoc do fix this (and
some others minor) issue.
Karel
$ git checkout -f
$ make clean
$ git status
On branch ad
nothing to commit, working tree clean
make the man page (V=1 for verbose output):
$ make libuuid/man/uuid_generate.3 V=1
/usr/bin/mkdir -p $(dirname libuuid/man/uuid_generate.3)
srcdir=''; \
test -f ./libuuid/man/uuid_generate.3.adoc || srcdir=./; \
/usr/bin/asciidoctor -b manpage -a 'VERSION=2.36.689-bdda0' -a 'ADJTIME_PATH=/etc/adjtime' ${srcdir}libuuid/man/uuid_generate.3.adoc
now see that asciidoctor also updated the uuid_generate_*.3 man pages:
$ git diff
diff --git a/libuuid/man/uuid_generate_random.3 b/libuuid/man/uuid_generate_random.3
index 8405486e9..1e51c4e6e 100644
--- a/libuuid/man/uuid_generate_random.3
+++ b/libuuid/man/uuid_generate_random.3
@@ -1 +1 @@
-.so man3/uuid_generate.3
+.so uuid_generate.3
\ No newline at end of file
diff --git a/libuuid/man/uuid_generate_time.3 b/libuuid/man/uuid_generate_time.3
index 8405486e9..1e51c4e6e 100644
--- a/libuuid/man/uuid_generate_time.3
+++ b/libuuid/man/uuid_generate_time.3
@@ -1 +1 @@
-.so man3/uuid_generate.3
+.so uuid_generate.3
\ No newline at end of file
diff --git a/libuuid/man/uuid_generate_time_safe.3 b/libuuid/man/uuid_generate_time_safe.3
index 8405486e9..1e51c4e6e 100644
--- a/libuuid/man/uuid_generate_time_safe.3
+++ b/libuuid/man/uuid_generate_time_safe.3
@@ -1 +1 @@
-.so man3/uuid_generate.3
+.so uuid_generate.3
\ No newline at end of file
--
Karel Zak <kzak@xxxxxxxxxx>
http://karelzak.blogspot.com
