mention that obconf older than 2.0 is no good.

[chaz/openbox] / doc / openbox.1.sgml

diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml
index 39faee09bb91d164c6a350a56bcf2f96ab1dea79..31f726f67002c682f08aed65c5354bb0326a06a6 100644 (file)
--- a/doc/openbox.1.sgml
+++ b/doc/openbox.1.sgml
@@ -19,8 +19,6 @@ manpage.1: manpage.sgml
   <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
   <!ENTITY dhucpackage "<refentrytitle>OPENBOX</refentrytitle>">
   <!ENTITY dhpackage   "openbox">
-
-  <!ENTITY gnu         "<acronym>GNU</acronym>">
 ]>
 
 <refentry>
@@ -43,10 +41,10 @@ manpage.1: manpage.sgml
       <arg><option>--replace</option></arg>
       <arg><option>--reconfigure</option></arg>
       <arg><option>--sm-disable</option></arg>
-      <arg><option>--config <replaceable>TYPE</replaceable></option></arg>
       <arg><option>--sync</option></arg>
       <arg><option>--debug</option></arg>
       <arg><option>--debug-focus</option></arg>
+      <arg><option>--debug-xinerama</option></arg>
     </cmdsynopsis>
   </refsynopsisdiv>
   <refsect1>
@@ -82,11 +80,21 @@ manpage.1: manpage.sgml
 
     <para>You can use the <command>obconf</command> tool to configure Openbox
       easily with a graphical interface, however more in-depth configuration
-      is possible by editing the configuration files by hand. The default
-      configuration file is installed in @confdir@/xdg/openbox/rc.xml, and the
-      user configuration is placed in ~/.config/openbox/rc.xml. You can copy
-      the default configuration to ~/.config/openbox and edit it to your
-      liking.</para>
+      is possible by editing the configuration files by hand. Please note that
+      <command>obconf</command> older than version 2.0 may not work at all
+      for you.</para>
+
+    <para>The default configuration files are installed in
+      configdir@/openbox/, and the user configuration is placed in
+      ~/.config/openbox/. You can copy the default configuration
+      to ~/.config/openbox and edit it to your liking.</para>
+
+    <para>There are 3 default configuration files, <literal>rc.xml</literal>,
+      <literal>rc-gnome.xml</literal>, and <literal>rc-kde.xml</literal>. The
+      rc-gnome.xml is used when you run
+      <command>openbox-gnome-session</command> and the rc-kde.xml is used when
+      you run <command>openbox-kde-session</command>. The configuration
+      files should be named the same in ~/.config/openbox/.</para>
 
   </refsect1>
   <refsect1>
@@ -125,12 +133,6 @@ manpage.1: manpage.sgml
           <para>Do not connect to the session manager.</para>
         </listitem>
       </varlistentry>
-      <varlistentry>
-        <term><option>--config<replaceable>TYPE</replaceable></option></term>
-        <listitem>
-          <para>Specify the configuration profile to use.</para>
-        </listitem>
-      </varlistentry>
       <varlistentry>
         <term><option>--sync</option></term>
         <listitem>
@@ -149,6 +151,14 @@ manpage.1: manpage.sgml
           <para>Display debugging output for focus handling.</para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term><option>--debug-xinerama</option></term>
+        <listitem>
+          <para>Split the display into two fake xinerama regions, if
+           xinerama is not already enabled. This is for debugging
+           xinerama support.</para>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </refsect1>
   <refsect1>
@@ -158,10 +168,10 @@ manpage.1: manpage.sgml
       </para>
 
     <para>The program's full documentation is available on the website:
-      <olink>http://openbox.org/</olink></para>
+      <literal>http://openbox.org/</literal></para>
 
-    <para>Please report bugs to: <olink>http://bugzilla.icculus.org/</olink>
-      </para>
+    <para>Please report bugs to: <literal>http://bugzilla.icculus.org/
+      </literal></para>
   </refsect1>
 </refentry>