https://bugzilla.redhat.com/show_bug.cgi?id=1471436

            Bug ID: 1471436
           Summary: Please link weblint(1) man page to HTML::Lint(3pm)
           Product: Fedora
           Version: 25
         Component: perl-HTML-Lint
          Severity: low
          Assignee: rc040...@freenet.de
          Reporter: ferd...@gmail.com
        QA Contact: extras...@fedoraproject.org
                CC: perl-devel@lists.fedoraproject.org,
                    rc040...@freenet.de



Description of problem:
There is currently no man page provided for the /usr/bin/weblint script, which
installs with perl-HTML-Lint. However, the HTML::Lint(3pm) man page does
contain some rudimentary documentation on weblint, and would be a "better than
nothing" result for `man weblint` than the current response, which is nothing.

Version-Release number of selected component (if applicable):
perl-HTML-Lint-2.26-1.fc25.noarch

How reproducible:
`man weblint`

Actual results:
"No manual entry for weblint"

Expected results:
Same as `man 3 HTML::Lint`

Additional info:
Man pages can be configured as references to other man pages in two ways.

1. A symlink can be created in /usr/share/man/$SECTION/ under a new name that
points to the existing documentation. However, since the link source would be
in a different section than the target, this would require a symlink through
../ and is not advisable. 

2. The preferable method, in the case of cross-section references, is to
install a file /usr/share/man/man1/weblint.1.gz containing (before compression)
a single line of text:

.so man3/HTML::Lint.3pm

This will establish weblint(1) as an alias for the HTML::Lint(3pm) man page,
and it will be displayed when the user runs `man weblint`.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
_______________________________________________
perl-devel mailing list -- perl-devel@lists.fedoraproject.org
To unsubscribe send an email to perl-devel-le...@lists.fedoraproject.org

Reply via email to