summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorLars Kellogg-Stedman <lars@seas.harvard.edu>2013-02-27 13:04:16 -0500
committerDavid Herrmann <dh.herrmann@gmail.com>2013-03-12 17:53:22 +0100
commit4e0b9813de9e75b5b487e76aa48799b332555b21 (patch)
tree2943b278ca4cc7edb6da759268cbc7d756dbabb2 /docs
parentd240c27ecb8c107eb52ab7a80eadbae3dab803e2 (diff)
docs: man: document configuration files in kmscon(1)
This moves the description of kmscon.conf to a separate "Configuration" section and adds some example kmscon.conf configuration lines. This addresses #71 (at least, with this change in place I probably would not have been momentarily confused by the exact syntax used in kmsconf.conf). (removed trailing whitespaces) Signed-off-by: David Herrmann <dh.herrmann@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/man/kmscon.xml31
1 files changed, 21 insertions, 10 deletions
diff --git a/docs/man/kmscon.xml b/docs/man/kmscon.xml
index 9fe0ba1..3d8a639 100644
--- a/docs/man/kmscon.xml
+++ b/docs/man/kmscon.xml
@@ -59,16 +59,6 @@
<para>When run in listener mode, kmscon watches the system for new seats and
automatically provides a system console on it.</para>
-
- <para>Default configuration directory is <filename>/etc/kmscon/</filename>
- and the main configuration file is called
- <filename>/etc/kmscon/kmscon.conf</filename>. You can provide an
- additional configuration file for each seat via
- <filename>/etc/kmscon/{seatname}.kmscon.conf</filename>.
- Any command-line option that can be passed to kmscon can also be put
- into those configuration files. Command-line options overwrite
- configuration file options. And per-seat configuration files overwrite
- the global configuration file.</para>
</refsect1>
<refsect1>
@@ -525,6 +515,27 @@
</refsect1>
<refsect1>
+ <title>Configuration</title>
+ <para>Default configuration directory is <filename>/etc/kmscon/</filename>
+ and the main configuration file is called
+ <filename>/etc/kmscon/kmscon.conf</filename>. You can provide an
+ additional configuration file for each seat via
+ <filename>/etc/kmscon/{seatname}.kmscon.conf</filename>.
+ Any command-line option that can be passed to kmscon can also be put
+ into those configuration files. For example:</para>
+
+ <programlisting>
+ font-name=Meslo LG M
+ font-size=14
+ login=/bin/bash -i
+ </programlisting>
+
+ <para>Command-line options overwrite
+ configuration file options. And per-seat configuration files overwrite
+ the global configuration file.</para>
+ </refsect1>
+
+ <refsect1>
<title>Default Mode</title>
<para>In default mode, kmscon acts as a replacement for
<citerefentry><refentrytitle>agetty</refentrytitle><manvolnum>1</manvolnum></citerefentry>.