From 4b446ce8b20b1de1488c73e1841dafbd25ca949f Mon Sep 17 00:00:00 2001 From: Walter Harms Date: Mon, 15 Apr 2019 23:03:31 +0200 Subject: 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. --- man/XtAddCallback.man | 9 ++++----- man/XtAddEventHandler.man | 12 ++++-------- man/XtAddGrab.man | 3 +-- man/XtAllocateGC.man | 3 +-- man/XtAppAddInput.man | 9 +++------ man/XtAppAddTimeOut.man | 6 ++---- man/XtAppAddWorkProc.man | 6 ++---- man/XtAppCreateShell.man | 14 ++++++-------- man/XtAppError.man | 8 +++----- man/XtAppErrorMsg.man | 8 +++----- man/XtAppGetErrorDatabase.man | 3 +-- man/XtAppInitialize.man | 3 +-- man/XtAppNextEvent.man | 3 +-- man/XtCallCallbacks.man | 3 +-- man/XtClass.man | 3 +-- man/XtConfigureWidget.man | 3 +-- man/XtConvert.man | 7 ++----- man/XtCreateApplicationContext.man | 3 +-- man/XtCreatePopupShell.man | 11 ++++------- man/XtCreateWidget.man | 8 +++----- man/XtCreateWindow.man | 6 ++---- man/XtDisplayInitialize.man | 3 +-- man/XtDisplayToApplicationContext.man | 3 +-- man/XtError.man | 8 +++----- man/XtErrorMsg.man | 8 +++----- man/XtGetApplicationResources.man | 15 ++++++--------- man/XtGetErrorDatabase.man | 3 +-- man/XtGetGC.man | 3 +-- man/XtGetResourceList.man | 3 +-- man/XtGetSelectionValue.man | 12 ++++-------- man/XtGetSelectionValueIncremental.man | 12 ++++-------- man/XtGetSubresources.man | 13 +++++-------- man/XtInitialize.man | 3 +-- man/XtMakeGeometryRequest.man | 3 +-- man/XtMalloc.man | 3 +-- man/XtManageChildren.man | 5 ++--- man/XtNameToWidget.man | 3 +-- man/XtOpenApplication.man | 3 +-- man/XtOwnSelection.man | 7 +++---- man/XtParseAcceleratorTable.man | 6 ++---- man/XtParseTranslationTable.man | 3 +-- man/XtPopdown.man | 6 ++---- man/XtSetKeyTranslator.man | 8 +++----- man/XtSetKeyboardFocus.man | 3 +-- man/XtSetValues.man | 15 ++++++++------- man/XtTranslateCoords.man | 3 +-- 46 files changed, 105 insertions(+), 180 deletions(-) (limited to 'man') 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 -- cgit v1.2.1