Bug#838854: cups-bsd: Typos in man pages

[Helge Kreutzmann]

Hello Didier,
On Mon, Sep 26, 2016 at 10:41:39AM +0200, Didier 'OdyX' Raboud wrote:
> Le dimanche, 25 septembre 2016, 21.05:13 h CEST Helge Kreutzmann a écrit :
> > While updating the German man page translation I finally moved myself
> > to report the numerous typos/inconsistencies noted during the German
> > translation. (Thus I marked them from the po file, but this is easily
> > translatable into the source files):
> 
> Thanks for this report; I've translated this into patches against the groff 
> source files and filed a pull request (see above URL)

Thanks.

> > *
> > 
> > Isn't the proper mark up "B"?
> > 
> > #. type: Plain text
> > #: ippfind.man:83
> > msgid ""
> > "Lists attributes returned by Get-Printer-Attributes for IPP printers and "
> > "traditional I \"-ls\" output for HTTP URLs.  The result is true if
> > the " "URI is accessible, false otherwise."
> 
> No, because `find -ls` isn't runnable as-is. You need `find  -ls` etc, 
> so referring to `find` 's "-ls" output makes sense.

Ah, but then the »'s« is missing, isn't it?

> > *
> > 
> > # FIXME: String broken??
> > #.  character. Common attributes and values are listed in the IANA IPP
> > registry \- see references below. #. type: Plain text
> > #: ipptoolfile.man:144
> > #, fuzzy
> > #| msgid ""
> > #| "Adds an attribute to the test request. Values are separated by the comma
> > " #| "(\",\")  character - escape commas using the \"\\e\" character.
> > Common " #| "attributes and values are listed in the IANA IPP registry -
> > see " #| "references below."
> > msgid ""
> > "Adds an attribute to the test request. Values are separated by the comma
> > (\"," "\") character - escape commas using the \""
> 
> I can't really see what's wrong here. How is it broken? In the original/final 
> manpages?

This might actually be a po4a bug. The part after »\"« is missing in the
pot file, i.e. the remaining part:
character. Common attributes and values are listed in the IANA IPP
registry \- see references below.

Greetings

  Helge
-- 
  Dr. Helge Kreutzmann deb...@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/


signature.asc
Description: Digital signature

Bug#838854: cups-bsd: Typos in man pages

[Didier 'OdyX' Raboud]

Control: forwarded -1 https://github.com/apple/cups/pull/4885
Control: tags -1 +upstream

Le dimanche, 25 septembre 2016, 21.05:13 h CEST Helge Kreutzmann a écrit :
> While updating the German man page translation I finally moved myself
> to report the numerous typos/inconsistencies noted during the German
> translation. (Thus I marked them from the po file, but this is easily
> translatable into the source files):

Thanks for this report; I've translated this into patches against the groff 
source files and filed a pull request (see above URL)

Two notes about things I didn't take:

> Is there really an "-" before "kind"?
> 
> #. type: TP
> #: cups-files.conf.man.in:90
> #, no-wrap
> msgid "BI<-kind >[ ... I<-kind >]"

Yes, as far as I understand it:

FatalErrors all -config

means "All errors but configuration file syntax errors are fatal", but:

FatalErrors config

means "Only configuration file syntax errors are fatal"

> *
> 
> Isn't the proper mark up "B"?
> 
> #. type: Plain text
> #: ippfind.man:83
> msgid ""
> "Lists attributes returned by Get-Printer-Attributes for IPP printers and "
> "traditional I \"-ls\" output for HTTP URLs.  The result is true if
> the " "URI is accessible, false otherwise."

No, because `find -ls` isn't runnable as-is. You need `find  -ls` etc, 
so referring to `find` 's "-ls" output makes sense.

> *
> 
> # FIXME: String broken??
> #.  character. Common attributes and values are listed in the IANA IPP
> registry \- see references below. #. type: Plain text
> #: ipptoolfile.man:144
> #, fuzzy
> #| msgid ""
> #| "Adds an attribute to the test request. Values are separated by the comma
> " #| "(\",\")  character - escape commas using the \"\\e\" character.
> Common " #| "attributes and values are listed in the IANA IPP registry -
> see " #| "references below."
> msgid ""
> "Adds an attribute to the test request. Values are separated by the comma
> (\"," "\") character - escape commas using the \""

I can't really see what's wrong here. How is it broken? In the original/final 
manpages?

-- 
Cheers,
OdyX

signature.asc
Description: This is a digitally signed message part.

Bug#838854: cups-bsd: Typos in man pages

[Helge Kreutzmann]

Package: cups-bsd
Version: 2.2.0-2
Severity: minor
Tags: upstream

While updating the German man page translation I finally moved myself
to report the numerous typos/inconsistencies noted during the German
translation. (Thus I marked them from the po file, but this is easily
translatable into the source files):

Inconsistent formatting, i.e., () once inside B<>, once outside

#. type: Plain text
#: backend.man:76
msgid ""
"Backends are responsible for reading side-channel requests using the "
"B()  function and responding with the "
"B function. The B constant defines the "
"file descriptor that should be monitored for incoming requests."

***

# s/design/designed/

#. type: Plain text
#: backend.man:178
msgid ""
"CUPS backends are not generally design to be run directly by the user. Aside "
"from the device URI issue ( I and B environment "
"variable contain the device URI), CUPS backends also expect specific "
"environment variables and file descriptors, and typically run in a user "
"session that (on macOS) has additional restrictions that affect how it runs. "
"Backends can also be installed with restricted permissions (0500 or 0700) "
"that tell the scheduler to run them as the \"root\" user instead of an "
"unprivileged user (typically \"lp\") on the system."

***

s/it not/is not/

#. type: Plain text
#: client.conf.man.in:55
msgid ""
"Specifies the address and optionally the port to use when connecting to the "
"server.  B"

***

IPP OPERATIONS → IPP OPERATION NAMES ?

#. #Limit
#. type: Plain text
#: cupsd.conf.man.in:236
msgid ""
"Specifies the IPP operations that are being limited inside a Policy section. "
"IPP operation names are listed below in the section \"IPP OPERATIONS\"."

**

HTTP METHODS does not exist; HTTP METHOD NAMES?

#. #LimitRequestBody
#. type: Plain text
#: cupsd.conf.man.in:243
msgid ""
"Specifies the HTTP methods that are being limited inside a Location section. "
"HTTP method names are listed below in the section \"HTTP METHODS\"."



Full stop only in this string (not in the ones before and after)

#. type: Plain text
#: cupsd.conf.man.in:693
msgid "The path for the specified job."



Is there really an "-" before "kind"?

#. type: TP
#: cups-files.conf.man.in:90
#, no-wrap
msgid "BI<-kind >[ ... I<-kind >]"

*

(8) outside bracket for xinetd

#. type: Plain text
#: cups-lpd.man.in:111
msgid ""
"CUPS includes configuration files for B(8), B(8), and "
"B Simply enable the B service using the corresponding "
"control program."

*

Isn't the proper mark up "B"?

#. type: Plain text
#: ippfind.man:83
msgid ""
"Lists attributes returned by Get-Printer-Attributes for IPP printers and "
"traditional I \"-ls\" output for HTTP URLs.  The result is true if the "
"URI is accessible, false otherwise."

*

# FIXME: String broken??
#.  character. Common attributes and values are listed in the IANA IPP registry 
\- see references below.
#. type: Plain text
#: ipptoolfile.man:144
#, fuzzy
#| msgid ""
#| "Adds an attribute to the test request. Values are separated by the comma "
#| "(\",\")  character - escape commas using the \"\\e\" character. Common "
#| "attributes and values are listed in the IANA IPP registry - see "
#| "references below."
msgid ""
"Adds an attribute to the test request. Values are separated by the comma (\","
"\") character - escape commas using the \""

-- 
  Dr. Helge Kreutzmann deb...@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/


signature.asc
Description: Digital signature