XF(1)

NAME
xf - interactive interface builder for Tcl/TK

SYNOPSIS
xf [xf options]

xf options:

    [-cmd <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>] [-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).

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

DISPLAY
    The default display to be used.

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

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

XF_ADD_DIR
    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 ':'.

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

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

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

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

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

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

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

XF_HELP_DIR
    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 ':'.

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

XF_ICONS_DIR
    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 ':'.

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

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

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

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

XF_PROC_DIR
    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 coma.cs.tu-berlin.de).

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

XF_TMPLT_DIR
    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 ':'.

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

XF_UNIQUE_ID
    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