Issue in man page wctype.3

Issue in man page wctype.3

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    all locales. → all locales:

"The B<wctype>()  function returns a property, given by its name.  The set of "
"valid names depends on the B<LC_CTYPE> category of the current locale, but "
"the following names are valid in all locales."

Re: Issue in man page wctype.3

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 998 bytes --]

Hi Helge,

At 2023-01-22T20:31:33+0100, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    all locales. → all locales:
> 
> "The B<wctype>()  function returns a property, given by its name.  The set of "
> "valid names depends on the B<LC_CTYPE> category of the current locale, but "
> "the following names are valid in all locales."

I disagree with this.  The material that follows does not serve to end
the sentence; it is a displayed list of items with no grammatical
structure.

The colon in English must be followed by an independent clause. (A list
of comma-separated items, or a list of semicolon-separated items that
contain commas is tolerated after a colon by some style guides.)

It is distressingly common that, in particular, programmers use colons
as a hatch for escaping the rules of English grammar, but it is _not_
correct usage, and any migration should be away from this practice, not
toward it.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page wctype.3

[Helge Kreutzmann]

[-- Attachment #1: Type: text/plain, Size: 1322 bytes --]

Hello Branden,
On Sun, Jan 22, 2023 at 02:01:49PM -0600, G. Branden Robinson wrote:
> At 2023-01-22T20:31:33+0100, Helge Kreutzmann wrote:
> > Without further ado, the following was found:
> > 
> > Issue:    all locales. → all locales:
> > 
> > "The B<wctype>()  function returns a property, given by its name.  The set of "
> > "valid names depends on the B<LC_CTYPE> category of the current locale, but "
> > "the following names are valid in all locales."
> 
> I disagree with this.  The material that follows does not serve to end
> the sentence; it is a displayed list of items with no grammatical
> structure.

For me, this would have been the perfect use of a colon, but …

> The colon in English must be followed by an independent clause. (A list
> of comma-separated items, or a list of semicolon-separated items that
> contain commas is tolerated after a colon by some style guides.)

… I'm not a native speaker, so please disregard this if it is
incorrect.

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 #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]