[groff] 01/01: roff(7): Fix incorrect line wrapping in example.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 17cc0a8cf7568e338d09e1759070f530d40d0e9b
Author: G. Branden Robinson <address@hidden>
Date:   Mon Nov 6 08:58:09 2017 -0500

    roff(7): Fix incorrect line wrapping in example.
    
    It looks like this material got reflowed by:
    
      commit 1a0ea2d7ae1e6fcf0facfc59690824818e0f4a31
      Author: Bernd Warken <address@hidden>
      Date:   Sat Sep 20 00:35:44 2014 +0200
    
          all man-pages in groff source tree: use \[aq], \[oq], \[cq], \[co]
    
    But it should not have been.  It makes the example quite wrong.
    
    Also further clarify the purpose of the example.  Drop the quotation
    marks around "cf." because they would distract from the subject under
    discussion.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 man/roff.7.man | 29 +++++++++++++++++++----------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/man/roff.7.man b/man/roff.7.man
index f19e1cd..8a92ab8 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -1096,21 +1096,30 @@ request (a line consisting of a dot only) after each 
sentence.
 .
 .
 .P
-The following example shows how optimal
+The following example shows judicious line breaking in a
 .I roff
-editing could look.
+input file.
 .
 .RS
 .P
 .EX
-This is an example for a \&.I roff document.  \&.
-.
-This is the next sentence in the same paragraph.  \&.
-.
-This is a longer sentence stretching over several lines; abbreviations
-like \[oq]cf.\[cq] are easily identified because the dot is not
-followed by a line break.  \&.  In the output, this will still go to
-the same paragraph.
+.\" Keep the text width to 65 columns or fewer in this example so that
+.\" it doesn't overrun the right margin when set in Courier (-Tps,
+.\" -Tpdf).
+This is an example of a
+\&.I roff
+document that you can type into your text editor.
+\&.
+.
+This is the next sentence in the same paragraph.
+\&.
+.
+This is a longer sentence stretching over several input lines;
+abbreviations like cf. are easily identified because the dot is
+not followed by a line break.
+\&.
+.
+In the output, this sentence continues the same paragraph.
 .EE
 .RE
 .