bugGNU roff - Bugs: bug #51021, [PATCH] groff_man(7) manual page:...

 
 

bug #51021: [PATCH] groff_man(7) manual page: recommendations for escape sequences

Submitter:  Ingo Schwarze <schwarze>
Submitted:  Sat 13 May 2017 11:29:48 PM UTC
   
 
Category:  Macro man Severity:  3 - Normal
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  schwarze
Open/Closed:  Closed Planned Release:  1.22.4
* Mandatory Fields

Add a New Comment Rich Markup
   

Sat 05 Mar 2022 11:04:48 PM UTC, comment #2: 


commit 428b822f36474d334778d8f3f745ba4dea0d47cf
Author: Ingo Schwarze <schwarze@usta.de>
Date:   Mon Aug 28 23:40:56 2017 +0200

    groff_man(7) manual page: recommendations for escape sequences.

    See bug at https://savannah.gnu.org/bugs/?51021.


G. Branden Robinson <gbranden>
Group administrator
Tue 29 Aug 2017 09:41:38 PM UTC, comment #1: 

Commited on master.

Bertrand Garrigues <bgarrigues>
Group administrator
Sat 13 May 2017 11:29:48 PM UTC, original submission:  

It was recently discussed on <groff@gnu.org> that including basic style recommendations into the groff_man(7) manual page would be helpful for manual page authors, both to make it easier to find low-level idioms needed in manual pages without requiring authors to read all the whole, long groff(7) and groff_char(7) manuals, and also to discourage excessive use of low level syntax that puts portability in jeopardy.

That is a very diverse topic, so i'm focussing on one very specific aspect here: recommendations for escape sequences.

Note that i'm deliberately not attempting to mix any other issues or improvements into this patch.

I have ordered the list in ASCII-alphabetic order.

Ingo Schwarze <schwarze>
Group Member

 

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

Attach Files:
   
   
Comment:
   

Attached Files
file #40679:  groff_man.patch added by schwarze (5KiB - text/x-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 bgarrigues (Posted a comment)
  • -email is unavailable- added by schwarze (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-03-05 gbranden CategoryNone Macro man
        Item GroupFeature change Documentation
        Assigned toNone schwarze
        Planned ReleaseNone 1.22.4
    2017-08-29 bgarrigues StatusNone Fixed
        Open/ClosedOpen Closed
    2017-05-13 schwarze Attached File- Added groff_man.patch, #40679

    Back to the top

    Powered by Savane 3.13-3230.
    Corresponding source code