long lines in man pages
The long lines in man pages are annoying. In particular, they make webrevs that include man page fixes not usable in "sdiff" view. Here's an example:
Mostly this is the CDDL header, which has the same wording we see on most sources, but spread out with one sencence per line. (Did I say annoying?:)
We should just wholesale convert the man page sources to have the canonical
line breaks in the CDDL so they will look just like the other CDDL sources.
Updated by Gordon Ross about 9 years ago
I believe there was concern about whether reformatting the CDDL text might somehow have legal effect. I asked a lawyer friend about this and was told that line breaks and format have no bearing on a document's legal interpretation except for references to specific clauses which are generally paragraphs, and certain consumer-protection rules about minimum sizes for small print. Hope that helps.
Updated by Garrett D'Amore over 6 years ago
To be clear, I'm convinced that reflowing license text is fine. We do need to be careful to preserve any whitespace associated with paragraph boundaries though.
I'd like to see this move forward, especially Yuri's other changes to switch to mdocml. Having the ability to use mdoc in man pages would be a huge boon.