[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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
 	&lt;name&gt;se&lt;/name&gt;
@@ -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: