[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#711709: cups-client: Unclear description in ipptoolfile(5)



Hello Odyx,
On Sun, Jun 09, 2013 at 02:41:31PM +0200, Didier 'OdyX' Raboud wrote:
> Le samedi, 8 juin 2013 21.53:40, Helge Kreutzmann a écrit :
> > While translating I had trouble understanding if attribute names
> > in ipptoolfile(5) are free form (i.e. like variable names) or are to
> > be taken from a fixed set.
> > 
> > E.g. at the beginning, in
> >     ATTR charset attributes-charset utf-8
> > 
> > Is »attributes-charset« a variable (could be "foobar") or a fixed
> > name. I assumed the former, while other German translators pointed me
> > to the latter.
> 
> I agree that the manpage is not overly clear. That said, I have just found 
> that the IPP variable, values, etc, are all defined in [RFC2911]. This 
> particular Request Operation Attribute, "attributes-charset" is defined in 
> section-3.1.4.1 of that RFC document, so it's definitely both a variable 
> (because there are other possible values) and a fixed name (because it's not 
> fully free-form, the list of possible values being RFC2911).

Thanks for your research.

> Does that make it clearer? How would you like this bug to be fixed in the cups 

Yes.

> source package?

The following pseudo patch should do the trick:
       ATTR tag attribute-name value(s)
-           Adds an attribute to the test request. Values are separated by the comma (",") character - escape commas using the "
+           Adds an attribute to the test request. Values are separated by the comma (",") character - escape commas using the ". Possible attribute-name are defined in RFC2911.


SEE ALSO
       ipptool(1),
       http://localhost:631/help
+      RFC2911 http://tools.ietf.org/html/rfc2911

Greetings

           Helge
-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

Attachment: signature.asc
Description: Digital signature


Reply to: