remove in-text macros

The in-text macros are a problem when maintaining the text.
While removing i noticed several problems with missing
definitions this is fixed also.

46 files changed, 105 insertions, 180 deletions

diff --git a/man/XtAddCallback.man b/man/XtAddCallback.man
index 5dc07c0..dc74c00 100644
--- a/man/XtAddCallback.man
+++ b/man/XtAddCallback.man
@@ -81,14 +81,13 @@ Specifies the callback procedure.
 .IP \fIcallbacks\fP 1i
 Specifies the null-terminated list of callback procedures and corresponding
 client data.
-.ds Cn \ to which the procedure is to be appended or deleted
 .IP \fIcallback_name\fP 1i
-Specifies the callback list\*(Cn.
-.ds Cd it is invoked by XtCallbacks or NULL, \
-or the client data to match on the registered callback procedures
+Specifies the callback list to which the procedure is to be appended or
+deleted.
 .IP \fIclient_data\fP 1i
 Specifies the argument that is to be passed to the specified procedure
-when \*(Cd.
+when it is invoked by XtCallbacks or NULL,
+or the client data to match on the registered callback procedures.
 .IP \fIw\fP 1i
 Specifies the widget.
 .SH DESCRIPTION
diff --git a/man/XtAddEventHandler.man b/man/XtAddEventHandler.man
index 9ab8ce5..ec334aa 100644
--- a/man/XtAddEventHandler.man
+++ b/man/XtAddEventHandler.man
@@ -87,13 +87,11 @@ typedef enum { XtListHead, XtListTail } XtListPosition;
 .SH ARGUMENTS
 .IP \fIclient_data\fP 1i
 Specifies additional data to be passed to the client's event handler.
-.ds Em to call or unregister this procedure
 .IP \fIevent_mask\fP 1i
-Specifies the event mask for which \*(Em.
-.ds Nm called or removed
+Specifies the event mask for which to call or unregister this procedure.
 .IP \fInonmaskable\fP 1i
 Specifies a Boolean value that indicates whether this procedure should be
-\*(Nm on the nonmaskable events ( 
+called or removed on the nonmaskable events (
 .BR GraphicsExpose ,
 .BR NoExpose ,
 .BR SelectionClear ,
@@ -102,12 +100,10 @@ Specifies a Boolean value that indicates whether this procedure should be
 .BR ClientMessage ,
 and
 .BR MappingNotify ).
-.ds Pr \ to be added or removed
 .IP \fIproc\fP 1i
-Specifies the procedure that is\*(Pr.
-.ds Wi for which this event handler is being registered
+Specifies the procedure that is to be added or removed.
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget for which this event handler is being registered.
 .IP \fIposition\fP 1i
 Specifies when the event handler is to be called relative to other
 previously registered handlers.
diff --git a/man/XtAddGrab.man b/man/XtAddGrab.man
index 550ba57..987a80b 100644
--- a/man/XtAddGrab.man
+++ b/man/XtAddGrab.man
@@ -72,9 +72,8 @@ or also to previous widgets in the cascade.
 .IP \fIspring_loaded\fP 1i
 Specifies whether this widget was popped up because the user pressed
 a pointer button.
-.ds Wi to add to or remove from the modal cascade
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget to add to or remove from the modal cascade.
 .SH DESCRIPTION
 The
 .BR XtAddGrab
diff --git a/man/XtAllocateGC.man b/man/XtAllocateGC.man
index c54863f..0590739 100644
--- a/man/XtAllocateGC.man
+++ b/man/XtAllocateGC.man
@@ -66,9 +66,8 @@ XtGCMask \fIunused_mask\fP);
 .SH ARGUMENTS
 .IP \fIvalues\fP 1i
 Specifies the actual values for this GC.
-.ds Vm fields of the values are specified
 .IP \fIvalue_mask\fP 1i
-Specifies which \*(Vm.
+Specifies which fields of the values are specified.
 .IP \fIw\fP 1i
 Specifies the widget.
 .IP \fIdepth\fP 1i
diff --git a/man/XtAppAddInput.man b/man/XtAppAddInput.man
index 65adf9f..89324b3 100644
--- a/man/XtAppAddInput.man
+++ b/man/XtAppAddInput.man
@@ -67,13 +67,11 @@ XtPointer \fIcondition\fP, XtInputCallbackProc \fIproc\fP, XtPointer
 .HP
 void XtRemoveInput(XtInputId \fIid\fP);
 .SH ARGUMENTS
-.ds Co that identifies the application
 .IP \fIapp_context\fP 1i
-Specifies the application context \*(Co.
-.ds Cd input is available
+Specifies the application context that identifies the application.
 .IP \fIclient_data\fP 1i
 Specifies the argument that is to be passed to the specified procedure
-when \*(Cd.
+when input is available.
 .IP \fIcondition\fP 1i
 Specifies the mask that indicates a read, write, or exception condition
 or some operating system dependent condition.
@@ -81,9 +79,8 @@ or some operating system dependent condition.
 Specifies the ID returned from the corresponding
 .BR XtAppAddInput
 call.
-.ds Pr \ to be called when input is available
 .IP \fIproc\fP 1i
-Specifies the procedure that is\*(Pr.
+Specifies the procedure that is to be called when input is available.
 .IP \fIsource\fP 1i
 Specifies the source file descriptor on a UNIX-based system
 or other operating system dependent device specification.
diff --git a/man/XtAppAddTimeOut.man b/man/XtAppAddTimeOut.man
index 57fce92..ddfb6b2 100644
--- a/man/XtAppAddTimeOut.man
+++ b/man/XtAppAddTimeOut.man
@@ -66,17 +66,15 @@ XtIntervalId XtAppAddTimeOut(XtAppContext \fIapp_context\fP, unsigned long
 .HP
 void XtRemoveTimeOut(XtIntervalId \fItimer\fP);
 .SH ARGUMENTS
-.ds Co for which the timer is to be set
 .IP \fIapp_context\fP 1i
-Specifies the application context \*(Co.
+Specifies the application context for which the timer is to be set.
 .IP \fIclient_data\fP 1i
 Specifies the argument that is to be passed to the specified procedure
 when handling the callback.
 .IP \fIinterval\fP 1i
 Specifies the time interval in milliseconds.
-.ds Pr \ to be called when time expires
 .IP \fIproc\fP 1i
-Specifies the procedure that is\*(Pr.
+Specifies the procedure that is to be called when time expires.
 .IP \fItimer\fP 1i
 Specifies the ID for the timeout request to be destroyed.
 .SH DESCRIPTION
diff --git a/man/XtAppAddWorkProc.man b/man/XtAppAddWorkProc.man
index 7791b92..fbd4acf 100644
--- a/man/XtAppAddWorkProc.man
+++ b/man/XtAppAddWorkProc.man
@@ -66,13 +66,11 @@ XtWorkProcId XtAppAddWorkProc(XtAppContext \fIapp_context\fP, XtWorkProc
 .HP
 void XtRemoveWorkProc(XtWorkProcId \fIid\fP);
 .SH ARGUMENTS
-.ds Co that identifies the application
 .IP \fIapp_context\fP 1i
-Specifies the application context \*(Co.
-.ds Cd it is called
+Specifies the application context that identifies the application.
 .IP \fIclient_data\fP 1i
 Specifies the argument that is to be passed to the specified procedure
-when \*(Cd.
+when it is called.
 .IP \fIproc\fP 1i
 Specifies the procedure that is to be called.
 .IP \fIid\fP 1i
diff --git a/man/XtAppCreateShell.man b/man/XtAppCreateShell.man
index 903b103..f1fc6de 100644
--- a/man/XtAppCreateShell.man
+++ b/man/XtAppCreateShell.man
@@ -70,21 +70,19 @@ Widget XtVaAppCreateShell(String \fIapplication_name\fP, String
 .SH ARGUMENTS
 .IP \fIapplication_name\fP 1i
 Specifies the name of the application instance.
-.ds Ac , which usually is the generic name for all instances of this application
 .IP \fIapplication_class\fP 1i
-Specifies the class name of this application\*(Ac.
-.ds Wc \ that the application top-level widget should be
+Specifies the class name of this application, which 
+usually is the generic name for all instances of this application.
 .IP \fIwidget_class\fP 1i
-Specifies the widget class\*(Wc.
-.ds Di \ from which to get the resources
+Specifies the widget class that the application top-level widget should be.
 .IP \fIdisplay\fP 1i
-Specifies the display\*(Di.
+Specifies the display from which to get the resources.
 .IP \fIargs\fP 1i
-Specifies the argument list\*(Di.
+Specifies the argument list from which to get the resources.
 .IP \fInum_args\fP 1i
 Specifies the number of arguments in the argument list.
 .IP \fI...\fP 1i
-Specifies the variable argument list\*(Di.
+Specifies the variable argument list from which to get the resources.
 .SH DESCRIPTION
 The
 .BR XtAppCreateShell
diff --git a/man/XtAppError.man b/man/XtAppError.man
index fb5bf74..55a1145 100644
--- a/man/XtAppError.man
+++ b/man/XtAppError.man
@@ -76,13 +76,11 @@ void XtAppWarning(XtAppContext \fIapp_context\fP, String \fImessage\fP);
 Specifies the application context.
 .IP \fImessage\fP 1i
 Specifies the nonfatal error message that is to be reported.
-.ds Ha fatal error procedure, which should not return, \
-or the nonfatal error procedure, which usually returns
 .IP \fIhandler\fP 1i
-Specifies the new \*(Ha.
-.ds Me reported
+Specifies the new fatal error procedure, which should not return, 
+or the nonfatal error procedure, which usually returns.
 .IP \fImessage\fP 1i
-Specifies the message that is to be \*(Me.
+Specifies the message that is to be reported.
 .SH DESCRIPTION
 The
 .BR XtAppError
diff --git a/man/XtAppErrorMsg.man b/man/XtAppErrorMsg.man
index 3a794d5..55fd8eb 100644
--- a/man/XtAppErrorMsg.man
+++ b/man/XtAppErrorMsg.man
@@ -78,19 +78,17 @@ Cardinal *\fInum_params\fP);
 .SH ARGUMENTS
 .IP \fIapp_context\fP 1i
 Specifies the application context.
-.ds Cl
 .IP \fIclass\fP 1i
-Specifies the resource class\*(Cl.
+Specifies the resource class of the error message.
 .IP \fIdefault\fP 1i
 Specifies the default message to use.
 .IP \fIname\fP 1i
 Specifies the general kind of error.
 .IP \fItype\fP 1i
 Specifies the detailed name of the error.
-.ds Mh fatal error procedure, which should not return \
-or the nonfatal error procedure, which usually returns
 .IP \fImsg_handler\fP 1i
-Specifies the new \*(Mh.
+Specifies the new fatal error procedure, which should not return \
+or the nonfatal error procedure, which usually returns.
 .IP \fInum_params\fP 1i
 Specifies the number of values in the parameter list.
 .IP \fIparams\fP 1i
diff --git a/man/XtAppGetErrorDatabase.man b/man/XtAppGetErrorDatabase.man
index d8af9c0..184d7a1 100644
--- a/man/XtAppGetErrorDatabase.man
+++ b/man/XtAppGetErrorDatabase.man
@@ -71,9 +71,8 @@ void XtAppGetErrorDatabaseText(XtAppContext \fIapp_context\fP, char
 Specifies the application context.
 .IP \fIbuffer_return\fP 1i
 Specifies the buffer into which the error message is to be returned.
-.ds Cl \ of the error message
 .IP \fIclass\fP 1i
-Specifies the resource class\*(Cl.
+Specifies the resource class of the error message.
 .IP \fIdatabase\fP 1i
 Specifies the name of the alternative database that is to be used
 or NULL if the application's database is to be used.
diff --git a/man/XtAppInitialize.man b/man/XtAppInitialize.man
index f69ba26..9de882a 100644
--- a/man/XtAppInitialize.man
+++ b/man/XtAppInitialize.man
@@ -72,9 +72,8 @@ Widget XtVaAppInitialize(XtAppContext* \fIapp_context_return\fP, String
 .SH ARGUMENTS
 .IP \fIapp_context_return\fP 1i
 Specifies the application context.
-.ds Ac , which usually is the generic name for all instances of this application
 .IP \fIapplication_class\fP 1i
-Specifies the class name of this application\*(Ac.
+Specifies the class name of this application, which usually is the generic name for all instances of this application.
 .IP \fIoptions\fP 1i
 Specifies how to parse the command line for any application-specific resources.
 The options argument is passed as a parameter to
diff --git a/man/XtAppNextEvent.man b/man/XtAppNextEvent.man
index d244e4f..7b5414e 100644
--- a/man/XtAppNextEvent.man
+++ b/man/XtAppNextEvent.man
@@ -77,9 +77,8 @@ Boolean XtDispatchEvent(XEvent *\fIevent\fP);
 .HP
 void XtAppMainLoop(XtAppContext \fIapp_context\fP);
 .SH ARGUMENTS
-.ds Co that identifies the application
 .IP \fIapp_context\fP 1i
-Specifies the application context \*(Co.
+Specifies the application context that identifies the application.
 .IP \fIevent\fP 1i
 Specifies a pointer to the event structure that is to be dispatched
 to the appropriate event handler.
diff --git a/man/XtCallCallbacks.man b/man/XtCallCallbacks.man
index f7fc7a6..8cbf638 100644
--- a/man/XtCallCallbacks.man
+++ b/man/XtCallCallbacks.man
@@ -71,9 +71,8 @@ XtCallbackStatus;
 .HP
 XtCallbackStatus XtHasCallbacks(Widget \fIw\fP, String \fIcallback_name\fP);
 .SH ARGUMENTS
-.ds Cn \ to be executed or checked
 .IP \fIcallback_name\fP 1i
-Specifies the callback list\*(Cn.
+Specifies the callback list to be executed or checked.
 .IP \fIcall_data\fP 1i
 Specifies a callback-list specific data value to pass to each of the callback
 procedure in the list.
diff --git a/man/XtClass.man b/man/XtClass.man
index 041d920..a7d5280 100644
--- a/man/XtClass.man
+++ b/man/XtClass.man
@@ -103,9 +103,8 @@ Boolean XtIsSessionShell(Widget \fIw\fP);
 Specifies the widget.
 .IP \fIwidget_class\fP 1i
 Specifies the widget class.
-.ds Me used
 .IP \fImessage\fP 1i
-Specifies the message that is to be \*(Me.
+Specifies the message that is to be used.
 .SH DESCRIPTION
 The
 .BR XtClass
diff --git a/man/XtConfigureWidget.man b/man/XtConfigureWidget.man
index 8235138..ce9b538 100644
--- a/man/XtConfigureWidget.man
+++ b/man/XtConfigureWidget.man
@@ -81,12 +81,11 @@ void XtResizeWindow(Widget \fIw\fP);
 Specify the new widget size.
 .IP \fIw\fP 1i
 Specifies the widget.
-.ds Nu new widget
 .IP \fIx\fP 1i
 .br
 .ns
 .IP \fIy\fP 1i
-Specify the \*(Nu x and y coordinates.
+Specify the new widget x and y coordinates.
 .SH DESCRIPTION
 The
 .BR XtConfigureWidget
diff --git a/man/XtConvert.man b/man/XtConvert.man
index 98e1ca0..af3dd27 100644
--- a/man/XtConvert.man
+++ b/man/XtConvert.man
@@ -67,10 +67,8 @@ String \fIto_type\fP, XrmValuePtr \fIto_return\fP);
 void XtDirectConvert(XtConverter \fIconverter\fP, XrmValuePtr \fIargs\fP,
 Cardinal \fInum_args\fP, XrmValuePtr \fIfrom\fP, XrmValuePtr \fIto_return\fP);
 .SH ARGUMENTS
-.ds Al that contains the additional arguments needed to perform \
-the conversion (often NULL)
 .IP \fIargs\fP 1i
-Specifies the argument list \*(Al.
+Specifies the argument list that contains the additional arguments needed to perform the conversion (often NULL).
 .IP \fIconverter\fP 1i
 Specifies the conversion procedure that is to be called.
 .IP \fIfrom\fP 1i
@@ -83,9 +81,8 @@ Specifies the number of additional arguments (often zero).
 Specifies the destination type.
 .IP \fIto_return\fP 1i
 Returns the converted value.
-.ds Wi to use for additional arguments (if any are needed)
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget to use for additional arguments (if any are needed).
 .SH DESCRIPTION
 The
 .BR XtConvert
diff --git a/man/XtCreateApplicationContext.man b/man/XtCreateApplicationContext.man
index b26f514..53778a3 100644
--- a/man/XtCreateApplicationContext.man
+++ b/man/XtCreateApplicationContext.man
@@ -72,9 +72,8 @@ void XtToolkitInitialize(void);
 .SH ARGUMENTS
 .IP \fIapp_context\fP 1i
 Specifies the application context.
-.ds wi that you want the application context for
 .IP \fIw\fP 1i
-Specifies the widget.
+Specifies the widget that you want the application context for.
 .SH DESCRIPTION
 The
 .BR XtCreateApplicationContext
diff --git a/man/XtCreatePopupShell.man b/man/XtCreatePopupShell.man
index 3e20961..64f10a1 100644
--- a/man/XtCreatePopupShell.man
+++ b/man/XtCreatePopupShell.man
@@ -67,21 +67,18 @@ Widget \fIparent\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP);
 Widget XtVaCreatePopupShell(String \fIname\fP, WidgetClass \fIwidget_class\fP,
 Widget \fIparent\fP, ...\^);
 .SH ARGUMENTS
-.ds Al to override the resource defaults
 .IP \fIargs\fP 1i
-Specifies the argument list \*(Al.
-.ds Sh \ shell
+Specifies the argument list to override the resource defaults.
 .IP \fIname\fP 1i
-Specifies the text name for the created\*(Sh widget.
+Specifies the text name for the created shell widget.
 .IP \fInum_args\fP 1i
 Specifies the number of arguments in the argument list.
 .IP \fIparent\fP 1i
 Specifies the parent widget.
-.ds Wc \ pointer for the created shell widget
 .IP \fIwidget_class\fP 1i
-Specifies the widget class\*(Wc.
+Specifies the widget class pointer for the created shell widget.
 .IP \fI...\fP 1i
-Specifies the variable argument list \*(Al.
+Specifies the variable argument list to override the resource defaults.
 .SH DESCRIPTION
 The
 .BR XtCreatePopupShell
diff --git a/man/XtCreateWidget.man b/man/XtCreateWidget.man
index 4c18fa0..d645f15 100644
--- a/man/XtCreateWidget.man
+++ b/man/XtCreateWidget.man
@@ -77,9 +77,8 @@ Widget XtVaCreateManagedWidget(String \fIname\fP, WidgetClass
 .HP
 void XtDestroyWidget(Widget \fIw\fP);
 .SH ARGUMENTS
-.ds Al to override the resource defaults
 .IP \fIargs\fP 1i
-Specifies the argument list \*(Al.
+Specifies the argument list to override the resource defaults.
 .IP \fIname\fP 1i
 Specifies the resource name for the created widget,
 which is used for retrieving resources
@@ -91,11 +90,10 @@ Specifies the number of arguments in the argument list.
 Specifies the parent widget.
 .IP \fIw\fP 1i
 Specifies the widget.
-.ds Wc \ pointer for the created widget
 .IP \fIwidget_class\fP 1i
-Specifies the widget class\*(Wc.
+Specifies the widget class pointer for the created widget.
 .IP \fI...\fP
-Specifies the variable argument list \*(Al.
+Specifies the variable argument list to override the resource defaults.
 .SH DESCRIPTION
 The
 .BR XtCreateWidget
diff --git a/man/XtCreateWindow.man b/man/XtCreateWindow.man
index 6412d3c..bb2c89e 100644
--- a/man/XtCreateWindow.man
+++ b/man/XtCreateWindow.man
@@ -69,15 +69,13 @@ void XtCreateWindow(Widget \fIw\fP, unsigned int \fIwindow_class\fP, Visual
 Specifies the window attributes to use in the
 .BR XCreateWindow
 call.
-.ds Vm attribute fields to use
 .IP \fIvalue_mask\fP 1i
-Specifies which \*(Vm.
+Specifies which attribute fields to use.
 .IP \fIvisual\fP 1i
 Specifies the visual type (usually
 .BR CopyFromParent ).
-.ds Wi that is used to set the x,y coordinates and so on
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that is used to set the x,y coordinates and so on.
 .IP \fIwindow_class\fP 1i
 Specifies the Xlib window class (for example,
 .BR InputOutput ,
diff --git a/man/XtDisplayInitialize.man b/man/XtDisplayInitialize.man
index 1ed6554..0356cbc 100644
--- a/man/XtDisplayInitialize.man
+++ b/man/XtDisplayInitialize.man
@@ -83,9 +83,8 @@ Specifies a pointer to the number of command line parameters.
 Specifies the command line parameters.
 .IP \fIapp_context\fP 1i
 Specifies the application context.
-.ds Ac , which usually is the generic name for all instances of this application
 .IP \fIapplication_class\fP 1i
-Specifies the class name of this application\*(Ac.
+Specifies the class name of this application, which usually is the generic name for all instances of this application.
 .IP \fIapplication_name\fP 1i
 Specifies the name of the application instance.
 .IP \fIdisplay\fP 1i
diff --git a/man/XtDisplayToApplicationContext.man b/man/XtDisplayToApplicationContext.man
index abc3755..9ad1bef 100644
--- a/man/XtDisplayToApplicationContext.man
+++ b/man/XtDisplayToApplicationContext.man
@@ -62,9 +62,8 @@ XtDisplayToApplicationContext \- obtain an application context
 .HP
 XtAppContext XtDisplayToApplicationContext(Display* \fIdpy\fP);
 .SH ARGUMENTS
-.ds Wi that you want the application context for
 .IP \fIdpy\fP 1i
-Specifies the display \*(Wi.
+Specifies the display that you want the application context for.
 .SH DESCRIPTION
 The
 .BR XtDisplayToApplicationContext
diff --git a/man/XtError.man b/man/XtError.man
index 9b6f5e8..d2dfbc5 100644
--- a/man/XtError.man
+++ b/man/XtError.man
@@ -70,13 +70,11 @@ void XtWarning(String \fImessage\fP);
 .SH ARGUMENTS
 .IP \fImessage\fP 1i
 Specifies the nonfatal error message that is to be reported.
-.ds Ha fatal error procedure, which should not return, \
-or the nonfatal error procedure, which usually returns
 .IP \fIhandler\fP 1i
-Specifies the new \*(Ha.
-.ds Me reported
+Specifies the new fatal error procedure, which should not return, 
+or the nonfatal error procedure, which usually returns.
 .IP \fImessage\fP 1i
-Specifies the message that is to be \*(Me.
+Specifies the message that is to be reported.
 .SH DESCRIPTION
 The
 .BR XtError
diff --git a/man/XtErrorMsg.man b/man/XtErrorMsg.man
index 4d32f98..f49f3b4 100644
--- a/man/XtErrorMsg.man
+++ b/man/XtErrorMsg.man
@@ -71,19 +71,17 @@ void XtSetWarningMsgHandler(XtErrorMsgHandler \fImsg_handler\fP);
 void XtWarningMsg(String \fIname\fP, String \fItype\fP, String \fIclass\fP,
 String \fIdefault\fP, String *\fIparams\fP, Cardinal *\fInum_params\fP);
 .SH ARGUMENTS
-.ds Cl
 .IP \fIclass\fP 1i
-Specifies the resource class\*(Cl.
+Specifies the resource class of the error message.
 .IP \fIdefault\fP 1i
 Specifies the default message to use.
 .IP \fIname\fP 1i
 Specifies the general kind of error.
 .IP \fItype\fP 1i
 Specifies the detailed name of the error.
-.ds Mh fatal error procedure, which should not return \
-or the nonfatal error procedure, which usually returns
 .IP \fImsg_handler\fP 1i
-Specifies the new \*(Mh.
+Specifies the new fatal error procedure, which should not return 
+or the nonfatal error procedure, which usually returns.
 .IP \fInum_params\fP 1i
 Specifies the number of values in the parameter list.
 .IP \fIparams\fP 1i
diff --git a/man/XtGetApplicationResources.man b/man/XtGetApplicationResources.man
index 1ac4301..202b31c 100644
--- a/man/XtGetApplicationResources.man
+++ b/man/XtGetApplicationResources.man
@@ -67,26 +67,23 @@ XtResourceList \fIresources\fP, Cardinal \fInum_resources\fP, ArgList
 .HP
 void XtVaGetApplicationResources(Widget \fIw\fP, XtPointer \fIbase\fP,
 XtResourceList \fIresources\fP, Cardinal \fInum_resources\fP, ...\^);
-.SH ARGUMENTS
-.ds Al to override resources obtained from the resource database
+.SH ARGUMENTS 
 .IP \fIargs\fP 1i
-Specifies the argument list \*(Al.
-.ds Ba written
+Specifies the argument list to override resources obtained from the resource database.
 .IP \fIbase\fP 1i
 Specifies the base address of the subpart data structure where the resources
-should be \*(Ba.
+should be written.
 .IP \fInum_args\fP 1i
 Specifies the number of arguments in the argument list.
 .IP \fInum_resources\fP 1i
 Specifies the number of resources in the resource list.
 .IP \fIresources\fP 1i
 Specifies the resource list for the subpart.
-.ds Wi that wants resources for a subpart \
-or that identifies the resource database to search
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that wants resources for a subpart 
+or that identifies the resource database to search.
 .IP \fI...\fP 1i
-Specifies the variable arguments \*(Al.
+Specifies the variable arguments to override resources obtained from the resource database.
 .SH DESCRIPTION
 The
 .BR XtGetApplicationResources
diff --git a/man/XtGetErrorDatabase.man b/man/XtGetErrorDatabase.man
index e78c983..db9ef32 100644
--- a/man/XtGetErrorDatabase.man
+++ b/man/XtGetErrorDatabase.man
@@ -69,9 +69,8 @@ void XtGetErrorDatabaseText(char *\fIname\fP, char *\fItype\fP, char
 .SH ARGUMENTS
 .IP \fIbuffer_return\fP 1i
 Specifies the buffer into which the error message is to be returned.
-.ds Cl \ of the error message
 .IP \fIclass\fP 1i
-Specifies the resource class\*(Cl.
+Specifies the resource class of the error message.
 .IP \fIdefault\fP 1i
 Specifies the default message to use.
 .IP \fIname\fP 1i
diff --git a/man/XtGetGC.man b/man/XtGetGC.man
index 6d1c58c..0df53d1 100644
--- a/man/XtGetGC.man
+++ b/man/XtGetGC.man
@@ -70,9 +70,8 @@ void XtReleaseGC(Widget \fIw\fP, GC \fIgc\fP);
 Specifies the GC to be deallocated.
 .IP \fIvalues\fP 1i
 Specifies the actual values for this GC.
-.ds Vm fields of the values are specified
 .IP \fIvalue_mask\fP 1i
-Specifies which \*(Vm.
+Specifies which fields of the values are specified.
 .IP \fIw\fP 1i
 Specifies the widget.
 .SH DESCRIPTION
diff --git a/man/XtGetResourceList.man b/man/XtGetResourceList.man
index e64428f..514c021 100644
--- a/man/XtGetResourceList.man
+++ b/man/XtGetResourceList.man
@@ -75,9 +75,8 @@ Specifies a pointer to where to store the returned resource list.
 The caller must free this storage using
 .BR XtFree
 when done with it.
-.ds Cl \ for which you want the list
 .IP \fIwidget_class\fP 1i
-Specifies the widget class.
+Specifies the widget class for which you want the list.
 .SH DESCRIPTION
 If
 .BR XtGetResourceList
diff --git a/man/XtGetSelectionValue.man b/man/XtGetSelectionValue.man
index 1385800..da37a63 100644
--- a/man/XtGetSelectionValue.man
+++ b/man/XtGetSelectionValue.man
@@ -69,13 +69,11 @@ void XtGetSelectionValues(Widget \fIw\fP, Atom \fIselection\fP, Atom
 *\fItargets\fP, int \fIcount\fP, XtSelectionCallbackProc \fIcallback\fP,
 XtPointer \fIclient_data\fP, Time \fItime\fP);
 .SH ARGUMENTS
-.ds Cb \ that is to be called when the selection value has been obtained
 .IP \fIcallback\fP 1i
-Specifies the callback procedure\*(Cb.
-.ds Cd it is called
+Specifies the callback procedure that is to be called when the selection value has been obtained.
 .IP \fIclient_data\fP 1i
 Specifies the argument that is to be passed to the specified procedure
-when \*(Cd.
+when it is called.
 .IP \fIclient_data\fP 1i
 Specifies the client data (one for each target type)
 that is passed to the callback procedure when it is called for that target.
@@ -87,12 +85,10 @@ Specifies the particular selection desired (that is, primary or secondary).
 Specifies the type of the information that is needed about the selection.
 .IP \fItargets\fP 1i
 Specifies the types of information that is needed about the selection.
-.ds Ti value is desired
 .IP \fItime\fP 1i
-Specifies the timestamp that indicates when the selection \*(Ti.
-.ds Wi that is making the request
+Specifies the timestamp that indicates when the selection value is desired.
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that is making the request.
 .SH DESCRIPTION
 The
 .BR XtGetSelectionValue
diff --git a/man/XtGetSelectionValueIncremental.man b/man/XtGetSelectionValueIncremental.man
index 841a1f7..662b3cb 100644
--- a/man/XtGetSelectionValueIncremental.man
+++ b/man/XtGetSelectionValueIncremental.man
@@ -68,13 +68,11 @@ void XtGetSelectionValuesIncremental(Widget \fIw\fP, Atom \fIselection\fP,
 Atom *\fItargets\fP, int \fIcount\fP, XtSelectionCallbackProc \fIcallback\fP,
 XtPointer \fIclient_data\fP, Time \fItime\fP);
 .SH ARGUMENTS
-.ds Cb \ that is to be called when the selection value has been obtained
 .IP \fIcallback\fP 1i
-Specifies the callback procedure\*(Cb.
-.ds Cd it is called
+Specifies the callback procedure that is to be called when the selection value has been obtained.
 .IP \fIclient_data\fP 1i
 Specifies the argument that is to be passed to the specified procedure
-when \*(Cd.
+when it is called.
 .IP \fIclient_data\fP 1i
 Specifies the client data (one for each target type)
 that is passed to the callback procedure when it is called for that target.
@@ -86,12 +84,10 @@ Specifies the particular selection desired (that is, primary or secondary).
 Specifies the type of the information that is needed about the selection.
 .IP \fItargets\fP 1i
 Specifies the types of information that is needed about the selection.
-.ds Ti value is desired
 .IP \fItime\fP 1i
-Specifies the timestamp that indicates when the selection \*(Ti.
-.ds Wi that is making the request
+Specifies the timestamp that indicates when the selection value is desired.
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that is making the request.
 .SH DESCRIPTION
 The
 .BR XtGetSelectionValueIncremental
diff --git a/man/XtGetSubresources.man b/man/XtGetSubresources.man
index 4d86e05..34797bf 100644
--- a/man/XtGetSubresources.man
+++ b/man/XtGetSubresources.man
@@ -69,13 +69,11 @@ void XtVaGetSubresources(Widget \fIw\fP, XtPointer \fIbase\fP, String
 \fIname\fP, String \fIclass\fP, XtResourceList \fIresources\fP, Cardinal
 \fInum_resources\fP);
 .SH ARGUMENTS
-.ds Al to override resources obtained from the resource database
 .IP \fIargs\fP 1i
-Specifies the argument list \*(Al.
-.ds Ba written
+Specifies the argument list to override resources obtained from the resource database.
 .IP \fIbase\fP 1i
 Specifies the base address of the subpart data structure where the resources
-should be \*(Ba.
+should be written.
 .IP \fIclass\fP 1i
 Specifies the class of the subpart.
 .IP \fIname\fP 1i
@@ -86,12 +84,11 @@ Specifies the number of arguments in the argument list.
 Specifies the number of resources in the resource list.
 .IP \fIresources\fP 1i
 Specifies the resource list for the subpart.
-.ds Wi that wants resources for a subpart \
-or that identifies the resource database to search
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that wants resources for a subpart 
+or that identifies the resource database to search.
 .IP \fI...\fP 1i
-Specifies the variable arguments \*(Al.
+Specifies the variable arguments to override resources obtained from the resource database.
 .SH DESCRIPTION
 The
 .BR XtGetSubresources
diff --git a/man/XtInitialize.man b/man/XtInitialize.man
index a722eb9..975c6c9 100644
--- a/man/XtInitialize.man
+++ b/man/XtInitialize.man
@@ -66,9 +66,8 @@ char** \fIargv\fP);
 .SH ARGUMENTS
 .IP \fIshell_name\fP 1i
 Specifies the name of the created shell widget.
-.ds Ac , which usually is the generic name for all instances of this application
 .IP \fIapplication_class\fP 1i
-Specifies the class name of this application\*(Ac.
+Specifies the class name of this application, which usually is the generic name for all instances of this application.
 .IP \fIoptions\fP 1i
 Specifies how to parse the command line for any application-specific resources.
 The options argument is passed as a parameter to
diff --git a/man/XtMakeGeometryRequest.man b/man/XtMakeGeometryRequest.man
index 01c6ac1..1b7043f 100644
--- a/man/XtMakeGeometryRequest.man
+++ b/man/XtMakeGeometryRequest.man
@@ -74,9 +74,8 @@ if the requesting widget is not interested in handling
 .IP \fIrequest\fP 1i
 Specifies the desired widget geometry (size, position, border width,
 and stacking order).
-.ds Wi that is making the request
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that is making the request.
 .IP \fIwidth_return\fP 1i
 .br
 .ns
diff --git a/man/XtMalloc.man b/man/XtMalloc.man
index e5af2f6..c53fa74 100644
--- a/man/XtMalloc.man
+++ b/man/XtMalloc.man
@@ -77,9 +77,8 @@ Cardinal XtAsprintf(String *\fInew_string\fP, const char *\fIformat\fP, ...);
 .SH ARGUMENTS
 .IP \fInum\fP 1i
 Specifies the number of bytes or array elements.
-.ds Po to the old storage or to the block of storage that is to be freed
 .IP \fIptr\fP 1i
-Specifies a pointer \*(Po.
+Specifies a pointer to the old storage or to the block of storage that is to be freed.
 .IP \fIsize\fP 1i
 Specifies the size of an array element (in bytes) or the number of bytes
 desired.
diff --git a/man/XtManageChildren.man b/man/XtManageChildren.man
index c467274..a1cc74c 100644
--- a/man/XtManageChildren.man
+++ b/man/XtManageChildren.man
@@ -235,9 +235,8 @@ is defined with an \fIallows_change_managed_set\fP field with a value of
 or if no
 .BR CompositeClassExtension
 is defined, and
-.BR XtChangeManagedSet was invoked with a NULL
-\fIdo_change_proc\fP procedure, then the following is
-performed:
+.BR XtChangeManagedSet 
+was invoked with a NULL \fIdo_change_proc\fP procedure, then the following is performed:
 .RS
 .IP \- 5
 For each child on the \fIunmanage_children\fP list; if the child is
diff --git a/man/XtNameToWidget.man b/man/XtNameToWidget.man
index c0a247c..c9b58d0 100644
--- a/man/XtNameToWidget.man
+++ b/man/XtNameToWidget.man
@@ -65,9 +65,8 @@ Widget XtNameToWidget(Widget \fIreference\fP, String \fInames\fP);
 .HP
 Widget XtWindowToWidget(Display *\fIdisplay\fP, Window \fIwindow\fP);
 .SH ARGUMENTS
-.ds Di \ on which the window is defined
 .IP \fIdisplay\fP 1i
-Specifies the display\*(Di.
+Specifies the display on which the window is defined.
 .IP \fInames\fP 1i
 Specifies the fully qualified name of the desired widget.
 .IP \fIreference\fP 1i
diff --git a/man/XtOpenApplication.man b/man/XtOpenApplication.man
index 0253c69..e61e30b 100644
--- a/man/XtOpenApplication.man
+++ b/man/XtOpenApplication.man
@@ -73,9 +73,8 @@ Widget XtVaOpenApplication(XtAppContext *\fIapp_context_return\fP, String
 .SH ARGUMENTS
 .IP \fIapp_context_return\fP 1i
 Specifies the application context.
-.ds Ac , which usually is the generic name for all instances of this application
 .IP \fIapplication_class\fP 1i
-Specifies the class name of this application\*(Ac.
+Specifies the class name of this application, which usually is the generic name for all instances of this application.
 .IP \fIoptions\fP 1i
 Specifies how to parse the command line for any application-specific resources.
 The options argument is passed as a parameter to
diff --git a/man/XtOwnSelection.man b/man/XtOwnSelection.man
index 105e7b9..650a158 100644
--- a/man/XtOwnSelection.man
+++ b/man/XtOwnSelection.man
@@ -90,12 +90,11 @@ Specifies an atom that describes the type of the selection (for example,
 .BR XA_SECONDARY ,
 or
 .BR XA_CLIPBOARD ).
-.ds Ti ownership should commence or is to be relinquished
 .IP \fItime\fP 1i
-Specifies the timestamp that indicates when the selection \*(Ti.
-.ds Wi that wishes to become the owner or to relinquish ownership
+Specifies the timestamp that indicates when the selection 
+ownership should commence or is to be relinquished.
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that wishes to become the owner or to relinquish ownership.
 .SH DESCRIPTION
 The
 .BR XtOwnSelection
diff --git a/man/XtParseAcceleratorTable.man b/man/XtParseAcceleratorTable.man
index b01400c..718c1ea 100644
--- a/man/XtParseAcceleratorTable.man
+++ b/man/XtParseAcceleratorTable.man
@@ -68,14 +68,12 @@ void XtInstallAccelerators(Widget \fIdestination\fP, Widget \fIsource\fP);
 .HP
 void XtInstallAllAccelerators(Widget \fIdestination\fP, Widget \fIsource\fP);
 .SH ARGUMENTS
-.ds So to compile
 .IP \fIsource\fP 1i
-Specifies the accelerator table \*(So.
+Specifies the accelerator table to compile.
 .IP \fIdestination\fP 1i
 Specifies the widget on which the accelerators are to be installed.
-.ds Sr widget or the root widget of the widget tree
 .IP \fIsource\fP 1i
-Specifies the \*(Sr from which the accelerators are to come.
+Specifies the widget or the root widget of the widget tree from which the accelerators are to come.
 .SH DESCRIPTION
 The
 .BR XtParseAcceleratorTable
diff --git a/man/XtParseTranslationTable.man b/man/XtParseTranslationTable.man
index 3708051..b9040c2 100644
--- a/man/XtParseTranslationTable.man
+++ b/man/XtParseTranslationTable.man
@@ -75,9 +75,8 @@ void XtUninstallTranslations(Widget \fIw\fP);
 Specifies the translation table to compile.
 .IP \fItranslations\fP 1i
 Specifies the compiled translation table to merge in (must not be NULL).
-.ds Wi into which the new translations are to be merged or removed
 .IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget into which the new translations are to be merged or removed.
 .SH DESCRIPTION
 The
 .BR XtParseTranslationTable
diff --git a/man/XtPopdown.man b/man/XtPopdown.man
index ba1a7c6..d78d06a 100644
--- a/man/XtPopdown.man
+++ b/man/XtPopdown.man
@@ -75,12 +75,10 @@ which is not used by this procedure.
 Specifies a pointer to the
 .BR XtPopdownID
 structure.
-.ds Ps \ to pop down
 .IP \fIpopup_shell\fP 1i
-Specifies the widget shell\*(Ps.
-.ds Sn down
+Specifies the widget shell to pop down.
 .IP \fIshell_name\fP 1i
-Specifies the name of the widget shell to pop \*(Sn.
+Specifies the name of the widget shell to pop down.
 .IP \fIw\fP 1i
 Specifies the widget.
 .SH DESCRIPTION
diff --git a/man/XtSetKeyTranslator.man b/man/XtSetKeyTranslator.man
index ced6f29..b8dba4e 100644
--- a/man/XtSetKeyTranslator.man
+++ b/man/XtSetKeyTranslator.man
@@ -74,9 +74,8 @@ KeySym \fIstart\fP, KeySym \fIstop\fP);
 void XtConvertCase(Display *\fIdisplay\fP, KeySym \fIkeysym\fP, KeySym
 *\fIlower_return\fP, KeySym *\fIupper_return\fP);
 .SH ARGUMENTS
-.ds Di
 .IP \fIdisplay\fP 1i
-Specifies the display\*(Di.
+Specifies the display.
 .IP \fIkeycode\fP 1i
 Specifies the KeyCode to translate.
 .IP \fIkeysym\fP 1i
@@ -92,9 +91,8 @@ Specifies the modifiers to the KeyCode.
 .IP \fImodifiers_return\fP 1i
 Returns a mask that indicates the modifiers actually used
 to generate the KeySym.
-.ds Pr \ to perform key translations or conversions
 .IP \fIproc\fP 1i
-Specifies the procedure that is\*(Pr.
+Specifies the procedure that is to perform key translations or conversions.
 .IP \fIstart\fP 1i
 Specifies the first KeySym for which this converter is valid.
 .IP \fIstop\fP 1i
@@ -127,7 +125,7 @@ The new converter overrides any previous converters for KeySyms in that range.
 No interface exists to remove converters;
 you need to register an identity converter.
 When a new converter is registered,
-the \*(xI  refreshes the keyboard state if necessary.
+the \*(xI refreshes the keyboard state if necessary.
 The default converter understands case conversion for all
 KeySyms defined in the core protocol.
 .LP
diff --git a/man/XtSetKeyboardFocus.man b/man/XtSetKeyboardFocus.man
index fc3aa1f..0695c8b 100644
--- a/man/XtSetKeyboardFocus.man
+++ b/man/XtSetKeyboardFocus.man
@@ -70,9 +70,8 @@ keyboard event, or
 Note that it is not an error to specify
 .BR None
 when no input focus was previously set.
-.ds Wi for which the keyboard focus is to be set
 .IP \fIdescendant\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget for which the keyboard focus is to be set.
 .SH DESCRIPTION
 If a future
 .BR KeyPress
diff --git a/man/XtSetValues.man b/man/XtSetValues.man
index 0378eca..1e1f95b 100644
--- a/man/XtSetValues.man
+++ b/man/XtSetValues.man
@@ -82,15 +82,14 @@ Cardinal \fInum_resources\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP);
 void XtVaGetSubvalues(XtPointer \fIbase\fP, XtResourceList \fIresources\fP,
 Cardinal \fInum_resources\fP, ...\^);
 .SH ARGUMENTS
-.ds Al of name/address pairs that contain the resource name \
-and either the address into which the resource value is to be stored \
-or their new values
 .IP \fIargs\fP 1i
-Specifies the argument list \*(Al.
-.ds Ba retrieved or written
+Specifies the argument list of name/address pairs that contain the resource
+name 
+and either the address into which the resource value is to be stored 
+or their new values.
 .IP \fIbase\fP 1i
 Specifies the base address of the subpart data structure where the resources
-should be \*(Ba.
+should be retrieved or written.
 .IP \fInum_args\fP 1i
 Specifies the number of arguments in the argument list.
 .IP \fIresources\fP 1i
@@ -100,7 +99,9 @@ Specifies the number of resources in the resource list.
 .IP \fIw\fP 1i
 Specifies the widget.
 .IP \fI...\fP 1i
-Specifies the variable argument list \*(Al.
+Specifies the variable argument list of name/address pairs that contain the resource name 
+and either the address into which the resource value is to be stored 
+or their new values.
 .SH DESCRIPTION
 The
 .BR XtSetValues
diff --git a/man/XtTranslateCoords.man b/man/XtTranslateCoords.man
index 68fa18d..15d46d6 100644
--- a/man/XtTranslateCoords.man
+++ b/man/XtTranslateCoords.man
@@ -69,12 +69,11 @@ void XtTranslateCoords(Widget \fIw\fP, Position \fIx\fP, \fIy\fP, Position
 .ns
 .IP \fIrooty_return\fP 1i
 Returns the root-relative x and y coordinates.
-.ds Nu widget-relative
 .IP \fIx\fP 1i
 .br
 .ns
 .IP \fIy\fP 1i
-Specify the \*(Nu x and y coordinates.
+Specify the widget-relative x and y coordinates.
 .IP \fIw\fP 1i
 Specifies the widget.
 .SH DESCRIPTION