[PATCH v3 0/2] newlib/libc/time/strftime: fix multi-page table format issues

[Brian Inglis]

Discussion about why newlib man generation by docbook2man is
incompatible with how man is incompatible with groff/tbl/grohtml:

	https://lists.gnu.org/archive/html/bug-groff/2023-02/msg00118.html

There does not appear to be good way to deal in docbook2man processing
with generation of tables > "page" size, or that may not adversely affect
other [newlib] doc man page tables, as the problem occurs solely on the
strftime.3 man page!

The imminent groff/tbl release fixes a number of tbl issues, so may
affect man pages with tables differently.

The following groff/grohtml release plans to change grohtml, from
generating tables as PNG graphics, which don't work reliably on some
"devices"/file formats, and are not searchable, to generating tables in
searchable text form on all "devices"/file formats, and fix other
related issues, so may also affect man pages with tables differently. 

So for the current release, localize the changes to the man page chew
input embedded in the strftime.c source comments, and the generated
strftime.3 man page table formatting.
Be prepared to tweak formatting if doc generation needs it, and
eventually eliminate custom processing.

newlib/libc/time/strftime.c: split chew table of conversion format
specifiers as man/tbl/groff can not handle large tables on all output
devices/file formats

newlib/libc/Makefile.inc: sed fix strftime.3 tbl/groff format issues:
remove multiple "^l l$" tbl line formats at tops of tables;
change remaining "^l l\.$" tbl line formats at tops of tables so second
column is lx and extends to margin;
remove "^.PP$" breaks before each format description as it misaligns
text below format specifier;
remove blank line between adjacent tables

Brian Inglis (2):
  newlib/libc/time/strftime.c: split chew table of conversion format
    specifiers
  newlib/libc/Makefile.inc: sed fix strftime.3 tbl/groff format issues

 newlib/libc/time/strftime.c | 3 ++-
 newlib/libc/Makefile.inc    | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

--
2.39.0