[bug-notifications] [cupsclient 0004532]: cupsclient lacks docs

Mantis Bug Tracker noreply at opencsw.org
Sun Jun 19 17:24:39 CEST 2011

A NOTE has been added to this issue. 
Reported By:                phil
Assigned To:                maciej
Project:                    cupsclient
Issue ID:                   4532
Category:                   packaging
Reproducibility:            always
Severity:                   major
Priority:                   normal
Status:                     resolved
Resolution:                 no change required
Fixed in Version:           
Date Submitted:             2010-08-27 19:18 CEST
Last Modified:              2011-06-19 17:24 CEST
Summary:                    cupsclient lacks docs
I decided to try switching to using "cupsclient" for printing.
Installed the package... and was left scratching my head.
the postinstall mentions "/etc/opt/csw/cups".
Which only contents "client.conf.CSW".
Which mentioned "man client.conf". Which is similarly unhelpful.
Looked in /opt/csw/share/doc/cupsclient.
Only thing there is the license file.

Please add some level of documentation to address,
"here's what you do if you actually want to print to something".

What would be helpful, would be two things:
1. mention of "how do I set up a printer"?
2. mention of "what do I do instead of the usual 'lp' ?"


 (0009124) phil (developer) - 2011-06-19 17:24
Congratulations! You win an "BOFH" award!
Your oh-so-cleverly-disguised [google it] reference, exactly justified my
complaint here.
The first hit, points to a fairly long document, 

which **does not tell you how to set up cupsclient** without also having
the full webserver admin thing.

Nor does the second hit.

So are you going to include actually useful documentation in the
cupsclient package now?

If you want to actually be helpful to our users, it would be good to
either have the readme say, "you need to install [the cups webadmin
package] to do stuff", or provide a simple example/link on how to admin
cupsclient from the command line.
Just saying "use lpadmin" would not be very helpful, since most new
solaris users have difficulty using it, and need a concise
example/reference to use it.

More information about the bug-notifications mailing list