Re: No 6.05/.01 pdf book available

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1.1: Type: text/plain, Size: 2649 bytes --]

Hi Brian,

On 2023-08-07 18:21, Brian Inglis wrote:
[...]

>>> $ pwd
>>> /home/alx/src/linux/man-pages/man-pages/6.04/scripts/LinuxManBook
>>> $ ./BuildLinuxMan.pl  ../../
>>> [...]
>>> Failed to open 'DESC'
> 
> That annoyingly minimal message provoked the patch submitted.

Yeah; it took me some time to find the cause.  The error message doesn't
even tell who failed --was it the shell, was it gropdf, was it troff?--.

:)

> 
>>>> When I run the script/LinuxManBook/BuildLinuxMan.pl, after applying the gropdf
>>>> patch, manually in the build dir, I get a pdf, but without any man page footers.
> 
>>> Hmm, that's weird.  After applying your patch, It works fine for me.
>>> I do see the page footers.  However, I have old builds of groff in my
>>> system, which I haven't cleaned up, so maybe they interfere positively
>>> to that outcome.  Maybe from a clean installation of Debian Sid I
>>> wouldn't be able to reproduce that.
> 
>> I have uploaded the 6.05.01 book now.
> 
> Nice - with current page footers!

Can you confirm if you can build the book correctly after I pushed Deri's
change?  I'm worried that I couldn't reproduce your problem, and would
like to know if it has gone away or persists for you.

> 
>>> Nevertheless, now I remember Deri told me he hardcoded a lot of stuff
>>> for 1.22.4 which should be removed after the release of 1.23.0, so it
>>> seems that the time has come to chop a lot of stuff from there.
>>>
>>> Deri, would you mind simplifying the scripts assuming a Build-dep of
>>> groff(>=1.23.0)?
> 
> Resent the patch cc Deri.
> 
> Would it make sense to merge changes into/from groff 1.23 grodpf, which I also 
> tried, and also did not produce page footers, but did produce lots of 
> *different* messages.
> It seems likely that changes made to build the huge man book might also benefit 
> other projects with large docs.

We don't have a gropdf(1) copy anymore.  :)

> 
>>>> Are there any other scripts which need to be run and/or groff commands or data
>>>> which need to be supplied?
> 
>>> No.  It's just:
>>>
>>> $ cd scripts/LinuxManBook/
>>> $ ./BuildLinuxMan.pl ../../
> 
>>>> It would be nice to see this eventually added to your RELEASE doc, and maybe
>>>> also to the make scripts.
> 
>>> Yes.  I first want to put it in the Makefiles, and then add it to
>>> INSTALL.  Then something to RELEASE.  But I first want to simplify
>>> the script so I can understand it.
> 
> See below ;^>

Sooo true.

Cheers,
Alex

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]