[bug #64238] [docs] Simplify the explanations of "italic corrections"

[G. Branden Robinson]

Update of bug #64238 (project groff):

                  Status:               Need Info => Invalid                
             Assigned to:                    None => gbranden               
             Open/Closed:                    Open => Closed                 

    _______________________________________________________

Follow-up Comment #3:

[comment #2 comment #2:]
>  I read "doc/groff.texi".
> 
>   The descriptions in "doc/groff_diff.7.man" and "man/groff.7.man"
> should also be simplified.
> The purpose should be added where it is missing.

The purpose is explained complete with examples in groff_diff(7), and has been
for quite some time.


    \/     Apply an italic correction: modify the spacing of the
           preceding glyph so that the distance between it and the
           following glyph is correct if the latter is of upright shape.
           For example, if an italic "f" is followed immediately by a
           roman right parenthesis, then in many fonts the top right
           portion of the "f" overlaps the top left of the right
           parenthesis, which is ugly.  Inserting \/ between them avoids
           this problem.  Use this escape sequence whenever an oblique
           glyph is immediately followed by an upright glyph without any
           intervening space.

    \,     Apply a left italic correction: modify the spacing of the
           following glyph so that the distance between it and the
           preceding glyph is correct if the latter is of upright shape.
           For example, if a roman left parenthesis is immediately
           followed by an italic "f", then in many fonts the bottom left
           portion of the "f" overlaps the bottom of the left
           parenthesis, which is ugly.  Inserting \, between them avoids
           this problem.  Use this escape sequence whenever an upright
           glyph is followed immediately by an oblique glyph without any
           intervening space.


groff(7) diff is terser, and that's deliberate.


    This document is intended as a reference.  The primary groff manual,
    Groff: The GNU Implementation of troff, by Trent A. Fisher and
    Werner Lemberg, is a better resource for learners, containing many
    examples and much discussion.  It is written in Texinfo; you can
    browse it interactively with "info groff".  Additional formats,
    including plain text, HTML, DVI, and PDF, may be available in /usr/
    local/share/doc/groff-1.23.0.


I don't expect to change it to parallel the foregoing lengthy motivation.


    \/  Apply italic correction.  Use between an immediately adjacent
        oblique glyph on the left and an upright glyph on the right.
    \,  Apply left italic correction.  Use between an immediately
        adjacent upright glyph on the left and an oblique glyph on the
        right.




    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?64238>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/