From owner-svn-doc-all@FreeBSD.ORG Tue Feb 11 16:55:42 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 840F3FED; Tue, 11 Feb 2014 16:55:42 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 6D704167F; Tue, 11 Feb 2014 16:55:42 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s1BGtg7T085017; Tue, 11 Feb 2014 16:55:42 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s1BGtghf085016; Tue, 11 Feb 2014 16:55:42 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201402111655.s1BGtghf085016@svn.freebsd.org> From: Dru Lavigne Date: Tue, 11 Feb 2014 16:55:42 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43874 - head/en_US.ISO8859-1/books/handbook/l10n X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 11 Feb 2014 16:55:42 -0000 Author: dru Date: Tue Feb 11 16:55:42 2014 New Revision: 43874 URL: http://svnweb.freebsd.org/changeset/doc/43874 Log: White space fix only. Translators can ignore. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml Tue Feb 11 16:35:54 2014 (r43873) +++ head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml Tue Feb 11 16:55:42 2014 (r43874) @@ -110,14 +110,15 @@ language codes country codes - The LanguageCode and CountryCode are used - to determine the country - and the specific language - variation. provides some - examples of LanguageCode_CountryCode: + The LanguageCode and + CountryCode are used to determine + the country and the specific language variation. provides some examples of + LanguageCode_CountryCode: Common Language and Country Codes + @@ -148,10 +149,10 @@ encodings ASCII - Some languages, such as Chinese or Japanese, cannot be represented using ASCII characters - and require an extended language encoding using either - wide or multibyte characters. Older applications - may mistake these encodings for control + Some languages, such as Chinese or Japanese, cannot be + represented using ASCII characters and require an extended + language encoding using either wide or multibyte characters. + Older applications may mistake these encodings for control characters while newer applications usually recognize 8-bit characters. Depending on the implementation, users may be required to compile an application with wide or multibyte @@ -161,13 +162,13 @@ considerations for finding or compiling applications with i18n support. - A complete listing of available locales can be found by + A complete listing of available locales can be found by typing: &prompt.user; locale -a | more - + To determine the current locale setting: - + &prompt.user; locale @@ -186,8 +187,7 @@ LANG, which sets the locale - POSIX - + POSIX @@ -203,46 +203,44 @@ specific application configuration and Xorg configuration. - locale - login class + locale + login class - Two methods are available for making the needed variable - assignments: the - login class method, which - is the recommended method, and the - startup file method. - The next two sections demonstrate how to use both methods. - - - Login Classes Method - - This first method is the recommended method as it - assigns the required environment variables for - locale name and MIME character sets - for every possible shell. - This setup can either be - performed by each user or it can be configured for all users by the - superuser. - - This minimal example sets both variables for - Latin-1 encoding in the - .login_conf of an individual user's - home directory: + Two methods are available for making the needed variable + assignments: the login + class method, which is the recommended method, and + the startup file method. + The next two sections demonstrate how to use both + methods. + + + Login Classes Method + + This first method is the recommended method as it + assigns the required environment variables for locale name + and MIME character sets for every possible shell. This + setup can either be performed by each user or it can be + configured for all users by the superuser. + + This minimal example sets both variables for Latin-1 + encoding in the .login_conf of an + individual user's home directory: - me:\ + me:\ :charset=ISO-8859-1:\ :lang=de_DE.ISO8859-1: - Traditional Chinese - BIG-5 encoding - Here is an example of a user's - ~/.login_conf that sets the variables - for Traditional Chinese in BIG-5 encoding. More - variables are needed because some applications do not - correctly respect locale variables for Chinese, - Japanese, and Korean: + Traditional Chinese + BIG-5 encoding + + Here is an example of a user's + ~/.login_conf that sets the variables + for Traditional Chinese in BIG-5 encoding. More variables + are needed because some applications do not correctly + respect locale variables for Chinese, Japanese, and + Korean: - #Users who do not wish to use monetary units or time formats + #Users who do not wish to use monetary units or time formats #of Taiwan can manually change each variable me:\ :lang=zh_TW.Big5:\ @@ -256,103 +254,108 @@ me:\ :charset=big5:\ :xmodifiers="@im=gcin": #Set gcin as the XIM Input Server - Alternately, the superuser can configure all users of the system for localization. The following variables in - /etc/login.conf are used to set the locale and - MIME character sete: + Alternately, the superuser can configure all users of + the system for localization. The following variables in + /etc/login.conf are used to set the + locale and MIME character sete: - language_name|Account Type Description:\ + language_name|Account Type Description:\ :charset=MIME_charset:\ :lang=locale_name:\ :tc=default: - So, the previous Latin-1 example would look like - this: + So, the previous Latin-1 example would look like + this: - german|German Users Accounts:\ + german|German Users Accounts:\ :charset=ISO-8859-1:\ :lang=de_DE.ISO8859-1:\ :tc=default: - See &man.login.conf.5; for more - details about these variables. + See &man.login.conf.5; for more details about these + variables. + + Whenever /etc/login.conf is edited, + remember to execute the following command to update the + capability database: + + &prompt.root; cap_mkdb /etc/login.conf + + + Utilities Which Change Login Classes + + + vipw + + + In addition to manually editing + /etc/login.conf, several utilities + are available for setting the locale for newly created + users. + + When using vipw to add new users, + specify the language to set the + locale: + + user:password:1111:11:language:0:0:User Name:/home/user:/bin/sh + + + adduser + + login class + + When using adduser to add new + users, the default language can be pre-configured for all + new users or specified for an individual user. + + If all new users use the same language, set + defaultclass = language in + /etc/adduser.conf. - Whenever /etc/login.conf is edited, remember to execute the following - command to update the capability database: + To override this setting when creating a user, either + input the required locale at this prompt: - &prompt.root; cap_mkdb /etc/login.conf + Enter login class: default []: - - Utilities Which Change Login Classes - - - vipw - - - In addition to manually editing - /etc/login.conf, several utilities - are available for setting the locale for newly created - users. - - When using vipw to add new users, - specify the language to set the - locale: - - user:password:1111:11:language:0:0:User Name:/home/user:/bin/sh - - - adduser - - login class - When using adduser to add new - users, the default language can be pre-configured for - all new users or specified for an individual user. - - If all new users use the same language, set - defaultclass = - language in - /etc/adduser.conf. - - To override this setting when creating a - user, either input the required locale at - this prompt: - - Enter login class: default []: - - or specify the locale to set when invoking - adduser: - - &prompt.root; adduser -class language - - - pw - - If pw is used to add new users, specify the - locale as follows: + or specify the locale to set when invoking + adduser: - &prompt.root; pw useradd user_name -L language + &prompt.root; adduser -class language + + + pw + + + If pw is used to add new users, + specify the locale as follows: + + &prompt.root; pw useradd user_name -L language Shell Startup File Method - This method is not recommended as each shell that is used requires - manual configuration, where each shell has a different configuration file - and differing syntax. As an example, to set the German - language for the sh shell, these - lines could be added to ~/.profile to set the shell for that user only. - Thse lines could also be added to /etc/profile or - /usr/share/skel/dot.profile to set that shell for all users: + This method is not recommended as each shell that is + used requires manual configuration, where each shell has a + different configuration file and differing syntax. As an + example, to set the German language for the + sh shell, these lines could be added to + ~/.profile to set the shell for that + user only. Thse lines could also be added to + /etc/profile or + /usr/share/skel/dot.profile to set + that shell for all users: LANG=de_DE.ISO8859-1; export LANG MM_CHARSET=ISO-8859-1; export MM_CHARSET - However, the name of the configuration file and the - syntax used differs for the - csh shell. These are the equivalent - settings for ~/.csh.login, - /etc/csh.login, or - /usr/share/skel/dot.login: + However, the name of the configuration file and the + syntax used differs for the csh shell. + These are the equivalent settings for + ~/.csh.login, + /etc/csh.login, or + /usr/share/skel/dot.login: setenv LANG de_DE.ISO8859-1 setenv MM_CHARSET ISO-8859-1 @@ -604,45 +607,40 @@ keychange="fkey_number sequ Compiling <acronym>i18n</acronym> Programs - The &os; - &os; Ports - Collection contains programs which provide - application support for wide or multibyte characters for several languages. - Refer to the i18n documentation in the - respective &os; port - for more information on how to configure the application correctly or to - determine which compile options to use when building the - port. - - Some things to keep in mind are: - - - - Language specific single C chars character sets - such as ISO8859-1, ISO8859-15, KOI8-R, and CP437. These - are described in &man.multibyte.3;. - - - - Wide or multibyte encodings such as EUC and - Big5. - - - - The active list of character sets can be found at the - IANA - Registry. - - - &os; uses Xorg-compatible locale encodings - instead. - - - In the &os; Ports Collection, i18n - applications include i18n in their names - for easy identification. However, they do not always support - the language needed. + The &os; &os; + Ports Collection contains programs which provide + application support for wide or multibyte characters for several + languages. Refer to the i18n documentation + in the respective &os; port for more information on how to + configure the application correctly or to determine which + compile options to use when building the port. + + Some things to keep in mind are: + + + + Language specific single C chars character sets such as + ISO8859-1, ISO8859-15, KOI8-R, and CP437. These are + described in &man.multibyte.3;. + + + + Wide or multibyte encodings such as EUC and Big5. + + + + The active list of character sets can be found at the IANA + Registry. + + + &os; uses Xorg-compatible locale encodings instead. + + + In the &os; Ports Collection, i18n + applications include i18n in their names for + easy identification. However, they do not always support the + language needed. Many applications in the &os; Ports Collection have been ported with i18n support. Some of these