mdoc(7) police: polish revision 1.17 changes.

share/man/man8/picobsd.8

@@ -249,43 +249,44 @@ with
 configurations:
 .Bl -bullet
 .It
-we can pass build options to those Makefile's which understand
+We can pass build options to those makefiles which understand
 that, in order to reduce the size of the programs.
 This is achieved with a line of the form
-.Bd -literal -offset indent
-buildopts -DNOPAM -DRELEASE_CRUNCH ...
-.Ed
+.Pp
+.Dl "buildopts -DNOPAM -DRELEASE_CRUNCH ..."
 .It
 When providing the list of directories where source files are, it
 is convenient to list the following entry first:
-.Bd -literal
-srcdirs /usr/src/release/picobsd/tinyware
-.Ed
+.Pp
+.Dl "srcdirs /usr/src/release/picobsd/tinyware"
+.Pp
 so that
-.Nm
--specific versions of the programs will be found there.
+.Nm Ns -specific
+versions of the programs will be found there.
 .It
 The string
-.Pa @__CWD__@
+.Dq Li @__CWD__@
 is replaced with the full pathname of the directory where the
 .Nm
 configuration resides (i.e. the one where we find
 .Pa PICOBSD , crunch.conf ,
 and so on).
 This can be useful to refer source code that resides within a
-configuration, e.g.
-.Bd -literal -offset indent
-srcdirs @__CWD__@/src
-.Ed
+configuration, e.g.\&
+.Pp
+.Dl "srcdirs @__CWD__@/src"
 .El
 .It Pa config
 Shell variables, sourced by the
 .Nm
 script (optional).
 The most important variables here are:
-.Bl -tag -width MY_DEVS
+.Bl -tag -width ".Va MY_DEVS"
 .It Va MY_DEVS
-(not used in -CURRENT where we have DEVFS).
+(Not used in
+.Fx 5.0
+where we have
+.Xr devfs 5 ) .
 Should be set to the list of devices to be created in the
 .Pa /dev
 directory of the image (it is really the argument passed to
@@ -313,12 +314,11 @@ Using a large image size per se does not waste RAM at runtime,
 because only the files that are actually loaded from the image
 contribute to the memory usage.
 .It Va import_files
-Contains a list of files to be imported in the floppy_tree.
+Contains a list of files to be imported in the floppy tree.
 Absolute names refer to the standard filesystem, relative
 names refer to the root of the source tree being used
-(i.e.
-.Va SRC_PATH/..
-).
+(i.e.\&
+.Va SRC_PATH/.. ) .
 You can normally use this option if you want to import
 files such as shared libraries, or databases, without
 having to replicate them first in your configuration
@@ -326,7 +326,6 @@ under the
 .Pa floppy.tree/
 directory.
 .El
-.Pp
 .It Pa floppy.tree.exclude
 List of files from the standard floppy tree which
 we do not want to be copied (optional).
@@ -673,8 +672,7 @@ driver installed.
 The build process must be run as
 .Dq root
 because of the need of running
-.Xr mdconfig 8 /
-.Xr vnconfig 8
+.Xr mdconfig 8 Ns / Ns Xr vnconfig 8
 and
 .Xr mount 8 .
 .Pp