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:
BuildLinuxMan.pl
Description: Perl program
