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

[G. Branden Robinson]

Update of bug #60227 (project groff):

              Item Group:     Incorrect behaviour => Documentation          
                  Status:                    None => In Progress            
                 Summary: [ms]: footnote format FF not applied to symbolic
footnotes => [ms]: documentation of .FS is inadequate

    _______________________________________________________

Follow-up Comment #1:

I was incorrect.  FF _is_ applied, which is good news, but, particularly in
ms.ms, we give the reader insufficient guidance regarding the .FS macro,
namely the fact that it takes an argument, and how to use non-auto-numbered
footnotes.

So this is now a documentation bug.

Only groff_ms(7) mentioned the use of an argument to .FS at all; our Texinfo
manual presented a synopsis that omitted it (implying that it _didn't_ take
one), and ms.ms has no syntax synopsis for the footnote macros at all.

I have updates in progress.  

    _______________________________________________________

Reply to this item at:

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

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