live-manual small update.
Hello,
you'll find joined to this e-mail a patch to give indications about
using klayout/kvariant parameters to specify keyboard layout, and about
hostname parameter.
Fred.
diff --git a/xml/chapters/live-environment.xml b/xml/chapters/live-environment.xml
index 087eac6..c12c3be 100644
--- a/xml/chapters/live-environment.xml
+++ b/xml/chapters/live-environment.xml
@@ -13,7 +13,10 @@
<section id="hostname">
<title>Hostname</title>
-<para>FIXME</para>
+<para>The name of host running live system can be set with the <command>hostname</command> parameter into the <command>--bootappend-live</command> option of <filename>lh_config</filename>, e.g.:
+
+<screen>lh_config --bootappend-live "hostname=myhost"</screen>
+This parameter can also be used in kernel command line.</para>
</section>
<section id="live-user">
@@ -33,11 +36,19 @@
<section id="language">
<title>Language</title>
-<para>When the live system boots there are three process which concerns language: the locale generation, setting the keyboard layout for the console and setting the keyboard layout for X. To define the locale that should be generated, use the <command>locale</command> parameter to the <command>--bootappend-live</command> option of <filename>lh_config</filename>, e.g.:
+<para>When the live system boots, language is involved in three steps:
+<itemizedlist>
+ <listitem><simpara>the locale generation</simpara></listitem>
+ <listitem><simpara>setting the keyboard layout for the console</simpara></listitem>
+ <listitem><simpara>setting the keyboard layout for X</simpara></listitem>
+</itemizedlist></para>
+
+<para>To define the locale that should be generated, use the <command>locale</command> parameter into the <command>--bootappend-live</command> option of <filename>lh_config</filename>, e.g.:
<screen>lh_config --bootappend-live "locale=sv_SE.utf8"</screen>
+This parameter can also be used in kernel command line. You can specify a locale by a two-letters code, or for better control, by a full <userinput><parameter>language</parameter>_<parameter>country</parameter>.<parameter>encoding</parameter></userinput> word.</para>
-Both the console and X keyboard configuration depends on the <command>keyb</command> parameter of the <command>--bootappend-live</command>option. Valid options for X keyboard layouts can be found in <filename>/etc/X11/xkb/base.xml</filename>. To find the value (the two characters) corresponding to a language try searching for the english name of the nation where the language is spoken, e.g:
+<para>Both the console and X keyboard configuration depends on the <command>keyb</command> parameter of the <command>--bootappend-live</command> option. Valid options for X keyboard layouts can be found in <filename>/etc/X11/xkb/base.xml</filename> (rather limited to two-letters country codes). To find the value (the two characters) corresponding to a language try searching for the english name of the nation where the language is spoken, e.g:
<screen>$ grep -i sweden -C3 /etc/X11/xkb/base.xml | grep name
<name>se</name>
@@ -57,6 +68,13 @@ To make the console keyboard use a swedish layout use
<screen>lh_config --bootappend-live "locale=sv_SE.utf8 keyb=se-latin1"</screen>
</para>
+
+<para>Alternatively, you can use the <literal>console-setup</literal> package, a tool to let you configure console layout using X (XKB) definitions; you can then setup your keyboard layout more precisely with <literal>klayout</literal>, <literal>kvariant</literal>, <literal>koptions</literal> and <literal>kmodel</literal> variables; <command>live-initramfs</command> will use also these parameters for X configuration. For example, to set up a french system with a french-dvorak layout (called Bépo) on a TypeMatrix keyboard, both in console and X11, use:
+<screen>lh_config --bootappend-live \
+ "locale=fr_FR.UTF-8 klayout=fr kvariant=bepo kmodel=tm2030usb"</screen>
+
+Note that on old versions of <literal>console-setup</literal> (i.e. Lenny's one), you'll need to setup also the <literal>keyb</literal> variable to the <literal>klayout</literal>'s value.
+</para>
</section>
<section id="persistence">
Reply to: