From 543bb91ac9564fbfd99cdf986cca15ac6a1a354b Mon Sep 17 00:00:00 2001
From: Kelvin Sherlock <ksherlock@gmail.com>
Date: Thu, 29 Dec 2016 16:12:23 -0500
Subject: [PATCH] update man pages.

---
 wdclib.1 | 18 +++++++++---------
 wdcln.1  |  8 ++++++++
 wdcobj.1 |  6 +++---
 wdcsym.1 |  3 ++-
 4 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/wdclib.1 b/wdclib.1
index b3ff777..5d3c1c8 100644
--- a/wdclib.1
+++ b/wdclib.1
@@ -40,7 +40,7 @@ are given, the default is to assume option
 .Fl A .
 To create a library from a set of object files, use the command:
 .Pp
-.Dl WDCLIB -A MYLIB.LIB LIBSRC1.OBJ LIBSRC2.OBJ LIBSRC3.OBJ
+.Dl Nm Fl A Ar MYLIB.LIB Ar LIBSRC1.OBJ Ar LIBSRC2.OBJ Ar LIBSRC3.OBJ
 .Pp
 which will create a library file called 
 .Ar MYLIB.LIB
@@ -57,7 +57,7 @@ with new ones.
 The following example shows how to remove the modules associated with an
 object file.
 .Pp
-.Dl WDCLIB -D MYLIB.LIB LIBSRC3.OBJ
+.Dl Nm Fl D Ar MYLIB.LIB Ar LIBSRC3.OBJ
 .Pp
 All of the modules associated with the file
 .Ar LIBSRC3.OBJ
@@ -65,8 +65,8 @@ will be deleted from the library.
 .Pp
 This example shows how to replace a file in a library.
 .Pp
-.Dl WDCLIB -D MYLIB.LIB LIBSRC2.OBJ
-.Dl WDCLIB -A MYLIB.LIB LIBSRC2.OBJ
+.Dl Nm Fl D Ar MYLIB.LIB Ar LIBSRC2.OBJ
+.Dl Nm Fl A Ar MYLIB.LIB Ar LIBSRC2.OBJ
 .Pp
 The modules associated with 
 .Ar LIBSRC2.OBJ
@@ -84,8 +84,8 @@ For example, these commands add all files with a
 .Ar .OBJ
 extension to the library.
 .Pp
-.Dl DIR *.OBJ > OBJLIST
-.Dl WDCLIB -A MYLIB.LIB -F OBJLIST
+.Dl Nm DIR Ar *.OBJ > Pa OBJLIST
+.Dl Nm Fl A Ar MYLIB.LIB Fl F Ar OBJLIST
 .It Fl L
 This option causes a list of the files in the library to be printed.
 Associated with each file name is a file number. This number will also
@@ -93,11 +93,11 @@ appear in the symbol listing which indicates which file contains the
 module that defines that symbol. This command will display the names
 of all files added to a library.
 .Pp
-.Dl WDCLIB -L MYLIB.LIB
+.Dl Nm  Fl L Ar MYLIB.LIB
 .Pp
 This command adds two files to the library.
 .Pp
-.Dl WDCLIB -AL MYLIB.LIB LIBSRC1.OBJ LIBSRC2.OBJ
+.Dl Nm Fl AL Ar MYLIB.LIB Ar LIBSRC1.OBJ Ar LIBSRC2.OBJ
 .Pp
 After the files are added, a list of all the files in the library will
 be printed.
@@ -113,7 +113,7 @@ name. After extraction, the modules in the library are deleted.
 .Pp
 The following example extracts two files from a library.
 .Pp
-.Dl WDCLIB -X MYLIB.LIB LIBSRC3.OBJ LIBSRC1.OBJ
+.Dl Nm Fl X Ar MYLIB.LIB Ar LIBSRC3.OBJ Ar LIBSRC1.OBJ
 .El
 .Sh SEE ALSO
 .Xr wdc02as 1 ,
diff --git a/wdcln.1 b/wdcln.1
index 77d09a8..8626541 100644
--- a/wdcln.1
+++ b/wdcln.1
@@ -383,6 +383,14 @@ are:
 and
 .Fl Z Ns Ar data Ns = .
 .El
+.Sh ENVIRONMENT
+The following environment variables affect the execution of
+.Nm :
+.Bl -tag -width indent
+.It Ev WDC_LIB
+A semi-colon separated list of directories to search if an
+input file cannot be found in the current directory.
+.El
 .Sh SEE ALSO
 .Xr wdc02as 1 ,
 .Xr wdc02cc 1 ,
diff --git a/wdcobj.1 b/wdcobj.1
index 6fbb49e..9701b2a 100644
--- a/wdcobj.1
+++ b/wdcobj.1
@@ -39,7 +39,7 @@ data.
 To examine the individual records in an object module but without seeing all
 of the data bytes, use the command:
 .Pp
-.Dl WDCOBJ -L PROG.OBJ
+.Dl Nm Fl L Ar PROG.OBJ
 .Pp
 .It Fl R
 This option causes display of each of the individual records in the object
@@ -47,7 +47,7 @@ module. Information about the object file format is available on request.
 .Pp
 To examine the individual records in an object module, use the command:
 .Pp
-.Dl WDCOBJ -R PROG.OBJ
+.Dl Nm Fl R Ar PROG.OBJ
 .Pp
 .It Fl S
 Normally, when
@@ -61,7 +61,7 @@ The following command displays just the section names and types of all
 modules in the file 
 .Ar PROG.OBJ :
 .Pp
-.Dl WDCOBJ -S PROG.OBJ
+.Dl Nm Fl S Ar PROG.OBJ
 .El
 .Sh SEE ALSO
 .Xr wdc02as 1 ,
diff --git a/wdcsym.1 b/wdcsym.1
index 03dd8d5..be6954b 100644
--- a/wdcsym.1
+++ b/wdcsym.1
@@ -43,7 +43,8 @@ file. Normally, the global symbol records are suppressed.
 The following command displays the section information, and symbols for all
 sections and the global symbols as well.
 .Pp
-.Dl WDCSYM -S PROG.SYM
+.Dl Nm Fl S Ar PROG.SYM
+.Pp
 .El
 The basic structure of the file is outlined as follows:
 .Bl -inset -compact -offset indent