On Mon, Jan 25, 2016 at 11:50:56AM +0000, Jonathan Dowland wrote:
[...]
> This is a substantial amount of the patch (in lines-changed terms).
> Is there a technical reason for this?

  Yes.
In man-pages the technical issue is to have
every sentence begin on a new line
or (worse) sentences are separated with two spaces.

  References are:

  1) man-pages(7) from package "man-pages" or
"www.kernel.org/doc/man-pages" section 7 or
"man7.org/linux/man-pages/man7/man-pages.7.html:

New sentences should be started on new lines.
This makes it easier to see the effect of patches,
which often operate at the level of individual sentences.

[The above is an example of how to write text,
making any "subsentence" (subordinate clause) start on its own line.]

  2) groff_diff(7) in package "groff":

In GNU troff, as in UNIX troff, you should always follow a sentence
with either a newline or two spaces.

  3) "info groff":

  Search for "sentence" to get more hints about input conventions.

-- 
Bjarni I. Gislason

Reply via email to