bugGNU roff - Bugs: bug #46319, errors in info pages

 
 

bug #46319: errors in info pages

Submitter:  Dave <barx>
Submitted:  Thu 29 Oct 2015 05:22:16 AM UTC
   
 
Category:  Core Severity:  3 - Normal
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  wl
Open/Closed:  Closed Planned Release:  1.22.4
* Mandatory Fields

Add a New Comment Rich Markup
   

Sat 22 Jan 2022 12:54:10 PM UTC, comment #3: 

Most of these were harmless typos (and instances of Denglish), but a couple were copy-and-paste errors that could have been misleading, so I am choosing item group "Documentation" rather than "Lint".


commit 97032f2e27f188acebbcb0028061875c721a77e0
Author: Dave Kemper <saint.snit@gmail.com>
Date:   Thu Nov 19 05:44:04 2015 +0100

    Typos in `groff.texi' (#46319).


G. Branden Robinson <gbranden>
Group administrator
Thu 19 Nov 2015 07:12:03 PM UTC, comment #2: 

Applied, thanks!

Werner LEMBERG <wl>
Group administrator
Tue 17 Nov 2015 07:04:02 PM UTC, comment #1: 

I've attached a patch to fix the described problems.  This patch also fixes

 - examples in the section about the \\, \e, and \E escapes where the given code did not produce the documented result

 - a few typos and grammar and punctuation errors

Please let me know if there are any issues with it.

(file #35482)

Dave <barx>
Group Member
Thu 29 Oct 2015 05:22:16 AM UTC, original submission:  

A couple errors in groff's info pages are described below.  For each error, I've supplied a command that shows the text where the error is, followed by a short description of the problem with that segment.  These commands all work against the latest version (commit a6690261058803fbb63af9f078ad5541d1beab0c) of doc/groff.texi.

$ fgrep -A28 'item latin-1' doc/groff.texi

Note the latin-1 and latin-2 sections consistently use "latin-1" and "latin-2" throughout their respective blocks, but the latin-5 section has elements referring to itself as both "latin-2" and "latin9".

$ fgrep -A4 '{ds}, and @code{as}' doc/groff.texi

This block says "string diversion" where it seems to mean only "string."  Also, the phrase "together with its variants" ought to be "together with their variants," since most if not all of the cited requests have variants.

$ fgrep -A1 '(this is, using' doc/groff.texi

Since the caller needn't be a macro, it seems this should say "from the caller" rather than "from the calling macro."

Also, the English idiom is "that is," not "this is."  This nonstandard phrase also appears a few other times throughout the info manual.

Dave <barx>
Group Member

 

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

Attach Files:
   
   
Comment:
   

Attached Files
file #35482:  groff_doc.patch added by barx (6KiB - text/x-diff - groff.texi patch)

 

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 wl (Posted a comment)
  • -email is unavailable- added by barx (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 7 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-01-22 gbranden CategoryNone Core
        Item GroupNone Documentation
    2015-11-19 wl StatusNone Fixed
        Assigned toNone wl
        Open/ClosedOpen Closed
        Planned ReleaseNone 1.22.4
    2015-11-17 barx Attached File- Added groff_doc.patch, #35482

    Back to the top

    Powered by Savane 3.13-d3ae.
    Corresponding source code