switch groff parameter -man to -mandoc
ClosedPublic
Actions

Authored by wosch on Sep 5 2023, 5:04 PM.

Details

Reviewers

emaste
se
imp
bapt
grahamperrin

Group Reviewers

releng

Commits

rG0e71efa38c9a: switch groff parameter -man to -mandoc
rG1cc5240b590b: switch groff parameter -man to -mandoc
rG7f9f15230765: switch groff parameter -man to -mandoc
rG035f7c9a3653: switch groff parameter -man to -mandoc

Summary

groff 1.23.0 changed the semantic of the -man parameter, and many manual pages will fail to render. The -mandoc parameter brings the old behaviour back, as in groff 1.22.4 and earlier.

MFC after: 1 week for all supported branches (stable/12, 13, 14)
PR: 273565, 273245

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

wosch requested review of this revision.Sep 5 2023, 5:04 PM

wosch created this revision.

wosch edited the summary of this revision. (Show Details)Sep 5 2023, 5:12 PM

Is there any backwards compatibility issue here? I.e., are there any groff versions still relevant in FreeBSD that don't support -mandoc?

This revision is now accepted and ready to land.Sep 5 2023, 5:13 PM

In D41737#950958, @emaste wrote:

Is there any backwards compatibility issue here? I.e., are there any groff versions still relevant in FreeBSD that don't support -mandoc?

As I understand the groff developer, the -mandoc flag exists for 22 years. I don't expect this change will break anything.

See the discussion
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=273245

bapt accepted this revision.Sep 6 2023, 7:35 AM

Closed by commit rG035f7c9a3653: switch groff parameter -man to -mandoc (authored by wosch). · Explain WhySep 7 2023, 6:34 AM

This revision was automatically updated to reflect the committed changes.

wosch added a commit: rG035f7c9a3653: switch groff parameter -man to -mandoc.

wosch added a commit: rG7f9f15230765: switch groff parameter -man to -mandoc.Sep 25 2023, 9:51 AM

wosch added a commit: rG1cc5240b590b: switch groff parameter -man to -mandoc.Sep 25 2023, 5:33 PM

wosch added a commit: rG0e71efa38c9a: switch groff parameter -man to -mandoc.