diff options
author | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2020-01-14 20:49:02 +0000 |
---|---|---|
committer | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2020-01-14 20:49:02 +0000 |
commit | 332defa5d8762e8c04e4e707c08ae3893173581f (patch) | |
tree | 3d1096bd168085fd8eac02831142c2466f9b2d26 /lib/libXt/man/XtAppInitialize.man | |
parent | c6b1589c2baee04df73cce89e6ffdaabe9a91a87 (diff) |
Update to libXt 1.2.0. Tested by tb@
Diffstat (limited to 'lib/libXt/man/XtAppInitialize.man')
-rw-r--r-- | lib/libXt/man/XtAppInitialize.man | 83 |
1 files changed, 29 insertions, 54 deletions
diff --git a/lib/libXt/man/XtAppInitialize.man b/lib/libXt/man/XtAppInitialize.man index 97c25c128..c4ab2bf99 100644 --- a/lib/libXt/man/XtAppInitialize.man +++ b/lib/libXt/man/XtAppInitialize.man @@ -33,58 +33,30 @@ .ds Vn 2.2 .hw XtApp-Initialize XtVa-App-Initialize .na -.de Ds -.nf -.\\$1D \\$2 \\$1 -.ft CW -.ps \\n(PS -.\".if \\n(VS>=40 .vs \\n(VSu -.\".if \\n(VS<=39 .vs \\n(VSp -.. -.de De -.ce 0 -.if \\n(BD .DF -.nr BD 0 -.in \\n(OIu -.if \\n(TM .ls 2 -.sp \\n(DDu -.fi -.. -.de IN \" send an index entry to the stderr -.. -.de Pn -.ie t \\$1\fB\^\\$2\^\fR\\$3 -.el \\$1\fI\^\\$2\^\fP\\$3 -.. -.de ZN -.ie t \fB\^\\$1\^\fR\\$2 -.el \fI\^\\$1\^\fP\\$2 -.. -.ny0 .TH XtAppInitialize __libmansuffix__ __xorgversion__ "XT FUNCTIONS" .SH NAME XtAppInitialize, XtVaAppInitialize \- initialize, open, or close a display .SH SYNTAX +#include <X11/Intrinsic.h> .HP -Widget XtAppInitialize(XtAppContext* \fIapp_context_return\fP, String -\fIapplication_class\fP, XrmOptionDescRec* \fIoptions\fP, Cardinal -\fInum_options\fP, int* \fIargc_in_out\fP, String* \fIargv_in_out\fP, String* -\fIfallback_resources\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP); +Widget XtAppInitialize(XtAppContext* \fIapp_context_return\fP, +const char *\fIapplication_class\fP, XrmOptionDescRec* \fIoptions\fP, +Cardinal \fInum_options\fP, int *\fIargc_in_out\fP, char **\fIargv_in_out\fP, +String *\fIfallback_resources\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP); .HP -Widget XtVaAppInitialize(XtAppContext* \fIapp_context_return\fP, String -\fIapplication_class\fP, XrmOptionDescRec* \fIoptions\fP, Cardinal -\fInum_options\fP, int* \fIargc_in_out\fP, String* \fIargv_in_out\fP, String* -\fIfallback_resources\fP, ...\^); +Widget XtVaAppInitialize(XtAppContext* \fIapp_context_return\fP, +const char *\fIapplication_class\fP, XrmOptionDescRec* \fIoptions\fP, +Cardinal \fInum_options\fP, int *\fIargc_in_out\fP, char **\fIargv_in_out\fP, +String *\fIfallback_resources\fP, ...\^); .SH ARGUMENTS .IP \fIapp_context_return\fP 1i Specifies the application context. -.ds Ac , which usually is the generic name for all instances of this application .IP \fIapplication_class\fP 1i -Specifies the class name of this application\*(Ac. +Specifies the class name of this application, which usually is the generic name for all instances of this application. .IP \fIoptions\fP 1i Specifies how to parse the command line for any application-specific resources. The options argument is passed as a parameter to -.ZN XrmParseCommand . +.BR XrmParseCommand . For further information, see \fI\*(xL\fP. .IP \fInum_options\fP 1i @@ -106,35 +78,38 @@ Specifies the variable argument list to override any other resource specification for the created shell widget. .SH DESCRIPTION The -.ZN XtAppInitialize +.B XtAppInitialize function calls -.ZN XtToolkitInitialize +.B XtToolkitInitialize followed by -.ZN XtCreateApplicationContext , +.BR XtCreateApplicationContext , then calls -.ZN XtOpenDisplay +.B XtOpenDisplay with \fIdisplay_string\fP NULL and \fIapplication_name\fP NULL, and finally calls -.ZN XtAppCreateShell +.B 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 +created shell. +The modified \fIargc\fP and \fIargv\fP returned by +.B 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 +is also returned. +If the display specified by the command line cannot be opened, an error message is issued and -.ZN XtAppInitialize -terminates the application. If \fIfallback_resources\fP is non-NULL, -.ZN XtAppSetFallbackResources +.B XtAppInitialize +terminates the application. +If \fIfallback_resources\fP is non-NULL, +.B XtAppSetFallbackResources is called with the value prior to calling -.ZN XtOpenDisplay . +.BR XtOpenDisplay . .LP XtAppInitialize and XtVaAppInitialize have been superceded by -.ZN XtOpenApplication +.B XtOpenApplication and -.ZN XtVaOpenApplication +.B XtVaOpenApplication respectively. .SH "SEE ALSO" XtOpenApplication(__libmansuffix__), XtVaOpenApplication(__libmansuffix__) |