From 4e0b9813de9e75b5b487e76aa48799b332555b21 Mon Sep 17 00:00:00 2001
From: Lars Kellogg-Stedman <lars@seas.harvard.edu>
Date: Wed, 27 Feb 2013 13:04:16 -0500
Subject: [PATCH] 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>
---
 docs/man/kmscon.xml | 31 +++++++++++++++++++++----------
 1 file 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>.
-- 
2.7.4