On Thu, Aug 17, 2023 at 06:49:03PM -0500, G. Branden Robinson wrote: > At 2023-08-17T10:23:55-0500, Eric Blake wrote: > > | diff --git a/Base/Text/Functions/getlocalename_l.mm b/Base/Text/Functions/getlocalename_l.mm > > | index 13af2a5..339bfc5 100644 > > | --- a/Base/Text/Functions/getlocalename_l.mm > > | +++ b/Base/Text/Functions/getlocalename_l.mm > > | @@ -12,7 +12,9 @@ const char *getlocalename_l(int \f6category\fP, locale_t \f6locobj\fP); > > | .sE > > | .yE > > | .mH DESCRIPTION > > | -The > > | +If > > | +.Ar category > > | +is not LC_ALL, the > > | .Fn getlocalename_l > > | function shall return the locale name for the given locale category of > > | the locale object > > Thanks for the peek behind the curtain, Eric! > > I infer that the Open Group's use of mm has an extensive layer of > bespoke macros supplementing it (not really a suprise). _None_ of the > macro names we see above appears in Documenter's Workbench troff 3.3 mm > or GNU troff. Indeed, there is another git repository containing a (rather sizable) set of tooling for converting sus_base into both .pdf and .html formats. Among other things, https://gitlab.opengroup.org/the-austin-group/sus_tools/-/blob/master/tools/macros.xo is over 43kB, containing custom macros such as: | .. | .\" Heading on man page: really a list item | .de mH | .\".P | .br | .ne 4v | .LI "\f3\\$1\f1" | .br | .. Supposedly the process is fairly automated, though (but I haven't tried it myself); the README for that project states: | For example, to do a build of SUS_Base from scratch: | | Check out sus_tools and sus_base from gitlab | cd sus_tools | ./build-docker.sh | cd ../sus_base | ../sus_tools/run-docker.sh sh -c 'cd /build/Base && /tdocs/build/tools/build' -- Eric Blake, Principal Software Engineer Red Hat, Inc. Virtualization: qemu.org | libguestfs.org
