Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 113072 - Handbook is missing an example of setting the system-wide locale (LANG and LC_ALL variables)
Summary: Handbook is missing an example of setting the system-wide locale (LANG and LC...
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Docs Team
Depends on:
Reported: 2005-11-20 04:38 UTC by Wiktor Wandachowicz
Modified: 2005-11-20 08:27 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Note You need to log in before you can comment on or make changes to this bug.
Description Wiktor Wandachowicz 2005-11-20 04:38:04 UTC
On all installations I do, I create a simple file which sets the default system
locale. It's simple and straightforward. I just create a /etc/env.d/00locale
file with the following contents:

----- BEGIN EXAMPLE -----
# /etc/env.d/00locale:
# Define default system locale

----- END EXAMPLE -----

Could there be a section in the Gentoo Handbook with such an example?
I'm sure that some people would love that setting to be described.
Especially not native English speakers :-)

I'm not sure if 00locale is the best name, but I want all of the services
to use that settings. So far I've never encountered any problem with it,
but if this is known to break something, then silly me... ;-)

So, if there is a better sequence number for putting such file in
/etc/env.d, I'd be delighted to know!

Reproducible: Always
Steps to Reproduce:
1. See the 8th chapter of the Handbook, section "8.c. System Information"
   There it would fit perfectly.
Actual Results:  
There's no information in the Handbook about setting system-wide locale.

Expected Results:  
To see a subsection in the Handbook describing how to set system-wide locale.

There is an open Bug #9988, which is in part related to the LANG/locale
settings, but in the end it ends with considerations about enhancing
ebuild files and merging process.

However, my original intent is much simpler and quite easy to implement.
OTOH maybe this should be accompanied with creation of such a file
(/etc/env.d/00locale) and adding it to a new version of baselayout?
Comment 1 SpanKY gentoo-dev 2005-11-20 04:46:41 UTC
all UTF8 stuff is covered in the UTF8 guide ... no point in duplicating info
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2005-11-20 05:56:28 UTC
Rather the Gentoo Localization guide for the respective language
Comment 3 Wiktor Wandachowicz 2005-11-20 08:27:27 UTC
Hmm. Indeed, both document are correct. The first one:

"Gentoo Linux Localization Guide"

is very detailed and jusifies setting both LANG and LC_ALL variables.
(I read this once, but there was no mention of /etc/env.d/02locale
file IIRC, or maybe I just forgot about it)

The second one:

"Using UTF-8 with Gentoo"

also mentions /etc/env.d/02locale file. That's good, because it's consistent.
The UTF-8 Guide at the same time skips the LANG variable setting/discussion
and doesn't contain any link to Localization Guide.

This solves one of my questions, that is what should be the name of 02locale
file. Big thank for it!

And after you've motivated me enough, I checked the whole Handbook and finally
I've found a link to the "Localization Guide" it the chapter 12...
So it looks like I raised the alarm too early. The only thing that justifies
me is that I got only to the chapter 9 before I started to post Handbook
enhancement requests...

// Now the system works and a looong night of compilation is ahead. :-)

Thanks again!