bugGNU roff - Bugs: bug #50898, groff_char(7) manual: improve...

 
 

bug #50898: groff_char(7) manual: improve description of ASCII characters that do not render as themselves

Submitter:  Ingo Schwarze <schwarze>
Submitted:  Sat 29 Apr 2017 06:57:30 PM UTC
   
 
Category:  Core Severity:  3 - Normal
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  carstenkunze
Open/Closed:  Closed Planned Release:  1.22.4
* Mandatory Fields

Add a New Comment Rich Markup
   

Sat 05 Mar 2022 11:16:29 PM UTC, comment #1: 


commit 3e9bfff922e540641e318eaf94994db720060cd4
Author: Ingo Schwarze <schwarze@usta.de>
Date:   Sat Apr 29 21:17:20 2017 +0200

    groff_char(7): improve description of ASCII chars

    Improve description of ASCII characters that do not render as
    themselves.

    See https://savannah.gnu.org/bugs/?50898


G. Branden Robinson <gbranden>
Group administrator
Sat 29 Apr 2017 06:57:30 PM UTC, original submission:  

This patch improves the section "7-bit Character Codes 32126" in the groff_char(7) manual in five respects:

1. Add clarity by giving the Unicode numbers for each output glyph.

2. Add even more clarity by also giving the character names that can be used to explicitly request each specific glyph, rather than simply typing some ASCII character.

3. Correct the output glyph for the input "'".  In a manual page, "'" does not render as a right single quotation mark (Unicode u2019), so we really need \[cq] here.

4. Add a sentence explaining that in typography, the right single quotation mark is usually used to represent the punctation apostrophe as well, to avoid misleading people into writing "don\(aqt".

5. Recommend \(mi if people explicitly want a minus sign rather than \-, because in some macro sets, \- may render as an ASCII hyphen-minus and not as a minus sign.

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 #40534:  groff_char.patch added by schwarze (2KiB - 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 carstenkunze (Updated the item)
  • -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 Core
        Item GroupFeature change Documentation
        Planned ReleaseNone 1.22.4
    2017-04-29 carstenkunze StatusNone Fixed
        Assigned toNone carstenkunze
        Open/ClosedOpen Closed
    2017-04-29 schwarze Attached File- Added groff_char.patch, #40534

    Back to the top

    Powered by Savane 3.13-02a9.
    Corresponding source code