1. Forum
  2. Usenet
  3. LINUX.DEBIAN.BUGS.DIST

  • Bug#265615: tar.1.gz: SYNOPSIS should be one wrapped line

    From Bdale Garbee@1:229/2 to Dan Jacobson on Fri Aug 20 01:30:12 2004
    From: [email protected]

    tag 265615 +pending
    thanks

    Dan Jacobson <[email protected]> writes:

    OK, sending. They should say on the man page that bugs about the man
    page should be sent to ______ and bugs about the program should be
    sent to [email protected] .

    I gather you didn't read the BUGS section near the end of the tar man page?

    .SH BUGS
    .LP
    The GNU folks, in general, abhor man pages, and create info documents instead.
    The maintainer of tar falls into this category. This man page is neither
    complete, nor current, and was included in the Debian Linux packaging of tar
    entirely to reduce the frequency with which the lack of a man page gets
    reported as a bug in our defect tracking system.

    If you really want to understand tar, then you should run info and read the
    tar info pages, or use the info mode in emacs.

    It seems pretty clear to me, but to avoid further confusion I've just added some more text about reporting bugs in the man page to the man page source in my revision control system for the next upload.

    Bdale


    --
    To UNSUBSCRIBE, email to [email protected]
    with a subject of "unsubscribe". Trouble? Contact [email protected]

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)
  • From Dan Jacobson@1:229/2 to Dan Jacobson on Sat Aug 14 01:40:08 2004
    From: [email protected]

    Package: tar
    Version: 1.13.93-4
    Severity: minor
    File: /usr/share/man/man1/tar.1.gz

    !Dan,
    !
    !GNU tar (as is normal for a GNU package) does *not* contain any manual
    !pages. The manpage you are referring to was probably created by your !distribution maintainer, to whom you should send your report.
    !
    !Regards,
    !Sergey

    OK, sending. They should say on the man page that bugs about the man
    page should be sent to ______ and bugs about the program should be
    sent to [email protected] .

    Dan Jacobson <[email protected]> wrote:

    $ man tar
    SYNOPSIS
    tar [ - ] A --catenate --concatenate | c --create | d --diff --compare | --delete | r
    --append | t --list | u --update | x --extract --get

    [ options ]...

    Bzzzit, this all belongs on one wrapped line.
    Also put the bug address on the man page, if not yet there.


    --
    To UNSUBSCRIBE, email to [email protected]
    with a subject of "unsubscribe". Trouble? Contact [email protected]

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)