--- ogle.old/doc/man/oglerc.5.in
+++ ogle/doc/man/oglerc.5.in
@@ -3,22 +3,23 @@
 .SH NAME
 oglerc \- ogle configuration file
 .SH DESCRIPTION
-The oglerc file is a configuration file for ogle.
-There is one system-wide file in @CONFIG_FILE@ (${prefix}/share/ogle/oglerc) and an optional user file $HOME/.oglerc which overrides system settings.
-.br
-The file is written in XML, with a DTD in an external file.
-.br
-Look in the system-wide oglerc for available settings.
-.br
-The configuration is divided into four main groups:
+An oglerc file is a configuration file that specifies "ogle"
+settings. There\'s one copy stored at:
+.PP
+@CONFIG_FILE@
+.PP
+The preceding file specifies system-wide "ogle" settings.
+"ogle" looks for a second (per-user) copy at $HOME/.oglerc.
+If the second file exists, it overrides the system-wide settings.
+
+The oglerc files are written in XML, with a DTD in an external file.
+The configuration settings are divided into four main groups:
 dvd, audio, video and user_interface.
 
 These are the available tags:
 
 <ogle_conf>
 
-
-
   <dvd>
     <nav>
       <defaults>
@@ -51,8 +52,6 @@
 
 <path> is the path to your DVD-ROM drive
 
-
-
   <audio>
     <device>
       <driver>oss</driver>
@@ -223,22 +222,22 @@
    <height>900</height>
  </geometry>
 
-The geometry should be the size of your tv in millimeters, the exact
+The geometry should be the size of your tv in millimeters. The exact
 size isn't that important, as long as the proportions are correct.
-1600/900 == 16/9 == widescreen tv.
-For a normal tv you should use something like 400/300.
+If you don't know the dimensions, use 1600/900 for a widescreen TV
+or 400/300 for a conventional TV.
 
  <resolution>
    <horizontal_pixels>720</horizontal_pixels>
    <vertical_pixels>576</vertical_pixels>
  </resolution>
 
-This tells us to only use 720x576 pixels in fullscreen and not the entire
+This tells us to use only 720x576 pixels in fullscreen and not the entire
 space available on your monitor/desktop.
 
 <initial_state> contains information about the state of the video window
-at start up. If <fullscreen> is set to yes, the video will start in fullscreen
-mode (default is no).
+at start up. If <fullscreen> is set to yes, the video will start in
+fullscreen mode (default is no).
 
   <user_interface>
     <bookmarks>
@@ -349,14 +348,21 @@
 of seconds to skip. The default value is 10 seconds. Entering '30' and then pressing Next(PageDown) will skip 30 seconds forwards. The Skip actions will use the last value entered for any following skips even if no number is entered.
 To get back to the default value, enter 0 and the skip.
 .br
-The Audio- and SubtitleStreamChange actions use the number argument to switch directly to that stream, instead of cycling through the available streams.
+The Audio- and SubtitleStreamChange actions use the number argument to
+switch directly to that stream, instead of cycling through the
+available streams.
 .br
 
-In addition to the above the arrow buttons and mouse can be used to move around in the DVD menues. Return, the keypad enter and left mouse button may be used to activate a DVD button.
+In addition to the above, the arrow buttons and mouse can be used to
+move around in the DVD menus. The Return key, the keypad Enter key,
+and the left mouse button may be used to activate a DVD button.
 
 Cropping the picture can be done by pressing the middle mouse button
-at the upper left corner of the crop area and dragging it to the lower right corner and then release the button.
-To uncrop press and release the middle mouse button without dragging it around.
+at the upper left corner of the crop area and dragging it to the lower
+right corner, then releasing the button.
+
+To uncrop, press and release the middle mouse button without dragging it
+around.
 
 .SH FILES
 $HOME/.oglerc
@@ -378,4 +384,3 @@
 .SH COPYRIGHT
 This is free software; see the source for copying conditions.  There is NO
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-