bugGNU roff - Bugs: bug #62560, [gt]roff(1): want option `-Z`...

 
 

bug #62560: [gt]roff(1): want option `-Z` described as "Show only enabled warnings"

Submitter:  Bjarni Ingi Gislason <bjarniig>
Submitted:  Wed 01 Jun 2022 11:06:14 PM UTC
   
 
Category:  General Severity:  1 - Wish
Item Group:  Documentation Status:  Rejected
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Closed Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Thu 02 Jun 2022 12:43:59 AM UTC, comment #1: 


original submission:

> Subject: "[gt]roff.1: option "-z": say "Show only enabled warnings"
>
>   Currently the option '-z' is explained with:
>
> "Suppress formatted device-independent output of troff."
>
>   Show the effect of this option, that is: what is shown, not was is not
> shown, like:
>
> Output only enabled warnings.


As we've just established in bug #62559, groff and troff produce other output, to the standard error stream.

Your suggested wording is easily falsified.


$ printf '.tm here is some output to stderr\n' | groff -z
here is some output to stderr


For that matter, let's observe this.


$ printf '.tm here is some output to stderr\n' | groff -Ez
here is some output to stderr


The `-z` option is documented as it is because it compactly describes how the presence of the option alters the command's behavior.  This is a common practice in Unix man pages.

Please spend some time with the groff Texinfo manual.

G. Branden Robinson <gbranden>
Group administrator
Wed 01 Jun 2022 11:06:14 PM UTC, original submission:  

Subject: "[gt]roff.1: option "-z": say "Show only enabled warnings"

  Currently the option '-z' is explained with:

"Suppress formatted device-independent output of troff."

  Show the effect of this option, that is: what is shown, not was is not
shown, like:

Output only enabled warnings.

Bjarni Ingi Gislason <bjarniig>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by gbranden (Posted a comment)
  • -email is unavailable- added by bjarniig (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 5 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-06-02 gbranden Summary&quot;[gt]roff.1: option &quot;-z&quot;: say &quot;Show only enabled warnings&quot; [gt]roff(1): want option `-Z` described as "Show only enabled warnings"
    2022-06-02 gbranden Severity3 - Normal 1 - Wish
        StatusNone Rejected
        Assigned toNone gbranden
        Open/ClosedOpen Closed

    Back to the top

    Powered by Savane 3.13-4448.
    Corresponding source code