PDF book of unreleased pages (was: strncpy clarify result may not be null terminated)

Alejandro Colomar
2023-11-18T09:34:08Z

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

On Fri, Nov 17, 2023 at 09:46:47PM +0000, Jonny Grant wrote:
> Thank you for your swift replies Alejandro and incorporating changes.

:-)

> >> I was reading again
> >> https://man7.org/linux/man-pages/man7/string_copying.7.html
> >>
> >> Sharing some comments, I realise not latest man page, if you have a new one online I could read that. I was reading man-pages 6.04, perhaps some already updated.
> >
> > You can check this one:
> >
> > <https://www.alejandro-colomar.es/share/dist/man-pages/6/6.05/6.05.01/man-pages-6.05.01.pdf#string_copying_7>
> > also available here:
> > <https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/book/man-pages-6.05.01.pdf#string_copying_7>
> >
> > And of course, you can install them from source, or read them from the
> > repository itself.
>
> That's good if you have your online PDF version of unreleased versions I could read through.

I have that as a goal, but need some help. The thing is: we have
<./scripts/LinuxManBook/>, which contains a Perl script and some helper
stuff for it. It was contributed by gropdf(1)'s maintainer Deri James.

Currently, that script does a lot of magic which produces the book from
all of the pages.

I'd like to be able to split the script into several smaller scripts
that can be run on each page, and then another script that merges all of
them into the single PDF file. That would be something I can merge into
the Makefiles so that we can run a `make build-pdf` and if I touch a
single page, it would only update the relevant part, reusing as much as
possible from previous runs.

Since I don't understand Perl, and don't know much of gropdf(1) either,
I need help.

Maybe Deri or Branden can help with that. If anyone else understands it
and can also help, that's very welcome too!

Then I could install a hook in my server that runs

$ make build-pdf docdir=/srv/www/...

Cheers,
Alex

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