[bug #64440] [docs] minor corrections and updates

[G. Branden Robinson]

Update of bug #64440 (project groff):

                  Status:             In Progress => Fixed                  
             Open/Closed:                    Open => Closed                 
         Planned Release:                    None => 1.24.0                 

    _______________________________________________________

Follow-up Comment #8:


commit c05c523e2bc0f0c35729076b870d86589e7cf31b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jul 25 03:13:52 2023 -0500

    [docs]: Revise material in our Texinfo manual.

    * doc/groff.texi (Manipulating Filling and Adjustment): Document a CSTR
      #54 erratum; the arguments to the `ss` request are in 12ths of the
      selected font's `spacewidth` parameter, not 36ths of an em.  Drop
      false claim of rounding of `.ss` and `.sss` register values on
      terminal devices.  (Rounding of any resulting adjustment quantities
      might still occur, but this is part of the usual application of motion
      quanta and not particular to the `ss` request.)  Characterize
      "undiscardable space" as "horizontal motion" to help the reader
      acquire this essential distinction between horizontal spaces and
      motions.

      (Manipulating Spacing): Clarify behavior.  Distinguish `sp` request
      from `\v` escape sequence and cross reference the latter.  Recast to
      squeeze presentation of `ss` request onto one U.S. letter page when
      typeset.  Drop (commented-out) trivial example of `ls` usage with a
      new example that illustrates some macros using `vs` instead, for
      pedagogical purposes and to eat up a lot of dead space on the page
      caused by a later lengthy example.  (Knuth-Plass for the...uh...win.)

      (Page Control): Stop (arguably) mis-applying the term "widow", in
      favor of less metaphorical language.  Extend Woolf example to narrow
      the seas of vertical space produced by TeX's formatting of the page it
      occupies.  Extend Woolf example to eat up some dead space.  (Our
      blanched discourse can use the purple prose.)

      (Page Motion): Fix straggling use of "escape" as a noun; we prefer
      "escape sequence".

    * man/groff.7.man (Request short reference) <ss>: Sync.

    Fixes <https://savannah.gnu.org/bugs/?64440>.  Thanks to Dave Kemper for
    the report and review.




    _______________________________________________________

Reply to this item at:

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

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