NAME

xf - interactive interface builder for Tcl/TK


SYNOPSIS

xf [xf options]

xf options:

[-cmd\ <arg>] [-testcmd\ <arg>] [-xf\ <pathname>] [-xfadditionals\ <pathname list>] [-xfbind\ <pathname>] [-xfcolors\ <filename>] [-xfconfig\ <filename>] [-xfcursors\ <filename>] [-xfelements\ <pathname>] [-xffonts\ <filename>] [-xfhelp] [-xfhelps\ <pathname list>] [-xficonbar\ <filename>] [-xficons\ <filename>] [-xfignore] [-xfkeysyms\ <filename>] [-xflib\ <pathname>] [-xfmenubar\ <filename>] [-xfmodelcolor] [-xfmodelmono] [-xfpos\ <filename>] [-xfprocs\ <pathname>] [-xfsrc\ <pathname>] [-xfstartup\ <filename>] [-xftemplates\ <pathname list>] [-xftmp\ <pathname>] [-xfversion] [file...] [application options]


DESCRIPTION

XF allows to interactively build and modify a graphical user interface, based upon the Tcl/TK package from John Ousterhout. It provides full access to the complete command and widget set of Tcl/Tk. If there occur errors during the work with XF that are producing output to stderr, these errors are mirrored to the file xferrors in the XF tmp directory. If you can say that they are caused by XF or you are not sure, please send me thw file so that I can locate the problem.


OPTIONS

The following options can be controlled from the command line.

-cmd <arg>

This option allows you to select a different interpreter (something else than in the xf script).

-testcmd <arg>

This option allows you to select a different interpreter for the testing (something else than in the xf script).

-xf <pathname>

This option sets the xf toplevel directory to the given value.

-xfadditionals <pathname list>

This option sets the xf additionals directory to the given value. This directory contains widget sources of the widgets that are not part of the core Tk distribution, like the Hypertext widget. The parameter can be a list of pathnames separated by ':'.

-xfbind <filename>

This option sets the xf binding file to the given value. This file contains the class bindings of the widgets, and procedures that are needed by the bindings.

-xfcolors <filename>

This option sets the xf color file to the given value. This file contains the names and values of the known colors.

-xfconfig <filename>

This option sets the xf configuration file to the given value. This file contains the settings of xf. If a configuration file is specified, all other commandline settings are ignored.

-xfcursors <filename>

This option sets the xf cursor file to the given value. This file contains the names of the known cursors.

-xfelements <pathname>

This option sets the xf element directory to the given value. This directory contains the widget sources of the widgets that are part of the core Tk distribution.

-xffonts <filename>

This option sets the xf font file to the given value. This file contains the names of the known fonts.

-xfhelp

This option shows a small help screen.

-xfhelps <pathname list>

This option sets the xf help directory to the given value. This directory contains the help pages for xf. The parameter can be a list of pathnames separated by ':'.

-xficonbar <filename>

This option sets the xf iconbar file to the given value. This file contains the definition of the iconbar.

-xficons <pathname list>

This option sets the xf icon directory to the given value. This directory contains the icons for the menubar. The parameter can be a list of pathnames separated by ':'.

-xfignore

All options following this parameter are ignored by xf, and are directly passed on to the application.

-xfkeysyms <filename>

This option sets the xf keysyms file to the given value. This file contains the names of the known keysyms.

-xflib <pathname>

This option sets the xf library directory to the given value. This directory contains the font-, color-, cursor- and keysym-files.

-xfmenubar <filename>

This option sets the xf menubar file to the given value. This file contains the definition of the menubar.

-xfmodelcolor

This option sets the color model to color.

-xfmodelmono

This option sets the color model to monochrome.

-xfpos <filename>

This option sets the xf position file to the given value. This file contains the positions of the windows.

-xfprocs <pathname>

This option sets the xf procedure directory to the given value. This directory contains the version archive of the procedures. Procedures can be stored with the shape toolkit (available at ftp.cs.tu-berlin.de).

-xfsrc <pathname>

This option sets the xf source directory to the given value. This directory contains the complete sources of xf.

-xfstartup <filename>

This option sets the xf startup file name to something different than .xf-init. This file is evaluated when xf is started.

-xftemplates <pathname list>

This option sets the xf template directory to the given value. This directory contains the source templates. You can use templates to create complex interface elements that are used repeatedly in your applications. These elements can be stored permanently. The parameter can be a list of pathnames separated by ':'.

-xftmp <pathname>

This option sets the xf temporary directory to the given value. This directory contains temporary files.

-xfversion

This option shows the current version number of XF.

file

The first name that is not an xf option is the name of the main application file or, if the file does not exist, the name of the new application. Additional file names that are passed to xf will be loaded as tcl files by xf.

application options

All names that are no xf option and cannot be found as a file, are passed to the called application as parameters.


HINTS

If you need hints, take a look at the FAQ's :-). They are part of the help system.


ENVIRONMENT

The default display to be used.

This variable allows you to select a different interpreter (something else than in the xf script).

This variable allows you to select a different interpreter for testing (something else than in the xf script).

This variable sets the xf toplevel directory to the given value.

This option sets the xf additionals directory to the given value. This directory contains widget sources of the widgets that are not part of the core Tk distribution, like the Hypertext widget. The parameter can be a list of pathnames separated by ':'.

This variable sets the xf application default file to the given value. This file contains application defaults for xf.

This variable sets the xf binding file to the given value. This file contains the class bindings of the widgets, and procedures that are needed by the bindings.

This variable sets the xf color file to the given value. This file contains the names and values of the known colors.

This variable sets the xf configuration file to the given value. This file contains the settings of xf. If a configuration file is specified, all other commandline settings are ignored.

This variable sets the xf cursor file to the given value. This file contains the names of the known cursors.

This variable sets the xf element directory to the given value. This directory contains the widget sources of the widgets that are part of the core Tk distribution.

This variable sets the xf font file to the given value. This file contains the names of the known fonts.

This option sets the xf help directory to the given value. This directory contains the help pages for xf. The parameter can be a list of pathnames separated by ':'.

This variable sets the xf iconbar file to the given value. This file contains the definition of the iconbar.

This option sets the xf icon directory to the given value. This directory contains the icons for the iconbar. The parameter can be a list of pathnames separated by ':'.

This variable sets the xf keysyms file to the given value. This file contains the names of the known keysyms.

This variable sets the xf library directory to the given value. This directory contains the font-, color-, cursor- and keysym-files.

This variable sets the xf menubar file to the given value. This file contains the definition of the menubar.

This variable sets the xf position file to the given value. This file contains the positions of the windows.

This variable sets the xf procedure directory to the given value. This directory contains the version archive of the procedures. Procedures can be stored with the shape toolkit (available at ftp.cs.tu-berlin.de).

This variable sets the xf source directory to the given value. This directory contains the complete sources of xf.

This variable sets the xf template directory to the given value. This directory contains the source templates. You can use templates to create complex interface elements that are used repeatedly in your applications. These elements can be stored permanently. The parameter can be a list of pathnames separated by ':'.

This variable sets the xf temporary directory to the given value. This directory contains temporary files.

This variable sets the unique id for xf. Each running xf that accesses the same file system as the other running xf, and does not use a local directory for temporary data should have a unique id. If this variable is not set, xf will create an id by itself. This variable is intended for these machines that have trouble with this id creation mechanism.


BUGS

Surely there are many bugs.


SEE ALSO

Tcl(3), Tk-manuals(3)


AUTHOR

Sven Delmas

TU Berlin, Germany

garfield@cs.tu-berlin.de