Date: Tue, 11 Feb 2014 18:40:01 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43875 - head/en_US.ISO8859-1/books/handbook/l10n Message-ID: <201402111840.s1BIe1OP026746@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dru Date: Tue Feb 11 18:40:01 2014 New Revision: 43875 URL: http://svnweb.freebsd.org/changeset/doc/43875 Log: Finish section 22.2.2 Console Setup. Update table on available consoles. 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:55:42 2014 (r43874) +++ head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml Tue Feb 11 18:40:01 2014 (r43875) @@ -342,7 +342,7 @@ me:\ example, to set the German language for the <command>sh</command> shell, these lines could be added to <filename>~/.profile</filename> to set the shell for that - user only. Thse lines could also be added to + user only. These lines could also be added to <filename>/etc/profile</filename> or <filename>/usr/share/skel/dot.profile</filename> to set that shell for all users:</para> @@ -365,7 +365,7 @@ me:\ <filename>~/.xinitrc</filename> also depends upon the shell. The first example is for the <command>sh</command> shell and the second is for the <command>csh</command> - shell.</para> + shell:</para> <programlisting><envar>LANG=de_DE.ISO8859-1; export LANG</envar></programlisting> @@ -376,75 +376,59 @@ me:\ <sect2 xml:id="setting-console"> <title>Console Setup</title> - <para>For all single C chars character sets, set the correct - console fonts in <filename>/etc/rc.conf</filename> for the - language in question with:</para> + <para>Several localized fonts + are available for the console. To see a listing of + available fonts, type + <command>ls /usr/share/syscons/fonts</command>. To configure + the console font, specify the + <replaceable>font_name</replaceable>, + without the <filename>.fnt</filename> suffix, + in <filename>/etc/rc.conf</filename>:</para> <programlisting>font8x16=<replaceable>font_name</replaceable> font8x14=<replaceable>font_name</replaceable> font8x8=<replaceable>font_name</replaceable></programlisting> - <para>The <replaceable>font_name</replaceable> is taken from - <filename>/usr/share/syscons/fonts</filename>, - without the <filename>.fnt</filename> suffix.</para> - - <indexterm> - <primary><application>sysinstall</application></primary> - </indexterm> <indexterm><primary>keymap</primary></indexterm> <indexterm><primary>screenmap</primary></indexterm> - <para>The keymap and screenmap for the single C chars character - set can be set using <command>sysinstall</command>. Once - inside <application>sysinstall</application>, choose - <guimenuitem>Configure</guimenuitem>, then - <guimenuitem>Console</guimenuitem>. Alternatively, - add the following to <filename>/etc/rc.conf</filename>:</para> + <para>The keymap and screenmap + can be set by + adding the following to <filename>/etc/rc.conf</filename>:</para> <programlisting>scrnmap=<replaceable>screenmap_name</replaceable> keymap=<replaceable>keymap_name</replaceable> keychange="<replaceable>fkey_number sequence</replaceable>"</programlisting> - <para>The <replaceable>screenmap_name</replaceable> is taken - from <filename>/usr/share/syscons/scrnmaps</filename>, - without the <filename>.scm</filename> suffix. A screenmap + <para>To see the list of available screenmaps, type + <command>ls /usr/share/syscons/scrnmaps</command>. Do + not include the <filename>.scm</filename> suffix when + specifying <replaceable>screenmap_name</replaceable>. A screenmap with a corresponding mapped font is usually needed as a workaround for expanding bit 8 to bit 9 on a VGA adapter's - font character matrix. This will move letters out of the + font character matrix so that letters are moved out of the pseudographics area if the screen font uses a bit 8 column.</para> - <para>If <application>moused</application> is enabled in - <filename>/etc/rc.conf</filename>, review the mouse cursor - information in the next paragraph.</para> - - <indexterm> - <primary><application>moused</application></primary> - </indexterm> - <para>By default, the mouse cursor of the &man.syscons.4; driver - occupies the 0xd0-0xd3 range in the character set. If the - language uses this range, move the cursor's range. To enable - this workaround for &os;, add the following line to - <filename>/etc/rc.conf</filename>:</para> - - <programlisting>mousechar_start=3</programlisting> - - <para>The <replaceable>keymap_name</replaceable> in the above - example is taken from - <filename>/usr/share/syscons/keymaps</filename>, without the + <para>To see the list of available keymaps, type + <filename>ls /usr/share/syscons/keymaps</filename>. When + specifying the <replaceable>keymap_name</replaceable>, do not include the <filename>.kbd</filename> suffix. When uncertain as to which keymap to use, &man.kbdmap.1; can be used to test keymaps without rebooting.</para> - <para>The <literal>keychange</literal> is usually needed to + <para>The <literal>keychange</literal> entry is usually needed to program function keys to match the selected terminal type - because function key sequences cannot be defined in the key - map.</para> + because function key sequences cannot be defined in the keymap.</para> - <para>Be sure to set the correct console terminal type in + <para>Next, set the correct console terminal type in <filename>/etc/ttys</filename> for all virtual terminal - entries. Current pre-defined correspondences are:</para> + entries. <xref + linkend="locale-charset"/> summarizes the available + terminal types.:</para> + + <table xml:id="locale-charset" frame="none" pgwide="1"> + <title>Defined Terminal Types for Character Sets</title> - <informaltable frame="none" pgwide="1"> <tgroup cols="2"> <thead> <row> @@ -490,22 +474,27 @@ keychange="<replaceable>fkey_number sequ </row> </tbody> </tgroup> - </informaltable> + </table> + + <indexterm> + <primary><application>moused</application></primary> + </indexterm> + + <para>For languages with wide or multibyte characters, install a + console for that language from the &os; Ports Collection. The + available ports are summarized in <xref + linkend="locale-console"/>. Once installed, refer to the + port's <filename>pkg-message</filename> or man pages for + configuration and usage instructions.</para> - <para>For languages with wide or multibyte characters, use the - correct &os; port in <filename>/usr/ports/language</filename>. - Some applications appear as serial terminals to the system. - Reserve enough terminals in <filename>/etc/ttys</filename> - for both <application>Xorg</application> and the pseudo-serial - console. Here is a partial list of applications for using - other languages in the console:</para> + <table xml:id="locale-console" frame="none" pgwide="1"> + <title>Available Console From Ports Collection</title> - <informaltable frame="none" pgwide="1"> <tgroup cols="2"> <thead> <row> <entry>Language</entry> - <entry>Location</entry> + <entry>Port Location</entry> </row> </thead> @@ -516,19 +505,45 @@ keychange="<replaceable>fkey_number sequ </row> <row> + <entry>Chinese/Japanese/Korean</entry> + <entry><package>chinese/cce</package></entry> + </row> + + <row> + <entry>Japanese</entry> + <entry><package>chinese/kon2</package></entry> + </row> + + <row> + <entry>Chinese/Japanese/Korean</entry> + <entry><package>chinese/zhcon</package></entry> + </row> + + <row> <entry>Japanese</entry> - <entry><package>japanese/kon2-16dot</package> or - <package>japanese/mule-freewnn</package></entry> + <entry><package>japanese/kon2-14dot</package></entry> </row> <row> - <entry>Korean</entry> - <entry><package>korean/han</package></entry> + <entry>Japanese</entry> + <entry><package>japanese/kon2-16dot</package></entry> </row> </tbody> </tgroup> - </informaltable> - </sect2> + </table> + + <para>If <application>moused</application> is enabled in + <filename>/etc/rc.conf</filename>, additional configuration + may be required. + By default, the mouse cursor of the &man.syscons.4; driver + occupies the <literal>0xd0</literal>-<literal>0xd3</literal> range in the character set. If the + language uses this range, move the cursor's range. To enable + this workaround for &os;, add the following line to + <filename>/etc/rc.conf</filename>:</para> + + <programlisting>mousechar_start=3</programlisting> + + </sect2> <sect2> <title>Xorg Setup</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402111840.s1BIe1OP026746>