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. _______________________________________________ bug-notifications mailing list [email protected] https://lists.opencsw.org/mailman/listinfo/bug-notifications
