CMDLINE(1)

NAME
Tk::CmdLine - Process standard X11 command line options

SYNOPSIS
use Tk::CmdLine;

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 : This option specifies the name of the X server to use. This option specifies the initial size and location of the first MainWindow. Either option specifies the color to use for the window background. Either option specifies the color to use for the window border. Either option specifies the width in pixels of the window border. Either option specifies the color to use for text or graphics. Either option specifies the font to use for displaying text. 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. 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 the Tk::option manpage for details about resources. 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.

Tk::CmdLine ignores this option. 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.

Tk::CmdLine ignores this option. This option specifies the timeout in milliseconds within which two communicating applications must respond to one another for a selection request.

Tk::CmdLine ignores this option. 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. 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. This option specifies the language, territory, and codeset for use in resolving resource and other filenames.

Tk::CmdLine ignores this option. 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 resourcestring is of the form 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 optionAdd (for each MainWindow configured), with "interactive" priority.

SEE ALSO
Tk::MainWindow