
=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.

=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

