Bogus index in man-pages book from other projects

Alejandro Colomar
2024-03-09T16:21:43Z

[-- Attachment #1: Type: text/plain, Size: 1284 bytes --]

Hi Deri!

I've tried to build a man-pages book of the shadow project, using the
Linux man-pages build system (which calls your script). The text
contents look good, but the index seems to be bogus, and man-page
references don't work (it results in just text).

I only see in the index the names of the pages that are aliases. None
of the actual pages (their in-page sections are top-level entries in the
index).

To reproduce it,

```sh
git clone -b shadow http://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/
git clone https://github.com/shadow-maint/shadow
mkdir build
cd build
sudo apt-get build-dep shadow
../shadow/autogen.sh
make -j4
cd ../man-pages
make build-book MANDIR=../build/man
open .tmp/man/man-pages.pdf
```

The `make build-book` step results in the following warning, which may
be relevant:

$ make build-book MANDIR=../build/man
MKDIR .tmp/man/
Build .tmp/man/man-pages.pdf
for my (...) is experimental at ./scripts/LinuxManBook/prepare.pl line 62.
pdf.tmac:chage.1:29: warning: adjusted level 3 bookmark; should be <= 1
pdf.tmac:chage.1:31: warning: adjusted level 3 bookmark; should be <= 2

Would you mind having a look at this?

Have a lovely day!
Alex

--
<https://www.alejandro-colomar.es/>