diff options
author | Walter Harms <wharms@bfs.de> | 2019-04-02 22:50:51 +0200 |
---|---|---|
committer | Walter Harms <wharms@bfs.de> | 2019-04-02 22:50:51 +0200 |
commit | 7caf7f47d473e92cf0fc36bf03720765916c17be (patch) | |
tree | fc94f08c87a1c4a8655bf9e0afa463322887cf89 /man | |
parent | 3b5b654d5b539364a2f19b5206a79fb2e13f810f (diff) |
replace .ZN with .BR
By replacing we do two things:
1. this fixes the troff behavier
2. this moves us closer to std. man pages
3. after this patch the macro ZN can be deleted
Signed-off-by: Walter Harms <wharms@bfs.de>
Diffstat (limited to 'man')
106 files changed, 954 insertions, 954 deletions
diff --git a/man/XtAddActions.man b/man/XtAddActions.man index e633775..1b0309c 100644 --- a/man/XtAddActions.man +++ b/man/XtAddActions.man @@ -68,9 +68,9 @@ Specifies the action table to register. .IP \fInum_args\fP 1i Specifies the number of entries in this action table. .SH DESCRIPTION -.ZN XtAddActions +.BR XtAddActions has been replaced by -.ZN XtAppAddActions . +.BR XtAppAddActions . .SH "SEE ALSO" XtAppAddActions(__libmansuffix__) .br diff --git a/man/XtAddCallback.man b/man/XtAddCallback.man index 90eedd1..5dc07c0 100644 --- a/man/XtAddCallback.man +++ b/man/XtAddCallback.man @@ -93,26 +93,26 @@ when \*(Cd. Specifies the widget. .SH DESCRIPTION The -.ZN XtAddCallback +.BR XtAddCallback function adds the specified callback procedure to the specified widget's callback list. .LP The -.ZN XtAddCallbacks +.BR XtAddCallbacks add the specified list of callbacks to the specified widget's callback list. .LP The -.ZN XtRemoveCallback +.BR XtRemoveCallback function removes a callback only if both the procedure and the client data match. .LP The -.ZN XtRemoveCallbacks +.BR XtRemoveCallbacks function removes the specified callback procedures from the specified widget's callback list. .LP The -.ZN XtRemoveAllCallbacks +.BR XtRemoveAllCallbacks function removes all the callback procedures from the specified widget's callback list. .SH "SEE ALSO" diff --git a/man/XtAddEventHandler.man b/man/XtAddEventHandler.man index 29ba041..9ab8ce5 100644 --- a/man/XtAddEventHandler.man +++ b/man/XtAddEventHandler.man @@ -94,14 +94,14 @@ Specifies the event mask for which \*(Em. .IP \fInonmaskable\fP 1i Specifies a Boolean value that indicates whether this procedure should be \*(Nm on the nonmaskable events ( -.ZN GraphicsExpose , -.ZN NoExpose , -.ZN SelectionClear , -.ZN SelectionRequest , -.ZN SelectionNotify , -.ZN ClientMessage , +.BR GraphicsExpose , +.BR NoExpose , +.BR SelectionClear , +.BR SelectionRequest , +.BR SelectionNotify , +.BR ClientMessage , and -.ZN MappingNotify ). +.BR MappingNotify ). .ds Pr \ to be added or removed .IP \fIproc\fP 1i Specifies the procedure that is\*(Pr. @@ -113,54 +113,54 @@ Specifies when the event handler is to be called relative to other previously registered handlers. .SH DESCRIPTION The -.ZN XtAddEventHandler +.BR XtAddEventHandler function registers a procedure with the dispatch mechanism that is to be called when an event that matches the mask occurs on the specified widget. If the procedure is already registered with the same client_data, the specified mask is ORed into the existing mask. If the widget is realized, -.ZN XtAddEventHandler +.BR XtAddEventHandler calls -.ZN XSelectInput , +.BR XSelectInput , if necessary. .LP The -.ZN XtAddRawEventHandler +.BR XtAddRawEventHandler function is similar to -.ZN XtAddEventHandler +.BR XtAddEventHandler except that it does not affect the widget's mask and never causes an -.ZN XSelectInput +.BR XSelectInput for its events. Note that the widget might already have those mask bits set because of other nonraw event handlers registered on it. .LP The -.ZN XtRemoveRawEventHandler +.BR XtRemoveRawEventHandler function stops the specified procedure from receiving the specified events. Because the procedure is a raw event handler, this does not affect the widget's mask and never causes a call on -.ZN XSelectInput . +.BR XSelectInput . .LP -.ZN XtInsertEventHandler +.BR XtInsertEventHandler is identical to -.ZN XtAddEventHandler +.BR XtAddEventHandler with the additional \fIposition\fP argument. if \fIposition\fP is -.ZN XtListHead , +.BR XtListHead , the event handler is registered to that it will be called before any event handlers that were previously registered for the same widget. If \fIposition\fP is -.ZN XtListTail , +.BR XtListTail , the event handler is registered to be called after any previously registered event handlers. If the procedure is already registered with the same \fIclient_data\fP value, the specified mask augments the existing mask and the procedure is repositioned in the list. .LP -.ZN XtInsertRawEventHandler +.BR XtInsertRawEventHandler is similar to -.ZN XtInsertEventHandler +.BR XtInsertEventHandler except that it does not modify the widget's event mask and never causes an -.ZN XSelectInput +.BR XSelectInput for the specified events. If the procedure is already registered with the same \fIclient_data\fP value, the specified mask augments the existing mask and the procedure is repositioned in the list. diff --git a/man/XtAddExposureToRegion.man b/man/XtAddExposureToRegion.man index cbf3627..36849fa 100644 --- a/man/XtAddExposureToRegion.man +++ b/man/XtAddExposureToRegion.man @@ -65,25 +65,25 @@ void XtAddExposureToRegion(XEvent *\fIevent\fP, Region \fIregion\fP); .SH ARGUMENTS .IP \fIevent\fP 1i Specifies a pointer to the -.ZN Expose +.BR Expose or -.ZN GraphicsExpose +.BR GraphicsExpose event. .IP \fIregion\fP 1i Specifies the region object (as defined in < -.ZN X11/Xutil.h >). +.BR X11/Xutil.h >). .SH DESCRIPTION The -.ZN XtAddExposureToRegion +.BR XtAddExposureToRegion function computes the union of the rectangle defined by the exposure event and the specified region. Then, it stores the results back in region. If the event argument is not an -.ZN Expose +.BR Expose or -.ZN GraphicsExpose +.BR GraphicsExpose event, -.ZN XtAddExposureToRegion +.BR XtAddExposureToRegion returns without an error and without modifying region. .LP This function is used by the exposure compression mechanism diff --git a/man/XtAddGrab.man b/man/XtAddGrab.man index ad2eb17..550ba57 100644 --- a/man/XtAddGrab.man +++ b/man/XtAddGrab.man @@ -77,26 +77,26 @@ a pointer button. Specifies the widget \*(Wi. .SH DESCRIPTION The -.ZN XtAddGrab +.BR XtAddGrab function appends the widget (and associated parameters) to the modal cascade and checks that exclusive is -.ZN True +.BR True if spring_loaded is -.ZN True . +.BR True . If these are not -.ZN True , -.ZN XtAddGrab +.BR True , +.BR XtAddGrab generates an error. .LP The modal cascade is used by -.ZN XtDispatchEvent +.BR XtDispatchEvent when it tries to dispatch a user event. When at least one modal widget is in the widget cascade, -.ZN XtDispatchEvent +.BR XtDispatchEvent first determines if the event should be delivered. It starts at the most recent cascade entry and follows the cascade up to and including the most recent cascade entry added with the exclusive parameter -.ZN True . +.BR True . .LP This subset of the modal cascade along with all descendants of these widgets comprise the active subset. @@ -104,10 +104,10 @@ User events that occur outside the widgets in this subset are ignored or remapped. Modal menus with submenus generally add a submenu widget to the cascade with exclusive -.ZN False . +.BR False . Modal dialog boxes that need to restrict user input to the most deeply nested dialog box add a subdialog widget to the cascade with exclusive -.ZN True . +.BR True . User events that occur within the active subset are delivered to the appropriate widget, which is usually a child or further descendant of the modal widget. @@ -115,11 +115,11 @@ widget. Regardless of where on the screen they occur, remap events are always delivered to the most recent widget in the active subset of the cascade that has spring_loaded -.ZN True , +.BR True , if any such widget exists. .LP The -.ZN XtRemoveGrab +.BR XtRemoveGrab function removes widgets from the modal cascade starting at the most recent widget up to and including the specified widget. It issues an error if the specified widget is not on the modal cascade. diff --git a/man/XtAddInput.man b/man/XtAddInput.man index 2510e7b..fa1d049 100644 --- a/man/XtAddInput.man +++ b/man/XtAddInput.man @@ -82,17 +82,17 @@ Specifies the procedure that is to be called when input is available. Specifies the source file descriptor on a UNIX-based system or other operating system dependent device specification. .SH DESCRIPTION -.ZN XtAddInput +.BR XtAddInput has been replaced by -.ZN XtAppAddInput. +.BR XtAppAddInput. .LP -.ZN XtAddTimeOut +.BR XtAddTimeOut has been replaced by -.ZN XtAppAddTimeOut. +.BR XtAppAddTimeOut. .LP -.ZN XtAddWorkProc +.BR XtAddWorkProc has been replaced by -.ZN XtAppAddWorkProc . +.BR XtAppAddWorkProc . .SH "SEE ALSO" XtAppAddInput(__libmansuffix__), XtAppAddTimeOut(__libmansuffix__), XtAppAddWorkProc(__libmansuffix__) .br diff --git a/man/XtAllocateGC.man b/man/XtAllocateGC.man index 3b49355..c54863f 100644 --- a/man/XtAllocateGC.man +++ b/man/XtAllocateGC.man @@ -79,7 +79,7 @@ Specifies the fields of the GC that will be modified by the caller. Specifies the fields of the GC that will not be needed by the caller. .SH DESCRIPTION The -.ZN XtAllocateGC +.BR XtAllocateGC function returns a sharable GC that may be modified by the client. The \fIscreen\fP field of the specified widget or of the nearest widget ancestor of the specified object and the specified \fIdepth\fP @@ -105,15 +105,15 @@ then immediately set to the value in \fIvalues\fP. If a field is set in \fIunused_mask\fP and also in either \fIvalue_mask\fP or \fIdynamic_mask\fP, the specification in \fIunused_mask\fP is ignored. .LP -.ZN XtAllocateGC +.BR XtAllocateGC tries to minimize the number of unique GCs created by comparing the arguments with those of previous calls and returning an existing GC when there are no conflicts. -.ZN XtAllocateGC +.BR XtAllocateGC may modify and return an existing GC if it was allocated with a nonzero \fIunused_mask\fP. .SH "SEE ALSO" -.ZN XtGetGC +.BR XtGetGC .br \fI\*(xT\fP .br diff --git a/man/XtAppAddActionHook.man b/man/XtAppAddActionHook.man index dde6ee7..cb6a7c5 100644 --- a/man/XtAppAddActionHook.man +++ b/man/XtAppAddActionHook.man @@ -72,21 +72,21 @@ Specifies the action hook procedure. .IP \fInum_args\fP 1i Specifies the application-specific data to be passed to the action hook. .SH DESCRIPTION -.ZN XtAppAddActionHook +.BR XtAppAddActionHook adds the specified procedure to the front of a list maintained in the application context. In the future, when an action routine is about to be invoked for any widget in this application context, either through the translation manager or via -.ZN XtCallActionProc , +.BR XtCallActionProc , the action hohok procedures will be called in reverse order of registration jut prior to invoking the action routine. .LP Action hook procedures are removed automatically and the -.ZN XtActionHookId +.BR XtActionHookId s destroyed when the application context in which they were added is destroyed. .LP -.ZN XtRemoveActionHook +.BR XtRemoveActionHook removes the specified action hook procedure from the list in which it was registered. .SH "SEE ALSO" diff --git a/man/XtAppAddActions.man b/man/XtAppAddActions.man index 1e5f272..150d7d8 100644 --- a/man/XtAppAddActions.man +++ b/man/XtAppAddActions.man @@ -72,7 +72,7 @@ Specifies the action table to register. Specifies the number of entries in this action table. .SH DESCRIPTION The -.ZN XtAppAddActions +.BR XtAppAddActions function adds the specified action table and registers it with the translation manager. .SH "SEE ALSO" diff --git a/man/XtAppAddBlockHook.man b/man/XtAppAddBlockHook.man index 0f6946c..a6e317a 100644 --- a/man/XtAppAddBlockHook.man +++ b/man/XtAppAddBlockHook.man @@ -72,17 +72,17 @@ Specifies the block hook procedure. .IP \fInum_args\fP 1i Specifies the application-specific data to be passed to the block hook. .SH DESCRIPTION -.ZN XtAppAddBlockHook +.BR XtAppAddBlockHook registers the specified procedure and returns an identifier for it. The hook is called at any time in the future when the Intrinsics are about to block pending some input. .LP Block hook procedures are removed automatically and the -.ZN XtBlockHookId +.BR XtBlockHookId is destroyed when the application context in which they were added is destroyed. .LP -.ZN XtRemoveBlockHook +.BR XtRemoveBlockHook removes the specified block hook procedure from the list in which it was registered. .SH "SEE ALSO" diff --git a/man/XtAppAddConverter.man b/man/XtAppAddConverter.man index ed19593..c1ee893 100644 --- a/man/XtAppAddConverter.man +++ b/man/XtAppAddConverter.man @@ -82,21 +82,21 @@ Specifies the number of additional arguments to the converter or zero. .IP \fIto_type\fP 1i Specifies the destination type. .SH DESCRIPTION -.ZN XtAppAddConverter +.BR XtAppAddConverter is equivalent in function to -.ZN XtAppSetTypeConverter +.BR XtAppSetTypeConverter with \fIcache_type\fP equal to -.ZN XtCacheAll +.BR XtCacheAll for old-format type converters. It has been superseded by -.ZN XtAppSetTypeConverter . +.BR XtAppSetTypeConverter . .LP -.ZN XtAddConverter +.BR XtAddConverter is equivalent in function to -.ZN XtSetTypeConverter +.BR XtSetTypeConverter with \fIcache_type\fP equal to -.ZN XtCacheAll +.BR XtCacheAll for old-format type converters. It has been superseded by -.ZN XtSetTypeConverter . +.BR XtSetTypeConverter . .SH "SEE ALSO" XtConvert(__libmansuffix__), XtStringConversionWarning(__libmansuffix__) diff --git a/man/XtAppAddInput.man b/man/XtAppAddInput.man index 73f37a2..65adf9f 100644 --- a/man/XtAppAddInput.man +++ b/man/XtAppAddInput.man @@ -79,7 +79,7 @@ Specifies the mask that indicates a read, write, or exception condition or some operating system dependent condition. .IP \fIid\fP 1i Specifies the ID returned from the corresponding -.ZN XtAppAddInput +.BR XtAppAddInput call. .ds Pr \ to be called when input is available .IP \fIproc\fP 1i @@ -89,12 +89,12 @@ Specifies the source file descriptor on a UNIX-based system or other operating system dependent device specification. .SH DESCRIPTION The -.ZN XtAppAddInput +.BR XtAppAddInput function registers with the \*(xI read routine a new source of events, which is usually file input but can also be file output. Note that file should be loosely interpreted to mean any sink or source of data. -.ZN XtAppAddInput +.BR XtAppAddInput also specifies the conditions under which the source can generate events. When input is pending on this source, the callback procedure is called. @@ -102,12 +102,12 @@ the callback procedure is called. The legal values for the condition argument are operating-system dependent. On a UNIX-based system, the condition is some union of -.ZN XtInputReadMask , -.ZN XtInputWriteMask , +.BR XtInputReadMask , +.BR XtInputWriteMask , and -.ZN XtInputExceptMask . +.BR XtInputExceptMask . The -.ZN XtRemoveInput +.BR XtRemoveInput function causes the \*(xI read routine to stop watching for input from the input source. .SH "SEE ALSO" diff --git a/man/XtAppAddSignal.man b/man/XtAppAddSignal.man index 1a5282e..f959839 100644 --- a/man/XtAppAddSignal.man +++ b/man/XtAppAddSignal.man @@ -74,51 +74,51 @@ Specifies the argument that is to be passed to the specified procedure when a signal has been raised. .IP \fIid\fP 1i Specifies the ID returned from the corresponding -.ZN XtAppAddSignal +.BR XtAppAddSignal call. .IP \fIproc\fP 1i Specifies the procedure that is to be called when the signal has been raised. .SH DESCRIPTION The -.ZN XtAppAddSignal +.BR XtAppAddSignal function initiates a mechanism for handling signals within the context of the Intrinsics. Prior to establishing an operating system dependent signal handler the application may call -.ZN XtAppAddSignal +.BR XtAppAddSignal and store the returned \fIid\fP in a place accessible to the signal handler. .LP Upon receipt of a signal from the operating system, the application may call -.ZN XtNoticeSignal +.BR XtNoticeSignal passing the \fIid\fP returned by the call to -.ZN XtAppAddSignal . +.BR XtAppAddSignal . .LP -.ZN XtNoticeSignal +.BR XtNoticeSignal is the only Intrinsics function that can safely be called from a signal handler. If -.ZN XtNoticeSignal +.BR XtNoticeSignal is called multiple times before the Intrinsics are able to invoke the registered callback, the callback is only called once. Logically the Intrinsics maintain ``pending'' for each registered callback. This flag is initially -.ZN False +.BR False and is set to -.ZN True +.BR True by -.ZN XtNoticeSignal ; +.BR XtNoticeSignal ; the Intrinsics invoke the callback whenever the flag is -.ZN True , +.BR True , and the flag is set to -.ZN False +.BR False just before the callback is invoked. .LP The -.ZN XtRemoveSignal +.BR XtRemoveSignal function is called to remove the specified Intrinsics signal handler. The client should disable the source of the signal before calling -.ZN XtRemoveSignal . +.BR XtRemoveSignal . .SH "SEE ALSO" XtAppAddTimeOut(__libmansuffix__),XtAppAddInput(__libmansuffix__),XtAppAddWorkProc(__libmansuffix__) .br diff --git a/man/XtAppAddTimeOut.man b/man/XtAppAddTimeOut.man index 1103ea7..57fce92 100644 --- a/man/XtAppAddTimeOut.man +++ b/man/XtAppAddTimeOut.man @@ -81,14 +81,14 @@ Specifies the procedure that is\*(Pr. Specifies the ID for the timeout request to be destroyed. .SH DESCRIPTION The -.ZN XtAppAddTimeOut +.BR XtAppAddTimeOut function creates a timeout and returns an identifier for it. The timeout value is set to interval. The callback procedure is called when the time interval elapses, and then the timeout is removed. .LP The -.ZN XtRemoveTimeOut +.BR XtRemoveTimeOut function removes the timeout. Note that timeouts are automatically removed once they trigger. .SH "SEE ALSO" diff --git a/man/XtAppAddWorkProc.man b/man/XtAppAddWorkProc.man index 9742bf0..7791b92 100644 --- a/man/XtAppAddWorkProc.man +++ b/man/XtAppAddWorkProc.man @@ -79,12 +79,12 @@ Specifies the procedure that is to be called. Specifies which work procedure to remove. .SH DESCRIPTION The -.ZN XtAppAddWorkProc +.BR XtAppAddWorkProc function adds the specified work procedure for the application identified by app_context. .LP The -.ZN XtRemoveWorkProc +.BR XtRemoveWorkProc function explicitly removes the specified background work procedure. .SH "SEE ALSO" XtAppNextEvent(__libmansuffix__) diff --git a/man/XtAppCreateShell.man b/man/XtAppCreateShell.man index c71e459..903b103 100644 --- a/man/XtAppCreateShell.man +++ b/man/XtAppCreateShell.man @@ -87,12 +87,12 @@ Specifies the number of arguments in the argument list. Specifies the variable argument list\*(Di. .SH DESCRIPTION The -.ZN XtAppCreateShell +.BR XtAppCreateShell function saves the specified application name and application class for qualifying all widget resource specifiers. The application name and application class are used as the left-most components in all widget resource names for this application. -.ZN XtAppCreateShell +.BR XtAppCreateShell should be used to create a new logical application within a program or to create a shell on another display. In the first case, @@ -101,7 +101,7 @@ In the second case, it uses the resource database associated with the other display. .LP Note that the widget returned by -.ZN XtAppCreateShell +.BR XtAppCreateShell has the \s-1WM_COMMAND\s+1 property set for session managers (see Chapter 4). .SH "SEE ALSO" diff --git a/man/XtAppError.man b/man/XtAppError.man index 1c68b4e..fb5bf74 100644 --- a/man/XtAppError.man +++ b/man/XtAppError.man @@ -85,21 +85,21 @@ Specifies the new \*(Ha. Specifies the message that is to be \*(Me. .SH DESCRIPTION The -.ZN XtAppError +.BR XtAppError function calls the installed error procedure and passes the specified message. .LP The -.ZN XtAppSetErrorHandler +.BR XtAppSetErrorHandler function registers the specified procedure, which is called when a fatal error condition occurs. .LP The -.ZN XtAppSetWarningHandler +.BR XtAppSetWarningHandler registers the specified procedure, which is called when a nonfatal error condition occurs. .LP The -.ZN XtAppWarning +.BR XtAppWarning function calls the installed nonfatal error procedure and passes the specified message. .SH "SEE ALSO" diff --git a/man/XtAppErrorMsg.man b/man/XtAppErrorMsg.man index 363a9ad..3a794d5 100644 --- a/man/XtAppErrorMsg.man +++ b/man/XtAppErrorMsg.man @@ -97,22 +97,22 @@ Specifies the number of values in the parameter list. Specifies a pointer to a list of values to be stored in the message. .SH DESCRIPTION The -.ZN XtAppErrorMsg +.BR XtAppErrorMsg function calls the high-level error handler and passes the specified information. .LP The -.ZN XtAppSetErrorMsgHandler +.BR XtAppSetErrorMsgHandler function registers the specified procedure, which is called when a fatal error occurs. .LP The -.ZN XtAppSetWarningMsgHandler +.BR XtAppSetWarningMsgHandler function registers the specified procedure, which is called when a nonfatal error condition occurs. .LP The -.ZN XtAppWarningMsg +.BR XtAppWarningMsg function calls the high-level error handler and passes the specified information. .SH "SEE ALSO" diff --git a/man/XtAppGetErrorDatabase.man b/man/XtAppGetErrorDatabase.man index 491f780..d8af9c0 100644 --- a/man/XtAppGetErrorDatabase.man +++ b/man/XtAppGetErrorDatabase.man @@ -89,14 +89,14 @@ of the error message. Specifies the size of the buffer in bytes. .SH DESCRIPTION The -.ZN XtAppGetErrorDatabase +.BR XtAppGetErrorDatabase function returns the address of the error database. The \*(xI do a lazy binding of the error database and do not merge in the database file until the first call to -.ZN XtAppGetErrorDatbaseText . +.BR XtAppGetErrorDatbaseText . .LP The -.ZN XtAppGetErrorDatabaseText +.BR XtAppGetErrorDatabaseText returns the appropriate message from the error database or returns the specified default message if one is not found in the error database. diff --git a/man/XtAppGetSelectionTimeout.man b/man/XtAppGetSelectionTimeout.man index 7051ec2..d10dfc1 100644 --- a/man/XtAppGetSelectionTimeout.man +++ b/man/XtAppGetSelectionTimeout.man @@ -72,19 +72,19 @@ Specifies the application context. Specifies the selection timeout in milliseconds. .SH DESCRIPTION The -.ZN XtAppGetSelectionTimeout +.BR XtAppGetSelectionTimeout function returns the current selection timeout value, in milliseconds. The selection timeout is the time within which the two communicating applications must respond to one another. The initial timeout value is set by the -.ZN selectionTimeout +.BR selectionTimeout application resource, or, if -.ZN selectionTimeout +.BR selectionTimeout is not specified, it defaults to five seconds. .LP The -.ZN XtAppSetSelectionTimeout +.BR XtAppSetSelectionTimeout function sets the \*(xI's selection timeout mechanism. Note that most applications should not set the selection timeout. .SH "SEE ALSO" diff --git a/man/XtAppInitialize.man b/man/XtAppInitialize.man index b0a6296..f69ba26 100644 --- a/man/XtAppInitialize.man +++ b/man/XtAppInitialize.man @@ -78,7 +78,7 @@ Specifies the class name of this application\*(Ac. .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 -.ZN XrmParseCommand . +.BR XrmParseCommand . For further information, see \fI\*(xL\fP. .IP \fInum_options\fP 1i @@ -100,35 +100,35 @@ Specifies the variable argument list to override any other resource specification for the created shell widget. .SH DESCRIPTION The -.ZN XtAppInitialize +.BR XtAppInitialize function calls -.ZN XtToolkitInitialize +.BR XtToolkitInitialize followed by -.ZN XtCreateApplicationContext , +.BR XtCreateApplicationContext , then calls -.ZN XtOpenDisplay +.BR XtOpenDisplay with \fIdisplay_string\fP NULL and \fIapplication_name\fP NULL, and finally calls -.ZN XtAppCreateShell +.BR XtAppCreateShell with \fIapplication_name\fP NULL, \fIwidget_class\fP -.ZN applicationShellWidgetClass , +.BR applicationShellWidgetClass , and the specified \fIargs\fP and \fInum_args\fP and returns the created shell. The modified \fIargc\fP and \fIargv\fP returned by -.ZN XtDisplayInitialize +.BR XtDisplayInitialize are returned in \fIargc_in_out\fP and \fIargv_in_out\fP. If \fIapp_context_return\fP is not NULL, the created application context is also returned. If the display specified by the command line cannot be opened, an error message is issued and -.ZN XtAppInitialize +.BR XtAppInitialize terminates the application. If \fIfallback_resources\fP is non-NULL, -.ZN XtAppSetFallbackResources +.BR XtAppSetFallbackResources is called with the value prior to calling -.ZN XtOpenDisplay . +.BR XtOpenDisplay . .LP XtAppInitialize and XtVaAppInitialize have been superceded by -.ZN XtOpenApplication +.BR XtOpenApplication and -.ZN XtVaOpenApplication +.BR XtVaOpenApplication respectively. .SH "SEE ALSO" XtOpenApplication(__libmansuffix__), XtVaOpenApplication(__libmansuffix__) diff --git a/man/XtAppLock.man b/man/XtAppLock.man index 885aa5c..c426d7f 100644 --- a/man/XtAppLock.man +++ b/man/XtAppLock.man @@ -67,10 +67,10 @@ void XtAppUnlock(XtAppContext \fIapp_context\fP); .IP \fIapp_context\fP 1i Specifies the application context. .SH DESCRIPTION -.ZN XtAppLock +.BR XtAppLock locks the application context including all its related displays and widgets. .LP -.ZN XtAppUnlock +.BR XtAppUnlock unlocks the application context. .SH "SEE ALSO" .br diff --git a/man/XtAppNextEvent.man b/man/XtAppNextEvent.man index 08b2ad2..d244e4f 100644 --- a/man/XtAppNextEvent.man +++ b/man/XtAppNextEvent.man @@ -88,17 +88,17 @@ Returns the event information to the specified event structure. .IP \fImask\fP 1i Specifies what types of events to process. The mask is the bitwise inclusive OR of any combination of -.ZN XtIMXEvent , -.ZN XtIMTimer , -.ZN XtIMAlternateInput , +.BR XtIMXEvent , +.BR XtIMTimer , +.BR XtIMAlternateInput , and -.ZN XtIMSignal . +.BR XtIMSignal . As a convenience, the \*(tk defines the symbolic name -.ZN XtIMAll +.BR XtIMAll to be the bitwise inclusive OR of all event types. .SH DESCRIPTION If the X event queue is empty, -.ZN XtAppNextEvent +.BR XtAppNextEvent flushes the X output buffers of each Display in the application context and waits for an event while looking at the other input sources, timeout timeout values, and signal handlers and calling any callback procedures @@ -106,54 +106,54 @@ triggered by them. This wait time can be used for background processing (see Section 7.8). .LP If there is an event in the queue, -.ZN XtAppPeekEvent +.BR XtAppPeekEvent fills in the event and returns a nonzero value. If no X input is on the queue, -.ZN XtAppPeekEvent +.BR XtAppPeekEvent flushes the output buffer and blocks until input is available (possibly calling some timeout callbacks in the process). If the input is an event, -.ZN XtAppPeekEvent +.BR XtAppPeekEvent fills in the event and returns a nonzero value. Otherwise, the input is for an alternate input source, and -.ZN XtAppPeekEvent +.BR XtAppPeekEvent returns zero. .LP The -.ZN XtAppPending +.BR XtAppPending function returns a nonzero value if there are events pending from the X server, timer pending, or other input sources pending. The value returned is a bit mask that is the OR of -.ZN XtIMXEvent , -.ZN XtIMTimer , -.ZN XtIMAlternateInput , +.BR XtIMXEvent , +.BR XtIMTimer , +.BR XtIMAlternateInput , and -.ZN XtIMSignal +.BR XtIMSignal (see -.ZN XtAppProcessEvent ). +.BR XtAppProcessEvent ). If there are no events pending, -.ZN XtAppPending +.BR XtAppPending flushes the output buffer and returns zero. .LP The -.ZN XtAppProcessEvent +.BR XtAppProcessEvent function processes one timer, alternate input, signal source, or X event. If there is nothing of the appropriate type to process, -.ZN XtAppProcessEvent +.BR XtAppProcessEvent blocks until there is. If there is more than one type of thing available to process, it is undefined which will get processed. Usually, this procedure is not called by client applications (see -.ZN XtAppMainLoop ). -.ZN XtAppProcessEvent +.BR XtAppMainLoop ). +.BR XtAppProcessEvent processes timer events by calling any appropriate timer callbacks, alternate input by calling any appropriate alternate input callbacks, signal source by calling any appropriate signal callbacks, and X events by calling -.ZN XtDispatchEvent . +.BR XtDispatchEvent . .LP When an X event is received, it is passed to -.ZN XtDispatchEvent , +.BR XtDispatchEvent , which calls the appropriate event handlers and passes them the widget, the event, and client-specific data registered with each procedure. @@ -162,51 +162,51 @@ the event is ignored and the dispatcher simply returns. The order in which the handlers are called is undefined. .LP The -.ZN XtDispatchEvent +.BR XtDispatchEvent function sends those events to the event handler functions that have been previously registered with the dispatch routine. -.ZN XtDispatchEvent +.BR XtDispatchEvent returns -.ZN True +.BR True if it dispatched the event to some handler and -.ZN False +.BR False if it found no handler to dispatch the event to. The most common use of -.ZN XtDispatchEvent +.BR XtDispatchEvent is to dispatch events acquired with the -.ZN XtAppNextEvent +.BR XtAppNextEvent procedure. However, it also can be used to dispatch user-constructed events. -.ZN XtDispatchEvent +.BR XtDispatchEvent also is responsible for implementing the grab semantics for -.ZN XtAddGrab . +.BR XtAddGrab . .LP The -.ZN XtAppMainLoop +.BR XtAppMainLoop function first reads the next incoming X event by calling -.ZN XtAppNextEvent +.BR XtAppNextEvent and then it dispatches the event to the appropriate registered procedure by calling -.ZN XtDispatchEvent . +.BR XtDispatchEvent . This constitutes the main loop of \*(tk applications, and, as such, it does not return unless -.ZN XtAppSetExitFlag +.BR XtAppSetExitFlag is called. Applications are expected to exit in response to some user action. There is nothing special about -.ZN XtAppMainLoop ; +.BR XtAppMainLoop ; it is simply an loop that calls -.ZN XtAppNextEvent +.BR XtAppNextEvent and then -.ZN XtDispatchEvent , +.BR XtDispatchEvent , until -.ZN XtAppGetExitFlag () +.BR XtAppGetExitFlag () returns true. .LP Applications can provide their own version of this loop, which tests some global termination flag or tests that the number of top-level widgets is larger than zero before circling back to the call to -.ZN XtAppNextEvent . +.BR XtAppNextEvent . .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtAppReleaseCacheRefs.man b/man/XtAppReleaseCacheRefs.man index 74c5bb8..a58b5c2 100644 --- a/man/XtAppReleaseCacheRefs.man +++ b/man/XtAppReleaseCacheRefs.man @@ -68,11 +68,11 @@ Specifies the application context. .IP \fIrefs\fP 1i Specifies the list of cache references to be released. .SH DESCRIPTION -.ZN XtAppReleaseCacheRefs +.BR XtAppReleaseCacheRefs decrements the reference count for the conversion entries identified by the \fIrefs\fP argument. This argument is a pointer to a NULL-terminated list of -.ZN XtCacheRef +.BR XtCacheRef values. If any reference count reaches zero, the destructor, if any, will be called and the resource removed from the conversion cache. .SH "SEE ALSO" diff --git a/man/XtAppSetExitFlag.man b/man/XtAppSetExitFlag.man index 7377744..361e59f 100644 --- a/man/XtAppSetExitFlag.man +++ b/man/XtAppSetExitFlag.man @@ -68,10 +68,10 @@ Boolean XtAppGetExitFlag(XtAppContext \fIapp_context\fP); Specifies the application context. .SH DESCRIPTION To indicate that an application context should exit, use -.ZN XtAppSetExitFlag . +.BR XtAppSetExitFlag . .LP To test the exit status of an application context, use -.ZN XtAppGetExitFlag . +.BR XtAppGetExitFlag . .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtAppSetFallbackResources.man b/man/XtAppSetFallbackResources.man index 57cf1a7..579d8ea 100644 --- a/man/XtAppSetFallbackResources.man +++ b/man/XtAppSetFallbackResources.man @@ -70,20 +70,20 @@ Specifies a NULL-terminated list of resource specifications to pre-load the database, or NULL. .SH DESCRIPTION Each entry in \fIspecification_list\fP points to a string in the format -.ZN XrmPutLineResource . +.BR XrmPutLineResource . following a call to -.ZN XtAppSetFallbackResources , +.BR XtAppSetFallbackResources , when a resource database is being created for a particular screen and the Intrinsics are not able to find or read an application-specific class resource file and if \fIspecification_list\fP is not NULL the resource specification in \fIspecification_list\fP will be merged into the screen resource database in place of the application-specific class resource file. -.ZN XtAppSetFallbackResources +.BR XtAppSetFallbackResources is not required to copy \fIspecification_list\fP; the caller must ensure that the contents of the list and the strings addressed by the list remain valid until all displays are initialized or until -.ZN XtAppSetFallbackResources +.BR XtAppSetFallbackResources is called again. The value NULL for \fIspecification_list\fP removes any previous fallback resource specification for the application context. The intended use for fallback resources is to provide a minimal number diff --git a/man/XtAppSetTypeConverter.man b/man/XtAppSetTypeConverter.man index 997196d..256bc62 100644 --- a/man/XtAppSetTypeConverter.man +++ b/man/XtAppSetTypeConverter.man @@ -89,11 +89,11 @@ Specifies a destroy procedure for resources produced by this conversion, or NULL if no additional action is required to deallocate resources produced by the converter. .SH DESCRIPTION -.ZN XtSetTypeConverter +.BR XtSetTypeConverter registers the specified type converter and destructor in all application contexts created by the calling process, including any future application contexts that may be created. -.ZN XtAppSetTypeConverter +.BR XtAppSetTypeConverter registers the specified type converter in the single application context specified. If the same \fIfrom_type\fP and \fIto_type\fP are specified in multiple calls to either function, the most recent overrides the diff --git a/man/XtBuildEventMask.man b/man/XtBuildEventMask.man index 872f0b0..b231fb1 100644 --- a/man/XtBuildEventMask.man +++ b/man/XtBuildEventMask.man @@ -67,16 +67,16 @@ EventMask XtBuildEventMask(Widget \fIw\fP); Specifies the widget. .SH DESCRIPTION The -.ZN XtBuildEventMask +.BR XtBuildEventMask function returns the event mask representing the logical OR of all event masks for event handlers registered on the widget with -.ZN XtAddEventHandler +.BR XtAddEventHandler and all event translations, including accelerators, installed on the widget. This is the same event mask stored into the -.ZN XSetWindowAttributes +.BR XSetWindowAttributes structure by -.ZN XtRealizeWidget +.BR XtRealizeWidget and sent to the server when event handlers and translations are installed or removed on the realized widget. .SH "SEE ALSO" diff --git a/man/XtCallAcceptFocus.man b/man/XtCallAcceptFocus.man index 110468f..7360acc 100644 --- a/man/XtCallAcceptFocus.man +++ b/man/XtCallAcceptFocus.man @@ -69,14 +69,14 @@ Specifies the X time of the event that is causing the accept focus. Specifies the widget. .SH DESCRIPTION The -.ZN XtCallAcceptFocus +.BR XtCallAcceptFocus function calls the specified widget's accept_focus procedure, passing it the specified widget and time, and returns what the accept_focus procedure returns. If accept_focus is NULL, -.ZN XtCallAcceptFocus +.BR XtCallAcceptFocus returns -.ZN False . +.BR False . .SH "SEE ALSO" XtSetKeyboardFocus(__libmansuffix__) .br diff --git a/man/XtCallActionProc.man b/man/XtCallActionProc.man index ebb1cdd..e039776 100644 --- a/man/XtCallActionProc.man +++ b/man/XtCallActionProc.man @@ -75,7 +75,7 @@ Specifies the contents of the \fIparams\fP passed to the action routine. .IP \fInum_params\fP 1i Specifies the num of entries in \fIparams\fP. .SH DESCRIPTION -.ZN XtCallActionProc +.BR XtCallActionProc searches for the named action routine in the same manner and order as translation tables are bound. If found, the action routine is invoked with the specified widget, event pointer, and parameters. It is the @@ -83,7 +83,7 @@ responsibility of the caller to ensure that the contents of \fIevent\fP, \fIparams\fP, and \fInum_params\fP arguments are appropriate for the specified routine, and if necessary, that the specified widget is realized or sensitive. If the named action routine cannot be found, -.ZN XtCallActionProc +.BR XtCallActionProc generates a warning message and returns. .SH "SEE ALSO" .br diff --git a/man/XtCallCallbacks.man b/man/XtCallCallbacks.man index 1c1c6a1..f7fc7a6 100644 --- a/man/XtCallCallbacks.man +++ b/man/XtCallCallbacks.man @@ -83,32 +83,32 @@ Specifies the callback list to be executed. Specifies the widget. .SH DESCRIPTION The -.ZN XtCallCallbacks +.BR XtCallCallbacks function calls each procedure that is registered in the specified widget's callback list. .LP If \fIcallbacks\fP is not NULL, -.ZN XtCallCallbackList +.BR XtCallCallbackList calls each of the callback procedures in the list, passing client data and \fIcall_data\fP. The \fIcallbacks\fP parameter must specify the contents of a widget or object resource declared with representation type -.ZN XtRCallback . +.BR XtRCallback . .LP The -.ZN XtHasCallbacks +.BR XtHasCallbacks function first checks to see if the widget has a callback list identified by callback_name. If the callback list does not exist, -.ZN XtHasCallbacks +.BR XtHasCallbacks returns -.ZN XtCallbackNoList . +.BR XtCallbackNoList . If the callback list exists but is empty, it returns -.ZN XtCallbackHasNone . +.BR XtCallbackHasNone . If the callback list exists and has at least one callback registered, it returns -.ZN XtCallbackHasSome . +.BR XtCallbackHasSome . .SH "SEE ALSO" XtAddCallback(__libmansuffix__) .br diff --git a/man/XtClass.man b/man/XtClass.man index 0830de2..041d920 100644 --- a/man/XtClass.man +++ b/man/XtClass.man @@ -108,63 +108,63 @@ Specifies the widget class. Specifies the message that is to be \*(Me. .SH DESCRIPTION The -.ZN XtClass +.BR XtClass function returns a pointer to the widget's class structure. .LP The -.ZN XtSuperclass +.BR XtSuperclass function returns a pointer to the widget's superclass class structure. .LP The -.ZN XtIsSubclass +.BR XtIsSubclass function returns -.ZN True +.BR True if the class of the specified widget is equal to or is a subclass of the specified class. The widget's class can be any number of subclasses down the chain and need not be an immediate subclass of the specified class. Composite widgets that need to restrict the class of the items they contain can use -.ZN XtIsSubclass +.BR XtIsSubclass to find out if a widget belongs to the desired class of objects. .LP The -.ZN XtCheckSubclass +.BR XtCheckSubclass macro determines if the class of the specified widget is equal to or is a subclass of the specified widget class. The widget can be any number of subclasses down the chain and need not be an immediate subclass of the specified widget class. If the specified widget is not a subclass, -.ZN XtCheckSubclass +.BR XtCheckSubclass constructs an error message from the supplied message, the widget's actual class, and the expected class and calls -.ZN XtErrorMsg . -.ZN XtCheckSubclass +.BR XtErrorMsg . +.BR XtCheckSubclass should be used at the entry point of exported routines to ensure that the client has passed in a valid widget class for the exported operation. .LP -.ZN XtCheckSubclass +.BR XtCheckSubclass is only executed when the widget has been compiled with the compiler symbol DEBUG defined; otherwise, it is defined as the empty string and generates no code. .LP To test if a given widget belongs to a subclass of an Intrinsics-defined class, the Intrinsics defines macros or functions equivalent to -.ZN XtIsSubclass +.BR XtIsSubclass for each of the built-in classes. These procedures are -.ZN XtIsObject , -.ZN XtIsRectObj , -.ZN XtIsWidget , -.ZN XtIsComposite , -.ZN XtIsConstraint , -.ZN XtIsShell , -.ZN XtIsOverrideShell , -.ZN XtIsWMShell , -.ZN XtIsVendorShell , -.ZN XtIsTransientShell , -.ZN XtIsTopLevelShell , -.ZN XtIsApplicationShell , +.BR XtIsObject , +.BR XtIsRectObj , +.BR XtIsWidget , +.BR XtIsComposite , +.BR XtIsConstraint , +.BR XtIsShell , +.BR XtIsOverrideShell , +.BR XtIsWMShell , +.BR XtIsVendorShell , +.BR XtIsTransientShell , +.BR XtIsTopLevelShell , +.BR XtIsApplicationShell , and -.ZN XtIsSessionShell . +.BR XtIsSessionShell . .LP The .SH "SEE ALSO" diff --git a/man/XtConfigureWidget.man b/man/XtConfigureWidget.man index 3e9268d..8235138 100644 --- a/man/XtConfigureWidget.man +++ b/man/XtConfigureWidget.man @@ -89,51 +89,51 @@ Specifies the widget. Specify the \*(Nu x and y coordinates. .SH DESCRIPTION The -.ZN XtConfigureWidget +.BR XtConfigureWidget function returns immediately if the specified geometry fields are the same as the old values. Otherwise, -.ZN XtConfigureWidget +.BR XtConfigureWidget writes the new x, y, width, height, and border_width values into the widget and, if the widget is realized, makes an Xlib -.ZN XConfigureWindow +.BR XConfigureWindow call on the widget's window. .LP If either the new width or height is different from its old value, -.ZN XtConfigureWidget +.BR XtConfigureWidget calls the widget's resize procedure to notify it of the size change; otherwise, it simply returns. .LP The -.ZN XtMoveWidget +.BR XtMoveWidget function returns immediately if the specified geometry fields are the same as the old values. Otherwise, -.ZN XtMoveWidget +.BR XtMoveWidget writes the new x and y values into the widget and, if the widget is realized, issues an Xlib -.ZN XMoveWindow +.BR XMoveWindow call on the widget's window. .LP The -.ZN XtResizeWidget +.BR XtResizeWidget function returns immediately if the specified geometry fields are the same as the old values. Otherwise, -.ZN XtResizeWidget +.BR XtResizeWidget writes the new width, height, and border_width values into the widget and, if the widget is realized, issues an -.ZN XConfigureWindow +.BR XConfigureWindow call on the widget's window. .LP If the new width or height are different from the old values, -.ZN XtResizeWidget +.BR XtResizeWidget calls the widget's resize procedure to notify it of the size change. .LP The -.ZN XtResizeWindow +.BR XtResizeWindow function calls the -.ZN XConfigureWindow +.BR XConfigureWindow Xlib function to make the window of the specified widget match its width, height, and border width. This request is done unconditionally because there is no way to tell if these @@ -141,9 +141,9 @@ values match the current values. Note that the widget's resize procedure is not called. .LP There are very few times to use -.ZN XtResizeWindow ; +.BR XtResizeWindow ; instead, you should use -.ZN XtResizeWidget . +.BR XtResizeWidget . .SH "SEE ALSO" XtMakeGeometryRequest(__libmansuffix__), XtQueryGeometry(__libmansuffix__) diff --git a/man/XtConvert.man b/man/XtConvert.man index a581375..98e1ca0 100644 --- a/man/XtConvert.man +++ b/man/XtConvert.man @@ -88,29 +88,29 @@ Returns the converted value. Specifies the widget \*(Wi. .SH DESCRIPTION The -.ZN XtConvert +.BR XtConvert function looks up the type converter registered to convert from_type to to_type, computes any additional arguments needed, and then calls -.ZN XtDirectConvert . -.ZN XtConvert +.BR XtDirectConvert . +.BR XtConvert has been replaced by -.ZN XtConvertAndStore . +.BR XtConvertAndStore . .LP The -.ZN XtDirectConvert +.BR XtDirectConvert function looks in the converter cache to see if this conversion procedure has been called with the specified arguments. If so, it returns a descriptor for information stored in the cache; otherwise, it calls the converter and enters the result in the cache. .LP Before calling the specified converter, -.ZN XtDirectConvert +.BR XtDirectConvert sets the return value size to zero and the return value address to NULL. To determine if the conversion was successful, the client should check to_return.address for non-NULL. -.ZN XtDirectConvert +.BR XtDirectConvert has been replaced by -.ZN XtCallConverter . +.BR XtCallConverter . .SH "SEE ALSO" XtAppAddConverter(__libmansuffix__), XtStringConversionWarning(__libmansuffix__), diff --git a/man/XtConvertAndStore.man b/man/XtConvertAndStore.man index 4a9f064..272ff44 100644 --- a/man/XtConvertAndStore.man +++ b/man/XtConvertAndStore.man @@ -89,58 +89,58 @@ and the destroy callback list. Specifies the display with which the conversion is to be associated. .SH DESCRIPTION The -.ZN XtConvertAndStore +.BR XtConvertAndStore function looks up the type converter registered to convert from_type to to_type, computes any additional arguments needed, and then calls -.ZN XtCallConverter . +.BR XtCallConverter . (or -.ZN XtDirectConvert +.BR XtDirectConvert if an old-style converter was registered with -.ZN XtAddConverter +.BR XtAddConverter or -.ZN XtAppAddConverter . +.BR XtAppAddConverter . ) with the from and to_in_out arguments. .LP The -.ZN XtCallConverter +.BR XtCallConverter function looks up the specified type converter in the application context associated with the display and, if the converter was not registered or was registered with cache type -.ZN XtCacheAll +.BR XtCacheAll or -.ZN XtCacheByDisplay +.BR XtCacheByDisplay looks in the conversion cache to see if this conversion procedure has been called with the specified conversion arguments. If so, it checks the success status of the prior call, and if the conversion failed, -.ZN XtCallConverter +.BR XtCallConverter returns -.ZN False +.BR False immediately; otherwise it checks the size specified in the \fIto\fP argument and, if it is greater than or equal to the size stored in the cache, copies the information stored in the cache into the location specified by \fIto->addr\fP, stores the cache size into \fIto->size\fP, and returns -.ZN True . +.BR True . If the size specified in the \fIto\fP argument is smaller than the size stored in the cache, -.ZN XtCallConverter +.BR XtCallConverter copies the cache size into the \fIto->size\fP and returns -.ZN False . +.BR False . If the converter was registered with cache type -.ZN XtCacheNone +.BR XtCacheNone or no value was found in the conversion cache, -.ZN XtCallConverter +.BR XtCallConverter calls the converter and, if it was not registered with cache type -.ZN XtCacheNone , +.BR XtCacheNone , enters the result into the cache. -.ZN XtCallConverter +.BR XtCallConverter then returns what the converter returned. .LP The \fIcache_ref_return\fP field specifies storage allocated by the caller in which an opaque value will be stored. If the type converter has been registered with the -.ZN XtCacheRefCount +.BR XtCacheRefCount modifier and if the value returned in in \fIcache_ref_return\fP is non-NULL, then the call should store the \fIcache_ref_return\fP value in order to decrement the reference count when the converted value diff --git a/man/XtCreateApplicationContext.man b/man/XtCreateApplicationContext.man index e3ac7f1..b26f514 100644 --- a/man/XtCreateApplicationContext.man +++ b/man/XtCreateApplicationContext.man @@ -77,28 +77,28 @@ Specifies the application context. Specifies the widget. .SH DESCRIPTION The -.ZN XtCreateApplicationContext +.BR XtCreateApplicationContext function returns an application context, which is an opaque type. Every application must have at least one application context. .LP The -.ZN XtDestroyApplicationContext +.BR XtDestroyApplicationContext function destroys the specified application context as soon as it is safe to do so. If called from with an event dispatch (for example, a callback procedure), -.ZN XtDestroyApplicationContext +.BR XtDestroyApplicationContext does not destroy the application context until the dispatch is complete. .LP The -.ZN XtWidgetToApplicationContext +.BR XtWidgetToApplicationContext function returns the application context for the specified widget. .LP The -.ZN XtToolkitInitialize +.BR XtToolkitInitialize function initializes the Intrinsics internals. If -.ZN XtToolkitInitialize +.BR XtToolkitInitialize was previously called it returns immediately. .LP .SH "SEE ALSO" diff --git a/man/XtCreateApplicationShell.man b/man/XtCreateApplicationShell.man index b956137..007514c 100644 --- a/man/XtCreateApplicationShell.man +++ b/man/XtCreateApplicationShell.man @@ -72,15 +72,15 @@ Specifies the argument list to override any other resource specifications. Specifies the number of arguments in the argument list. .SH DESCRIPTION The procedure -.ZN XtCreateApplicationShell +.BR XtCreateApplicationShell calls -.ZN XtAppCreateShell +.BR XtAppCreateShell with the \fIapplication\fP NULL, the application class passed to -.ZN XtInitialize , +.BR XtInitialize , and the default application context created by -.ZN XtInitialize . +.BR XtInitialize . This routine has been replaced by -.ZN XtAppCreateShell . +.BR XtAppCreateShell . .SH "SEE ALSO" XtAppCreateShell(__libmansuffix__) .br diff --git a/man/XtCreatePopupShell.man b/man/XtCreatePopupShell.man index ea82cc3..3e20961 100644 --- a/man/XtCreatePopupShell.man +++ b/man/XtCreatePopupShell.man @@ -84,9 +84,9 @@ Specifies the widget class\*(Wc. Specifies the variable argument list \*(Al. .SH DESCRIPTION The -.ZN XtCreatePopupShell +.BR XtCreatePopupShell function ensures that the specified class is a subclass of -.ZN Shell +.BR Shell and, rather than using insert_child to attach the widget to the parent's .IN "insert_child procedure" children list, attaches the shell to the parent's pop-ups list directly. diff --git a/man/XtCreateSelectionRequest.man b/man/XtCreateSelectionRequest.man index 8b6254a..120f307 100644 --- a/man/XtCreateSelectionRequest.man +++ b/man/XtCreateSelectionRequest.man @@ -77,51 +77,51 @@ Specifies the particular selection desired. Specifies the timestamp to be used in making the request. .SH DESCRIPTION When -.ZN XtCreateSelectionRequest +.BR XtCreateSelectionRequest is called, subsequent calls to -.ZN XtGetSelectionValue +.BR XtGetSelectionValue and -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental with the requestor and selection as specified to -.ZN XtCreateSelectionRequest +.BR XtCreateSelectionRequest will be bundled into a single selection conversion request with multiple targets. The request is actually initiated by calling -.ZN XtSendSelectionRequest . +.BR XtSendSelectionRequest . .LP When -.ZN XtSendSelectionRequest +.BR XtSendSelectionRequest is called with a value of \fIrequestor\fP and \fIselection\fP matching a previous call to -.ZN XtCreateSelectionRequest , +.BR XtCreateSelectionRequest , a selection conversion request is actually sent to the selection owner. If a single target request is queued, that request is made. If multiple targets are queued they are bundled into a single request with the target MULTIPLE using the specified timestamp. As the conversions are made, the callbacks associated with each -.ZN XtGetSelectionValue +.BR XtGetSelectionValue and -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental are invoked in turn. .LP Multi-threaded applications should lock the application context before calling -.ZN XtCreateSelectionRequest +.BR XtCreateSelectionRequest and release the lock after calling -.ZN XtSendSelectionRequest +.BR XtSendSelectionRequest to ensure that the thread assembling the request is safe from interference by another thread assembling a different request naming the same widget and selection. .LP When -.ZN XtCancelSelectionRequest +.BR XtCancelSelectionRequest is called, any requests queued since the last call to -.ZN XtCreateSelectionRequest +.BR XtCreateSelectionRequest are cleaned up. Subsequent calls to -.ZN XtGetSelectionValue , -.ZN XtGetSelectionValues , -.ZN XtGetSelectionValueIncremental , +.BR XtGetSelectionValue , +.BR XtGetSelectionValues , +.BR XtGetSelectionValueIncremental , and -.ZN XtGetSelectionValuesIncremental +.BR XtGetSelectionValuesIncremental will not be deferred. .SH "SEE ALSO" .br diff --git a/man/XtCreateWidget.man b/man/XtCreateWidget.man index 98317a4..4c18fa0 100644 --- a/man/XtCreateWidget.man +++ b/man/XtCreateWidget.man @@ -98,7 +98,7 @@ Specifies the widget class\*(Wc. Specifies the variable argument list \*(Al. .SH DESCRIPTION The -.ZN XtCreateWidget +.BR XtCreateWidget function performs much of the boilerplate operations of widget creation: .IP \(bu 5 Checks to see if the class_initialize procedure has been called for this class @@ -108,7 +108,7 @@ superclass-to-subclass order. Allocates memory for the widget instance. .IP \(bu 5 If the parent is a subclass of -.ZN constraintWidgetClass , +.BR constraintWidgetClass , it allocates memory for the parent's constraints and stores the address of this memory into the constraints field. .IP \(bu 5 @@ -119,45 +119,45 @@ Initializes the resource fields (for example, background_pixel) by using the resource lists specified for this class and all superclasses. .IP \(bu 5 If the parent is a subclass of -.ZN constraintWidgetClass , +.BR constraintWidgetClass , it initializes the resource fields of the constraints record by using the constraint resource list specified for the parent's class and all superclasses up to -.ZN constraintWidgetClass . +.BR constraintWidgetClass . .IP \(bu 5 Calls the initialize procedures for the widget by starting at the -.ZN Core +.BR Core initialize procedure on down to the widget's initialize procedure. .IP \(bu 5 If the parent is a subclass of -.ZN compositeWidgetClass , +.BR compositeWidgetClass , it puts the widget into its parent's children list by calling its parent's insert_child procedure. For further information, see Section 3.5. .IP \(bu 5 If the parent is a subclass of -.ZN constraintWidgetClass , +.BR constraintWidgetClass , it calls the constraint initialize procedures, starting at -.ZN constraintWidgetClass +.BR constraintWidgetClass on down to the parent's constraint initialize procedure. .LP Note that you can determine the number of arguments in an argument list by using the -.ZN XtNumber +.BR XtNumber macro. For further information, see Section 11.1. .LP The -.ZN XtCreateManagedWidget +.BR XtCreateManagedWidget function is a convenience routine that calls -.ZN XtCreateWidget +.BR XtCreateWidget and -.ZN XtManageChild . +.BR XtManageChild . .LP The -.ZN XtDestroyWidget +.BR XtDestroyWidget function provides the only method of destroying a widget, including widgets that need to destroy themselves. It can be called at any time, @@ -166,16 +166,16 @@ This requires a two-phase destroy process in order to avoid dangling references to destroyed widgets. .LP In phase one, -.ZN XtDestroyWidget +.BR XtDestroyWidget performs the following: .IP \(bu 5 If the being_destroyed field of the widget is -.ZN True , +.BR True , it returns immediately. .IP \(bu 5 Recursively descends the widget tree and sets the being_destroyed field to -.ZN True +.BR True for the widget and all children. .IP \(bu 5 Adds the widget to a list of widgets (the destroy list) that should be @@ -189,12 +189,12 @@ Phase two occurs when all procedures that should execute as a result of the current event have been called (including all procedures registered with the event and translation managers), that is, when the current invocation of -.ZN XtDispatchEvent +.BR XtDispatchEvent is about to return or immediately if not in -.ZN XtDispatchEvent . +.BR XtDispatchEvent . .LP In phase two, -.ZN XtDestroyWidget +.BR XtDestroyWidget performs the following on each entry in the destroy list: .IP \(bu 5 Calls the destroy callback procedures registered on the widget @@ -202,19 +202,19 @@ Calls the destroy callback procedures registered on the widget before parent callbacks). .IP \(bu 5 If the widget's parent is a subclass of -.ZN compositeWidgetClass +.BR compositeWidgetClass and if the parent is not being destroyed, it calls -.ZN XtUnmanageChild +.BR XtUnmanageChild on the widget and then calls the widget's parent's delete_child procedure (see Section 3.4). .IP \(bu 5 If the widget's parent is a subclass of -.ZN constraintWidgetClass , +.BR constraintWidgetClass , it calls the constraint destroy procedure for the parent, then the parent's superclass, until finally it calls the constraint destroy procedure for -.ZN constraintWidgetClass . +.BR constraintWidgetClass . .IP \(bu 5 Calls the destroy methods for the widget (and all descendants) in post-order. @@ -225,13 +225,13 @@ until finally it calls the destroy procedure declared in the Core class record. .IP \(bu 5 Calls -.ZN XDestroyWindow +.BR XDestroyWindow if the widget is realized (that is, has an X window). The server recursively destroys all descendant windows. .IP \(bu 5 Recursively descends the tree and deallocates all pop-up widgets, constraint records, callback lists and, if the widget is a subclass of -.ZN compositeWidgetClass , +.BR compositeWidgetClass , children. .SH "SEE ALSO" XtAppCreateShell(__libmansuffix__), diff --git a/man/XtCreateWindow.man b/man/XtCreateWindow.man index 78f109b..6412d3c 100644 --- a/man/XtCreateWindow.man +++ b/man/XtCreateWindow.man @@ -67,34 +67,34 @@ void XtCreateWindow(Widget \fIw\fP, unsigned int \fIwindow_class\fP, Visual .SH ARGUMENTS .IP \fIattributes\fP 1i Specifies the window attributes to use in the -.ZN XCreateWindow +.BR XCreateWindow call. .ds Vm attribute fields to use .IP \fIvalue_mask\fP 1i Specifies which \*(Vm. .IP \fIvisual\fP 1i Specifies the visual type (usually -.ZN CopyFromParent ). +.BR CopyFromParent ). .ds Wi that is used to set the x,y coordinates and so on .IP \fIw\fP 1i Specifies the widget \*(Wi. .IP \fIwindow_class\fP 1i Specifies the Xlib window class (for example, -.ZN InputOutput , -.ZN InputOnly , +.BR InputOutput , +.BR InputOnly , or -.ZN CopyFromParent ). +.BR CopyFromParent ). .SH DESCRIPTION The -.ZN XtCreateWindow +.BR XtCreateWindow function calls the Xlib -.ZN XCreateWindow +.BR XCreateWindow function with values from the widget structure and the passed parameters. Then, it assigns the created window to the widget's window field. .LP -.ZN XtCreateWindow +.BR XtCreateWindow evaluates the following fields of the -.ZN Core +.BR Core widget structure: .IP \(bu 5 depth diff --git a/man/XtDisplay.man b/man/XtDisplay.man index 14ef065..57a689c 100644 --- a/man/XtDisplay.man +++ b/man/XtDisplay.man @@ -78,22 +78,22 @@ Specifies the widget. .IP \fIobject\fP 1i Specifies the widget. .SH DESCRIPTION -.ZN XtDisplay +.BR XtDisplay returns the display pointer for the specified widget. .LP -.ZN XtDisplayOfObject +.BR XtDisplayOfObject returns the display pointer for the specified object. .LP -.ZN XtScreen +.BR XtScreen returns the screen pointer for the specified widget. .LP -.ZN XtScreenOfObject +.BR XtScreenOfObject returns the screen pointer for the specified object. .LP -.ZN XtWindow +.BR XtWindow returns the window of the specified widget. .LP -.ZN XtWindowOfObject +.BR XtWindowOfObject returns the window of the specified object. .SH "SEE ALSO" .br diff --git a/man/XtDisplayInitialize.man b/man/XtDisplayInitialize.man index a73bd26..1ed6554 100644 --- a/man/XtDisplayInitialize.man +++ b/man/XtDisplayInitialize.man @@ -96,20 +96,20 @@ Specifies the number of entries in the options list. .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 -.ZN XrmParseCommand . +.BR XrmParseCommand . For further information, see \fI\*(xL\fP. .IP \fIscreen\fP 1i Specifies the screen whose resource database is to be returned. .SH DESCRIPTION The -.ZN XtDisplayInitialize +.BR XtDisplayInitialize function builds the resource database, calls the Xlib -.ZN XrmParseCommand +.BR XrmParseCommand function to parse the command line, and performs other per display initialization. After -.ZN XrmParseCommand +.BR XrmParseCommand has been called, argc and argv contain only those parameters that were not in the standard option table or in the table specified by the @@ -120,77 +120,77 @@ listing the allowable options. On UNIX-based systems, the application name is usually the final component of argv[0]. If the synchronize resource is -.ZN True +.BR True for the specified application, -.ZN XtDisplayInitialize +.BR XtDisplayInitialize calls the Xlib -.ZN XSynchronize +.BR XSynchronize function to put Xlib into synchronous mode for this display connection. If the reverseVideo resource is -.ZN True , +.BR True , the \*(xI exchange -.ZN XtDefaultForeground +.BR XtDefaultForeground and -.ZN XtDefaultBackground +.BR XtDefaultBackground for widgets created on this display. (See Section 9.6.1). .LP The -.ZN XtOpenDisplay +.BR XtOpenDisplay function calls -.ZN XOpenDisplay +.BR XOpenDisplay the specified display name. If display_string is NULL, -.ZN XtOpenDisplay +.BR XtOpenDisplay uses the current value of the \-display option specified in argv and if no display is specified in argv, uses the user's default display (on UNIX-based systems, this is the value of the DISPLAY environment variable). .LP If this succeeds, it then calls -.ZN XtDisplayInitialize +.BR XtDisplayInitialize and pass it the opened display and the value of the \-name option specified in argv as the application name. If no name option is specified, it uses the application name passed to -.ZN XtOpenDisplay . +.BR XtOpenDisplay . If the application name is NULL, it uses the last component of argv[0]. -.ZN XtOpenDisplay +.BR XtOpenDisplay returns the newly opened display or NULL if it failed. .LP -.ZN XtOpenDisplay +.BR XtOpenDisplay is provided as a convenience to the application programmer. .LP The -.ZN XtCloseDisplay +.BR XtCloseDisplay function closes the specified display as soon as it is safe to do so. If called from within an event dispatch (for example, a callback procedure), -.ZN XtCloseDisplay +.BR XtCloseDisplay does not close the display until the dispatch is complete. Note that applications need only call -.ZN XtCloseDisplay +.BR XtCloseDisplay if they are to continue executing after closing the display; otherwise, they should call -.ZN XtDestroyApplicationContext +.BR XtDestroyApplicationContext or just exit. .LP The -.ZN XtDatabase +.BR XtDatabase function returns the fully merged resource database that was built by -.ZN XtDisplayInitialize +.BR XtDisplayInitialize associated with the display that was passed in. If this display has not been initialized by -.ZN XtDisplayInitialize , +.BR XtDisplayInitialize , the results are not defined. .LP The -.ZN XtScreenDatabase +.BR XtScreenDatabase function returns the fully merged resource database associated with the specified screen. If the \fIscreen\fP does not belong to a -.ZN Display +.BR Display initialized by -.ZN XtDisplayInitialize , +.BR XtDisplayInitialize , the results are undefined. .SH "SEE ALSO" XtAppCreateShell(__libmansuffix__), diff --git a/man/XtDisplayStringConversionWarning.man b/man/XtDisplayStringConversionWarning.man index 6390b38..2e4846c 100644 --- a/man/XtDisplayStringConversionWarning.man +++ b/man/XtDisplayStringConversionWarning.man @@ -72,18 +72,18 @@ Specifies the string that could not be converted. Specifies the target representation type requested. .SH DESCRIPTION The -.ZN XtDisplayStringConversionWarning +.BR XtDisplayStringConversionWarning function issues a warning message using -.ZN XtAppWarningMsg +.BR XtAppWarningMsg with name ``conversionError'', type ``string'', class ``XtToolkitError, and the default message string ``Cannot convert "\fIfrom_value\fP" to type \fIto_type\fP''. .LP To issue other types of warning or error messages, the type converter should use -.ZN XtAppWarningMsg +.BR XtAppWarningMsg or -.ZN XtAppErrorMsg . +.BR XtAppErrorMsg . .SH "SEE ALSO" XtAppWarningMsg(3t) .br diff --git a/man/XtDisplayToApplicationContext.man b/man/XtDisplayToApplicationContext.man index e6c946b..abc3755 100644 --- a/man/XtDisplayToApplicationContext.man +++ b/man/XtDisplayToApplicationContext.man @@ -67,7 +67,7 @@ XtAppContext XtDisplayToApplicationContext(Display* \fIdpy\fP); Specifies the display \*(Wi. .SH DESCRIPTION The -.ZN XtDisplayToApplicationContext +.BR XtDisplayToApplicationContext function returns the application context for the specified display. .SH "SEE ALSO" \fI\*(xT\fP diff --git a/man/XtError.man b/man/XtError.man index dca326e..9b6f5e8 100644 --- a/man/XtError.man +++ b/man/XtError.man @@ -79,24 +79,24 @@ Specifies the new \*(Ha. Specifies the message that is to be \*(Me. .SH DESCRIPTION The -.ZN XtError +.BR XtError function has been superceded by -.ZN XtAppError . +.BR XtAppError . .LP The -.ZN XtSetErrorHandler +.BR XtSetErrorHandler function has been superceded by -.ZN XtAppSetErrorHandler . +.BR XtAppSetErrorHandler . .LP The -.ZN XtSetWarningHandler +.BR XtSetWarningHandler function has been superceded by -.ZN XtAppSetWarningHandler . +.BR XtAppSetWarningHandler . .LP The -.ZN XtWarning +.BR XtWarning function has been superceded by -.ZN XtAppWarning . +.BR XtAppWarning . .SH "SEE ALSO" .BR XtAppError (__libmansuffix__) .br diff --git a/man/XtErrorMsg.man b/man/XtErrorMsg.man index 028f851..4d32f98 100644 --- a/man/XtErrorMsg.man +++ b/man/XtErrorMsg.man @@ -90,24 +90,24 @@ Specifies the number of values in the parameter list. Specifies a pointer to a list of values to be stored in the message. .SH DESCRIPTION The -.ZN XtErrorMsg +.BR XtErrorMsg function has been superceded by -.ZN XtAppErrorMsg . +.BR XtAppErrorMsg . .LP The -.ZN XtSetErrorMsgHandler +.BR XtSetErrorMsgHandler function has been superceded by -.ZN XtAppSetErrorMsgHandler . +.BR XtAppSetErrorMsgHandler . .LP The -.ZN XtSetWarningMsgHandler +.BR XtSetWarningMsgHandler function has been superceded by -.ZN XtAppSetWarningMsgHandler . +.BR XtAppSetWarningMsgHandler . .LP The -.ZN XtWarningMsg +.BR XtWarningMsg function has been superceded by -.ZN XtAppWarningMsg +.BR XtAppWarningMsg .SH "SEE ALSO" .BR XtAppErrorMsg (__libmansuffix__) .br diff --git a/man/XtFindFile.man b/man/XtFindFile.man index a2b59db..ad67ce9 100644 --- a/man/XtFindFile.man +++ b/man/XtFindFile.man @@ -81,7 +81,7 @@ single colon. The character sequence ``%%'' specifies a percent character that does not introduce a substitution; the sequence is replaced by a single percent character. If a percent character is followed by any other character, -.ZN XtFindFile +.BR XtFindFile looks through the specified \fIsubstitutions\fP for that character in the \fImatch\fP field and if found replaces the percent and match characters with the string in the @@ -89,29 +89,29 @@ corresponding \fIsubstitution\fP field. A \fIsubstitution\fP field entry of NUL is equivalent to a pointer to an empty string. If the operating system does not interpret multiple embedded name separators in the path (i.e., ``/'' in POSIX) the same way as a single separator, -.ZN XtFindFile +.BR XtFindFile will collapse multiple separators into a single one after performing all string substitutions. Except for collapsing embedded separators, the contents of the string substitutions are not interpreted by -.ZN XtFindFile +.BR XtFindFile and may therefore contain any operating-system-dependent characters, including additional name separators. Each resulting string is passed to the predicate procedure until a string is found for which the procedure returns -.ZN True ; +.BR True ; this string is the return value for -.ZN XtFindFile . +.BR XtFindFile . If no string yields a -.ZN True +.BR True return from the predicate, -.ZN XtFindFile +.BR XtFindFile returns NULL. .LP If the \fIpredicate\fP parameter is NULL, an internal procedure that checks if the file exists, is readable, and is not a directory will be used. .LP It is the responsibility of the caller to free the returned string using -.ZN XtFree +.BR XtFree when it is no longer needed. .SH "SEE ALSO" .br diff --git a/man/XtGetActionKeysym.man b/man/XtGetActionKeysym.man index 6acf76d..86139ad 100644 --- a/man/XtGetActionKeysym.man +++ b/man/XtGetActionKeysym.man @@ -70,29 +70,29 @@ Intrinsics. Returns the modifiers that caused the match, if non-NULL. .SH DESCRIPTION If -.ZN XtGetActionKeysym +.BR XtGetActionKeysym is called after an action procedure has been invoked by the Intrinsics and before that action procedure returns, and if the event pointer has the same value as the event pointer passed to that action routine, and if the event is a -.ZN KeyPress +.BR KeyPress or -.ZN KeyRelease +.BR KeyRelease event, then -.ZN XtGetActionKeysym +.BR XtGetActionKeysym returns the KeySym that matched the final event specification in the translation table and, if \fImodifiers_return\fP is non-NULL, the modifier state actually used to generate this KeySym; otherwise, if the event is a -.ZN KeyPress +.BR KeyPress or -.ZN KeyRelease +.BR KeyRelease event, then -.ZN XtGetActionKeysym +.BR XtGetActionKeysym calls -.ZN XtTranslateKeycode +.BR XtTranslateKeycode and returns the results; else it returns -.ZN NoSymbol +.BR NoSymbol and does not examine \fImodifiers_return\fP. .SH "SEE ALSO" .br diff --git a/man/XtGetActionList.man b/man/XtGetActionList.man index 6b3c592..7899ee6 100644 --- a/man/XtGetActionList.man +++ b/man/XtGetActionList.man @@ -70,16 +70,16 @@ Returns the action list. .IP \fInum_actions_return\fP 1i Returns the number of action procedures declared by the class. .SH DESCRIPTION -.ZN XtGetActionList +.BR XtGetActionList returns the action table defined by the specified widget class. This table does not include actions defined by the superclasses. If \fIwidget_class\fP is not initialized, or is not -.ZN coreWidgetClass +.BR coreWidgetClass or a subclass thereof, or if the class does not define any actions, *\fIactions_return\fP will be NULL and *\fInum_actions_return\fP will be zero. If *\fIactions_return\fP is non-NULL the client is responsible for freeing the table using -.ZN XtFree +.BR XtFree when it is no longer needed. .SH "SEE ALSO" .br diff --git a/man/XtGetApplicationNameAndClass.man b/man/XtGetApplicationNameAndClass.man index 99efa5c..869447b 100644 --- a/man/XtGetApplicationNameAndClass.man +++ b/man/XtGetApplicationNameAndClass.man @@ -65,15 +65,15 @@ void XtGetApplicationNameAndClass(Display* \fIdisplay\fP, String* .SH ARGUMENTS .IP \fIdisplay\fP 1i Specifies an open display connection that has been initialized with -.ZN XtDisplayInitialize . +.BR XtDisplayInitialize . .IP \fIname_return\fP 1i Returns the application name. .IP \fIclass_return\fP 1i Returns the application class. .SH DESCRIPTION -.ZN XtGetApplicationNameAndClass +.BR XtGetApplicationNameAndClass returns the application name and class passed to -.ZN XtDisplayInitialize +.BR XtDisplayInitialize for the specified display. If the display was never initialized or has been closed, the result is undefined. The returned strings are owned by the Intrinsics and must not be modified or freed by the diff --git a/man/XtGetApplicationResources.man b/man/XtGetApplicationResources.man index 16fb08a..1ac4301 100644 --- a/man/XtGetApplicationResources.man +++ b/man/XtGetApplicationResources.man @@ -89,14 +89,14 @@ Specifies the widget \*(Wi. Specifies the variable arguments \*(Al. .SH DESCRIPTION The -.ZN XtGetApplicationResources +.BR XtGetApplicationResources function first uses the passed widget, which is usually an application shell, to construct a resource name and class list, Then, it retrieves the resources from the argument list, the resource database, or the resource list default values. After adding base to each address, -.ZN XtGetApplicationResources +.BR XtGetApplicationResources copies the resources into the address given in the resource list. If args is NULL, num_args must be zero. diff --git a/man/XtGetClassExtension.man b/man/XtGetClassExtension.man index 5c3116e..dc77d3e 100644 --- a/man/XtGetClassExtension.man +++ b/man/XtGetClassExtension.man @@ -83,7 +83,7 @@ The list of extension records at the specified offset in the specified \fItype\fP, a version greater than or equal to the specified \fIversion\fP, and a record size greater than or equal the specified \fIrecord_size\fP if it is nonzero. -.ZN XtGetClassExtension +.BR XtGetClassExtension returns a pointer to a matching extension record or NULL if no match is found. The returned extension record is owned by the widget class and must not be modified or freed by the caller, except possibly to diff --git a/man/XtGetDisplays.man b/man/XtGetDisplays.man index 88e6cc1..116a061 100644 --- a/man/XtGetDisplays.man +++ b/man/XtGetDisplays.man @@ -72,7 +72,7 @@ context. Returns the count of open X display connections in \fIdpy_return\fP. .SH DESCRIPTION To free the list of displays, use -.ZN XtFree . +.BR XtFree . .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtGetErrorDatabase.man b/man/XtGetErrorDatabase.man index 628b592..e78c983 100644 --- a/man/XtGetErrorDatabase.man +++ b/man/XtGetErrorDatabase.man @@ -84,14 +84,14 @@ of the error message. Specifies the size of the buffer in bytes. .SH DESCRIPTION The -.ZN XtGetErrorDatabase +.BR XtGetErrorDatabase function has been superceded by -.ZN XtAppGetErrorDatabase . +.BR XtAppGetErrorDatabase . .LP The -.ZN XtGetErrorDatabaseText +.BR XtGetErrorDatabaseText function has been superceded by -.ZN XtAppGetErrorDatabaseText . +.BR XtAppGetErrorDatabaseText . .SH "SEE ALSO" .BR XtAppGetErrorDatabase (__libmansuffix__) .BR XtAppGetErrorDatabaseText (__libmansuffix__) diff --git a/man/XtGetGC.man b/man/XtGetGC.man index f65bff2..6d1c58c 100644 --- a/man/XtGetGC.man +++ b/man/XtGetGC.man @@ -77,14 +77,14 @@ Specifies which \*(Vm. Specifies the widget. .SH DESCRIPTION The -.ZN XtGetGC +.BR XtGetGC function returns a sharable, read-only GC. The parameters to this function are the same as those for -.ZN XCreateGC +.BR XCreateGC except that a widget is passed instead of a display. -.ZN XtGetGC +.BR XtGetGC shares only GCs in which all values in the GC returned by -.ZN XCreateGC +.BR XCreateGC are the same. In particular, it does not use the value_mask provided to determine which fields of the GC a widget considers relevant. @@ -92,11 +92,11 @@ The value_mask is used only to tell the server which fields should be filled in with widget data and which it should fill in with default values. For further information about value_mask and values, see -.ZN XCreateGC +.BR XCreateGC in the \fI\*(xL\fP. .LP The -.ZN XtReleaseGC +.BR XtReleaseGC function deallocate the specified shared GC. .SH "SEE ALSO" .br diff --git a/man/XtGetKeyboardFocusWidget.man b/man/XtGetKeyboardFocusWidget.man index 7662d5d..e6d6944 100644 --- a/man/XtGetKeyboardFocusWidget.man +++ b/man/XtGetKeyboardFocusWidget.man @@ -66,7 +66,7 @@ Widget XtGetKeyboardFocusWidget(Widget \fIwidget\fP); Specifies the widget for this event handler. Must be of class Core or any subclass thereof. .SH DESCRIPTION -.ZN XtGetKeyboardFocusWidget +.BR XtGetKeyboardFocusWidget function returns the widget that would be the end result of keyboard event forwarding for a keyboard event for the specified widget. .SH "SEE ALSO" diff --git a/man/XtGetKeysymTable.man b/man/XtGetKeysymTable.man index fea4389..4693b28 100644 --- a/man/XtGetKeysymTable.man +++ b/man/XtGetKeysymTable.man @@ -86,17 +86,17 @@ or NULL if \fIkeycount_return\fP is 0. .IP \fIkeycount_return\fP 1i Returns the number of KeyCodes in the keycode list. .SH DESCRIPTION -.ZN XtGetKeysymTable +.BR XtGetKeysymTable returns a pointer to the Intrinsics' copy of the server's KeyCode-to-KeySym table. This table must not be modified. .LP The -.ZN XtKeysymToKeycodeList +.BR XtKeysymToKeycodeList procedure returns all the KeyCodes that have \fIkeysym\fP in their entry for the keyboard mapping table associated with \fIdisplay\fP. The caller should free the storage pointed to by \fIkeycodes_return\fP using -.ZN XtFree +.BR XtFree when it is no longer useful. .SH "SEE ALSO" .br diff --git a/man/XtGetResourceList.man b/man/XtGetResourceList.man index 8557402..e64428f 100644 --- a/man/XtGetResourceList.man +++ b/man/XtGetResourceList.man @@ -73,43 +73,43 @@ resource list. .IP \fIresources_return\fP 1i Specifies a pointer to where to store the returned resource list. The caller must free this storage using -.ZN XtFree +.BR XtFree when done with it. .ds Cl \ for which you want the list .IP \fIwidget_class\fP 1i Specifies the widget class. .SH DESCRIPTION If -.ZN XtGetResourceList +.BR XtGetResourceList is called before the widget class is initialized (that is, before the first widget of that class has been created), -.ZN XtGetResourceList +.BR XtGetResourceList returns the resource list as specified in the widget class record. If it is called after the widget class has been initialized, -.ZN XtGetResourceList +.BR XtGetResourceList returns a merged resource list that contains the resources for all superclasses. The list returned by -.ZN XtGetResourceList +.BR XtGetResourceList should be freed using -.ZN XtFree +.BR XtFree when it is no longer needed. .LP If -.ZN XtGetConstraintResourceList +.BR XtGetConstraintResourceList is called before the widget class is initialized (that is, before the first widget of that class has been created), -.ZN XtGetConstraintResourceList +.BR XtGetConstraintResourceList returns the resource list as specified in the widget class Constraint part record. If it is called after the widget class has been initialized, -.ZN XtGetConstraintResourceList +.BR XtGetConstraintResourceList returns a merged resource list that contains the Constraint resources for all superclasses. If the specified class is not a subclass of -.ZN constraintWidgetClass , +.BR constraintWidgetClass , \fI*resources_return\fP is set to NULL and \fI*num_resources_return\fP is set to zero. The list returned by -.ZN XtGetConstraintResourceList +.BR XtGetConstraintResourceList should be freed using -.ZN XtFree +.BR XtFree when it is no longer needed. .SH "SEE ALSO" XtGetSubresources(__libmansuffix__), diff --git a/man/XtGetSelectionParameters.man b/man/XtGetSelectionParameters.man index f95ea3e..a4d1c17 100644 --- a/man/XtGetSelectionParameters.man +++ b/man/XtGetSelectionParameters.man @@ -86,11 +86,11 @@ stored. Specifies a pointer into which the size in bits of the parameter data in the elements of \fIvalue_return\fP will be stored. .SH DESCRIPTION -.ZN XtGetSelectionParameters +.BR XtGetSelectionParameters may only be called from within an -.ZN XtConvertSelectionProc +.BR XtConvertSelectionProc or from within the last call to an -.ZN XtConvertSelectionIncrProc +.BR XtConvertSelectionIncrProc with a new request_id. .SH "SEE ALSO" XtSetSelectionParameters(__libmansuffix__) diff --git a/man/XtGetSelectionRequest.man b/man/XtGetSelectionRequest.man index 7014c23..edd2ca7 100644 --- a/man/XtGetSelectionRequest.man +++ b/man/XtGetSelectionRequest.man @@ -71,19 +71,19 @@ Specifies the selection being processed. Specifies the requestor id in the case of incremental selections, or NULL in the case of atomic transfers. .SH DESCRIPTION -.ZN XtGetSelectionRequest +.BR XtGetSelectionRequest may only be called from within an -.ZN XtConvertSelectionProc +.BR XtConvertSelectionProc procedure and returns a pointer to the -.ZN SelectionRequest +.BR SelectionRequest event that caused the conversion procedure to be invoked. \fIRequest_id\fP specifies a unique id for the individual request in the case that multiple incremental transfers are outstanding. For atomic transfers, \fIrequest_id\fP must be specified as NULL. If no -.ZN SelectionRequest +.BR SelectionRequest event is being processed for the specified \fIwidget\fP, \fIselection\fP, and \fIrequest_id\fP, -.ZN XtGetSelectionRequest +.BR XtGetSelectionRequest returns NULL. .SH "SEE ALSO" .br diff --git a/man/XtGetSelectionTimeout.man b/man/XtGetSelectionTimeout.man index 987217b..a3a71ba 100644 --- a/man/XtGetSelectionTimeout.man +++ b/man/XtGetSelectionTimeout.man @@ -68,14 +68,14 @@ void XtSetSelectionTimeout(unsigned long \fItimeout\fP); Specifies the selection timeout in milliseconds. .SH DESCRIPTION The -.ZN XtGetSelectionTimeout +.BR XtGetSelectionTimeout function has been superceded by -.ZN XtAppGetSelectionTimeout . +.BR XtAppGetSelectionTimeout . .LP The -.ZN XtSetSelectionTimeout +.BR XtSetSelectionTimeout function has been superceded by -.ZN XtAppSetSelectionTimeout . +.BR XtAppSetSelectionTimeout . .SH "SEE ALSO" .BR XtAppGetSelectionTimeout (__libmansuffix__) .br diff --git a/man/XtGetSelectionValue.man b/man/XtGetSelectionValue.man index a6a7e60..1385800 100644 --- a/man/XtGetSelectionValue.man +++ b/man/XtGetSelectionValue.man @@ -95,30 +95,30 @@ Specifies the timestamp that indicates when the selection \*(Ti. Specifies the widget \*(Wi. .SH DESCRIPTION The -.ZN XtGetSelectionValue +.BR XtGetSelectionValue function requests the value of the selection that has been converted to the target type. The specified callback will be called some time after -.ZN XtGetSelectionValue +.BR XtGetSelectionValue is called; in fact, it may be called before or after -.ZN XtGetSelectionValue +.BR XtGetSelectionValue returns. .LP The -.ZN XtGetSelectionValues +.BR XtGetSelectionValues function is similar to -.ZN XtGetSelectionValue +.BR XtGetSelectionValue except that it takes a list of target types and a list of client data and obtains the current value of the selection converted to each of the targets. The effect is as if each target were specified in a separate call to -.ZN XtGetSelectionValue . +.BR XtGetSelectionValue . The callback is called once with the corresponding client data for each target. -.ZN XtGetSelectionValues +.BR XtGetSelectionValues does guarantee that all the conversions will use the same selection value because the ownership of the selection cannot change in the middle of the list, as would be when calling -.ZN XtGetSelectionValue +.BR XtGetSelectionValue repeatedly. .SH "SEE ALSO" XtAppGetSelectionTimeout(__libmansuffix__), diff --git a/man/XtGetSelectionValueIncremental.man b/man/XtGetSelectionValueIncremental.man index 44c27f7..841a1f7 100644 --- a/man/XtGetSelectionValueIncremental.man +++ b/man/XtGetSelectionValueIncremental.man @@ -94,9 +94,9 @@ Specifies the timestamp that indicates when the selection \*(Ti. Specifies the widget \*(Wi. .SH DESCRIPTION The -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental function is similar to -.ZN XtGetSelectionValue +.BR XtGetSelectionValue except that the \fIselection_callback\fP procedure will be called repeatedly upon delivery of multiple segments of the selection value. The end of the selection value is indicated when \fIselection_callback\fP @@ -105,27 +105,27 @@ freed by the client. If the transfer of the selection is aborted in the middle of a transfer (for example, because to timeout), the \fIselection_callback\fP procedure is called with a type value equal to the symbolic constant -.ZN XT_CONVERT_FAIL +.BR XT_CONVERT_FAIL so that the requestor can dispose of the partial selection value it has collected up until that point. Upon receiving -.ZN XT_CONVERT_FAIL , +.BR XT_CONVERT_FAIL , the requesting client must determine for itself whether or not a partially completed transfer is meaningful. .LP The -.ZN XtGetSelectionValuesIncremental +.BR XtGetSelectionValuesIncremental function is similar to -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental except that it takes a list of target types and a list of client data and obtains the current value of the selection converted to each of the targets. The effect is as if each target were specified in a separate call to -.ZN XtGetSelectionValueIncremental . +.BR XtGetSelectionValueIncremental . The callback is called once with the corresponding client data for each target. -.ZN XtGetSelectionValuesIncremental +.BR XtGetSelectionValuesIncremental does guarantee that all the conversions will use the same selection value because the ownership of the selection cannot change in the middle of the list, as would be when calling -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental repeatedly. .SH "SEE ALSO" .br diff --git a/man/XtGetSubresources.man b/man/XtGetSubresources.man index 52626be..4d86e05 100644 --- a/man/XtGetSubresources.man +++ b/man/XtGetSubresources.man @@ -94,7 +94,7 @@ Specifies the widget \*(Wi. Specifies the variable arguments \*(Al. .SH DESCRIPTION The -.ZN XtGetSubresources +.BR XtGetSubresources function constructs a name/class list from the application name/class, the name/classes of all its ancestors, and the widget itself. Then, it appends to this list the name/class pair passed in. diff --git a/man/XtGrabKey.man b/man/XtGrabKey.man index 1892eca..db13fc3 100644 --- a/man/XtGrabKey.man +++ b/man/XtGrabKey.man @@ -118,125 +118,125 @@ class Core or a subclass thereof. .IP \fIcursor\fP 1i Specifies arguments to the associated Xlib function call. .SH DESCRIPTION -.ZN XtGrabKey +.BR XtGrabKey calls -.ZN XGrabKey +.BR XGrabKey specifying the widget's window as the grab window if the widget is realized. The remaining arguments are exactly as for -.ZN XGrabKey . +.BR XGrabKey . If the widget is not realized, or is later unrealized, the call to -.ZN XGrabKey +.BR XGrabKey will be performed (again) when the widget is realized and its window becomes mapped. In the future, if -.ZN XtDispatchEvent +.BR XtDispatchEvent is called with a -.ZN KeyPress +.BR KeyPress event matching the specified keycode and modifiers (which may be -.ZN AnyKey +.BR AnyKey or -.ZN AnyModifier , +.BR AnyModifier , respectively) for the widget's window, the Intrinsics will call -.ZN XtUngrabKeyboard +.BR XtUngrabKeyboard with the timestamp from the -.ZN KeyPress +.BR KeyPress event if either of the following conditions is true: .IP \(bu 3 There is a modal cascade and the widget is not in the active subset of the cascade and the keyboard was not previously grabbed, or .IP \(bu 3 -.ZN XFilterEvent +.BR XFilterEvent returns -.ZN True . +.BR True . .LP -.ZN XtUngrabKey +.BR XtUngrabKey calls -.ZN XUngrabKey +.BR XUngrabKey specifying the widget's window as the ungrab window if the widget is realized. The remaining arguments are exactly as for -.ZN XUngrabKey . +.BR XUngrabKey . If the widget is not realized, -.ZN XtUngrabKey +.BR XtUngrabKey removes a deferred -.ZN XtGrabKey +.BR XtGrabKey request, if any, for the specified widget, keycode, and modifiers. .LP If the specified widget is realized -.ZN XtGrabKeyboard +.BR XtGrabKeyboard calls -.ZN XGrabKeyboard +.BR XGrabKeyboard specifying the widget's window as the grab window. The remaining arguments and return value are exactly as for -.ZN XGrabKeyboard . +.BR XGrabKeyboard . If the widget is not realized, -.ZN XtGrabKeyboard +.BR XtGrabKeyboard immediately returns -.ZN GrabNotViewable . +.BR GrabNotViewable . No future ungrab is implied by -.ZN XtGrabKeyboard . +.BR XtGrabKeyboard . .LP -.ZN XtUngrabKeyboard +.BR XtUngrabKeyboard calls -.ZN XUngrabKeyboard +.BR XUngrabKeyboard with the specified time. .LP -.ZN XtGrabButton +.BR XtGrabButton calls -.ZN XGrabButton +.BR XGrabButton specifying the widget's window as the grab window if the widget is realized. The remaining arguments are exactly as for -.ZN XGrabButton . +.BR XGrabButton . If the widget is not realized, or is later unrealized, the call to -.ZN XGrabButton +.BR XGrabButton will be performed (again) when the widget is realized and its window becomes mapped. In the future, if -.ZN XtDispatchEvent +.BR XtDispatchEvent is called with a -.ZN ButtonPress +.BR ButtonPress event matching the specified button and modifiers (which may be -.ZN AnyButton +.BR AnyButton or -.ZN AnyModifier , +.BR AnyModifier , respectively) for the widget's window, the Intrinsics will call -.ZN XtUngrabPointer +.BR XtUngrabPointer with the timestamp from the -.ZN ButtonPress +.BR ButtonPress event if either of the following conditions is true: .IP \(bu 3 There is a modal cascade and the widget is not in the active subset of the cascade and the pointer was not previously grabbed, or .IP \(bu 3 -.ZN XFilterEvent +.BR XFilterEvent returns -.ZN True . +.BR True . .LP -.ZN XtUngrabButton +.BR XtUngrabButton calls -.ZN XUngrabButton +.BR XUngrabButton specifying the widget's window as the ungrab window if the widget is realized. The remaining arguments are exactly as for -.ZN XUngrabButton . +.BR XUngrabButton . If the widget is not realized, -.ZN XtUngrabButton +.BR XtUngrabButton removes a deferred -.ZN XtGrabButton +.BR XtGrabButton request, if any, for the specified widget, button, and modifiers. .LP -.ZN XtGrabPointer +.BR XtGrabPointer calls -.ZN XGrabPointer +.BR XGrabPointer specifying the widget's window as the grab window. The remaining arguments and return value are exactly as for -.ZN XGrabPointer . +.BR XGrabPointer . If the widget is not realized, -.ZN XtGrabPointer +.BR XtGrabPointer immediately returns -.ZN GrabNotViewable . +.BR GrabNotViewable . No future ungrab is implied by -.ZN XtGrabPointer . +.BR XtGrabPointer . .LP -.ZN XtUngrabPointer +.BR XtUngrabPointer calls -.ZN XUngrabPointer +.BR XUngrabPointer with the specified time. .SH "SEE ALSO" .br diff --git a/man/XtInitialize.man b/man/XtInitialize.man index aa966cc..a722eb9 100644 --- a/man/XtInitialize.man +++ b/man/XtInitialize.man @@ -72,7 +72,7 @@ Specifies the class name of this application\*(Ac. .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 -.ZN XrmParseCommand . +.BR XrmParseCommand . For further information, see \fI\*(xL\fP. .IP \fInum_options\fP 1i @@ -82,21 +82,21 @@ Specifies a pointer to the number of command line parameters. .IP \fIargv\fP 1i Specifies the command line parameters. .SH DESCRIPTION -.ZN XtInitialize +.BR XtInitialize calls -.ZN XtToolkitInitialize +.BR XtToolkitInitialize followed by -.ZN XtOpenDisplay +.BR XtOpenDisplay with \fIdisplay_string\fP NULL and \fIapplication_name\fP NULL, and finally calls -.ZN XtAppCreateShell +.BR XtAppCreateShell with \fIapplication_name\fP NULL, \fIwidget_class\fP -.ZN applicationShellWidgetClass , +.BR applicationShellWidgetClass , and the specified \fIargs\fP and \fInum_args\fP and returns the created shell. The semantics of calling -.ZN XtInitialize +.BR XtInitialize more than once are undefined. This routine has been replaced by -.ZN XtAppInitialize . +.BR XtAppInitialize . .SH "SEE ALSO" .BR XtAppInitialize (__libmansuffix__) .br diff --git a/man/XtInitializeWidgetClass.man b/man/XtInitializeWidgetClass.man index e654e93..a246dfd 100644 --- a/man/XtInitializeWidgetClass.man +++ b/man/XtInitializeWidgetClass.man @@ -66,13 +66,13 @@ void XtInitializeWidgetClass(WidgetClass \fIobject_class\fP); Specifies the object class to initialize. .SH DESCRIPTION If the specified widget class is already initialized, -.ZN XtInitializeWidgetClass +.BR XtInitializeWidgetClass returns immediately. .LP If the class initialization procedure registers type converters, these type converters are not available until the first object of the class or subclass is created or -.ZN XtInitializeWidgetClass +.BR XtInitializeWidgetClass is called. .SH "SEE ALSO" .br diff --git a/man/XtInsertEventTypeHandler.man b/man/XtInsertEventTypeHandler.man index e3825d6..da2ab0b 100644 --- a/man/XtInsertEventTypeHandler.man +++ b/man/XtInsertEventTypeHandler.man @@ -102,24 +102,24 @@ Specifies the range of event types for this extension. Specifies a pointer to the event to be dispatched. .SH DESCRIPTION The -.ZN XtInsertEventTypeHandler +.BR XtInsertEventTypeHandler function registers a procedure with the dispatch mechanism that is to be called when an event that matches the specified \fIevent_type\fP is dispatched to the specified \fIwidget\fP. .LP If \fIevent_type\fP is one of the core X protocol events then \fIselect_data\fP must be a pointer to a value of type -.ZN EventMask , +.BR EventMask , indicating the event mask to be used to select for the desired event. This event mask will be included in the value returned by -.ZN XtBuildEventMask . +.BR XtBuildEventMask . If the widget is realized -.ZN XtInsertEventTypeHandler +.BR XtInsertEventTypeHandler calls -.ZN XSelectInput +.BR XSelectInput if necessary. Specifying NULL for \fIselect_data\fP is equivalent to specifying a pointer to an event mask containing 0. This is similar to the -.ZN XtInsertRawEventHandler +.BR XtInsertRawEventHandler function. .LP If \fIevent_type\fP specifies an extension event type then the semantics @@ -134,28 +134,28 @@ as long as the event handler remains registered with this value of The \fIposition\fP argument allows the client to control the order of the invocation of event handlers registered for the same event type. If the client does not care about the order, it should normally specify -.ZN XtListTail , +.BR XtListTail , which registers this event handler after any previously registered handlers for this event type. .LP The -.ZN XtRemoveEventTypeHandler +.BR XtRemoveEventTypeHandler function unregisters an even handler registered with -.ZN XtInsertEventTypeHandler +.BR XtInsertEventTypeHandler for the specified event type. The request is ignored if \fIclient_data\fP does not match the value given with the handler was registered. .LP If \fIevent_type\fP specifies on of the core X protocol events, \fIselect_data\fP must be a pointer to a value of type -.ZN EventMask , +.BR EventMask , indicating the mask to be used to deselect for the appropriate event. If the widget is realized, -.ZN XtRemoveEventTypeHandler +.BR XtRemoveEventTypeHandler calls -.ZN XSelectInput +.BR XSelectInput if necessary. Specifying NULL for \fIselect_data\fP is equivalent to specifying a pointer to an event mask containing 0. This is similar to the -.ZN XtRemoveRawEventHandler +.BR XtRemoveRawEventHandler function. .LP If \fIevent_type\fP specifies an extension event type then the semantics @@ -163,20 +163,20 @@ of the data pointed to by \fIselect_data\fP are defined by the extension selector registered for the specified event type. .LP The -.ZN XtRegisterExtensionSelector +.BR XtRegisterExtensionSelector function registers a procedure to arrange for the delivery of extension events to widgets. .LP If \fImin_event_type\fP and \fImax_event_type\fP match the parameters to a previous call to -.ZN XtRegisterExtensionSelector +.BR XtRegisterExtensionSelector for the same display, the \fIproc\fP and \fIclient_data\fP replace the previously registered values. If the range specified by \fImin_event_type\fP and \fImax_event_type\fP overlaps the range of the parameters to a previous call for the same display in any other way, an error results. .LP The -.ZN XtSetEventDispatcher +.BR XtSetEventDispatcher function registers the event dispatcher procedure specified by \fIproc\fP for events with the type \fIevent_type\fP. The previously registered dispatcher (or the default dispatcher if there was no previously registered @@ -184,35 +184,35 @@ dispatcher) is returned. If \fIproc\fP is NULL, the default procedure is restored for the specified type. .LP In the future, when -.ZN XtDispatchEvent +.BR XtDispatchEvent is called with an event of \fIevent_type\fP, the specified \fIproc\fP (or the default dispatcher) will be invoked to determine a widget ot which to dispatch the event. .LP The -.ZN XtDispatchEventToWidget +.BR XtDispatchEventToWidget function scans the list of registered event handlers for the specified widget and calls each handler that has been registered for the specified event type, subject to the \fIcontinue_to_dispatch\fP value returned by each handler. The Intrinsics behave as if event handlers were registered at the head of the list for -.ZN Expose , -.ZN NoExpose , -.ZN GraphicsExpose , +.BR Expose , +.BR NoExpose , +.BR GraphicsExpose , and -.ZN VisibilityNotify +.BR VisibilityNotify events to invoke the widget's expose procedure according to the exposure compression rules and to update the widget's \fIvisible\fP field if \fIvisible_interest\fP is -.ZN True . +.BR True . These internal event handlers never set \fIcontinue_to_dispatch\fP to -.ZN False . +.BR False . .LP -.ZN XtDispatchEventToWidget +.BR XtDispatchEventToWidget returns -.ZN True +.BR True if any event handler was called and -.ZN False +.BR False otherwise. .LP .SH "SEE ALSO" diff --git a/man/XtLastEventProcessed.man b/man/XtLastEventProcessed.man index 85ac84c..4f7aad7 100644 --- a/man/XtLastEventProcessed.man +++ b/man/XtLastEventProcessed.man @@ -67,26 +67,26 @@ Time XtLastTimestampProcessed(Display* \fIdisplay\fP); .IP \fIdisplay\fP 1i Specifies the open display connection. .SH DESCRIPTION -.ZN XtLastEventProcessed +.BR XtLastEventProcessed returns the last event passed to -.ZN XtDispatchEvent +.BR XtDispatchEvent for the specified display and NULL if there has been no event. The client must not modify the contents of the returned event. .LP -.ZN XtLastTimestampProcessed +.BR XtLastTimestampProcessed returns the timestamp of the last -.ZN KeyPress , -.ZN KeyRelease , -.ZN ButtonPress , -.ZN ButtonRelease , -.ZN MotionNotify , -.ZN EnterNotify , -.ZN LeaveNotify , -.ZN PropertyNotify , +.BR KeyPress , +.BR KeyRelease , +.BR ButtonPress , +.BR ButtonRelease , +.BR MotionNotify , +.BR EnterNotify , +.BR LeaveNotify , +.BR PropertyNotify , or -.ZN SelectionClear +.BR SelectionClear event that has been passed to -.ZN XtDispatchEvent +.BR XtDispatchEvent for the specified display and zero if there has been no such event. .SH "SEE ALSO" .br diff --git a/man/XtMakeGeometryRequest.man b/man/XtMakeGeometryRequest.man index b10e034..01c6ac1 100644 --- a/man/XtMakeGeometryRequest.man +++ b/man/XtMakeGeometryRequest.man @@ -70,7 +70,7 @@ XtGeometryResult XtMakeResizeRequest(Widget \fIw\fP, Dimension \fIwidth\fP, .IP \fIreply_return\fP 1i Returns the allowed widget size or may be NULL if the requesting widget is not interested in handling -.ZN XtGeometryAlmost . +.BR XtGeometryAlmost . .IP \fIrequest\fP 1i Specifies the desired widget geometry (size, position, border width, and stacking order). @@ -84,81 +84,81 @@ Specifies the widget \*(Wi. Return the allowed widget width and height. .SH DESCRIPTION Depending on the condition, -.ZN XtMakeGeometryRequest +.BR XtMakeGeometryRequest performs the following: .IP \(bu 5 If the widget is unmanaged or the widget's parent is not realized, it makes the changes and returns -.ZN XtGeometryYes . +.BR XtGeometryYes . .IP \(bu 5 If the parent is not a subclass of -.ZN compositeWidgetClass +.BR compositeWidgetClass or the parent's geometry_manager is NULL, it issues an error. .IP \(bu 5 If the widget's being_destroyed field is -.ZN True , +.BR True , it returns -.ZN XtGeometryNo . +.BR XtGeometryNo . .IP \(bu 5 If the widget x, y, width, height and border_width fields are all equal to the requested values, it returns -.ZN XtGeometryYes ; +.BR XtGeometryYes ; otherwise, it calls the parent's geometry_manager procedure with the given parameters. .IP \(bu 5 If the parent's geometry manager returns -.ZN XtGeometryYes +.BR XtGeometryYes and if -.ZN XtCWQueryOnly +.BR XtCWQueryOnly is not set in the request_mode and if the widget is realized, -.ZN XtMakeGeometryRequest +.BR XtMakeGeometryRequest calls the -.ZN XConfigureWindow +.BR XConfigureWindow Xlib function to reconfigure the widget's window (set its size, location, and stacking order as appropriate). .IP \(bu 5 If the geometry manager returns -.ZN XtGeometryDone , +.BR XtGeometryDone , the change has been approved and actually has been done. In this case, -.ZN XtMakeGeometryRequest +.BR XtMakeGeometryRequest does no configuring and returns -.ZN XtGeometryYes . -.ZN XtMakeGeometryRequest +.BR XtGeometryYes . +.BR XtMakeGeometryRequest never returns -.ZN XtGeometryDone . +.BR XtGeometryDone . .LP Otherwise, -.ZN XtMakeGeometryRequest +.BR XtMakeGeometryRequest returns the resulting value from the parent's geometry manager. .LP Children of primitive widgets are always unmanaged; thus, -.ZN XtMakeGeometryRequest +.BR XtMakeGeometryRequest always returns -.ZN XtGeometryYes +.BR XtGeometryYes when called by a child of a primitive widget. .LP The -.ZN XtMakeResizeRequest +.BR XtMakeResizeRequest function, a simple interface to -.ZN XtMakeGeometryRequest , +.BR XtMakeGeometryRequest , creates a -.ZN XtWidgetGeometry +.BR XtWidgetGeometry structure and specifies that width and height should change. The geometry manager is free to modify any of the other window attributes (position or stacking order) to satisfy the resize request. If the return value is -.ZN XtGeometryAlmost , +.BR XtGeometryAlmost , width_return and height_return contain a compromise width and height. If these are acceptable, the widget should immediately make an -.ZN XtMakeResizeRequest +.BR XtMakeResizeRequest and request that the compromise width and height be applied. If the widget is not interested in -.ZN XtGeometryAlmost +.BR XtGeometryAlmost replies, it can pass NULL for width_return and height_return. .SH "SEE ALSO" diff --git a/man/XtMalloc.man b/man/XtMalloc.man index b76c392..c6932bc 100644 --- a/man/XtMalloc.man +++ b/man/XtMalloc.man @@ -93,54 +93,54 @@ Specifies a pointer to write a newly allocated string to. Specifies a formatting string as defined by sprintf(3c) .SH DESCRIPTION The -.ZN XtMalloc +.BR XtMalloc functions returns a pointer to a block of storage of at least the specified size bytes. If there is insufficient memory to allocate the new block, -.ZN XtMalloc +.BR XtMalloc calls -.ZN XtErrorMsg . +.BR XtErrorMsg . .LP The -.ZN XtCalloc +.BR XtCalloc function allocates space for the specified number of array elements of the specified size and initializes the space to zero. If there is insufficient memory to allocate the new block, -.ZN XtCalloc +.BR XtCalloc calls -.ZN XtErrorMsg . +.BR XtErrorMsg . .LP The -.ZN XtRealloc +.BR XtRealloc function changes the size of a block of storage (possibly moving it). Then, it copies the old contents (or as much as will fit) into the new block and frees the old block. If there is insufficient memory to allocate the new block, -.ZN XtRealloc +.BR XtRealloc calls -.ZN XtErrorMsg . +.BR XtErrorMsg . If ptr is NULL, -.ZN XtRealloc +.BR XtRealloc allocates the new storage without copying the old contents; that is, it simply calls -.ZN XtMalloc . +.BR XtMalloc . .LP The -.ZN XtFree +.BR XtFree function returns storage and allows it to be reused. If ptr is NULL, -.ZN XtFree +.BR XtFree returns immediately. .LP -.ZN XtNew +.BR XtNew returns a pointer to the allocated storage. If there is insufficient memory to allocate the new block, -.ZN XtNew +.BR XtNew calls -.ZN XtErrorMsg . -.ZN XtNew +.BR XtErrorMsg . +.BR XtNew is a convenience macro that calls -.ZN XtMalloc +.BR XtMalloc with the following arguments specified: .LP .Ds @@ -148,15 +148,15 @@ with the following arguments specified: ((type *) XtMalloc((unsigned) sizeof(type)) .De .LP -.ZN XtNewString +.BR XtNewString returns a pointer to the allocated storage. If there is insufficient memory to allocate the new block, -.ZN XtNewString +.BR XtNewString calls -.ZN XtErrorMsg . -.ZN XtNewString +.BR XtErrorMsg . +.BR XtNewString is a convenience macro that calls -.ZN XtMalloc +.BR XtMalloc with the following arguments specified: .LP .Ds @@ -165,16 +165,16 @@ with the following arguments specified: .De .LP The -.ZN XtAsprintf +.BR XtAsprintf function allocates space for a string large enough to hold the string specified by the sprintf(3c) format pattern when used with the remaining arguments, and fills it with the formatted results. The address of the allocated string is placed into the pointer passed as ret. The length of the string (not including the terminating null byte) is returned. If there is insufficient memory to allocate the new block, -.ZN XtAsprintf +.BR XtAsprintf calls -.ZN XtErrorMsg . +.BR XtErrorMsg . .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtManageChildren.man b/man/XtManageChildren.man index a81c849..c467274 100644 --- a/man/XtManageChildren.man +++ b/man/XtManageChildren.man @@ -101,16 +101,16 @@ Specifies the post unmanage, pre manage hook procedure to invoke. Specifies the client data to be passed to the hook procedure. .SH DESCRIPTION The -.ZN XtManageChildren +.BR XtManageChildren function performs the following: .IP \(bu 5 Issues an error if the children do not all have the same parent or if the parent is not a subclass of -.ZN compositeWidgetClass . +.BR compositeWidgetClass . .IP \(bu 5 Returns immediately if the common parent is being destroyed; otherwise, for each unique child on the list, -.ZN XtManageChildren +.BR XtManageChildren ignores the child if it already is managed or is being destroyed and marks it if not. .IP \(bu 5 @@ -121,21 +121,21 @@ it makes some of the newly managed children viewable: Calls the change_managed routine of the widgets' parent. .IP \- 5 Calls -.ZN XtRealizeWidget +.BR XtRealizeWidget on each previously unmanaged child that is unrealized. .IP \- 5 Maps each previously unmanaged child that has map_when_managed -.ZN True . +.BR True . .RE .LP Managing children is independent of the ordering of children and independent of creating and deleting children. The layout routine of the parent should consider children whose managed field is -.ZN True +.BR True and should ignore all other children. Note that some composite widgets, especially fixed boxes, call -.ZN XtManageChild +.BR XtManageChild from their insert_child procedure. .LP If the parent widget is realized, @@ -143,29 +143,29 @@ its change_managed procedure is called to notify it that its set of managed children has changed. The parent can reposition and resize any of its children. It moves each child as needed by calling -.ZN XtMoveWidget , +.BR XtMoveWidget , which first updates the x and y fields and then calls -.ZN XMoveWindow +.BR XMoveWindow if the widget is realized. .LP The -.ZN XtManageChild +.BR XtManageChild function constructs a -.ZN WidgetList +.BR WidgetList of length one and calls -.ZN XtManageChildren . +.BR XtManageChildren . .LP The -.ZN XtUnmanageChildren +.BR XtUnmanageChildren function performs the following: .IP \(bu 5 Issues an error if the children do not all have the same parent or if the parent is not a subclass of -.ZN compositeWidgetClass . +.BR compositeWidgetClass . .IP \(bu 5 Returns immediately if the common parent is being destroyed; otherwise, for each unique child on the list, -.ZN XtUnmanageChildren +.BR XtUnmanageChildren performs the following: .RS .IP \- 5 @@ -180,19 +180,19 @@ Calls the change_managed routine of the widgets' parent after all children have been marked if the parent is realized. .LP -.ZN XtUnmanageChildren +.BR XtUnmanageChildren does not destroy the children widgets. Removing widgets from a parent's managed set is often a temporary banishment, and, some time later, you may manage the children again. .LP The -.ZN XtUnmanageChild +.BR XtUnmanageChild function constructs a widget list of length one and calls -.ZN XtUnmanageChildren . +.BR XtUnmanageChildren . .LP The -.ZN XtChangeManagedSet +.BR XtChangeManagedSet function performs the following: .IP \(bu 5 Issues an error if the widgets specified in the \fImanage_children\fP @@ -202,40 +202,40 @@ if that parent is not a subclass of compositeWidgetClass. Returns immediately if the common parent is being destroyed. .IP \(bu 5 If no -.ZN CompositeClassExtension +.BR CompositeClassExtension is defined, or a -.ZN CompositeClassExtension +.BR CompositeClassExtension is defined but with an \fIallows_change_managed_set\fP field with a value of -.ZN False , +.BR False , and -.ZN XtChangeManagedSet +.BR XtChangeManagedSet was invoked with a non-NULL \fIdo_change_proc\fP procedure then -.ZN XtChangeManagedSet +.BR XtChangeManagedSet performs the following: .RS .IP \- 5 Calls -.ZN XtUnmanageChildren +.BR XtUnmanageChildren (\fIunmanage_children\fP, \fInum_unmanage_children\fP). .IP \- 5 Calls the \fIdo_change_proc\fP specified. .IP \- 5 Calls -.ZN XtManageChildren +.BR XtManageChildren (\fImanage_children\fP, \fInum_manage_children\fP) and then returns immediately. .RE .IP \(bu 5 Otherwise, if a -.ZN CompositeClassExtension +.BR CompositeClassExtension is defined with an \fIallows_change_managed_set\fP field with a value of -.ZN True , +.BR True , or if no -.ZN CompositeClassExtension +.BR CompositeClassExtension is defined, and -.ZN XtChangeManagedSet was invoked with a NULL +.BR XtChangeManagedSet was invoked with a NULL \fIdo_change_proc\fP procedure, then the following is performed: .RS @@ -259,20 +259,20 @@ of the newly managed children are made viewable by: .RS .IP \- 5 Calling -.ZN XtRealizeWidget +.BR XtRealizeWidget on each of the previously unmanaged child that is unrealized. .IP \- 5 Mapping each previously unmanaged child that has \fImap_when_managed\fP -.ZN True . +.BR True . .RE .LP The -.ZN XtIsManaged +.BR XtIsManaged function returns -.ZN True +.BR True if the specified widget is of class RectObj or any subclass thereof and is managed, or -.ZN False +.BR False otherwise. .SH "SEE ALSO" XtMapWidget(__libmansuffix__), diff --git a/man/XtMapWidget.man b/man/XtMapWidget.man index b9e1cfb..04d69b9 100644 --- a/man/XtMapWidget.man +++ b/man/XtMapWidget.man @@ -75,27 +75,27 @@ Specifies the widget. .SH DESCRIPTION If the widget is realized and managed and if the new value of map_when_managed is -.ZN True , -.ZN XtSetMappedWhenManaged +.BR True , +.BR XtSetMappedWhenManaged maps the window. If the widget is realized and managed and if the new value of map_when_managed is -.ZN False , +.BR False , it unmaps the window. -.ZN XtSetMappedWhenManaged +.BR XtSetMappedWhenManaged is a convenience function that is equivalent to (but slightly faster than) calling -.ZN XtSetValues +.BR XtSetValues and setting the new value for the mappedWhenManaged resource. As an alternative to using -.ZN XtSetMappedWhenManaged +.BR XtSetMappedWhenManaged to control mapping, a client may set mapped_when_managed to -.ZN False +.BR False and use -.ZN XtMapWidget +.BR XtMapWidget and -.ZN XtUnmapWidget +.BR XtUnmapWidget explicitly. .SH "SEE ALSO" XtManageChildren(__libmansuffix__) diff --git a/man/XtName.man b/man/XtName.man index 4a49578..4b7c321 100644 --- a/man/XtName.man +++ b/man/XtName.man @@ -65,7 +65,7 @@ String XtName(Widget \fIw\fP); .IP \fIw\fP 1i Specifies the widget. .SH DESCRIPTION -.ZN XtName +.BR XtName returns the widget's name. .SH "SEE ALSO" .br diff --git a/man/XtNameToWidget.man b/man/XtNameToWidget.man index 5568ccc..c0a247c 100644 --- a/man/XtNameToWidget.man +++ b/man/XtNameToWidget.man @@ -76,15 +76,15 @@ Specifies the widget from which the search is to start. Specify the window for which you want the widget. .SH DESCRIPTION The -.ZN XtNameToWidget +.BR XtNameToWidget function looks for a widget whose name is the first component in the specified names and that is a pop-up child of reference (or a normal child if reference is a subclass of -.ZN compositeWidgetClass ). +.BR compositeWidgetClass ). It then uses that widget as the new reference and repeats the search after deleting the first component from the specified names. If it cannot find the specified widget, -.ZN XtNameToWidget +.BR XtNameToWidget returns NULL. .LP Note that the names argument contains the name of a widget with respect to the @@ -93,20 +93,20 @@ specified reference widget and can contain more than one widget name of the specified reference widget. .LP If more than one child of the reference widget matches the name, -.ZN XtNameToWidget +.BR XtNameToWidget can return any of the children. The \*(xI do not require that all children of a widget have unique names. If the specified names contain more than one component and if more than one child matches the first component, -.ZN XtNameToWidget +.BR XtNameToWidget can return NULL if the single branch that it follows does not contain the named widget. That is, -.ZN XtNameToWidget +.BR XtNameToWidget does not back up and follow other matching branches of the widget tree. .LP The -.ZN XtWindowToWidget +.BR XtWindowToWidget function translates the specified window and display pointer into the appropriate widget instance. .SH "SEE ALSO" diff --git a/man/XtNextEvent.man b/man/XtNextEvent.man index 774e55b..5766c0b 100644 --- a/man/XtNextEvent.man +++ b/man/XtNextEvent.man @@ -79,34 +79,34 @@ Returns the event information to the specified event structure. .IP \fImask\fP 1i Specifies what types of events to process. The mask is the bitwise inclusive OR of any combination of -.ZN XtIMXEvent , -.ZN XtIMTimer , -.ZN XtIMAlternateInput , +.BR XtIMXEvent , +.BR XtIMTimer , +.BR XtIMAlternateInput , and -.ZN XtIMSignal . +.BR XtIMSignal . As a convenience, the \*(tk defines the symbolic name -.ZN XtIMAll +.BR XtIMAll to be the bitwise inclusive OR of all event types. .SH DESCRIPTION -.ZN XtNextEvent +.BR XtNextEvent has been replaced by -.ZN XtAppNextEvent . +.BR XtAppNextEvent . .LP -.ZN XtPeekEvent +.BR XtPeekEvent has been replaced by -.ZN XtAppPeekEvent . +.BR XtAppPeekEvent . .LP -.ZN XtPending +.BR XtPending has been replaced by -.ZN XtAppPending . +.BR XtAppPending . .LP -.ZN XtProcessEvent +.BR XtProcessEvent has been replaced by -.ZN XtAppProcessEvent . +.BR XtAppProcessEvent . .LP -.ZN XtMainLoop +.BR XtMainLoop has been replaced by -.ZN XtAppMainLoop . +.BR XtAppMainLoop . .SH "SEE ALSO" XtAppNextEvent(3xt), XtAppPending(__libmansuffix__), XtAppPeekEvent(__libmansuffix__), XtAppProcessEvent(__libmansuffix__), XtAppMainLoop(__libmansuffix__) diff --git a/man/XtOffset.man b/man/XtOffset.man index 0afd336..aa668c4 100644 --- a/man/XtOffset.man +++ b/man/XtOffset.man @@ -76,22 +76,22 @@ Specifies a type that is declared as a pointer to the structure. Specifies a type that is declared as a structure. .SH DESCRIPTION The -.ZN XtOffset +.BR XtOffset macro is usually used to determine the offset of various resource fields from the beginning of a widget and can be used at compile time in static initializations. .LP The -.ZN XtOffsetOf +.BR XtOffsetOf macro expands to a constant expression that gives the offset in bytes to the specified structure member from the beginning of the structure. It is normally used to statically initialize resource lists and is more portable than -.ZN XtOffset , +.BR XtOffset , which serves the same function. .LP The -.ZN XtNumber +.BR XtNumber macro returns the number of elements in the specified argument lists, resources lists, and other counted arrays. .SH "SEE ALSO" diff --git a/man/XtOpenApplication.man b/man/XtOpenApplication.man index 80488de..0253c69 100644 --- a/man/XtOpenApplication.man +++ b/man/XtOpenApplication.man @@ -79,7 +79,7 @@ Specifies the class name of this application\*(Ac. .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 -.ZN XrmParseCommand . +.BR XrmParseCommand . For further information, see \fI\*(xL\fP. .IP \fInum_options\fP 1i @@ -103,34 +103,34 @@ Specifies the variable argument list to override any other resource specification for the created shell widget. .SH DESCRIPTION The -.ZN XtOpenApplication +.BR XtOpenApplication function calls -.ZN XtToolkitInitialize +.BR XtToolkitInitialize followed by -.ZN XtCreateApplicationContext , +.BR XtCreateApplicationContext , then calls -.ZN XtOpenDisplay +.BR XtOpenDisplay with \fIdisplay_string\fP NULL and \fIapplication_name\fP NULL, and finally calls -.ZN XtAppCreateShell +.BR XtAppCreateShell with \fIapplication_name\fP NULL, the specified \fIwidget_class\fP, and the specified \fIargs\fP and \fInum_args\fP and returns the created shell. The modified \fIargc\fP and \fIargv\fP returned by -.ZN XtDisplayInitialize +.BR XtDisplayInitialize are returned in \fIargc_in_out\fP and \fIargv_in_out\fP. If \fIapp_context_return\fP is not NULL, the created application context is also returned. If the display specified by the command line cannot be opened, an error message is issued and -.ZN XtOpenApplication +.BR XtOpenApplication terminates the application. If \fIfallback_resources\fP is non-NULL, -.ZN XtAppSetFallbackResources +.BR XtAppSetFallbackResources is called with the value prior to calling -.ZN XtOpenDisplay . +.BR XtOpenDisplay . .LP XtAppInitialize and XtVaAppInitialize have been superceded by -.ZN XtOpenApplication +.BR XtOpenApplication and -.ZN XtVaOpenApplication +.BR XtVaOpenApplication respectively. .SH "SEE ALSO" XtAppInitialize(__libmansuffix__), XtVaAppInitialize(__libmansuffix__) diff --git a/man/XtOwnSelection.man b/man/XtOwnSelection.man index b824d97..105e7b9 100644 --- a/man/XtOwnSelection.man +++ b/man/XtOwnSelection.man @@ -86,10 +86,10 @@ lost selection ownership or NULL if the owner is not interested in being called back. .IP \fIselection\fP 1i Specifies an atom that describes the type of the selection (for example, -.ZN XA_PRIMARY , -.ZN XA_SECONDARY , +.BR XA_PRIMARY , +.BR XA_SECONDARY , or -.ZN XA_CLIPBOARD ). +.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. @@ -98,13 +98,13 @@ Specifies the timestamp that indicates when the selection \*(Ti. Specifies the widget \*(Wi. .SH DESCRIPTION The -.ZN XtOwnSelection +.BR XtOwnSelection function informs the \*(xI selection mechanism that a widget believes it owns a selection. It returns -.ZN True +.BR True if the widget has successfully become the owner and -.ZN False +.BR False otherwise. The widget may fail to become the owner if some other widget has asserted ownership at a time later than this widget. @@ -115,41 +115,41 @@ Also note that the lose_selection procedure is not called if the widget fails to obtain selection ownership in the first place. .LP The -.ZN XtOwnSelectionIncremental +.BR XtOwnSelectionIncremental procedure informs the Intrinsics incremental selection mechanism that the specified widget wishes to own the selection. It returns -.ZN True +.BR True if the specified widget successfully becomes the selection owner or -.ZN False +.BR False otherwise. For more information about \fIselection\fP, \fItarget\fP, and \fItime\fP, see Section 2.6 of the \fIInter-Client Communication Conventions Manual\fP. .LP A widget that becomes the selection owner using -.ZN XtOwnSelectionIncremental +.BR XtOwnSelectionIncremental may use -.ZN XtDisownSelection +.BR XtDisownSelection to relinquish selection ownership. .LP The -.ZN XtDisownSelection +.BR XtDisownSelection function informs the \*(xI selection mechanism that the specified widget is to lose ownership of the selection. If the widget does not currently own the selection either because it lost the selection or because it never had the selection to begin with, -.ZN XtDisownSelection +.BR XtDisownSelection does nothing. .LP After a widget has called -.ZN XtDisownSelection , +.BR XtDisownSelection , its convert procedure is not called even if a request arrives later with a timestamp during the period that this widget owned the selection. However, its done procedure will be called if a conversion that started before the call to -.ZN XtDisownSelection +.BR XtDisownSelection finishes after the call to -.ZN XtDisownSelection . +.BR XtDisownSelection . .SH "SEE ALSO" XtAppGetSelectionTimeout(__libmansuffix__), XtGetSelectionValue(__libmansuffix__) diff --git a/man/XtParent.man b/man/XtParent.man index eb4c77f..e11d029 100644 --- a/man/XtParent.man +++ b/man/XtParent.man @@ -66,7 +66,7 @@ Widget XtParent(Widget \fIw\fP); .IP \fIw\fP 1i Specifies the widget. .SH DESCRIPTION -.ZN XtParent +.BR XtParent returns the widget's parent widget ID. .SH "SEE ALSO" .br diff --git a/man/XtParseAcceleratorTable.man b/man/XtParseAcceleratorTable.man index 3464e57..b01400c 100644 --- a/man/XtParseAcceleratorTable.man +++ b/man/XtParseAcceleratorTable.man @@ -78,15 +78,15 @@ Specifies the widget on which the accelerators are to be installed. Specifies the \*(Sr from which the accelerators are to come. .SH DESCRIPTION The -.ZN XtParseAcceleratorTable +.BR XtParseAcceleratorTable function compiles the accelerator table into the opaque internal representation. .LP The -.ZN XtInstallAccelerators +.BR XtInstallAccelerators function installs the accelerators from source onto destination by augmenting the destination translations with the source accelerators. If the source display_accelerator method is non-NULL, -.ZN XtInstallAccelerators +.BR XtInstallAccelerators calls it with the source widget and a string representation of the accelerator table, which indicates that its accelerators have been installed @@ -95,11 +95,11 @@ The string representation of the accelerator table is its canonical translation table representation. .LP The -.ZN XtInstallAllAccelerators +.BR XtInstallAllAccelerators function recursively descends the widget tree rooted at source and installs the accelerators of each widget encountered onto destination. A common use os to call -.ZN XtInstallAllAccelerators +.BR XtInstallAllAccelerators and pass the application main window as the source. .SH "SEE ALSO" XtParseTranslationTable(1) diff --git a/man/XtParseTranslationTable.man b/man/XtParseTranslationTable.man index 16f7215..3708051 100644 --- a/man/XtParseTranslationTable.man +++ b/man/XtParseTranslationTable.man @@ -80,17 +80,17 @@ Specifies the compiled translation table to merge in (must not be NULL). Specifies the widget \*(Wi. .SH DESCRIPTION The -.ZN XtParseTranslationTable +.BR XtParseTranslationTable function compiles the translation table into the opaque internal representation of type -.ZN XtTranslations . +.BR XtTranslations . Note that if an empty translation table is required for any purpose, one can be obtained by calling -.ZN XtParseTranslationTable +.BR XtParseTranslationTable and passing an empty string. .LP The -.ZN XtAugmentTranslations +.BR XtAugmentTranslations function nondestructively merges the new translations into the existing widget translations. If the new translations contain an event or event sequence that @@ -98,7 +98,7 @@ already exists in the widget's translations, the new translation is ignored. .LP The -.ZN XtOverrideTranslations +.BR XtOverrideTranslations function destructively merges the new translations into the existing widget translations. If the new translations contain an event or event sequence that @@ -106,12 +106,12 @@ already exists in the widget's translations, the new translation is merged in and override the widget's translation. .LP To replace a widget's translations completely, use -.ZN XtSetValues +.BR XtSetValues on the XtNtranslations resource and specify a compiled translation table as the value. .LP The -.ZN XtUninstallTranslations +.BR XtUninstallTranslations function causes the entire translation table for widget to be removed. .SH "SEE ALSO" XtAppAddActions(__libmansuffix__), diff --git a/man/XtPopdown.man b/man/XtPopdown.man index c43d6db..fc6348f 100644 --- a/man/XtPopdown.man +++ b/man/XtPopdown.man @@ -73,7 +73,7 @@ Specifies the callback data, which is not used by this procedure. .IP \fIclient_data\fP 1i Specifies a pointer to the -.ZN XtPopdownID +.BR XtPopdownID structure. .ds Ps \ to pop down .IP \fIpopup_shell\fP 1i @@ -85,14 +85,14 @@ Specifies the name of the widget shell to pop \*(Sn. Specifies the widget. .SH DESCRIPTION The -.ZN XtPopdown +.BR XtPopdown function performs the following: .IP \(bu 5 Calls -.ZN XtCheckSubclass +.BR XtCheckSubclass .\".ZN XtCheckSubclass(popup_shell, popupShellWidgetClass) to ensure popup_shell is a subclass of -.ZN Shell . +.BR Shell . .IP \(bu 5 Checks that popup_shell is currently popped_up; otherwise, it generates an error. @@ -100,22 +100,22 @@ otherwise, it generates an error. Unmaps popup_shell's window. .IP \(bu 5 If popup_shell's grab_kind is either -.ZN XtGrabNonexclusive +.BR XtGrabNonexclusive or -.ZN XtGrabExclusive , +.BR XtGrabExclusive , it calls -.ZN XtRemoveGrab . +.BR XtRemoveGrab . .\".ZN XtRemoveGrab(popup_shell) .IP \(bu 5 Sets pop-up shell's popped_up field to -.ZN False . +.BR False . .IP \(bu 5 Calls the callback procedures on the shell's popdown_callback list. .LP The -.ZN XtCallbackPopdown +.BR XtCallbackPopdown function casts the client data parameter to an -.ZN XtPopdownID +.BR XtPopdownID pointer: .LP .Ds @@ -128,21 +128,21 @@ typedef struct { The shell_widget is the pop-up shell to pop down, and the enable_widget is the widget that was used to pop it up. .LP -.ZN XtCallbackPopdown +.BR XtCallbackPopdown calls -.ZN XtPopdown +.BR XtPopdown with the specified shell_widget and then calls -.ZN XtSetSensitive +.BR XtSetSensitive to resensitize the enable_widget. .LP If a shell name is not given, -.ZN MenuPopdown +.BR MenuPopdown calls -.ZN XtPopdown +.BR XtPopdown with the widget for which the translation is specified. If a shell_name is specified in the translation table, -.ZN MenuPopdown +.BR MenuPopdown tries to find the shell by looking up the widget tree starting at the parent of the widget in which it is invoked. If it finds a shell with the specified name in the pop-up children @@ -150,7 +150,7 @@ of that parent, it pops down the shell; otherwise, it moves up the parent chain as needed. If -.ZN MenuPopdown +.BR MenuPopdown gets to the application top-level shell widget and cannot find a matching shell, it generates an error. diff --git a/man/XtPopup.man b/man/XtPopup.man index be2ab24..4c71156 100644 --- a/man/XtPopup.man +++ b/man/XtPopup.man @@ -90,34 +90,34 @@ Specifies the widget shell. Specifies the widget. .SH DESCRIPTION The -.ZN XtPopup +.BR XtPopup function performs the following: .IP \(bu 5 Calls -.ZN XtCheckSubclass +.BR XtCheckSubclass .\".ZN XtCheckSubclass(popup_shell, popupShellWidgetClass) to ensure popup_shell is a subclass of -.ZN Shell . +.BR Shell . .IP \(bu 5 Generates an error if the shell's popped_up field is already -.ZN True . +.BR True . .IP \(bu 5 Calls the callback procedures on the shell's popup_callback list. .IP \(bu 5 Sets the shell popped_up field to -.ZN True , +.BR True , the shell spring_loaded field to -.ZN False , +.BR False , and the shell grab_kind field from grab_kind. .IP \(bu 5 If the shell's create_popup_child field is non-NULL, -.ZN XtPopup +.BR XtPopup calls it with popup_shell as the parameter. .IP \(bu 5 If grab_kind is either -.ZN XtGrabNonexclusive +.BR XtGrabNonexclusive or -.ZN XtGrabExclusive , +.BR XtGrabExclusive , it calls: .LP .Ds @@ -125,99 +125,99 @@ XtAddGrab(popup_shell, (grab_kind == XtGrabExclusive), False) .De .IP \(bu 5 Calls -.ZN XtRealizeWidget +.BR XtRealizeWidget with popup_shell specified. .IP \(bu 5 Calls -.ZN XMapWindow +.BR XMapWindow with popup_shell specified. .LP The -.ZN XtPopupSpringLoaded +.BR XtPopupSpringLoaded function performs exactly as -.ZN XtPopup +.BR XtPopup except that it sets the shell \fIspring_loaded\fP field to -.ZN True +.BR True and always calls -.ZN XtAddGrab +.BR XtAddGrab with \fIexclusive\fP -.ZN True +.BR True and \fIspring_loaded\fP -.ZN True . +.BR True . .LP The -.ZN XtCallbackNone , -.ZN XtCallbackNonexclusive , +.BR XtCallbackNone , +.BR XtCallbackNonexclusive , and -.ZN XtCallbackExclusive +.BR XtCallbackExclusive functions call -.ZN XtPopup +.BR XtPopup with the shell specified by the client data argument and grab_kind set as the name specifies. -.ZN XtCallbackNone , -.ZN XtCallbackNonexclusive , +.BR XtCallbackNone , +.BR XtCallbackNonexclusive , and -.ZN XtCallbackExclusive +.BR XtCallbackExclusive specify -.ZN XtGrabNone , -.ZN XtGrabNonexclusive , +.BR XtGrabNone , +.BR XtGrabNonexclusive , and -.ZN XtGrabExclusive , +.BR XtGrabExclusive , respectively. Each function then sets the widget that executed the callback list to be insensitive by using -.ZN XtSetSensitive . +.BR XtSetSensitive . Using these functions in callbacks is not required. In particular, an application must provide customized code for callbacks that create pop-up shells dynamically or that must do more than desensitizing the button. .LP -.ZN MenuPopup +.BR MenuPopup is known to the translation manager, which must perform special actions for spring-loaded pop-ups. Calls to -.ZN MenuPopup +.BR MenuPopup in a translation specification are mapped into calls to a nonexported action procedure, and the translation manager fills in parameters based on the event specified on the left-hand side of a translation. .LP If -.ZN MenuPopup +.BR MenuPopup is invoked on -.ZN ButtonPress +.BR ButtonPress (possibly with modifiers), the translation manager pops up the shell with grab_kind set to -.ZN XtGrabExclusive +.BR XtGrabExclusive and spring_loaded set to -.ZN True . +.BR True . If -.ZN MenuPopup +.BR MenuPopup is invoked on -.ZN EnterWindow +.BR EnterWindow (possibly with modifiers), the translation manager pops up the shell with grab_kind set to -.ZN XtGrabNonexclusive +.BR XtGrabNonexclusive and spring_loaded set to -.ZN False . +.BR False . Otherwise, the translation manager generates an error. When the widget is popped up, the following actions occur: .IP \(bu 5 Calls -.ZN XtCheckSubclass +.BR XtCheckSubclass .\".ZN XtCheckSubclass(popup_shell, popupShellWidgetClass) to ensure popup_shell is a subclass of -.ZN Shell . +.BR Shell . .IP \(bu 5 Generates an error if the shell's popped_up field is already -.ZN True . +.BR True . .IP \(bu 5 Calls the callback procedures on the shell's popup_callback list. .IP \(bu 5 Sets the shell popped_up field to -.ZN True +.BR True and the shell grab_kind and spring_loaded fields appropriately. .IP \(bu 5 If the shell's create_popup_child field is non-NULL, @@ -230,23 +230,23 @@ XtAddGrab(popup_shell, (grab_kind == XtGrabExclusive), spring_loaded) .De .IP \(bu 5 Calls -.ZN XtRealizeWidget +.BR XtRealizeWidget with popup_shell specified. .IP \(bu 5 Calls -.ZN XMapWindow +.BR XMapWindow with popup_shell specified. .LP (Note that these actions are the same as those for -.ZN XtPopup .) -.ZN MenuPopup +.BR XtPopup .) +.BR MenuPopup tries to find the shell by searching the widget tree starting at the parent of the widget in which it is invoked. If it finds a shell with the specified name in the pop-up children of that parent, it pops up the shell with the appropriate parameters. Otherwise, it moves up the parent chain as needed. If -.ZN MenuPopup +.BR MenuPopup gets to the application widget and cannot find a matching shell, it generates an error. .SH "SEE ALSO" diff --git a/man/XtProcessLock.man b/man/XtProcessLock.man index ce5527e..f2b2daf 100644 --- a/man/XtProcessLock.man +++ b/man/XtProcessLock.man @@ -64,10 +64,10 @@ void XtProcessLock(void); .HP void XtProcessUnlock(void); .SH DESCRIPTION -.ZN XtProcessLock +.BR XtProcessLock is used to lock all process global data. .LP -.ZN XtProcessUnlock +.BR XtProcessUnlock unlocks the process. .SH "SEE ALSO" .br diff --git a/man/XtQueryGeometry.man b/man/XtQueryGeometry.man index 30320d6..79404e5 100644 --- a/man/XtQueryGeometry.man +++ b/man/XtQueryGeometry.man @@ -77,19 +77,19 @@ the child's parent sets any changes that it intends to make to the child's geometry in the corresponding fields of the intended structure, sets the corresponding bits in intended.request_mode, and calls -.ZN XtQueryGeometry . +.BR XtQueryGeometry . .LP -.ZN XtQueryGeometry +.BR XtQueryGeometry clears all bits in the preferred_return->request_mode and checks the query_geometry field of the specified widget's class record. If query_geometry is not NULL, -.ZN XtQueryGeometry +.BR XtQueryGeometry calls the query_geometry procedure and passes as arguments the specified widget, intended, and preferred_return structures. If the intended argument is NULL, -.ZN XtQueryGeometry +.BR XtQueryGeometry replaces it with a pointer to an -.ZN XtWidgetGeometry +.BR XtWidgetGeometry structure with request_mode=0 before calling query_geometry. .SH "SEE ALSO" XtConfigureWidget(__libmansuffix__), diff --git a/man/XtRealizeWidget.man b/man/XtRealizeWidget.man index aaa6c58..77ab5ae 100644 --- a/man/XtRealizeWidget.man +++ b/man/XtRealizeWidget.man @@ -71,7 +71,7 @@ void XtUnrealizeWidget(Widget \fIw\fP); Specifies the widget. .SH DESCRIPTION If the widget is already realized, -.ZN XtRealizeWidget +.BR XtRealizeWidget simply returns. Otherwise, it performs the following: .IP \(bu 5 @@ -83,16 +83,16 @@ at the specified widget and calls the change_managed procedure of each composite widget that has one or more managed children. .IP \(bu 5 Constructs an -.ZN XSetWindowAttributes +.BR XSetWindowAttributes structure filled in with information derived from the -.ZN Core +.BR Core widget fields and calls the realize procedure for the widget, which adds any widget-specific attributes and creates the X window. .IP \(bu 5 If the widget is not a subclass of -.ZN compositeWidgetClass , -.ZN XtRealizeWidget +.BR compositeWidgetClass , +.BR XtRealizeWidget returns; otherwise, it continues and performs the following: .RS .IP \- 5 @@ -102,23 +102,23 @@ Primitive widgets that instantiate children are responsible for realizing those children themselves. .IP \- 5 Maps all of the managed children windows that have mapped_when_managed -.ZN True . +.BR True . (If a widget is managed but mapped_when_managed is -.ZN False , +.BR False , the widget is allocated visual space but is not displayed. Some people seem to like this to indicate certain states.) .RE .LP If the widget is a top-level shell widget (that is, it has no parent), and mapped_when_managed is -.ZN True , -.ZN XtRealizeWidget +.BR True , +.BR XtRealizeWidget maps the widget window. .LP The -.ZN XtIsRealized +.BR XtIsRealized function returns -.ZN True +.BR True if the widget has been realized, that is, if the widget has a nonzero X window ID. .LP @@ -127,12 +127,12 @@ operate differently after the widget has been realized. .LP The -.ZN XtUnrealizeWidget +.BR XtUnrealizeWidget function destroys the windows of an existing widget and all of its children (recursively down the widget tree). To recreate the windows at a later time, call -.ZN XtRealizeWidget +.BR XtRealizeWidget again. If the widget was managed, it will be unmanaged automatically before its window is freed. diff --git a/man/XtRegisterDrawable.man b/man/XtRegisterDrawable.man index 8ffea73..a8ac671 100644 --- a/man/XtRegisterDrawable.man +++ b/man/XtRegisterDrawable.man @@ -72,10 +72,10 @@ Specifies the drawable to register. .IP \fIwidget\fP 1i Specifies the widget to register the drawable for. .SH DESCRIPTION -.ZN XtRegisterDrawable +.BR XtRegisterDrawable associates the specified drawable with the specified widget so that future calls to -.ZN XtWindowToWidget +.BR XtWindowToWidget with the drawable will return the widget. The default event dispatcher will dispatch future core events that arrive with the drawable to the widget as though the event contained the widget's window, but the event @@ -85,15 +85,15 @@ or action procedures. If the drawable is already registered with another widget, or if the drawable is the window of a widget in the client's widget tree, the results of calling -.ZN XtRegisterDrawable +.BR XtRegisterDrawable are undefined. .LP -.ZN XtUnregisterDrawable +.BR XtUnregisterDrawable removes an association created with -.ZN XtRegisterDrawable . +.BR XtRegisterDrawable . If the drawable is the window of a widget in the client's widget tree the results of calling -.ZN XtUnregisterDrawable +.BR XtUnregisterDrawable are undefined. .SH "SEE ALSO" .br diff --git a/man/XtRegisterGrabAction.man b/man/XtRegisterGrabAction.man index 47f0916..a7384a4 100644 --- a/man/XtRegisterGrabAction.man +++ b/man/XtRegisterGrabAction.man @@ -71,11 +71,11 @@ Specifies the action procedure to search for in translation tables. .IP \fIparams\fP 1i .IP \fInum_params\fP 1i Specify arguments to -.ZN XtGrabButton +.BR XtGrabButton or -.ZN XtGrabKey +.BR XtGrabKey .SH DESCRIPTION -.ZN XtRegisterGrabAction +.BR XtRegisterGrabAction adds the specified \fIaction_proc\fP to a list known to the translation manager. .SH "SEE ALSO" diff --git a/man/XtReservePropertyAtom.man b/man/XtReservePropertyAtom.man index 76b98c5..e84940c 100644 --- a/man/XtReservePropertyAtom.man +++ b/man/XtReservePropertyAtom.man @@ -69,7 +69,7 @@ Specifies the widget used to reserve the atom. .IP \fIatom\fP 1i Specifies the atom whose reservation is to be released. .SH DESCRIPTION -.ZN XtReservePropertyAtom +.BR XtReservePropertyAtom returns an atom that may be used for properties in conjunction with conversion requests from widget \fIw\fP. The atom returned will be unique for the display of the widget specified. diff --git a/man/XtResolvePathname.man b/man/XtResolvePathname.man index a359d5f..e3d1b2e 100644 --- a/man/XtResolvePathname.man +++ b/man/XtResolvePathname.man @@ -85,9 +85,9 @@ Specifies the number of entries in \fIsubstitutions\fP. Specifies a procedure called to judge each potential file name, or NULL. .SH DESCRIPTION The substitutions specified by -.ZN XtResolvePathname +.BR XtResolvePathname are determined from the value of the language string retrieved by -.ZN XtDisplayInitialize +.BR XtDisplayInitialize for the specified display. To set the language for all applications specify ``*xnlLanguage: \fIlang\fP'' in the @@ -101,12 +101,12 @@ this composition is accomplished is implementation-defined and the \*(xI make no interpretation of the parts other than to use them in substitutions as described below. .LP -.ZN XtResolvePathname +.BR XtResolvePathname calls -.ZN XtFindFile +.BR XtFindFile with the following substitutions in addition to any passed by the caller and returns the value returned by -.ZN XtFindFile : +.BR XtFindFile : .IP %N 5 The value of the \fIfilename\fP parameter, or the application's class name if \fIfilename\fP is NULL. @@ -129,16 +129,16 @@ database associated with \fIdisplay\fP. The value of the implementation-specific default path. .LP If a path is passed to -.ZN XtResolvePathname , +.BR XtResolvePathname , it will be passed along to -.ZN XtFindFile . +.BR XtFindFile . If the \fIpath\fP argument is NULL, the value of the -.ZN \s-1XFILESEARCHPATH\s+1 +.BR \s-1XFILESEARCHPATH\s+1 .IN "XFILESEARCHPATH" "" "@DEF@" environment variable will be passed to -.ZN XtFindFile . +.BR XtFindFile . If -.ZN \s-1XFILESEARCHPATH\s+1 +.BR \s-1XFILESEARCHPATH\s+1 is not defined, an implementation-specific default path will be used which contains at least 6 entries. These entries must contain the following substitutions: @@ -190,22 +190,22 @@ allow additional directories to be searched without preventing resources in the system directories from being found. For example, a user installing resource files under a directory called ``ourdir'' might set -.ZN \s-1XFILESEARCHPATH\s+1 +.BR \s-1XFILESEARCHPATH\s+1 to .IP %D:ourdir/%T/%N%C:ourdir/%T/%N .LP The customization string is obtained by querying the resource database currently associated with the display (the database returned by -.ZN XrmGetDatabase ) +.BR XrmGetDatabase ) for the resource \fIapplication_name\fP.customization, class \fIapplication_class\fP.Customization where \fIapplication_name\fP and \fIapplication_class\fP are the values returned by -.ZN XtGetApplicationNameAndClass . +.BR XtGetApplicationNameAndClass . If no value is specified in the database, the empty string is used. .LP It is the responsibility of the caller to free the returned string using -.ZN XtFree +.BR XtFree when it is no longer needed. .SH "SEE ALSO" .br diff --git a/man/XtSessionGetToken.man b/man/XtSessionGetToken.man index c7537ef..21d307c 100644 --- a/man/XtSessionGetToken.man +++ b/man/XtSessionGetToken.man @@ -73,13 +73,13 @@ Specifies the value in the type field of the token. Specifies the token to be returned. .SH DESCRIPTION The -.ZN XtSessionGetToken +.BR XtSessionGetToken function will return NULL if the checkpoint operation instigated by the session manager is not currently under way. .LP To indicate the completion of a deferred save operation and to return the checkpoint token use -.ZN XtSessionReturnToken . +.BR XtSessionReturnToken . .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtSetArg.man b/man/XtSetArg.man index 33fc0cc..e9a1807 100644 --- a/man/XtSetArg.man +++ b/man/XtSetArg.man @@ -70,10 +70,10 @@ ArgList XtMergeArgLists(ArgList \fIargs1\fP, Cardinal \fInum_args1\fP, ArgList Specifies the name-value pair to set. .IP \fIargs1\fP 1i Specifies the first -.ZN ArgList . +.BR ArgList . .IP \fIargs2\fP 1i Specifies the second -.ZN ArgList . +.BR ArgList . .IP \fInum_args1\fP 1i Specifies the number of arguments in the first argument list. .IP \fInum_args2\fP 1i @@ -82,11 +82,11 @@ Specifies the number of arguments in the second argument list. Specifies the name of the resource. .IP \fIvalue\fP 1i Specifies the value of the resource if it will fit in an -.ZN XtArgVal +.BR XtArgVal or the address. .SH DESCRIPTION The -.ZN XtSetArg +.BR XtSetArg function is usually used in a highly stylized manner to minimize the probability of making a mistake; for example: .LP @@ -102,7 +102,7 @@ XtSetValues(widget, args, n); .LP Alternatively, an application can statically declare the argument list and use -.ZN XtNumber : +.BR XtNumber : .LP .Ds static Args args[] = { @@ -114,19 +114,19 @@ XtSetValues(Widget, args, XtNumber(args)); .LP Note that you should not use auto-increment or auto-decrement within the first argument to -.ZN XtSetArg . -.ZN XtSetArg +.BR XtSetArg . +.BR XtSetArg can be implemented as a macro that dereferences the first argument twice. .LP The -.ZN XtMergeArgLists +.BR XtMergeArgLists function allocates enough storage to hold the combined -.ZN ArgList +.BR ArgList structures and copies them into it. Note that it does not check for duplicate entries. When it is no longer needed, free the returned storage by using -.ZN XtFree . +.BR XtFree . .SH "SEE ALSO" XtOffset(__libmansuffix__) .br diff --git a/man/XtSetKeyTranslator.man b/man/XtSetKeyTranslator.man index 744ed25..ced6f29 100644 --- a/man/XtSetKeyTranslator.man +++ b/man/XtSetKeyTranslator.man @@ -101,12 +101,12 @@ Specifies the first KeySym for which this converter is valid. Specifies the last KeySym for which this converter is valid. .SH DESCRIPTION The -.ZN XtSetKeyTranslator +.BR XtSetKeyTranslator function sets the specified procedure as the current key translator. The default translator is -.ZN XtTranslateKey , +.BR XtTranslateKey , an -.ZN XtKeyProc +.BR XtKeyProc that uses Shift and Lock modifiers with the interpretations defined by the core protocol. It is provided so that new translators can call it to get default @@ -114,12 +114,12 @@ KeyCode-to-KeySym translations and so that the default translator can be reinstalled. .LP The -.ZN XtTranslateKeycode +.BR XtTranslateKeycode function passes the specified arguments directly to the currently registered KeyCode to KeySym translator. .LP The -.ZN XtRegisterCaseConverter +.BR XtRegisterCaseConverter registers the specified case converter. The start and stop arguments provide the inclusive range of KeySyms for which this converter is to be called. @@ -132,10 +132,10 @@ The default converter understands case conversion for all KeySyms defined in the core protocol. .LP The -.ZN XtConvertCase +.BR XtConvertCase function calls the appropriate converter and returns the results. A user-supplied -.ZN XtKeyProc +.BR XtKeyProc may need to use this function. .SH "SEE ALSO" .br diff --git a/man/XtSetKeyboardFocus.man b/man/XtSetKeyboardFocus.man index c93c65c..fc3aa1f 100644 --- a/man/XtSetKeyboardFocus.man +++ b/man/XtSetKeyboardFocus.man @@ -66,22 +66,22 @@ XtSetKeyboardFocus(Widget \fIsubtree\fP, Widget \fIdescendant\fP); .IP \fIsubtree\fP 1i Specifies either the widget in the subtree structure which is to receive the keyboard event, or -.ZN None . +.BR None . Note that it is not an error to specify -.ZN None +.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. .SH DESCRIPTION If a future -.ZN KeyPress +.BR KeyPress or -.ZN KeyRelease +.BR KeyRelease event occurs within the specified subtree, -.ZN XtSetKeyboardFocus +.BR XtSetKeyboardFocus causes -.ZN XtDispatchEvent +.BR XtDispatchEvent to remap and send the event to the specified descendant widget. .LP When there is no modal cascade, @@ -98,20 +98,20 @@ and the pointer is within W. When there is a modal cascade, a widget W receives keyboard events if an ancestor of W is in the active subset of the modal cascade and one or more of the previous conditions is -.ZN True . +.BR True . .LP When subtree or one of its descendants acquires the X input focus or the pointer moves into the subtree such that keyboard events would now be delivered to subtree, a -.ZN FocusIn +.BR FocusIn event is generated for the descendant if -.ZN FocusNotify +.BR FocusNotify events have been selected by the descendant. Similarly, when W loses the X input focus or the keyboard focus for one of its ancestors, a -.ZN FocusOut +.BR FocusOut event is generated for descendant if -.ZN FocusNotify +.BR FocusNotify events have been selected by the descendant. .SH "SEE ALSO" XtCallAcceptFocus(__libmansuffix__) diff --git a/man/XtSetLanguageProc.man b/man/XtSetLanguageProc.man index 5212c2f..b9e4e17 100644 --- a/man/XtSetLanguageProc.man +++ b/man/XtSetLanguageProc.man @@ -75,52 +75,52 @@ Specifies the language procedure, or NULL. Specifies additional client data to be passed to the language procedure when it is called. .SH DESCRIPTION -.ZN XtSetLanguageProc +.BR XtSetLanguageProc sets the language procedure that will be called from -.ZN XtDisplayInitialize +.BR XtDisplayInitialize for all subsequent Displays initialized in the specified application context. If \fIapp_context\fP is NULL, the specified language procedure is registered in all application contexts created by the calling process, including any future application contexts that may be created. If \fIproc\fP is NULL a default language procedure is registered. -.ZN XtSetLanguageProc +.BR XtSetLanguageProc returns the previously registered language procedure. If a language procedure has not yet been registered, the return value is unspecified but if this return value is used in a subsequent call to -.ZN XtSetLanguageProc , +.BR XtSetLanguageProc , it will cause the default language procedure to be registered. .LP The default language procedure does the following: .IP \(bu 5 Sets the locale according to the environment. On ANSI C-based systems this is done by calling -.ZN setlocale ( -.ZN LC_ALL , +.BR setlocale ( +.BR LC_ALL , language ). If an error is encountered a warning message is issued with -.ZN XtWarning . +.BR XtWarning . .IP \(bu 5 Calls -.ZN XSupportsLocale +.BR XSupportsLocale to verify that the current locale is supported. If the locale is not supported, a warning message is issued with -.ZN XtWarning +.BR XtWarning and the locale is set to ``C''. .IP \(bu 5 Calls -.ZN XSetLocaleModifiers +.BR XSetLocaleModifiers specifying the empty string. .IP \(bu 5 Returns the value of the current locale. On ANSI C-based systems this is the return value from a final call to -.ZN setlocale ( -.ZN LC_ALL , +.BR setlocale ( +.BR LC_ALL , NULL ). .LP A client wishing to use this mechanism to establish locale can do so by calling -.ZN XtSetLanguageProc +.BR XtSetLanguageProc prior to -.ZN XtDisplayInitialize. +.BR XtDisplayInitialize. .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtSetMultiClickTime.man b/man/XtSetMultiClickTime.man index d373f7b..6eb5d7e 100644 --- a/man/XtSetMultiClickTime.man +++ b/man/XtSetMultiClickTime.man @@ -69,11 +69,11 @@ Specifies the display connection. .IP \fItime\fP 1i Specifies the multi-click time in milliseconds. .SH DESCRIPTION -.ZN XtSetMultiClickTime +.BR XtSetMultiClickTime sets the time interval used by the translation manager to determine when multiple events are interpreted as a repeated event. .LP -.ZN XtGetMultiClickTime +.BR XtGetMultiClickTime returns the time in milliseconds that the translation manager uses to determine if multiple events are to be interpreted as a repeated event for purposes of matching a translation entry containing a repeat count. diff --git a/man/XtSetSelectionParameters.man b/man/XtSetSelectionParameters.man index 7f543aa..444553c 100644 --- a/man/XtSetSelectionParameters.man +++ b/man/XtSetSelectionParameters.man @@ -82,13 +82,13 @@ Specifies the size in bits of the data in the elements of \fIvalue\fP. The specified parameters will be copied and stored in a new property of the specified type and format on the requestor's window. To initiate a selection request with a target and these parameters, a subsequent call to -.ZN XtGetSelectionValue +.BR XtGetSelectionValue or to -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental specifying the same requestor widget and selection atom will generate a -.ZN ConvertSelection +.BR ConvertSelection request referring referring to the property containing the parameters. If -.ZN XtSetSelectionParameters +.BR XtSetSelectionParameters is called more than once with the same widget and selection without a call to specify a request, the most recently specified parameters are used in the subsequent request. @@ -99,18 +99,18 @@ sizeof(short); if 32, sizeof(long). .LP To generate a MULTIPLE target request with parameters for any of the multiple targets of the selection request, precede individual calls to -.ZN XtGetSelectionValue +.BR XtGetSelectionValue and -.ZN XtGetSelectionValueIncremental +.BR XtGetSelectionValueIncremental with corresponding individual calls to -.ZN XtSetSelectionParameters , +.BR XtSetSelectionParameters , and enclose these all within -.ZN XtCreateSelectionRequest +.BR XtCreateSelectionRequest and -.ZN XtSendSelectionRequest . -.ZN XtGetSelectionValues +.BR XtSendSelectionRequest . +.BR XtGetSelectionValues and -.ZN XtGetSelectionValuesIncremental +.BR XtGetSelectionValuesIncremental cannot be used to make selection requests with parameterized targets. .SH "SEE ALSO" XtGetSelectionParameters(__libmansuffix__) diff --git a/man/XtSetSensitive.man b/man/XtSetSensitive.man index 9265862..992090b 100644 --- a/man/XtSetSensitive.man +++ b/man/XtSetSensitive.man @@ -72,47 +72,47 @@ keyboard and pointer events. Specifies the widget. .SH DESCRIPTION The -.ZN XtSetSensitive +.BR XtSetSensitive function first calls -.ZN XtSetValues +.BR XtSetValues on the current widget with an argument list specifying that the sensitive field should change to the new value. It then recursively propagates the new value down the managed children tree by calling -.ZN XtSetValues +.BR XtSetValues on each child to set the ancestor_sensitive to the new value if the new values for sensitive and the child's ancestor_sensitive are not the same. .LP -.ZN XtSetSensitive +.BR XtSetSensitive calls -.ZN XtSetValues +.BR XtSetValues to change sensitive and ancestor_sensitive. Therefore, when one of these changes, the widget's set_values procedure should take whatever display actions are needed (for example, greying out or stippling the widget). .LP -.ZN XtSetSensitive +.BR XtSetSensitive maintains the invariant that if parent has either sensitive or ancestor_sensitive -.ZN False , +.BR False , then all children have ancestor_sensitive -.ZN False . +.BR False . .LP The -.ZN XtIsSensitive +.BR XtIsSensitive function returns -.ZN True +.BR True or -.ZN False +.BR False to indicate whether or not user input events are being dispatched. If both core.sensitive and core.ancestor_sensitive are -.ZN True , -.ZN XtIsSensitive +.BR True , +.BR XtIsSensitive returns -.ZN True ; +.BR True ; otherwise, it returns -.ZN False . +.BR False . .SH "SEE ALSO" .br \fI\*(xT\fP diff --git a/man/XtSetValues.man b/man/XtSetValues.man index b15ba5b..0378eca 100644 --- a/man/XtSetValues.man +++ b/man/XtSetValues.man @@ -103,14 +103,14 @@ Specifies the widget. Specifies the variable argument list \*(Al. .SH DESCRIPTION The -.ZN XtSetValues +.BR XtSetValues function starts with the resources specified for the -.ZN Core +.BR Core widget fields and proceeds down the subclass chain to the widget. At each stage, it writes the new value (if specified by one of the arguments) or the existing value (if no new value is specified) to a new widget data record. -.ZN XtSetValues +.BR XtSetValues then calls the set_values procedures for the widget in superclass-to-subclass order. .IN "hook" @@ -118,65 +118,65 @@ If the widget has any non-NULL set_values_hook fields, these are called immediately after the corresponding set_values procedure. This procedure permits subclasses to set nonwidget data for -.ZN XtSetValues . +.BR XtSetValues . .LP If the widget's parent is a subclass of -.ZN constraintWidgetClass , -.ZN XtSetValues +.BR constraintWidgetClass , +.BR XtSetValues also updates the widget's constraints. It starts with the constraint resources specified for -.ZN constraintWidgetClass +.BR constraintWidgetClass and proceeds down the subclass chain to the parent's class. At each stage, it writes the new value or the existing value to a new constraint record. It then calls the constraint set_values procedures from -.ZN constraintWidgetClass +.BR constraintWidgetClass down to the parent's class. The constraint set_values procedures are called with widget arguments, as for all set_values procedures, not just the constraint record arguments, so that they can make adjustments to the desired values based on full information about the widget. .LP -.ZN XtSetValues +.BR XtSetValues determines if a geometry request is needed by comparing the current widget to the new widget. If any geometry changes are required, it makes the request, and the geometry manager returns -.ZN XtGeometryYes , -.ZN XtGeometryAlmost , +.BR XtGeometryYes , +.BR XtGeometryAlmost , or -.ZN XtGeometryNo . +.BR XtGeometryNo . If -.ZN XtGeometryYes , -.ZN XtSetValues +.BR XtGeometryYes , +.BR XtSetValues calls the widget's resize procedure. If -.ZN XtGeometryNo , -.ZN XtSetValues +.BR XtGeometryNo , +.BR XtSetValues resets the geometry fields to their original values. If -.ZN XtGeometryAlmost , -.ZN XtSetValues +.BR XtGeometryAlmost , +.BR XtSetValues calls the set_values_almost procedure, which determines what should be done and writes new values for the geometry fields into the new widget. -.ZN XtSetValues +.BR XtSetValues then repeats this process, deciding once more whether the geometry manager should be called. .LP Finally, if any of the set_values procedures returned -.ZN True , -.ZN XtSetValues +.BR True , +.BR XtSetValues causes the widget's expose procedure to be invoked by calling the Xlib -.ZN XClearArea +.BR XClearArea function on the widget's window. .LP The -.ZN XtSetSubvalues +.BR XtSetSubvalues function stores resources into the structure identified by base. .LP The -.ZN XtGetValues +.BR XtGetValues function starts with the resources specified for the core widget fields and proceeds down the subclass chain to the widget. The value field of a passed argument list should contain the @@ -186,11 +186,11 @@ to allocate and deallocate this storage according to the size of the resource representation type used within the widget. .LP If the widget's parent is a subclass of -.ZN constraintWidgetClass , -.ZN XtGetValues +.BR constraintWidgetClass , +.BR XtGetValues then fetches the values for any constraint resources requested. It starts with the constraint resources specified for -.ZN constraintWidgetClass +.BR constraintWidgetClass and proceeds down to the subclass chain to the parent's constraint resources. If the argument list contains a resource name that is not found in any of the resource lists searched, @@ -199,12 +199,12 @@ the value at the corresponding address is not modified. Finally, if the get_values_hook procedures are non-NULL, they are called in superclass-to-subclass order after all the resource values have been fetched by -.ZN XtGetValues . +.BR XtGetValues . This permits a subclass to provide nonwidget resource data to -.ZN XtGetValues . +.BR XtGetValues . .LP The -.ZN XtGetSubvalues +.BR XtGetSubvalues function obtains resource values from the structure identified by base. .SH "SEE ALSO" .br diff --git a/man/XtSetWMColormapWindows.man b/man/XtSetWMColormapWindows.man index 6aca827..9cfc12b 100644 --- a/man/XtSetWMColormapWindows.man +++ b/man/XtSetWMColormapWindows.man @@ -72,10 +72,10 @@ listed in the WM_COLORMAP_WINDOWS property. .IP \fIcount\fP 1i Specifies the number of widgets in \fIlist\fP. .SH DESCRIPTION -.ZN XtSetWMColormapWindows +.BR XtSetWMColormapWindows returns immediately if \fIwidget\fP is not realized or if \fIcount\fP is zero. Otherwise, -.ZN XtSetWMColormapWindows +.BR XtSetWMColormapWindows constructs an ordered list of windows by examining each widget in \fIlist\fP in turn and ignoring the widget if it is not realized, or adding the widget's window to the window list if the widget is @@ -84,7 +84,7 @@ resources of all widgets whose windows are already on the window list. .LP Finally, -.ZN XtSetWMColormapWindows +.BR XtSetWMColormapWindows stores the resulting window list in the WM_COLORMAP_WINDOWS property on the specified widget's window. .SH "SEE ALSO" diff --git a/man/XtStringConversionWarning.man b/man/XtStringConversionWarning.man index b7acebb..0d60d2c 100644 --- a/man/XtStringConversionWarning.man +++ b/man/XtStringConversionWarning.man @@ -69,14 +69,14 @@ Specifies the string that could not be converted. Specifies the name of the type to which the string could not be converted. .SH DESCRIPTION The -.ZN XtStringConversionWarning +.BR XtStringConversionWarning function issues a warning message with name ``conversionError'', type ``string'', class ``XtToolkitError, and the default message string ``Cannot convert "\fIsrc\fP" to type \fIdst_type\fP''. .LP -.ZN XtStringConversionWarning +.BR XtStringConversionWarning has been replaced by -.ZN XtDisplayStringConversionWarning . +.BR XtDisplayStringConversionWarning . .SH "SEE ALSO" XtAppAddConverter(__libmansuffix__), XtAppErrorMsg(3t), diff --git a/man/XtToolkitThreadInitialize.man b/man/XtToolkitThreadInitialize.man index f8955af..de616b5 100644 --- a/man/XtToolkitThreadInitialize.man +++ b/man/XtToolkitThreadInitialize.man @@ -63,14 +63,14 @@ XtToolkitThreadInitialize \- initialize the toolkit for multiple threads Boolean XtToolkitThreadInitialize(void); .SH DESCRIPTION If -.ZN XtToolkitThreadInitialize +.BR XtToolkitThreadInitialize was previously called, it returns. The application programmer must ensure that two or more threads do not simultaneously attempt to call -.ZN XtToolkitThreadInitialize ; +.BR XtToolkitThreadInitialize ; the effect of this is undefined. -.ZN XtToolkitThreadInitialize +.BR XtToolkitThreadInitialize returns -.ZN True +.BR True if the host operating system has threads and the Intrinsics are thread safe. .SH "SEE ALSO" diff --git a/man/XtTranslateCoords.man b/man/XtTranslateCoords.man index 4248d8c..68fa18d 100644 --- a/man/XtTranslateCoords.man +++ b/man/XtTranslateCoords.man @@ -79,9 +79,9 @@ Specify the \*(Nu x and y coordinates. Specifies the widget. .SH DESCRIPTION While -.ZN XtTranslateCoords +.BR XtTranslateCoords is similar to the Xlib -.ZN XTranslateCoordinates +.BR XTranslateCoordinates function, it does not generate a server request because all the required information already is in the widget's data structures. .SH "SEE ALSO" diff --git a/man/XtVaCreateArgsList.man b/man/XtVaCreateArgsList.man index 624237b..843967b 100644 --- a/man/XtVaCreateArgsList.man +++ b/man/XtVaCreateArgsList.man @@ -67,19 +67,19 @@ Must be specified as NULL. Specifies a variable parameter list of resource name and value pairs. .SH DESCRIPTION The -.ZN XtVaCreateArgsList +.BR XtVaCreateArgsList function allocates memory and copies its arguments into a single list pointer, which may be used with -.ZN XtVaNestedList . +.BR XtVaNestedList . The end of both lists is identified by a \fIname\fP entry containing NULL. Any entries of type -.ZN XtVaTypedArg +.BR XtVaTypedArg are copied as specified without applying conversions. Data passed by reference (including Strings) are not copied, only the pointers themselves; the caller must ensure that the data remain valid for the lifetime of the created varargs list. The list should be freed using -.ZN XtFree +.BR XtFree when no longer needed. .SH "SEE ALSO" .br |