[bug #60227] [ms]: documentation of .FS is inadequate

[G. Branden Robinson]

Update of bug #60227 (project groff):

                  Status:             In Progress => Fixed                  
             Assigned to:                    None => gbranden               
             Open/Closed:                    Open => Closed                 
         Planned Release:                    None => 1.23.0                 

    _______________________________________________________

Follow-up Comment #2:


commit b054ed29c152a60bdb126bea6f02a9340163262b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Fri Apr 9 10:17:34 2021 +1000

    [ms]: Update footnote documentation.
    
    * doc/groff.texi (ms Document Control Settings) <FF>: Update description
      to cover application of footnote format to footnote markers in
      general, not just numbers.  Clarify different behavior of format 1
      with respect to automatic numbers and other markers.
    
      (ms Footnotes): Recast introductory paragraph to drop promotional
      language in favor of describing functionality.  Add concept index
      entry for "footnote marker".  Shift string and macro descriptions from
      sentence fragments to statements in the imperative mood.  Expand
      advice on usage of footnote markers.  Discuss configurable footnote
      parameters with link to "ms Document Control Settings" node.
    
      <*>: Describe string operation in more detail.
    
      <FS>: Describe more precisely how the optional argument is handled.
    
    * doc/ms.ms (Footnotes): Bracket section heading and lead paragraph in a
      keep.  Synchronize with doc/groff.texi.  Add example using document's
      own text as a model.  Move paragraph discussing footnote usage in
      keeps and displays to precede (new) discussion of footnote formatting.
    
    * tmac/groff_ms.7.man (Usage/Footnotes): Resync relevant portions with
      doc/ms.ms.
    
    Fixes <https://savannah.gnu.org/bugs/?60227>.


    _______________________________________________________

Reply to this item at:

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

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