  TkDesk User's Guide
  Originally written by Christian Bolik, now maintained by 
  J. Chris Coppick, jchris@znet.com
  Version 1.3, 14 September 1999

  TkDesk is a graphical, highly configurable and powerful desktop man-
  ager for UNIX and the X Window System.  This document is meant to be a
  comprehensive guide to the functions, services and configuration pos-
  sibilities offered by TkDesk.  Please also take a look at the CHANGES
  file for latest news.  A list of answers to frequently asked questions
  is also included.  The "official unofficial" TkDesk homepage on the
  Web is at <http://people.mainz.netsurf.de/~bolik/tkdesk/>.  There is
  also a mailing list dedicated to TkDesk available at major-
  domo@lists.stanford.edu.  To join this list simply send an email with
  an empty subject line and the body "subscribe tkdesk-list".
  ______________________________________________________________________

  Table of Contents
















































  1. Introduction

     1.1 Acknowledgments
     1.2 Using TkDesk's Help System
     1.3 Command Line Options

  2. The File Browser Window

     2.1 The Menu Bar
        2.1.1 TkDesk Menu
        2.1.2 File Menu
        2.1.3 Directory Menu
        2.1.4 Commands Menu
        2.1.5 Bookmarks Menu
        2.1.6 Options Menu
        2.1.7 Help Menu
     2.2 The Button Bar
     2.3 The Path Entry
     2.4 The File Listboxes
        2.4.1 Handling of the Listboxes (Bindings)
     2.5 The Status Bar

  3. The File List Window

  4. File Operations

     4.1 File Information
     4.2 Copying, Moving and Deleting Files
     4.3 Finding Files

  5. Cascading Directory Popup Menus

  6. The Application Bar

  7. The Built-in Editor

     7.1 Marks

  8. Using the TkDesk Server

  9. Configuration of TkDesk

     9.1 Configuration Files
        9.1.1 AppBar
        9.1.2 ButtonBar
        9.1.3 Commands
        9.1.4 Directories
        9.1.5 FileTags
        9.1.6 Local
        9.1.7 Popups
        9.1.8 Sounds
        9.1.9 System
     9.2 The TkDesk API
     9.3 Shortcuts
     9.4 Utilities

  10. Frequently Asked Questions

     10.1 How can I change the position of the application bar?
     10.2 Can I have transparent icons?
     10.3 How can I change the background colour of the icons and desk items?
     10.4 How can I have a different set of desk items on each virtual screen?
        10.4.1 FVWM and similar or derived window managers
        10.4.2 CDE window manager
     10.5 How do I configure FVWM mini-icons for TkDesk?
     10.6 Configuring the appbar or popup menus to execute (export foo=bar; program;) doesn't work.
     10.7 Composing characters doesn't work in TkDesk's editor.
     10.8 TkDesk's layout seems to be screwed.  I can't get the appbar displayed anymore.
     10.9 On my RedHat 5.x system the appbar clock shows the wrong time.
     10.10 TkDesk complains about "invalid command name wm" and won't start up
     10.11 I cannot launch other Tcl/Tk applications from within TkDesk
     10.12 I'd like TkDesk to do this and that. How can I achieve this?
     10.13 Is there a TkDesk mailing list?
     10.14 Where can I find out more about Tcl/Tk?

  11. Tips and Tricks

     11.1 TkDesk and XEmacs


  ______________________________________________________________________

  1.  Introduction


  TkDesk is a graphical desktop manager for UNIX (with a slight emphasis
  on Linux, but it also runs just as well on AIX, Solaris, HP-UX, SGI
  Irix and other UNIX flavors) and the X Window System.   It offers a
  very complete set of file operations and services, plus gives the user
  the ability to configure most aspects of TkDesk in a very powerful
  way.  The reason for this is the use of the Tcl scripting language as
  the configuration and (for the greatest part of TkDesk) implementation
  language.  This makes TkDesk not just configurable but truly
  programmable.  TkDesk has been influenced by various other systems and
  file managers: NeXT, for laying out the file browser windows, Apple
  Finder, for the idea of file annotations and, (shock horror), Windows
  95, for some other (of course minor and unimportant) inspirations.

  This is a brief overview of the most prominent features of TkDesk:


  o  Arbitrary number of automatically refreshed file browsers and file
     list windows,

  o  Configurable file-specific popup-menus,

  o  Drag and drop,

  o  Files and directories may also be dropped onto the root window,
     a.k.a. desktop,

  o  Configurable application bar, with several displays and cascaded
     popup menus for each button, files can also be dropped here,

  o  History of visited directories, opened files, executed commands,
     and others, which is automatically saved to disk,

  o  Find files through their annotation, name, contents, size, age, or
     other criteria,

  o  A trash can for safe deletion of files and directories,

  o  Calculation of disk usage for directory hierarchies,

  o  All file operations (find, copy, disk usage, etc.) are carried out
     in the background,

  o  Traversal of directory hierarchies through recursive cascaded
     menus,

  o  Bookmarks, create menu entries for often used files/directories,

  o  Comprehensive hypertextish online help,

  o  Built-in multi-buffer and undo-capable editor,

  o  Remote control of XEmacs,

  o  Close coupling with Netscape Navigator for displaying HTML files or
     selected URLs,

  o  Sound support,

  o  Powerful on-the-fly configuration of nearly all aspect of TkDesk
     using Tcl/Tk, this also allows the Tcl-literate to extend TkDesk in
     arbitrary ways,

  o  Free of charge! But see the file COPYING, or menu entry
     Help/License for information on usage and redistribution of TkDesk.



  1.1.  Acknowledgments


  TkDesk uses a number of other freely available packages without which
  TkDesk would not have been possible.  I'd like to say many thanks to
  the following people:


  o  Chris Sterritt for setting up and managing the TkDesk mailing list
     (at the old location majordomo@mrj.com, this one's disabled since a
     couple of weeks),

  o  Alan V. Shackelford for seamlessly taking over the list to his
     machine and responsibility (the list is now at
     majordomo@shaknet.clark.net),

  o  Ken Hornstein for his wonderful netscape-remote package,

  o  Ioi Kim Lan for making an XPM image reader for Tk available,

  o  George Howlett for his great BLT, of which parts are used by
     TkDesk,

  o  Michael McLennan for his massively useful [incr tcl],

  o  John Ousterhout for Tcl/Tk, which is definitely the best thing
     since sliced bread,

  o  Greg Hankins and Matt Welsh for putting together the most wonderful
     linuxdoc-sgml package,

  o  and of course, Linus Torvalds whose Linux kind of changed my life,
     really!

  And a very big thank you to the growing TkDesk user community, which
  provides me with a constant flow of bug reports (getting less now
  :-)), suggestions for enhancements of TkDesk, and lots of motivation
  and encouragement.

  Special thanks to Chuck Robey for revising a previous version of this
  guide.





  1.2.  Using TkDesk's Help System


  If you check menu entry Options/Use Netscape for Help, TkDesk will use
  that for displaying this User's Guide on-line.  Otherwise, to reduce
  overhead, TkDesk uses its own help system.  It features hypertext
  links, context sensitivity (which is not yet fully utilised by TkDesk)
  and full text search.

  The help window consists of four areas:


  1. A listbox listing all the section headings.  A section can be
     selected by pressing the left mouse button,

  2. the text display, which contains the actual help text,

  3. a text entry field in which a regular expression may be entered
     (such as [Ff]eatures).  After hitting Return, the whole help text
     is searched for this expression.  Pressing Return again continues
     the search,

  4. three buttons: "Print" prints the complete help volume, "Back"
     jumps back after a hypertext link has been followed (see next
     paragraph), and "Close" to close the help window.

  Text that is displayed blue in the help window is a hypertext link.
  When the left mouse button is clicked over such a link the display
  will automatically change to the referenced section.  You can jump
  back by pressing the "Back" button described above.

  The following keys are bound when the mouse pointer is inside the help
  window:


     Tab
        Moves to the next section.

     Shift-Tab
        Moves to the previous section.

     Control-Tab
        Moves to the first section.

     Control-Shift-Tab
        Moves to the last section.

     Up, Down
        Scrolls one line up/down.

     Page up, Page down
        Scrolls one page up/down.

     Control-Home
        Jumps to start of help text.

     Control-End
        Jumps to end of help text.

     Meta/Alt-b
        Equivalent to pressing the "Back" button.

     Meta/Alt-c, Escape
        Equivalent to pressing the "Close" button.


  1.3.  Command Line Options


  Usually TkDesk is started simply by executing the command "tkdesk"
  from the shell prompt or your X initialisation file.  However, you may
  specify the following options to this command:


     -configdir dir
        Reads the configuration from directory dir instead of ~/.tkdesk.

     -default
        Reads the default configuration of TkDesk instead of the user's
        one in ~/.tkdesk.

     -iconic
        Iconifies all file browser and file list windows created by
        TkDesk during start-up.

     -layout file
        Reads the window layout information from file file instead of
        the default ~/.tkdesk/_layout.

     -startdir dir
        If this option is given, the first file browser will open with
        directory dir.

     -twm
        Don't use icon windows when file browser or list windows are
        iconified.  Some window managers liek twm cannot handle these
        properly.

  For example, the command "tkdesk -twm -iconic" tells Tkdesk to not use
  icon windows and start with all windows iconified.




  2.  The File Browser Window


  The file browser window is the largest window when TkDesk is started
  for the first time.  It contains a menu bar, a configurable button bar
  (for fast access to the most often used file operations and other
  functions), an entry field (displaying the current path), a horizontal
  scrollbar, a certain number of file listboxes (three by default), and
  a status and information bar.




  2.1.  The Menu Bar


  The following sections describe the entries of the individual menus of
  the file browser windows.




  2.1.1.  TkDesk Menu


  The "TkDesk" menu contains the following entries:


     New Browser...
        Asks for a directory for which to open a new file browser
        window.  If the directory is the empty string, the operation is
        cancelled.  By default the checkbox "In Browser" is checked, but
        if you uncheck it a file list window will be opened instead.
        The button to the right of the text entry field gives access to
        a menu containing previously visited directories.


     Clone Window
        Creates a new file browser window with the same directory as the
        current one (that is, the directory of the file browser from
        which this menu entry was invoked).


     Display AppBar/Hide AppBar
        Opens the application bar if it had been closed before, or hides
        (closes) it otherwise.  This menu entry's label changes based on
        whether the AppBar is currently displayed or not.


     Configuration
        This is a submenu from which individual or all configuration
        files of TkDesk can be opened to modify them.


     Auto Save
        Here you can select which parts of TkDesk are automatically
        saved periodically and when TkDesk exits.


     Save All Now
        Saves all parts of TkDesk's configuration no matter what the
        settings in the previous submenu.


     Close Window
        Closes the file browser window.


     Quit
        Quits TkDesk.




  2.1.2.  File Menu


  This menu provides all the usual file operations plus entries for
  finding files.  The contained menu entries are:



     Information
        Opens a file information window for each currently selected
        file.  This window, which can also be used to add annotations to
        files, is described in section ``File Information''.


     New File...
        Asks for the name of a file which will be created in the current
        directory of the file browser or list.  If "Open in Editor" is
        checked the new file will automatically be opened in the
        configured editor.

     New Directory...
        Asks for the name of a directory which will be created in the
        current directory of the file browser or list.  If "Open after
        Creation" is checked the current window will switch to the new
        directory after it is created.


     Open
        Opens the selected files using their default action, which
        corresponds to the first action defined in their popup menus as
        configured in the "Popups" configuration file.


     Print...
        Asks for a command to print the currently selected files.  The
        names of the selected files will be appended to the command.
        The default command can be defined in the configuration file
        "System".


     Copy, Move, Link...
        Opens a dialog box for copying, moving, linking, symbolic
        linking etc. of files.  This dialog window is described in more
        detail in section ``Copying, Moving and Deleting Files''.


     Rename...
        For each selected file, TkDesk asks for a new name.  Before
        actually renaming TkDesk checks for an existing file with the
        same name.


     Delete...
        Opens a dialog to delete files.  The section ``Copying, Moving
        and Deleting Files'' gives more details.


     Find Files...
        Opens a dialog window which can be used to search for files,
        using a variety of characteristics.  This dialog is described in
        more detail in section ``Finding Files''.


     Find Annotation...
        Lets you search for files with a certain annotation.  More
        details in section ``Finding Files''.


     Copy To X Selection
        Copies the complete names of all currently selected files (i.e.
        including their paths) to the X clipboard.  They can then be
        pasted into any other X application using the middle mouse
        button.


     Copy Names Only
        Same as previous one, but copies only the files' names (i.e. not
        their paths.)


     History
        Displays a submenu containing recently opened files.


     Close Window
        Closes the window.
  2.1.3.  Directory Menu


  The main purpose of this menu is to select directories which are to be
  opened.  It also manages TkDesk's trash can.  The menu contains the
  following entries:



     Open...
        Asks for a directory.  A new file list or file browser window
        will be created, baesed on the setting of the "In Browser"
        checkbutton.


     New...
        Asks for the name of a directory which will be created in the
        current directory of the file browser or list.


     Home Directory
        Changes the directory of the window from which this entry is
        invoked to the user's home directory.


     A number of path entries
        These can be configured in the configuration file Directories.
        See section ``Configuration of TkDesk'' for details on how to do
        this.   If one of these menu entries is invoked, the path of the
        file browser will change to that directory.   If such an entry
        is invoked while at the same time pressing the "Control" key, a
        new file list window will be created (if the option "Always In
        Browser" is selected a file browser window will be created),
        displaying the contents of the selected directory.  This feature
        applies to all menus that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this option is selected, TkDesk won't ask if the destination
        file already exists when copying or moving files.


     Really Delete
        Relates to the deletion of files. If this option is selected,
        the "Delete Files" dialog box will always have the "Delete
        permanently" checkbutton selected by default.


     Quick Drag'n'Drop
        Normally when you drop files onto a file list, the copy dialog
        appears. If this option is selected, dropped files will be moved
        to the destination directory without further questions. If
        Control is pressed during dropping, the files will be copied. If
        the drop target is the trash can, TkDesk will ask if the files
        are to be deleted "really".


     Sort History
        This option determines whether the history menus are to be
        sorted alphabetically or not.


     TkDesk Server
        Start or stop the built-in server to remote execute TkDesk
        commands.  See also section ``Using the TkDesk Server''.


     Dialogs at Pointer
        If selected, TkDesk will always try to place new windows right
        under the mouse pointer.


     Autoraise AppBar
        Whether to raise the AppBar above any obscuring window when it
        is entered by the mouse pointer.
     Use Sound
        If you have sound working with TkDesk on your machine, you can
        temporarily disable sound by selecting this option. Handy when
        playing Audio CDROMs, for instance.


     Number Of Listboxes
        This relates to the number of listboxes in the file browser
        window. Between 1 and 6 can be displayed, though 18 would
        theoratically not be a problem.


     Balloon Help
        Whether to display a small window at the mouse pointer if it is
        placed over part of TkDesk, e.g. an AppBar button.


     Use Netscape for Help
        Whether to use Netscape rather than the built-in help viewer for
        displaying TkDesk online help.


  The settings of these options are by default ,

  4. three buttons: that contain directory names!


     Trees
        Contains two cascaded submenus: "Home" and "Root".  The contents
        of these submenus is dynamically generated and corresponds to
        the directory hierarchy rooted either at the user's home
        directory or at "/".  Selecting an entry from these submenus
        changes the directory of the window to the selected directory.
        Pressing Control at the same time opens a new window with this
        directory.


     Open Trash Can
        Opens a file list window displaying the contents of the trash
        can.  When this window is iconified and TkDesk uses icon windows
        the icon can be used as a Mac-like trash can.


     Empty Trash Can
        Empties the trash can after confirmation from the user.  This
        erases the files contained in the trash can for good!


     History
        Displays a submenu containing recently opened directories.






  2.1.4.  Commands Menu


  This menu provides entries to execute commands either once or
  periodically, edit files, and provides some very basic form of "job
  control".  Its entries are:



     Execute...
        Asks for a command to execute.  The button to the right of the
        command entry contains a history of previously executed
        commands.  Selecting one of these copies its name to the entry
        widget.  Checking the "View Output" button will open an editor
        window after the command completed displaying its output (stdout
        and stderr).


     Execute as root...
        The same as the previous entry but TkDesk will ask you for the
        root password before executing the command.  The command will
        then run under root permission.


     Periodic Execution...
        Opens a window which can be used to execute a command and watch
        its output periodically.  If the "Don't execute" checkbutton is
        selected, the execution is paused.


     Job Control
        Opens a window which allows to stop, terminate, kill etc.
        processes which have been started by TkDesk.


     Environment...
        Opens the "Edit Environment" dialog which can be used to display
        and modify TkDesk's environment variables.  Programs and
        commands started from TkDesk after any modification in this
        dialog has been made will pick up the modified environment.


     Edit File...
        Asks for the name of a file to edit, and opens it in the editor
        you selected in the "System" configuration file (defaults to the
        built-in editor).  The "Browse..." button opens a file selector
        from which a file may be selected.


     New File
        Opens a new blank editor window.


     Edit Selected
        Opens all currently selected files in one new editor window.


     Buffers
        Displays a submenu of all current editor buffers (both files and
        command output).


     A number of custom command entries
        These can be defined in the configuration file Commands.  See
        section ``Configuration of TkDesk'' for details on how to do
        this.  If one of these menu entries is invoked, the
        corresponding command will be executed.


     History
        Displays a submenu containing commands recently executed.





  2.1.5.  Bookmarks Menu


  This menu lets you create bookmarks for often used files and
  directories.  To do this, select at least one file/directory and
  invoke the "Add Bookmark" menu entry.  The name(s) of the selected
  files and directories will now appear alphabetically sorted in the
  "Bookmarks" menu.  You can remove any bookmark from the menu by
  selecting its corresponding entry from the "Remove Bookmark" submenu.

  The bookmarks you add will be automatically saved, if the "Bookmarks"
  entry of the "Auto Save" submenu contained in the "TkDesk" menu is
  selected (which is the default).



  2.1.6.  Options Menu


  The Options menu lets you configure many aspects of TkDesk "on the
  fly".  The entries are:



     Long Listing
        Select this to let the details of all files and directories be
        displayed in the file listboxes.  This slightly decreases
        performance and for that reason is switched off by default.


     Show All Files
        Whether to show files in the file lists whose name start with
        ".".


     Add Icons
        If selected, small icons will be displayed to the left of the
        file names in the file listboxes.  Turn this off for faster
        scrolling.


     Folders On Top
        If selected (default) folders will always appear on top of the
        file lists.


     Append Type Char
        Whether to append a file-type specific character to the file
        names.  This is mainly intended for monochrome displays and is
        then automatically selected.


     Single Click (Dirs)
        Lets you open directories with a single click of the left mouse
        button.  Individual directories can still be selected by
        pressing Control at the same time.
     Always In Browser
        If this option is selected, the "In Browser" checkbutton of the
        "Open Directory" dialog will always be selected. Control-
        Doubleclick on a directory will open a file browser instead of a
        file list window.


     Status in List Windows
        Whether the singly columned file list windows should have a
        status bar as well.


     Sort by ...
        Sort all file listboxes by one of these criteria: Name, Name
        (fold, meaning that upper and lower case characters will be
        "folded", i.e. disregard case when sorting), Size, Date,
        Extension, or Don't Sort to display directory entries as they
        are read from disk.


     Strip <your home directory>
        If this is selected, and the current path of the browser is
        somewhere under your home directory, the leftmost file listbox
        will contain your home directory rather than the root directory.
        This speeds up the display of directory hierarchies under your
        home directory.


     Overwrite Always
        If this opt