bugGNU troff - Bugs: bug #51327, [Patch] Manuals: Split lines >...

 
 

bug #51327: [Patch] Manuals: Split lines > 80 characters into more lines

Submitted by:  Bjarni Ingi Gislason <bjarniig>
Submitted on:  Tue 27 Jun 2017 06:22:53 PM UTC  
 
Category:  None Severity:  2 - Minor
Item Group:  Documentation Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open Planned Release:  None

Add a New Comment(Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Sun 30 Dec 2018 11:49:23 PM UTC, comment #3:

The corrections were never applied, and the commit
7239885bc8f614e8ec14a5dd41c8fc6879ef0841 from 9th November 2017
introduced the bugs (man/groff_diff.7.man).

So they must be applied (to the tag of .TP) to avoid the inclusion
of '.lt' requests, that the preprocessor "eqn" adds to the source, and
then appears in the output.

The .TP macro contains the '.itc' request and so skips requests if an
'\c' is used in its tag.

Example:

.as 10 " \
.ec
.cp \n(0C
.lf 3495
\*(10
.lf 3496

The string '\*(10' contain a '\' as the last character so the next
line is included in the output.

Bjarni Ingi Gislason <bjarniig>
Wed 01 Nov 2017 08:24:32 AM UTC, comment #2:

Also note this fix to the patch:

G. Branden Robinson <gbranden>
Project Member
Wed 01 Nov 2017 08:18:30 AM UTC, comment #1:

As noted in #51441, this patch introduces a space character where one should not be, in the first hunk of the patch to groff_out.5.man.

Caveat committer.

G. Branden Robinson <gbranden>
Project Member
Tue 27 Jun 2017 06:22:53 PM UTC, original submission:

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---

References:

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."

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 the word "sentence" in the output to get more hints about input
conventions.

contrib/hdtbl/groff_hdtbl.7.man | 4 +++-
contrib/mm/groff_mm.7.man | 41 ++++++++++++++++++++++++------------
contrib/mom/groff_mom.7.man | 12 +++++++----
man/groff.7.man | 4 +++-
man/groff_diff.7.man | 13 ++++++++----
man/groff_out.5.man | 5 +++--
src/devices/gropdf/gropdf.1.man | 3 ++-
src/devices/grops/grops.1.man | 8 ++++---
src/devices/xditview/gxditview.1.man | 12 +++++++----
tmac/groff_man.7.man | 3 ++-
tmac/groff_mdoc.7.man | 3 ++-
11 files changed, 73 insertions(+), 35 deletions(-)

Bjarni Ingi Gislason <bjarniig>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

Attached Files

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by gbranden (Posted a comment)
  • -email is unavailable- added by bgarrigues (Updated the item)
  • -email is unavailable- added by bjarniig (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    Follow 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2017-09-01 bgarrigues Severity3 - Normal => 2 - Minor
        Item GroupNone => Documentation
    2017-06-27 bjarniig Attached File- => Added 0001-Split-lines-80-characters-into-more-lines.txt.gz, #41056

    Back to the top


    Powered by Savane 3.4