Index: en/usage.xml
===================================================================
--- en/usage.xml	(revision 21785)
+++ en/usage.xml	(working copy)
@@ -101,7 +101,86 @@
 </para>
 </sect1>
 
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
 
+
+<sect1 id="conf">
+<title>Configuration Files</title>
+<para>
+<application>MPlayer</application> can use information stored in 3 types of configuration file.
+<itemizedlist>
+  <listitem><para>System</para></listitem>
+  <listitem><para>User</para></listitem>
+  <listitem><para>File Specific</para></listitem>
+</itemizedlist>
+</para>
+<para>The system wide configuration file <filename>mplayer.conf</filename>,
+ or for <application>MEncoder</application> <filename>mencoder.conf</filename>, 
+  is in your configuration directory
+ (e.g. /etc/ mplayer or /usr/local/etc/mplayer).
+ As part of the install an example <filename>mplayer.conf</filename> is created with a number
+  of useful options well documented but commented out.
+</para>
+<para>The user file is called simply <filename>config</filename> 
+or for <application>MEncoder</application> <filename>mencoder.conf</filename>, and is located in ~/ .mplayer
+This will not exist in a default installation, but can be added by the user.
+</para>
+<para>If you wish to have a configuration file for a file called <filename>movie.avi</filename>, 
+create a file named <filename>movie.avi.conf</filename> with the file-specific options in it 
+and put it in ~/.mplayer/. You can also put the configuration file in the same directory
+ as the file to be played, as long as you give the −use-filedir-conf option 
+ (either on the command line or in your global config file).
+</para>
+<para>The options will be read in the following order with the later over ruling earlier options
+</para>
+<para>	System ==> User ==> File ==> Command line
+</para>
+<formalpara><title>Syntax</title>
+<para> Option=Value </para></formalpara>
+<para> Where Option is any of the command line options, without the leading '-'. 
+The value will vary with each option, but must exist. Where normaly no value is used
+'=yes' or '=1' or '=true' can be used.  ('=no' or '=0' or '=false' to disable)
+</para>
+<para>Everything after a '#' is considered a comment</para>
+<para>
+Examples:
+<screen>
+# mplayer.conf
+# Use Matrox driver by default.
+vo=xmga
+# I love practicing handstands while watching videos.
+flip=yes
+# Decode/encode multiple files from PNG,
+# start with mf://filemask
+mf=type=png:fps=25
+# Eerie negative images are cool.
+vf=eq2=1.0:-0.8</screen>
+<screen>
+#mencoder.conf
+# Make MEncoder output to a default filename.
+o=encoded.avi
+# The next 4 lines allow mencoder tv:// to start capturing immediately.
+oac=pcm=yes
+ovc=lavc=yes
+lavcopts=vcodec=mjpeg
+tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000
+# more complex default encoding option set
+lavcopts=vcodec=mpeg4:autoaspect=1
+lameopts=aq=2:vbr=4
+ovc=lavc=1
+oac=lavc=1
+passlogfile=pass1stats.log
+noautoexpand=1
+subfont-autoscale=3
+subfont-osd-scale=6
+subfont-text-scale=4
+subalign=2
+subpos=96
+spuaa=20
+</screen>
+</para>
+</sect1>
+
 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->