summaryrefslogtreecommitdiff
path: root/man/XtDisplayInitialize.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/XtDisplayInitialize.man')
-rw-r--r--man/XtDisplayInitialize.man54
1 files changed, 27 insertions, 27 deletions
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__),