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

[Mantis Bug Tracker]

The following issue has been ASSIGNED. 
====================================================================== 
https://www.opencsw.org/mantis/view.php?id=4532 
====================================================================== 
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
Description: 
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
 https://www.opencsw.org/mantis/view.php?id=4532#c9112 
---------------------------------------------------------------------- 
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.)