Re: No 6.05/.01 pdf book available

[Deri <deri@chuzzlewit.myzen.co.uk>]

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

On Tuesday, 15 August 2023 01:34:16 BST Brian Inglis wrote:
> On 2023-08-14 10:06, Deri wrote:
> > I'm afraid the dangling page hyphens are all my fault. :-(
> > 
> > Line missing in the bespoke an.tmac I provided, new version attached. 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.
> > 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.
> > 
> > Sorting
> > 
> > I decided to use Sort::Versions (rather than RPM::VersionSort) because it
> > is available as a package on my system. Seems to do the job.
> > 
> > Paper
> > 
> > You can now specify the paper size for the book on the command line as
> > "-paper size".
> > 
> > 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.
> > 
> > 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.
> > 
> > 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.
> > 
> > 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, ...
> 
> Looking forward to trying out the new spiffy macros and scripts.
> 
> >> 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.
> 
> Unlikely as versioncmp treats underscores as special rather than ignoring
> them as in rpmvercmp and sortman: see attached diffs for comparisons. ;^>
> 
> Had to drop more details as got bounced with too many attachments - retrying
> with only diffs: official-order is 6.05.01.

Hi Brian,

Please can you check if this sort order is acceptable.

Cheers 

Deri


[-- Attachment #2: BuildLinuxMan.pl --]
[-- Type: application/x-perl, Size: 7075 bytes --]