From 5459a5c007eefa442bc11729a5913ebddc49f504 Mon Sep 17 00:00:00 2001
From: Michael Raskin <7c6f434c@mail.ru>
Date: Mon, 5 Nov 2007 21:17:16 +0000
Subject: [PATCH] Added user configuration chapter - currently about Compiz.

svn path=/nixos/trunk/; revision=9589
---
 doc/manual/installation.xml      |  4 +--
 doc/manual/manual.xml            |  3 +-
 doc/manual/userconfiguration.xml | 48 ++++++++++++++++++++++++++++++++
 3 files changed, 52 insertions(+), 3 deletions(-)
 create mode 100644 doc/manual/userconfiguration.xml

diff --git a/doc/manual/installation.xml b/doc/manual/installation.xml
index f9c7743b23a..6a56b3b874a 100644
--- a/doc/manual/installation.xml
+++ b/doc/manual/installation.xml
@@ -19,7 +19,7 @@ one from <link xlink:href="http://nix.cs.uu.nl/nixos/"/>.  If you want
   <listitem><para>Make sure that you have a <emphasis>very</emphasis>
   recent pre-release version of Nix installed (<link
   xlink:href="http://nix.cs.uu.nl/dist/nix/nix-unstable-latest/"/>).
-  The NixOS Nix expressions frequently use bleading-edge features.  If
+  The NixOS Nix expressions frequently use bleeding-edge features.  If
   you get any kind of expression evaluation error, try to upgrade your
   Nix.</para></listitem>
 
@@ -268,4 +268,4 @@ shown in <xref linkend="sec-changing-config"/>.)</para>
 
 
 
-</chapter>
\ No newline at end of file
+</chapter>
diff --git a/doc/manual/manual.xml b/doc/manual/manual.xml
index 65c2a81bb90..55adf3e647d 100644
--- a/doc/manual/manual.xml
+++ b/doc/manual/manual.xml
@@ -40,8 +40,9 @@
   
 
   <xi:include href="installation.xml" />
+  <xi:include href="userconfiguration.xml" />
   <xi:include href="troubleshooting.xml" />
   <xi:include href="development.xml" />
   <xi:include href="options-db.xml" />
 
-</book>
\ No newline at end of file
+</book>
diff --git a/doc/manual/userconfiguration.xml b/doc/manual/userconfiguration.xml
new file mode 100644
index 00000000000..6e20afec9ab
--- /dev/null
+++ b/doc/manual/userconfiguration.xml
@@ -0,0 +1,48 @@
+<chapter xmlns="http://docbook.org/ns/docbook"
+         xmlns:xlink="http://www.w3.org/1999/xlink">
+
+<title>Configuration in home directory</title>
+
+
+<!--===============================================================-->
+
+<section>
+<title>Compiz Fusion</title>
+<para>
+	Compiz Fusion is just a set of plugins fr Compiz. Your best interest is to have 
+	them found both by Compiz and by Compiz Configuration Settings (also in Compiz Fusion
+	distribution). By default they look in Compiz installation path and in home directory.
+	You do not need to track /nix/store manually - everything is already in 
+	/var/run/current-system/sw/share.
+
+	<orderedlist>
+	<listitem><para><filename>$HOME/.compiz/plugins</filename> 
+	should contain plugins you want to load. All the installed 
+	plugins are available in 
+	<filename>/var/run/current-system/sw/share/compiz-plugins/compiz/</filename>,
+	so you can use symlinks to this directory.
+	</para></listitem>
+
+	<listitem><para><filename>$HOME/.compiz/metadata</filename> 
+	should contain metadata (definition of configuration options) for plugins 
+	you want to load. All the installed metadata is available in 
+	<filename>/var/run/current-system/sw/share/compiz/</filename>,
+	so you can use symlinks to this directory.
+	</para></listitem>
+
+	<listitem><para>
+	Probably a way to load <literal>GConf</literal> configuration backend by default 
+	should be found, but if you run <literal>Compiz</literal> with 
+	<literal>GConf</literal> configuration (default for <literal>X server</literal> job
+	for now), you have to link 
+	<filename>/var/run/current-system/sw/share/compizconfig/backends/libgconf.so</filename>
+	into <filename>$HOME/.compizconfig/backends</filename> directory.
+	</para></listitem>
+
+	</orderedlist>
+
+	Now you can launch <literal>ccsm</literal> and configure everything.
+</para>
+</section>
+
+</chapter>