On 11/11/22 01:04, Andrew Clayton wrote: > On Fri, 11 Nov 2022 00:59:59 +0100 > Alejandro Colomar wrote: > >>> +but is present on a number of other systems, >>> +including: musl libc 0.9.7; FreeBSD 6.0, OpenBSD 5.4, >>> +NetBSD, and Illumos. >> >> I've been thinking about the line breaks. I'm not sure how I'd split them, but >> I'm not happy with the current suggestion. >> >> Please see man-pages(7) about semantic newlines, and see if you come up with >> something nicer. >> >> man-pages(7): >> Use semantic newlines >> In the source of a manual page, new sentences should be >> started on new lines, long sentences should be split into >> lines at clause breaks (commas, semicolons, colons, and >> so on), and long clauses should be split at phrase bound‐ >> aries. This convention, sometimes known as "semantic >> newlines", makes it easier to see the effect of patches, >> which often operate at the level of individual sentences, >> clauses, or phrases. > > I guess the best thing then is to just break it on the semi-colon. Yeah, either semicolon or ':'. > > Andrew --