[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:                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-13 00:08 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' ?"


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

---------------------------------------------------------------------- 
 (0009114) phil (developer) - 2011-06-13 00:08
 https://www.opencsw.org/mantis/view.php?id=4532#c9114 
---------------------------------------------------------------------- 
What the heck Maciej... how do you pass off my bug report as "ranting" ?
To me, this seems like another example of, "ignore something, *just
because its Phil saying it*".
Or is it that because I described a large difficulty I had using the
package in the past, you describe it as "ranting"?  So users need to be
careful not to describe having large difficulties with packages, or you'll
close the bug?


"How do I use this thing", is a very normal concern. 
The more complex or non standard a thing is, the more important it is for
us to provide a carefully marked pointer to a trail. 
You just writing "read the docs"  for a complex package, leaves a gap in
the user experience


If there was a nice straightforward preexisting guide of "here's how to
get started with minimum hassle", then it would be fine for you to provide
a url, or file reference.
But you didnt. Maybe because, last time I checked, there isnt one.

If you *know* of one, please reference it. 
If there isnt... then could you please take 5 minutes to help out new
users to get started with cups client?

You seem to imply this should be configurable without the web interface,
and usable via lpadmin.
So how about just putting in a ONE LINE  example that, according to you,
should work?

I previously tried it. it didnt work for me. which is why as an "opencsw
user", I asked you, the package maintainer, for  a better (specific)
reference for use of the client package.