[bug #57498] [PATCH] nroff documentation housekeeping

[Dave]

URL:
  <https://savannah.gnu.org/bugs/?57498>

                 Summary: [PATCH] nroff documentation housekeeping
                 Project: GNU troff
            Submitted by: barx
            Submitted on: Sun 29 Dec 2019 09:44:56 AM CST
                Category: Device - others
                Severity: 3 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

The SYNOPSIS section of the nroff man page, as well as the usage statement
output by "nroff --help", list -v among the other options that can be
specified before a filename.  In fact, when -v is specified, any other options
and filenames are ignored, so -v should not be here.

-v is a synonym of --version, both of which the SYNOPSIS already documents
separately.  The usage statement does not document --version at all, so there
is no real need for it to document -v either.

The attached patch removes -v from these erroneous places.

The patch also updates the order in which options are listed in the usage
statement to match that of the man page.  (Commit ee0ce46b3 changed this order
in the man page, for reasons not entirely clear: the log statement says "Sort
lists of options in locale collation order," but the man page and the usage
statement both ignore the user's current locale and hard-code the order of
their lists.  Nevertheless, for consistency the order should be the same in
both places.)



    _______________________________________________________

File Attachments:


-------------------------------------------------------
Date: Sun 29 Dec 2019 09:44:57 AM CST  Name: nroff.patch  Size: 849B   By:
barx

<http://savannah.gnu.org/bugs/download.php?file_id=48136>

    _______________________________________________________

Reply to this item at:

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

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