Re: Issues in man pages of bison (part 2)

This is a multi-part message in MIME format.
--------------4R1WZx6oqgckfX1UjpVrjYpt
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

Thanks for the bug report about the Bison man page 
<https://lists.gnu.org/r/bug-bison/2026-01/msg00000.html>. I assumes 
this supersedes the report last month 
<https://lists.gnu.org/r/bug-bison/2025-12/msg00000.html>.

I installed the attached patch which I hope addresses the problems 
reported, except for the following issue:

On 2026-01-17 22:42, Helge Kreutzmann wrote:

> Issue:    NAME in italics?
> 
> "B<-D>, B<--define=NAME>[=I<\\,VALUE\\/>]"
> 
> "B<-F>, B<--force-define=NAME>[=I<\\,VALUE\\/>]"

These strings are generated by help2man, so I'll cc this email to 
[email protected]. The bug is that help2man reads this output of 
'bison --help':

   -D, --define=NAME[=VALUE]        similar to '%define NAME VALUE'
   -F, --force-define=NAME[=VALUE]  override '%define NAME VALUE'

and outputs these lines:

.TP
\fB\-D\fR, \fB\-\-define=NAME\fR[=\fI\,VALUE\/\fR]
similar to '%define NAME VALUE'
.TP
\fB\-F\fR, \fB\-\-force\-define=NAME\fR[=\fI\,VALUE\/\fR]
override '%define NAME VALUE'

I suppose help2man should output something like this instead:

.TP
\fB\-D\fR, \fB\-\-define\fR=\fI\,NAME\/\fR[\fB=\fR\fI\,VALUE\/\fR]
similar to '%define NAME VALUE'
.TP
\fB\-F\fR, \fB\-\-force\-define\fR=\fI\,NAME\/\fR[\fB=\fR\fI\,VALUE\/\fR]
override '%define NAME VALUE'

or if that's too much work, at least this:

.TP
\fB\-D\fR, \fB\-\-define\fR=\fI\,NAME[=VALUE\/\fR]
similar to '%define NAME VALUE'
.TP
\fB\-F\fR, \fB\-\-force\-define\fR=\fI\,NAME[=VALUE\/\fR]
override '%define NAME VALUE'

--------------4R1WZx6oqgckfX1UjpVrjYpt
Content-Type: text/x-patch; charset=UTF-8;
 name="0001-doc-improve-man-page-mostly-fonts.patch"
Content-Disposition: attachment;
 filename="0001-doc-improve-man-page-mostly-fonts.patch"
Content-Transfer-Encoding: base64

RnJvbSBjNmQxZjY1MTg1ZGZkMTFlNzExZGY5ODU2NzRjMDNlYzAwYTFkYWIyIE1vbiBTZXAg
MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QGNzLnVjbGEuZWR1
PgpEYXRlOiBTdW4sIDE4IEphbiAyMDI2IDA5OjIzOjIxIC0wODAwClN1YmplY3Q6IFtQQVRD
SF0gZG9jOiBpbXByb3ZlIG1hbiBwYWdlIChtb3N0bHkgZm9udHMpCgpQcm9ibGVtcyByZXBv
cnRlZCBieSBIZWxnZSBLcmV1dHptYW5uIGluOgpodHRwczovL2xpc3RzLmdudS5vcmcvci9i
dWctYmlzb24vMjAyNi0wMS9tc2cwMDAwMC5odG1sCiogZG9jL2Jpc29uLng6IFJlZm9udGlm
eSwgbW9zdGx5LgoqIHNyYy9nZXRhcmdzLmMgKHVzYWdlKTogQ2xhcmlmeSB1c2FnZSBtZXNz
YWdlLgotLS0KIGRvYy9iaXNvbi54ICAgfCA1NyArKysrKysrKysrKysrKysrKysrKysrKysr
Ky0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KIHNyYy9nZXRhcmdzLmMgfCAgNiArKystLS0K
IDIgZmlsZXMgY2hhbmdlZCwgMzIgaW5zZXJ0aW9ucygrKSwgMzEgZGVsZXRpb25zKC0pCgpk
aWZmIC0tZ2l0IGEvZG9jL2Jpc29uLnggYi9kb2MvYmlzb24ueAppbmRleCBlZGFlYmU4My4u
Y2I0ZjdhOGQgMTAwNjQ0Ci0tLSBhL2RvYy9iaXNvbi54CisrKyBiL2RvYy9iaXNvbi54CkBA
IC0yLDQ4ICsyLDQ5IEBACiBiaXNvbiBcLSBHTlUgUHJvamVjdCBwYXJzZXIgZ2VuZXJhdG9y
ICh5YWNjIHJlcGxhY2VtZW50KQogCiBbZGVzY3JpcHRpb25dCi0uSSBCaXNvbgotaXMgYSBw
YXJzZXIgZ2VuZXJhdG9yIGluIHRoZSBzdHlsZSBvZgotLklSIHlhY2MgKDEpLgotSXQgc2hv
dWxkIGJlIHVwd2FyZGx5IGNvbXBhdGlibGUgd2l0aCBpbnB1dCBmaWxlcyBkZXNpZ25lZAot
Zm9yCi0uSVIgeWFjYyAuCitUaGUKKy5CIGJpc29uCitwYXJzZXIgZ2VuZXJhdG9yIGlucHV0
cyBncmFtbWFycyBpbiB0aGUgc3R5bGUgb2YKKy5CUiB5YWNjICgxKQorYW5kIG91dHB1dHMg
cGFyc2VycyBmb3IgdGhvc2UgZ3JhbW1lcnMuCiAuUFAKIElucHV0IGZpbGVzIHNob3VsZCBm
b2xsb3cgdGhlCi0uSSB5YWNjCisuQiB5YWNjCiBjb252ZW50aW9uIG9mIGVuZGluZyBpbgot
LkJSIC55IC4KKy5JUiAueSAuCiBVbmxpa2UKLS5JUiB5YWNjICwKKy5CUiB5YWNjICwKIHRo
ZSBnZW5lcmF0ZWQgZmlsZXMgZG8gbm90IGhhdmUgZml4ZWQgbmFtZXMsIGJ1dCBpbnN0ZWFk
IHVzZSB0aGUgcHJlZml4CiBvZiB0aGUgaW5wdXQgZmlsZS4KLU1vcmVvdmVyLCBpZiB5b3Ug
bmVlZCB0byBwdXQKLS5JIEMrKwotY29kZSBpbiB0aGUgaW5wdXQgZmlsZSwgeW91IGNhbiBl
bmQgaGlzIG5hbWUgYnkgYSBDKystbGlrZSBleHRlbnNpb24KLSgueXBwIG9yIC55KyspLCB0
aGVuIGJpc29uIHdpbGwgZm9sbG93IHlvdXIgZXh0ZW5zaW9uIHRvIG5hbWUgdGhlCi1vdXRw
dXQgZmlsZSAoLmNwcCBvciAuYysrKS4KK01vcmVvdmVyLCBpZiB5b3UgbmVlZCB0byBwdXQg
QysrCitjb2RlIGluIHRoZSBpbnB1dCBmaWxlLCB5b3UgY2FuIGVuZCBpdHMgbmFtZSBieSBh
IEMrKy1saWtlIGV4dGVuc2lvbgorLlJJICggLnlwcAorb3IKKy5JUiAueSsrICksCithbmQg
dGhlbgorLkIgYmlzb24KK3dpbGwgZm9sbG93IHlvdXIgZXh0ZW5zaW9uIHRvIG5hbWUgdGhl
CitvdXRwdXQgZmlsZQorLlJJICggLmNwcAorb3IKKy5JUiAuYysrICkuCiBGb3IgaW5zdGFu
Y2UsIGEgZ3JhbW1hciBkZXNjcmlwdGlvbiBmaWxlIG5hbWVkCi0uQiBwYXJzZS55eHgKKy5J
IHBhcnNlLnl4eAogd291bGQgcHJvZHVjZSB0aGUgZ2VuZXJhdGVkIHBhcnNlciBpbiBhIGZp
bGUgbmFtZWQKLS5CUiBwYXJzZS50YWIuY3h4ICwKKy5JUiBwYXJzZS50YWIuY3h4ICwKIGlu
c3RlYWQgb2YKLS5JUiB5YWNjICdzCi0uQiB5LnRhYi5jCi1vciBvbGQKLS5JIEJpc29uCi12
ZXJzaW9uJ3MKLS5CUiBwYXJzZS50YWIuYyAuCisuQlIgeWFjYyAncworLklSIHkudGFiLmMg
LgogLlBQCiBUaGlzIGRlc2NyaXB0aW9uIG9mIHRoZSBvcHRpb25zIHRoYXQgY2FuIGJlIGdp
dmVuIHRvCi0uSSBiaXNvbgorLkIgYmlzb24KIGlzIGFkYXB0ZWQgZnJvbSB0aGUgbm9kZQog
LkIgSW52b2NhdGlvbgotaW4gdGhlCi0uQiBiaXNvbi50ZXhpCi1tYW51YWwsIHdoaWNoIHNo
b3VsZCBiZSB0YWtlbiBhcyBhdXRob3JpdGF0aXZlLgoraW4gdGhlIEJpc29uIG1hbnVhbCwg
d2hpY2ggc2hvdWxkIGJlIHRha2VuIGFzIGF1dGhvcml0YXRpdmUuCiAuUFAKLS5JIEJpc29u
Ci1zdXBwb3J0cyBib3RoIHRyYWRpdGlvbmFsIHNpbmdsZS1sZXR0ZXIgb3B0aW9ucyBhbmQg
bW5lbW9uaWMgbG9uZworVGhlCisuQiBiaXNvbgorY29tbWFuZCBzdXBwb3J0cyBib3RoIHRy
YWRpdGlvbmFsIHNpbmdsZS1sZXR0ZXIgb3B0aW9ucyBhbmQgbW5lbW9uaWMgbG9uZwogb3B0
aW9uIG5hbWVzLiAgTG9uZyBvcHRpb24gbmFtZXMgYXJlIGluZGljYXRlZCB3aXRoCiAuQiBc
LVwtCiBpbnN0ZWFkIG9mCmRpZmYgLS1naXQgYS9zcmMvZ2V0YXJncy5jIGIvc3JjL2dldGFy
Z3MuYwppbmRleCA3OWE4YjcwNi4uOWU1M2QzZjkgMTAwNjQ0Ci0tLSBhL3NyYy9nZXRhcmdz
LmMKKysrIGIvc3JjL2dldGFyZ3MuYwpAQCAtNDIyLDEyICs0MjIsMTIgQEAgRGlhZ25vc3Rp
Y3M6XG5cCiBUdW5pbmcgdGhlIFBhcnNlcjpcblwKICAgLUwsIC0tbGFuZ3VhZ2U9TEFOR1VB
R0UgICAgICAgICAgc3BlY2lmeSB0aGUgb3V0cHV0IHByb2dyYW1taW5nIGxhbmd1YWdlXG5c
CiAgIC1TLCAtLXNrZWxldG9uPUZJTEUgICAgICAgICAgICAgIHNwZWNpZnkgdGhlIHNrZWxl
dG9uIHRvIHVzZVxuXAotICAtdCwgLS1kZWJ1ZyAgICAgICAgICAgICAgICAgICAgICBpbnN0
cnVtZW50IHRoZSBwYXJzZXIgZm9yIHRyYWNpbmdcblwKKyAgLXQsIC0tZGVidWcgICAgICAg
ICAgICAgICAgICAgICAgaW5zdHJ1bWVudCB0aGUgcGFyc2VyIGZvciB0cmFjaW5nO1xuXAog
ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBzYW1lIGFzICctRHBhcnNlLnRy
YWNlJ1xuXAogICAgICAgLS1sb2NhdGlvbnMgICAgICAgICAgICAgICAgICBlbmFibGUgbG9j
YXRpb24gc3VwcG9ydFxuXAogICAtRCwgLS1kZWZpbmU9TkFNRVs9VkFMVUVdICAgICAgICBz
aW1pbGFyIHRvICclZGVmaW5lIE5BTUUgVkFMVUUnXG5cCiAgIC1GLCAtLWZvcmNlLWRlZmlu
ZT1OQU1FWz1WQUxVRV0gIG92ZXJyaWRlICclZGVmaW5lIE5BTUUgVkFMVUUnXG5cCi0gIC1w
LCAtLW5hbWUtcHJlZml4PVBSRUZJWCAgICAgICAgIHByZXBlbmQgUFJFRklYIHRvIHRoZSBl
eHRlcm5hbCBzeW1ib2xzXG5cCisgIC1wLCAtLW5hbWUtcHJlZml4PVBSRUZJWCAgICAgICAg
IHByZXBlbmQgUFJFRklYIHRvIHRoZSBleHRlcm5hbCBzeW1ib2xzO1xuXAogICAgICAgICAg
ICAgICAgICAgICAgICAgICAgICAgICAgICBkZXByZWNhdGVkIGJ5ICctRGFwaS5wcmVmaXg9
e1BSRUZJWH0nXG5cCiAgIC1sLCAtLW5vLWxpbmVzICAgICAgICAgICAgICAgICAgIGRvbid0
IGdlbmVyYXRlICcjbGluZScgZGlyZWN0aXZlc1xuXAogICAtaywgLS10b2tlbi10YWJsZSAg
ICAgICAgICAgICAgICBpbmNsdWRlIGEgdGFibGUgb2YgdG9rZW4gbmFtZXNcblwKQEAgLTQ0
Myw3ICs0NDMsNyBAQCBPdXRwdXQgRmlsZXM6XG5cCiAgICAgICAtLXJlcG9ydC1maWxlPUZJ
TEUgICAgICAgIHdyaXRlIHJlcG9ydCB0byBGSUxFXG5cCiAgIC12LCAtLXZlcmJvc2UgICAg
ICAgICAgICAgICAgIHNhbWUgYXMgJy0tcmVwb3J0PXN0YXRlJ1xuXAogICAtYiwgLS1maWxl
LXByZWZpeD1QUkVGSVggICAgICBzcGVjaWZ5IGEgUFJFRklYIGZvciBvdXRwdXQgZmlsZXNc
blwKLSAgLW8sIC0tb3V0cHV0PUZJTEUgICAgICAgICAgICAgbGVhdmUgb3V0cHV0IHRvIEZJ
TEVcblwKKyAgLW8sIC0tb3V0cHV0PUZJTEUgICAgICAgICAgICAgb3V0cHV0IHRvIEZJTEVc
blwKICAgLWcsIC0tZ3JhcGhbPUZJTEVdICAgICAgICAgICAgYWxzbyBvdXRwdXQgYSBncmFw
aCBvZiB0aGUgYXV0b21hdG9uXG5cCiAgICAgICAtLWh0bWxbPUZJTEVdICAgICAgICAgICAg
IGFsc28gb3V0cHV0IGFuIEhUTUwgcmVwb3J0IG9mIHRoZSBhdXRvbWF0b25cblwKICAgLXgs
IC0teG1sWz1GSUxFXSAgICAgICAgICAgICAgYWxzbyBvdXRwdXQgYW4gWE1MIHJlcG9ydCBv
ZiB0aGUgYXV0b21hdG9uXG5cCi0tIAoyLjUxLjAKCg==

--------------4R1WZx6oqgckfX1UjpVrjYpt--