english/language-env/set-language-env.1

.TH SET-LANGUAGE-ENV 1 "2001/7/3"
.SH NAME
set\-language\-env \- Making basic settings for native languages
.SH SYNOPSIS
.B set\-language\-env 
.RB [\| \-l
.IR language \|]
.RB [\| \-hvsrNcCRE \|]
.\" ********************************************************************
.SH DESCRIPTION
.B set\-language\-env
establishes basic native language environment by adding lines
to your dot\-files.  Since the setting is established
by adding lines to your dot\-files, the private environment
for only a person who invokes
.B set\-language\-env
is affected.  It does not change any system\-wide settings.
(Note: The root user can change /etc/skel directory.)
.PP
This version supports Belarusian, Bulgarian, Catalan Danish, French,
German, Japanese, Korean, Macedonian, Polish, Russian, Serbian, Spanish,
Thai and Ukrainian.
.PP
.B set\-language\-env
shows a list of Debian packages which should be installed.
These packages are required to utilize settings.
You have to install them or ask the site administrator
to install them.
.PP
Added lines are surrounded with the header and footer lines.
Since these lines are used by 
.B set\-language\-env
to recognize the lines
it has added, please do not modify them. You can modify lines before
the header line and after the footer line and the modification 
will be preserved after invocations of
.BR set\-language\-env .
.PP
When 
.B language\-env
package is updated, you can safely update your dot\-files by only invoking 
.B set\-language\-env 
without your original setting being affected.
The place where the lines were added is not changed by the process.
However, if you directly modified a setting which 
.B set\-language\-env
have added, it will be lost on the next invocation of 
.BR set\-language\-env .
.PP
.\" ********************************************************************
.SH OPTIONS
.TP
.BI \-l\  language
specify your favorite native language.  Here are the supported languages:
.br
.B be
Belarusian
.br
.B bg
Bulgarian
.br
.B ca
Catalan
.br
.B da
Danish
.br
.B de
German
.br
.B es
Spanish
.br
.B fr
French
.br
.B ja
Japanese
.br
.B ko
Korean
.br
.B mk
Macedonian
.br
.B pl
Polish
.br
.B ru
Russian
.br
.B sr
Serbian
.br
.B th
Thai
.br
.B uk
Ukrainian
.br
.TP
.B \-h
Show help message.
.TP
.B \-v
Verbose mode, mainly for debugging.
.TP
.B \-s
Show a list of supported languages.
.TP
.B \-r
Remove all settings by 
.B set\-language\-env 
in your dot\-files.
.TP
.B \-N
Don't fork another 
.BR set\-language\-env .
This option is for internal use.
.TP
.B \-c
On runtime of
.BR set\-language\-env ,
native language\-specific (i.e. non\-ASCII) characters (such as Kanji
and ISO\-8859\-1) are not used.  Though this option is intended to be used 
internally, this can be used to override automatic detection of whether
native language\-specific characters can be used or not when the detection
does not work well.
.TP
.B \-C
On runtime of
.BR set\-language\-env ,
native language\-specific (i.e. non\-ASCII) characters (such as Kanji
and ISO\-8859\-1) are used.  Though this option is intended to be used 
internally, this can be used to override automatic detection of whether
native language\-specific characters can be used or not when the detection
does not work well.
.TP
.B \-R
Root user usually cannot set his/her own settings into /root directory
because
.B set\-language\-env
checks it.  This option disables the check.
.TP
.B \-E
Settings are done into 
.I /etc/skel 
directory instead of users' home directory. 
Only root user can use this option.
.\" ********************************************************************
.SH ADDING NEW LANGUAGE
If you would like to add a new language support, read
.IR /usr/share/doc/language\-env/README.i18n .
In short, you will have to write
.br
(1) contents which will be added to users' dot\-files,
.br
(2) 'support' file,
.br
(3) documents, and
.br
(4) image file for tklanguage.
.br
Please contact to the developer of
.BR language\-env .
.SH SEE ALSO
.TP
.I "/usr/share/doc/language\-env/README*"
Detailed explanation on each language.
.SH FILES
.TP
.I "/usr/share/language\-env/*"
Prototypes to be added to your dot\-files.
.SH AUTHOR
Tomohiro KUBOTA <kubota@debian.org>
1	.TH SET-LANGUAGE-ENV 1 "2001/7/3"
2	.SH NAME
3	set\-language\-env \- Making basic settings for native languages
4	.SH SYNOPSIS
5	.B set\-language\-env
6	.RB [\\| \-l
7	.IR language \\|]
8	.RB [\\| \-hvsrNcCRE \\|]
9	.\" ********************************************************************
10	.SH DESCRIPTION
11	.B set\-language\-env
12	establishes basic native language environment by adding lines
13	to your dot\-files. Since the setting is established
14	by adding lines to your dot\-files, the private environment
15	for only a person who invokes
16	.B set\-language\-env
17	is affected. It does not change any system\-wide settings.
18	(Note: The root user can change /etc/skel directory.)
19	.PP
20	This version supports Belarusian, Bulgarian, Catalan Danish, French,
21	German, Japanese, Korean, Macedonian, Polish, Russian, Serbian, Spanish,
22	Thai and Ukrainian.
23	.PP
24	.B set\-language\-env
25	shows a list of Debian packages which should be installed.
26	These packages are required to utilize settings.
27	You have to install them or ask the site administrator
28	to install them.
29	.PP
30	Added lines are surrounded with the header and footer lines.
31	Since these lines are used by
32	.B set\-language\-env
33	to recognize the lines
34	it has added, please do not modify them. You can modify lines before
35	the header line and after the footer line and the modification
36	will be preserved after invocations of
37	.BR set\-language\-env .
38	.PP
39	When
40	.B language\-env
41	package is updated, you can safely update your dot\-files by only invoking
42	.B set\-language\-env
43	without your original setting being affected.
44	The place where the lines were added is not changed by the process.
45	However, if you directly modified a setting which
46	.B set\-language\-env
47	have added, it will be lost on the next invocation of
48	.BR set\-language\-env .
49	.PP
50	.\" ********************************************************************
51	.SH OPTIONS
52	.TP
53	.BI \-l\ language
54	specify your favorite native language. Here are the supported languages:
55	.br
56	.B be
57	Belarusian
58	.br
59	.B bg
60	Bulgarian
61	.br
62	.B ca
63	Catalan
64	.br
65	.B da
66	Danish
67	.br
68	.B de
69	German
70	.br
71	.B es
72	Spanish
73	.br
74	.B fr
75	French
76	.br
77	.B ja
78	Japanese
79	.br
80	.B ko
81	Korean
82	.br
83	.B mk
84	Macedonian
85	.br
86	.B pl
87	Polish
88	.br
89	.B ru
90	Russian
91	.br
92	.B sr
93	Serbian
94	.br
95	.B th
96	Thai
97	.br
98	.B uk
99	Ukrainian
100	.br
101	.TP
102	.B \-h
103	Show help message.
104	.TP
105	.B \-v
106	Verbose mode, mainly for debugging.
107	.TP
108	.B \-s
109	Show a list of supported languages.
110	.TP
111	.B \-r
112	Remove all settings by
113	.B set\-language\-env
114	in your dot\-files.
115	.TP
116	.B \-N
117	Don't fork another
118	.BR set\-language\-env .
119	This option is for internal use.
120	.TP
121	.B \-c
122	On runtime of
123	.BR set\-language\-env ,
124	native language\-specific (i.e. non\-ASCII) characters (such as Kanji
125	and ISO\-8859\-1) are not used. Though this option is intended to be used
126	internally, this can be used to override automatic detection of whether
127	native language\-specific characters can be used or not when the detection
128	does not work well.
129	.TP
130	.B \-C
131	On runtime of
132	.BR set\-language\-env ,
133	native language\-specific (i.e. non\-ASCII) characters (such as Kanji
134	and ISO\-8859\-1) are used. Though this option is intended to be used
135	internally, this can be used to override automatic detection of whether
136	native language\-specific characters can be used or not when the detection
137	does not work well.
138	.TP
139	.B \-R
140	Root user usually cannot set his/her own settings into /root directory
141	because
142	.B set\-language\-env
143	checks it. This option disables the check.
144	.TP
145	.B \-E
146	Settings are done into
147	.I /etc/skel
148	directory instead of users' home directory.
149	Only root user can use this option.
150	.\" ********************************************************************
151	.SH ADDING NEW LANGUAGE
152	If you would like to add a new language support, read
153	.IR /usr/share/doc/language\-env/README.i18n .
154	In short, you will have to write
155	.br
156	(1) contents which will be added to users' dot\-files,
157	.br
158	(2) 'support' file,
159	.br
160	(3) documents, and
161	.br
162	(4) image file for tklanguage.
163	.br
164	Please contact to the developer of
165	.BR language\-env .
166	.SH SEE ALSO
167	.TP
168	.I "/usr/share/doc/language\-env/README*"
169	Detailed explanation on each language.
170	.SH FILES
171	.TP
172	.I "/usr/share/language\-env/*"
173	Prototypes to be added to your dot\-files.
174	.SH AUTHOR
175	Tomohiro KUBOTA <kubota@debian.org>