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

Mantis Bug Tracker noreply at opencsw.org
Sun Jun 12 21:42:51 CEST 2011

The following issue has been ASSIGNED. 
Reported By:                phil
Assigned To:                maciej
Project:                    cupsclient
Issue ID:                   4532
Category:                   packaging
Reproducibility:            always
Severity:                   major
Priority:                   normal
Status:                     assigned
Date Submitted:             2010-08-27 19:18 CEST
Last Modified:              2011-06-12 21:42 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' ?"


 (0009112) phil (developer) - 2011-06-12 19:25
I'm afraid I dont find a "documentation" file that says "go read the REAL
documentation" to be very helpful.
It's "better than nothing", but I thought cups was supposed to be so
wonderfully easy to use?
(I dont use it, which is why I found myself in need of documentation.. and
then said "the heck with this" when I did not fight straightforward docs
for it)

If it's so wonderfully easy,  shouldnt it be "easy" for you to throw
together a couple of lines saying, "here are the steps you need to do to
point your cupsclient at a working cupsd back end" ?

I dunno whether it is or not, I still havent figured out a simple way to
use it :p

(and as a reply to your last comment: I vaguely recall lpadmin not
functioning as normal, which is why I tore the packages off my workstation,
after giving it an initial try. but that was some time ago.)

More information about the bug-notifications mailing list