bug-groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[bug #59415] tmac/groff_mdoc.7.man: Warnings from "mandoc -T lint"


From: Ingo Schwarze
Subject: [bug #59415] tmac/groff_mdoc.7.man: Warnings from "mandoc -T lint"
Date: Thu, 5 Nov 2020 09:14:15 -0500 (EST)
User-agent: Mozilla/5.0 (X11; OpenBSD amd64; rv:82.0) Gecko/20100101 Firefox/82.0

Update of bug #59415 (project groff):

                Severity:              3 - Normal => 1 - Wish               
                  Status:                    None => Invalid                
             Open/Closed:                    Open => Closed                 

    _______________________________________________________

Follow-up Comment #1:

It is blatantly obvious that groff does not follow the recommendations of the
mandoc project for writing manual pages.  There is a huge number of ways in
which groff manual pages are systematically and deliberately written in a way
that is clearly discouraged by the mandoc project.

Some of the suggestions of the mandoc project have been discussed and
rejected.  Some have not been discussed.  Many are of minor importance (in
particular of less importance than those explicitly rejected).  While mandoc
-T lint *can* be used to detect syntactic and stylistic oversights in groff
documentation, that is tedious work because the main job is filtering out the
huge amount of messages that the groff project does *not* want to do anything
about.

Dumping mostly useless output that anybody interested can trivially generate
themselves is an unwelcome distraction.

    _______________________________________________________

Reply to this item at:

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

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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]