Re: For review: New locale(1) page

[Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org>]

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

On Mon 10 Mar 2014 14:27:43 Michael Kerrisk wrote:
> For each argument, the following is displayed:
> .IP * 3
> For a locale keyword, the value of that keyword to be displayed.
> .IP *
> For a locale category,
> the values of all keywords in that category are displayed.

these bullet points don't seem to be indented.  should they be ?  the 
rendering looks not that great ... but maybe it's the standard.

> .BR "\-c" ", " \-\-category\-name"

that last " shouldn't be there

> .BR "\-k" ", " "\-\-keyword\-name"
> For each keyword whose value is being displayed,
> include also the name of that keyword,
> so that the output has the format:
> 
>     \fIkeyword\fP="\fIvalue\fP"
> 
> .PP

there's two blank lines after this keyword section.  is the intention for each 
.PP to have two blank lines precede it in the output ?  this is the only one, 
so maybe the other .PP need tweaking ?

> .SH EXAMPLE
> .nf
> $ \fBlocale\fP

this this example discuss which env vars you had set ahead of time ?  seems 
like you just have LC_ALL=en_US.UTF-8 (which is kind of weird ... normally you 
only set LANG).

> LANG=en_US.UTF\-8
> LC_CTYPE="en_US.UTF\-8"
> LC_NUMERIC="en_US.UTF\-8"
> LC_TIME="en_US.UTF\-8"
> LC_COLLATE="en_US.UTF\-8"
> LC_MONETARY="en_US.UTF\-8"
> LC_MESSAGES="en_US.UTF\-8"
> LC_PAPER="en_US.UTF\-8"
> LC_NAME="en_US.UTF\-8"
> LC_ADDRESS="en_US.UTF\-8"
> LC_TELEPHONE="en_US.UTF\-8"
> LC_MEASUREMENT="en_US.UTF\-8"
> LC_IDENTIFICATION="en_US.UTF\-8"
> LC_ALL=en_US.UTF\-8
> $ \fBlocale date_fmt\fP
> %a %b %e %H:%M:%S %Z %Y
> $ \fBlocale \-k date_fmt\fP
> date_fmt="%a %b %e %H:%M:%S %Z %Y"
> $ \fBlocale \-ck date_fmt\fP
> LC_TIME
> date_fmt="%a %b %e %H:%M:%S %Z %Y"
> $ \fBlocale LC_MESSAGES\fP
> ^[yY].*
> ^[nN].*
> Yes
> No
> UTF\-8
> $ \fBlocale \-k LC_MESSAGES\fP
> yesexpr="^[yY].*"
> noexpr="^[nN].*"
> yesstr="Yes"
> nostr="No"
> messages\-codeset="UTF\-8"

i think this section would be a bit more readable if there was a blank line 
before each $ prompt.  relying on the bolding alone seems insufficient.
-mike

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 836 bytes --]