Bug 227052 - print/hplip: no man pages for hp-*
Summary: print/hplip: no man pages for hp-*
Status: Closed Not A Bug
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Ben Woods
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2018-03-28 20:47 UTC by freebsd
Modified: 2018-04-02 16:03 UTC (History)
1 user (show)

See Also:
bugzilla: maintainer-feedback? (woodsb02)

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description freebsd 2018-03-28 20:47:22 UTC 
hplip ships with auxiliary documentation in /usr/local/share/doc/hplip.
It also installs numerous programs as hp-xxx in /usr/local/bin.
None of the installed hp-xxx programs has a man page.
They should at least have a minimal man page referencing the installed documentation and telling you to run "hp-xxx -h".  Otherwise the user has to grep around or look at the port pkg-plist to see what and where the documentation is, particularly when you don't know which package installed it.

Better would be to have an actual man page.  Perhaps the output of "hp-xxx -h" could be used to generate a minimal man page.
Comment 1 Tijl Coosemans freebsd_committer freebsd_triage 2018-03-29 09:44:19 UTC 
This is not a FreeBSD bug, you'll have to report this upstream.  Some documentation is available at https://developers.hp.com/hp-linux-imaging-and-printing/tech_docs/man_pages/setup
Comment 2 Ben Woods freebsd_committer freebsd_triage 2018-04-02 12:40:19 UTC 
I am closing this issue, as it is not a bug with FreeBSD, but with the upstream project who don't provide manpages. Please do follow up with a bug report to the hplip upstream project https://launchpad.net/hplip/+filebug.
Comment 3 freebsd 2018-04-02 16:03:12 UTC 
I've already filed a bug with upstream, sounds like they will get it done.