On Fri, 11 Nov 2022 00:59:59 +0100 Alejandro Colomar <alx.manpages@xxxxxxxxx> 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. Andrew
Attachment:
pgpTgSa0RoK7w.pgp
Description: OpenPGP digital signature
