[cups.general] Documentation? You call that Documentation?

[Michael Sweet]

Dan Coit wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> You guys are the piss-poorest documentation writers in the history of
> computation.  The purpose of documentation is to inform others how to
> use your product.  But if you don't know how to communicate your ideas
> you are incapable of communication.  As a case in point, printers.conf
> lists the following description:
> 
> "KLimit number
>     Specifies the job-k-limit value for the printer."
> 
> Are you kidding?  I don't know what a KLimit is.  After reading your
> definition, I STILL don't know what a KLimit is.  It's the same as
> writing "Frammis Valve:  The valve on the frammis."  Well Duh!  Now it's
> clear to you what a frammis is, right?
> 
> Do us all a favor and hire someone who isn't as dazzled by his own
> brilliance and who is capable of conveying an idea, okay?

Thank you for your comments.

While I understand your frustration, let me start by pointing you at
the *user* documentation for the quota support:

     man lpadmin

     http://www.cups.org/doc-1.1/sam.html#4_3_6

In this case, you are looking at the file format reference, which
is only there to explain the file format - we assume that the reader
already understands what each attribute does, and focus instead on
the mapping of those attributes to the directives in the file.

You might notice I pointed you at the CUPS 1.1.x documentation; the
CUPS 1.2.x documentation doesn't have the old admin manual, and not
all of the content has been converted to help documents or added to
the corresponding man page.  I'll see about adding a "quotas" help
page which describes the quota support in CUPS and the available
add-ons.

That said, I don't think that will help you...

> Of course in my case, I still need to find someone who can explain why I
> get "quota limit reached" whenever I try to print and why creating a
> printer on the web interface (and saving it) fails to create a printer.

Well, since you haven't told us what operating system or distribution
you are using, what version of CUPS you are using, or how you have
configured your system, it would be impossible to answer that
question.

However, if I was to *guess*, you are running Debian or Ubuntu and
are seeing (yet another) side-effect of their non-standard CUPS build.
The issue is not the CUPS quota support, but rather filesystem quotas
being enforced on the "lp" user which owns all of the print system
files.

-- 
______________________________________________________________________
Michael Sweet, Easy Software Products           mike at easysw dot com
Internet Printing and Publishing Software        http://www.easysw.com