On Mon, May 28, 2018 at 02:59:24AM +0200, Guillem Jover wrote: > On Mon, 2018-05-28 at 02:47:40 +0200, Guillem Jover wrote: > > On Thu, 2018-05-24 at 22:34:36 +0000, Bjarni Ingi Gislason wrote: > > > Begin each sentence on a new line (or use two spaces between them, > > > which is not recommended as the text contains formatting commands). > > > See man-pages(7) [package "manpages"] and "info groff". > > > > This is a somewhat controversial style dispute in general, and I find > > two spaces uglier. :) In addition vim seems to agree, and prints red > > on ". " with syntax highlighting. > > Let me clarify. I do not agree with the explicit two space after dot, > I've always found that to be rather ugly. OTOH I find the rationale > for splitting sentences on newline sound, because it reduces diff > changes as it requires less text reflowing. The fact that groff > considers that an implicit ". " is then minor, although still > slightly annoying. :) Split lines still looks ugly and unnatural when > reading the source though, so I'm still not 100% sold on that one. > > But I've only split lines for text I've added or changed, I don't > think touching existing text just for this is worth the diff noise. > "groff" has an extended ".ss" request. To get only one space character between sentences in the formatted man page,".ss 12 0" is used in a file that is always read, for example "troffrc", "man.local", "mdoc.local" or some personal file that is named in "GROFF_TMAC_PATH".
-- Bjarni I. Gislason
