1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
=head1 NAME
Tk::CmdLine - Process standard X11 command line options
=for pm Tk/CmdLine.pm
=for category Creating and Configuring Widgets
=head1 SYNOPSIS
S< >B<use Tk::CmdLine;>
=head1 DESCRIPTION
The X11R5 man page for X11 says :
"Most X programs attempt to use the same names for command
line options and arguments. All applications written with
the X Toolkit Intrinsics automatically accept the following
options: ..."
This module implemements these command line options for perl/Tk
applications.
The options which are processed are :
=over 4
=item B<-display> I<display>
This option specifies the name of the X server to
use.
=item B<-geometry> I<geometry>
This option specifies the initial size and location
of the I<first> L<MainWindow|Tk::MainWindow>.
=item B<-bg> I<color>, B<-background> I<color>
Either option specifies the color to use for the
window background.
=item B<-bd> I<color>, B<-bordercolor> I<color>
Either option specifies the color to use for the
window border.
=item B<-bw> I<number>, B<-borderwidth> I<number>
Either option specifies the width in pixels of the
window border.
=item B<-fg> I<color>, B<-foreground> I<color>
Either option specifies the color to use for text or
graphics.
=item B<-fn> I<font>, B<-font> I<font>
Either option specifies the font to use for displaying text.
=item B<-iconic>
This option indicates that the user would prefer
that the application's windows initially not be
visible as if the windows had be immediately iconi
fied by the user. Window managers may choose not to
honor the application's request.
=item B<-name>
This option specifies the name under which resources
for the application should be found. This option is
useful in shell aliases to distinguish between invocations
of an application, without resorting to
creating links to alter the executable file name.
See also L<Tk::option> for details about resources.
=item B<-rv>, B<-reverse>
Either option indicates that the program should
simulate reverse video if possible, often by swapping
the foreground and background colors. Not all
programs honor this or implement it correctly. It
is usually only used on monochrome displays.
I<Tk::CmdLine ignores this option.>
=item B<+rv>
This option indicates that the program should not
simulate reverse video. This is used to override any
defaults since reverse video doesn't always work
properly.
I<Tk::CmdLine ignores this option.>
=item B<-selectionTimeout>
This option specifies the timeout in milliseconds
within which two communicating applications must
respond to one another for a selection request.
I<Tk::CmdLine ignores this option.>
=item B<-synchronous>
This option indicates that requests to the X server
should be sent synchronously, instead of
asynchronously. Since Xlib normally buffers requests to the
server, errors do not necessarily get reported
immediately after they occur. This option turns off
the buffering so that the application can be
debugged. It should never be used with a working
program.
=item B<-title> I<string>
This option specifies the title to be used for this
window. This information is sometimes used by a
window manager to provide some sort of header identifying
the window.
=item B<-xnllanguage> I<language[_territory][.codeset]>
This option specifies the language, territory, and
codeset for use in resolving resource and other
filenames.
I<Tk::CmdLine ignores this option.>
=item B<-xrm> I<resourcestring>
This option specifies a resource name and value to
override any defaults. It is also very useful for
setting resources that don't have explicit command
line arguments.
The I<resourcestring> is of the form C<name:value>, that is (the first) ':'
is the used to determine which part is name and which part is value.
The name/value pair is entered into the options database with B<optionAdd>
(for each L<MainWindow|Tk::MainWindow> configured), with "interactive" priority.
=back 4
=head1 SEE ALSO
L<Tk::MainWindow|Tk::MainWindow>
=cut
|
