Clean up mdoc:

* Apply sentence breaking style.
* Add missing periods to the ends of sentences.
* Replace bogus use of Nm with Em and Pa as appropriate.
* Rename the EXAMPLE section to EXAMPLES.
* Tidy up wording and fix spelling errors.
* Use an Rs -> Re block instead of Xr for the SourceForge URL.
* Correct the SourceForge URL.
* Improve the compilation instructions for the SourceForge utilities.

Approved by:    n_hibma

1 files changed, 45 insertions, 33 deletions

diff --git a/share/man/man4/urio.4 b/share/man/man4/urio.4
index d0b3d99..49cde44 100644
--- a/share/man/man4/urio.4
+++ b/share/man/man4/urio.4
@@ -41,55 +41,67 @@
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for the Rio500 MP3 player from Diamond MultiMedia which attaches to the USB port. The
+driver provides support for the Rio500 MP3 player from Diamond MultiMedia
+which attaches to the USB port.
+The
 .Nm
 device must be configured in the kernel, along with
-.Nm usb
-and one of the controllers:
-.Nm uhci
+.Em usb
+and one of the
+.Em uhci
 or
-.Nm ohci
+.Em ohci
+controllers.
 .Pp
-The 
-.Nm /dev/urio0
-device can subsequentlty be used by the Rio500 userland applications.
+Subsequently, the
+.Pa /dev/urio0
+device can be used by the Rio500 userland applications.
 .Sh FILES
 .Bl -tag -width /dev/ums0 -compact
 .It Pa /dev/urio0
 blocking device node 
-.Sh EXAMPLE
+.Sh EXAMPLES
+The following line in the kernel configuration file adds the
+.Nm
+driver to the kernel:
 .Dl device urio0
 .Pp
-Adds the
-.Nm 
-driver to the kernel. Create the device node in the /dev directory:
-.Pp
+The following commands create the device node in the
+.Pa /dev
+directory:
 .Dl cd /dev
 .Dl sh MAKEDEV urio0
 .Pp
-And finally
-.Pp
-.Dl rio_add_song /local/MP3/TraceyChapman/02-Fast-Car.mp3
-.Pp
-Will download a song over the 
-.Nm USB
-connection into your Rio500.
-.Pp
+Finally, to download a song over the
+.Tn USB
+connection into the Rio500 using the
+.Xr rio_add_song 1
+utility (see the
+.Sx SEE ALSO
+section):
+.Dl rio_add_song /usr/local/MP3/TraceyChapman/02-Fast-Car.mp3
 .Sh SEE ALSO
 .Xr ohci 4 ,
 .Xr uhci 4 ,
-.Xr usb 4 ,
-.Xr http://rio500.sourceforge.org WWW
-.Pp
-The rio500 tools from the SourceForge are the actual userland tools
-you use to download, format or rename songs on your players. When
-compiling you must make sure that 
-.Nm /usr/include/dev/usb/rio_usb.h
-is in your include path, and that you configure the
-.Nm /dev/urio0
-as the device with following configure:
+.Xr usb 4
+.Rs
+.%T The Rio 500 SourceForge Project Web Page
+.%O http://rio500.sourceforge.net/
+.Re
 .Pp
-CFLAGS="-I/usr/include/dev/usb" ./configure --with-devicepath='/dev' --with-deviceentry='urio0'
+The Rio500 tools from SourceForge
+are the actual userland tools used to download,
+format or rename songs on players.
+When compiling these tools,
+the following pre-build configuration command will ensure that
+.Pa rio_usb.h
+is available in the include path
+and that the device used is
+.Pa /dev/urio0 :
+.Bd -literal -offset indent
+CFLAGS="-I/usr/include/dev/usb" ./configure \\
+    --with-devicepath='/dev' --with-deviceentry='urio0'
+.Ed
 .\".Sh HISTORY
 .Sh AUTHORS
 The
@@ -97,7 +109,7 @@ The
 driver was written by
 .An Iwasa Kazmi Aq kzmi@ca2.so-net.ne.jp
 for
-.Fx
+.Fx .
 .Pp
 This manual page was written by
 .An Dirk-Willem van Gulik Aq dirkx@webweaving.org