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

[Mantis Bug Tracker]

A NOTE has been added to this issue. 
====================================================================== 
https://www.opencsw.org/mantis/view.php?id=4532 
====================================================================== 
Reported By:                phil
Assigned To:                
====================================================================== 
Project:                    cupsclient
Issue ID:                   4532
Category:                   packaging
Reproducibility:            always
Severity:                   major
Priority:                   normal
Status:                     new
====================================================================== 
Date Submitted:             2010-08-27 19:18 CEST
Last Modified:              2011-05-12 20:21 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' ?"


====================================================================== 

---------------------------------------------------------------------- 
 (0009038) phil (developer) - 2011-05-12 20:21
 https://www.opencsw.org/mantis/view.php?id=4532#c9038 
---------------------------------------------------------------------- 
Hi Maciej,

oopsie on missing the CSWcupsdoc package. So yes, a file saying "Please
see that" would help. 
However... cups is supposed to be (the wonderful new, easy printing system
that doesnt need manuals).
As such, seems like it would be rather nice to have some very brief
"quickstart" file. I'm imagining it would only be a few lines?
ie: 
  "cups is administered via local web server ONLY. Go to port xyz with
your browser and follow the directions ...." 
?