From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from omta002.cacentral1.a.cloudfilter.net (omta002.cacentral1.a.cloudfilter.net [3.97.99.33]) by sourceware.org (Postfix) with ESMTPS id 274193858D1E for ; Tue, 21 Feb 2023 04:18:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 274193858D1E Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=Shaw.ca Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=shaw.ca Received: from shw-obgw-4002a.ext.cloudfilter.net ([10.228.9.250]) by cmsmtp with ESMTP id U5vBpZ0ODjvm1UK6ZpXylS; Tue, 21 Feb 2023 04:18:15 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=shaw.ca; s=s20180605; t=1676953095; bh=meVeShqvMq7mPd5hwsUOU3T2VROLgumatSjkoBvQ2Ac=; h=From:To:Subject:Date:In-Reply-To:References; b=aJ1WJ4Y3kfSql06H4tR8rRxQYwyDLxUPoXGDJjncdv+n2TV/7QX8i57i7JoL6uInQ e7J9SEHnsLpQ9Lt44/YyGdSHX2cNwu3oISXTtJh6QukyKWNYr/sXD/ce8mnjvIrNHw 4eD8f5kWmq3AgXSnx36WOndPzh50oqa4JJldKjfovfgmVe/GwUaAwH1WGlPQ+jZ97l ME238dXvykSMCxb86+C9P6Di9+ktE1F8o5HF1Cri/9EPqz+Z1MFia5K9JW/YPqwuqd 14REguGQbfhJcrZItIJVf/dYU0KPVMPIoVpREE20amjMCSW/r+2YsRisJECJBCwz/G l2PjhDQc3UGfg== Received: from localhost.localdomain ([184.64.102.149]) by cmsmtp with ESMTP id UK6ZpVLa2yAOeUK6ZpnKb8; Tue, 21 Feb 2023 04:18:15 +0000 X-Authority-Analysis: v=2.4 cv=e5oV9Il/ c=1 sm=1 tr=0 ts=63f44607 a=DxHlV3/gbUaP7LOF0QAmaA==:117 a=DxHlV3/gbUaP7LOF0QAmaA==:17 a=mDV3o1hIAAAA:8 a=YP7CapC394ZNLcSS2coA:9 a=AP3JQZ_qGYIA:10 a=_FVE-zBwftR9WsbkzFJk:22 From: Brian Inglis To: newlib@sourceware.org Subject: [PATCH v3 0/2] newlib/libc/time/strftime: fix multi-page table format issues Date: Mon, 20 Feb 2023 21:17:59 -0700 Message-Id: <20230221041801.51970-1-Brian.Inglis@Shaw.ca> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230217204902.3735-1-Brian.Inglis@Shaw.ca> References: <20230217204902.3735-1-Brian.Inglis@Shaw.ca> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4xfPDca+plKxBHvUN0J9GJLuNEIRA4dZOuqM2zqmUvqjZZcm/Rti/UC3oZpA4WePBFCYooL+6A6v9Ryy5ye2McfyKuesH0mVNAbWPyu+LWXJGdL9YV3HSP ZFBsoROZpPeZC/pezFi1yJeuoXTWVQvktPNSXQHb5mQiNs9HBs/y3Ehkvr2WDA75Qu1sXLOUJpcds+9OX/Ni+ijZBlqv9OChOOJ645GV5hENQXlQ0wVCa0JY tauyB7qSESbluypKqOMUIA== X-Spam-Status: No, score=-3.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: 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