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-19 17:24 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' ?" ====================================================================== ---------------------------------------------------------------------- (0009124) phil (developer) - 2011-06-19 17:24 https://www.opencsw.org/mantis/view.php?id=4532#c9124 ---------------------------------------------------------------------- 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, http://blogs.oracle.com/DanX/entry/using_cups_print_server_for 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. _______________________________________________ bug-notifications mailing list [email protected] https://lists.opencsw.org/mailman/listinfo/bug-notifications
