[Top][All Lists]

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

[bug #21270] Improved manpage formatting

From: Andreas Metzler
Subject: [bug #21270] Improved manpage formatting
Date: Sat, 06 Oct 2007 12:33:02 +0000
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv: Gecko/20070505 Iceape/1.0.9 (Debian-1.0.10~pre070720-0etch3)


                 Summary: Improved manpage formatting
                 Project: findutils
            Submitted by: ametzler
            Submitted on: Samstag 06.10.2007 um 14:33
                Category: documentation
                Severity: 3 - Normal
              Item Group: None
                  Status: None
                 Privacy: Public
             Assigned to: None
         Originator Name: Andre Majorel
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 4.2.31
           Fixed Release: None



This http://bugs.debian.orgs/445200 submiited by Andre Majorel:
Dear findutils maintainer,

1)  In the xargs(1) man page, in the OPTIONS subsection, the names of the
options are in italic. They should be in bold.

In addition, the long name is listed first. Short name first would be more

Recommendation : replace
      .I "\-\-arg\-file=3Dfile, \-a file"
      \fB\-a\fP \fIfile\fP, \fB\-\-arg\-file=3D\fP\fIfile\fP
and so on.

2)  The OPTIONS section is erroneously a subsection.

Recommendation : replace


I think it is clear that item 2 is a bug. I do not know about item 1, though.
Is there a (semi-)official policy on manpage formatting which requires options
to be bold? man(1) seems to suggest that this is the case but I do not know
whether this source is authoritative.
cu andreas


Reply to this item at:


  Nachricht geschickt von/durch Savannah

reply via email to

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