At 2018-06-17T22:26:00+0200, Jean Delvare wrote: > Hi Branden, Hi Jean!
> Hmmm. I see the improvement in the formatted output, but the absence > of blank lines in the man page "source" make it pretty hard to read > now. I would appreciate some form of spacing at least before each > section to make it easier to navigate whenever a developer needs to > edit the document. Does roff provide no way to achieve this? It does! There are a few possible approaches, which are not mutually exclusive. The empty request (just a dot on a line by itself) can be used for vertically spacing the input. Here are some conventions, all of which I've seen in groff's own man page corpus. For instance, I'll put a segment of pfbtops(1) at the end of this message. There are 3 features of note in it. 1. A single empty request is used between sentences; 2. Two empty requests are used between paragraphs; and 3. The empty request plus a comment of a line-spanning set of equals signs marks off a section. In principle the break-suppressing escape character (') could also be drafted into service for structuring the input, but in practice I have not seen that done, and I fear it would confuse non-expert consumers of the source. What would you like to see in quilt's man pages? .\" ==================================================================== .SH DESCRIPTION .\" ==================================================================== . .B pfbtops translates a PostScript font in .B .pfb format to ASCII, splitting overlong lines in text packets into smaller chunks. . If .I pfb_file is omitted the pfb file will be read from the standard input. . The ASCII format PostScript font will be written on the standard output. . PostScript fonts for MS-DOS are normally supplied in .B .pfb format. . . .LP The resulting ASCII format PostScript font can be used with groff. . -- Regards, Branden
signature.asc
Description: PGP signature
_______________________________________________ Quilt-dev mailing list Quilt-dev@nongnu.org https://lists.nongnu.org/mailman/listinfo/quilt-dev