TreeCat - Disc Cataloguer
by Bill Hine

Purpose
-------
The purpose of this application is to create a catalogue of the tree of objects (directories and files) contained at all the subsidiary levels of a chosen directory. The chosen directory may be the root directory of a disc or a sub-directory at any level. The user may choose whether to list directories, files, or both, and whether to include the filetype and date stamp of each object. The file's name may appear as either its full or partial pathname. The "treecat" (tree catalogue) is displayed in a Desktop window and may optionally be saved as a file. The window displays the pathname of the directory being catalogued, the options chosen, and the date and time at which the treecat was produced. The number of directories and files found is indicated, and finally they are listed in the required format. 

Getting started
---------------
Running the application installs an icon on the icon bar. To produce a treecat of any directory, simply drag the directory's icon to the icon bar icon. If Ctrl is held down while a directory icon is dragged, the catalogue of the parent directory will be produced. Dragging the icon of a file will catalogue the directory to which the file belongs.

Options
-------
Click Menu over the icon bar icon to open a menu of options. Clicking on an option with the Select or Adjust button toggles its selection on or off, as indicated by the tick. Using the Select button closes the menu; click with Adjust to keep the menu open. Clicking with Select or Adjust on the TreeCat icon opens the latest treecat window (if any).

Info:
Move right across the Info arrow to open the standard information window.

Copy to dir:
Selecting "Copy to dir" will ensure that subsequent treecats will be copied as a text file to the directory being catalogued. The filename is "treecat" by default, but this may be altered by moving the pointer across the arrow and editing the name which will appear.

Copy as:
Alternatively, the treecat may be copied to any directory. Move the pointer across the arrow to the right of "Copy as". This will open a dialogue box similar to a "Save as" box. The file, which has a default name of adfs::0.$.treecat, may be edited in the usual way. Alternatively, the default may be deleted and a simple (leaf) filename entered instead; the icon should then be dragged to a directory. This will enter the full pathname into the "Copy as" icon. Click on OK or press Return to ensure that subsequent treecats will be copied to this file.

Note that only one copy option may be selected at any one time.

Files and directories:
Select Files and/or Directories to ensure that they are included in the treecat. By default, both are selected.

Filetype:
Select Filetype to include the filetype of each object in the treecat. By default, Filetype is unselected. Applications are distinguished from ordinary directories in the treecat. 

Date stamp:
Select Date stamp to include the date stamp of each object in the treecat. By default, Date stamp is unselected.

Full path:
By default, Full path is ticked. This ensures that the full pathname of each object will be included in the treecat. Deselecting Full path results in only the partial pathname being included. The partial pathname includes all the sub-directories needed to identify an object within the directory being catalogued. The full pathname of any object can be reconstructed by taking the full pathname of the directory being catalogued, followed by a ".", followed by the partial path name.

Redo:
Until the first catalogue has been created, Redo remains greyed out. If, after producing a treecat, you would like to see it with a different set of options, make your selection and then click on Redo to produce the revised version. When changing options, note that clicking with Adjust holds the menu open.

Save options:
Your own selection of options may be saved by clicking on Save options. Your selected set of options will be initialised next time you run TreeCat.

Default opts:
If, after altering the options, you wish to return to the initial ones, click on Default opts.

Quit:
Clicking on Quit will remove the TreeCat icon from the icon bar.

 RISC User 1992
