Re: No 6.05/.01 pdf book available

[Alejandro Colomar <alx@kernel.org>]

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

Hi Deri, Branden,

On 2023-08-14 18:06, Deri wrote:
[...]

> Line missing in the bespoke an.tmac I provided, new version attached.

Thanks; will try.

> I know 
> Alex wants to run against a stock version of groff, with minimal 
> customisation, and, once my branch is merged, there will be further pruning, 
> but unless you add to Branden's wish list to include an ability to control the 
> hierarchy of the bookmark panel, you will need a customised an.tmac. The 
> reason is because the stock an.tmac has a hard coded hierarchy where the .TH 
> line is given level 1 but as you want to have separate sections these need to 
> be level one and everything else is moved up a level. Of course this just 
> means making the starting level configurable on the command line, i.e. 
> -r startbkmk=2 or some such.

Deri's wish is my wish :)

> Another change which would need to be accepted is 
> to allow a fourth parameter to .MR which is the destination name. Normally the 
> name of the destination is derived from the first two parameters concatenated 
> with "_", but if the name part of the .MR call to the man page includes non-
> ascii characters (such as ".MR my\-lovely\-page 7 ,") then it needs to provide 
> a "clean" destination name.

Is this really needed?  Can't gropdf just translate them internally?  Say, do
unconditionally the equivalent of `| tr - _ |` or something like that.

[...]

> 
> Fonts
> 
> There are 2 reasons I included fonts in the build environment:-
> 
> A) The man pages which define the various iso-8859 pages contain many glyphs 
> which are not defined in the standard groff fonts, so I used the Tinos font 
> from google which improves the coverage. If you want to get rid of the fonts, 
> and rely on just the fonts in groff, you can change line 4 of anmark.tmac to:-
> 
> .special S U-TR
> 
> Which is an improvement on the standard fonts, and should be available as 
> standard if the URW fonts were found when groff was built. You will see 
> differences in iso-8859-7 and iso-8859-8 for example.

I'll try.  I wouldn't want to make those ISO-8859 pages useless, though.

> 
> B) If you build the LinuxManBook using the 1.23.0+ flavour (with the newer 
> gropdf that produces a substantially smaller pdf) it requires a slightly 
> different font format so needs the embedded font directory. If you have 
> installed groff from the deri-gropdf-ng the new format fonts will have been 
> installed, so the embedded font directory can be removed.

Do you have an estimate of how long your branch could take to merge?
As in, more than a month or less than a month?

> 
> Makefile
> 
> The simplest option would be to add a new rule to the Makefile which is 
> dependent on all the man pages have been built, and cd's into the scripts/
> LinuxManBook directory and calls the program with the location where the man 
> pages exist. However, I suspect Alex fancies something more complicated by 
> replacing the perl with a hybrid of shell command and make magic.

You suspect well.  :)

> 
> I attach a new copy of BuildLinuxMan.pl which is an amalgam of mine and 
> Brian's code. This has the new -paper flag.
> 
> Alex's MR branch
> 
> The new program now recognises existing .MR's in the document and provides the 
> "clean" destination name, so it should run against the new branch.
> 
>> 	nodemask ... on-
>> 	...
>> 	line, ...
>>
>> There appear to be 24 single word instances of online and 12 outdated
>> hyphenated compound word instances of on-line across all man pages.
>>
>> UI: I also noticed, while looking for tables to compare, that pages are
>> ordered by filename not like rpmvercmp/ls -v/RPM::VersionSort e.g
>> ISO_8859-2 is after ISO_8859-16 which may not be as expected.
>> Used rpmvercmp in last line of perl sub sortman and works as expected.
> 
> I have used Sort::Versions (see above), thanks for the suggestion.
> 
>> Tech nitpick: .Z is still recognized by GUIs as compress output
>> (UNIX-compressed file) - is there no other file type suffix used for
>> ditroff intermediate output? Aha - Alex says .set:
>>
>> 	https://lists.gnu.org/archive/html/groff/2023-04/msg00213.html
>>
> Well, that's settled.
> 
>> Added variables and changed those also in BLM-letter.pl: copy attached.
>>
>>> Thanks for your help.
>>
>> Happy to help in any way.
> 
> Hope you're happy with this version.

Let's open the improved Christmas present!  :D

Cheers,
Alex

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


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