man-pages-posix: POSIX book build

man-pages-posix: POSIX book build

[Brian Inglis]

Hi folks,

Just to see if making a POSIX book works, I copied 1.23.0 LinuxManBook as 
PosixManBook, BuildLinuxMan.pl to BuildPosixMan.pl, LMBfront.t to PMBfront.t 
with content changes, added sections "[013]p" and made other obvious perl script 
edits '%s/Linux/Posix/g', '%s/LMB/PMB/g'.

When I ran the perl script, eqn was growing into the GB memory, and eqn and 
troff were each hogging a cpu, so I left it running while we were out at dinner 
with friends, but *eqn* died after apparently exhausting all memory and using 
48GB page space, getting as far as limits.h(0p) for a 57 page PDF!

-- 
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retirer     but when there is no more to cut
                                 -- Antoine de Saint-Exupéry

Re: man-pages-posix: POSIX book build

[Alejandro Colomar]

[-- Attachment #1.1.1: Type: text/plain, Size: 1669 bytes --]

Hi Brian,

On 2023-08-13 23:04, Brian Inglis wrote:
> Hi folks,
> 
> Just to see if making a POSIX book works, I copied 1.23.0 LinuxManBook as 
> PosixManBook, BuildLinuxMan.pl to BuildPosixMan.pl, LMBfront.t to PMBfront.t 
> with content changes, added sections "[013]p" and made other obvious perl script 
> edits '%s/Linux/Posix/g', '%s/LMB/PMB/g'.
> 
> When I ran the perl script, eqn was growing into the GB memory, and eqn and 
> troff were each hogging a cpu, so I left it running while we were out at dinner 
> with friends, but *eqn* died after apparently exhausting all memory and using 
> 48GB page space, getting as far as limits.h(0p) for a 57 page PDF!

Huh!

If you want to tinker with the Linux man-pages Makefile, it may be useful to your
experiment.

$ # run the following from the root of the Linux man-pages repository.
$ make -kj lint build check MANDIR=../../man-pages-posix/man-pages-posix-2017/

This works.  It gets many warnings, of course, but it builds PDF files of every
page, among PS, HTML, and a lot more stuff.  You may be able to tweak the
makefiles to build a book.  If you get to that, please send the patches =)

I attached one of the pages (from man-pages-posix-2003).  (Oh boy, did I ever
mention that I like bzero(3)? :D).

As mentioned recently in the list, you can use the Linux man-pages Makefile to
lint and build PDF, PS, and HTML pages of every project (or at least of every
project I tried).  If any project fails, I'm interested in making it work, so
please report.

Cheers,
Alex

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

[-- Attachment #1.1.2: bzero.3p.pdf --]
[-- Type: application/pdf, Size: 20743 bytes --]

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

Re: man-pages-posix: POSIX book build

[G. Branden Robinson]

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

Hi Brian,

At 2023-08-13T15:04:03-0600, Brian Inglis wrote:
> When I ran the perl script, eqn was growing into the GB memory, and
> eqn and troff were each hogging a cpu, so I left it running while we
> were out at dinner with friends, but *eqn* died after apparently
> exhausting all memory and using 48GB page space, getting as far as
> limits.h(0p) for a 57 page PDF!

Gack.  If this was GNU troff, please report it officially.

https://savannah.gnu.org/bugs/?group=groff&func=additem

Please attach the offending exhibit and any script(s) necessary to drive
the issue.  If you have time to truncate the input to the page after
limits.h(0p), and the bug reproduces, that would be helpful.

I only know of one other issue like this, but it has nothing to do with
eqn, and it tarpits every *roff it meets.

https://savannah.gnu.org/bugs/index.php?64229

But eqn itself doesn't create or use diversions (it can't--it's already
exited by the time a "diversion" exists), so at first blush I think
something else must be making it go asymptotic.

Regards,
Branden

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