@DATABASE DiskLibrarian.guide
@$VER: 1.0 (02-Sep-2000) by J.T. Steichen
@AUTHOR James T. Steichen

@(c) 2000 by J.T. Steichen

@REM Source: DiskLibrarian.deck

@MACRO BOLD  "@{B} $1 @{UB}"
@MACRO SHINE "@{FG SHINE} $1 @{FG TEXT}"
@MACRO PGMNAME "@{B}DiskLibrarian@{UB}"
    
@REM "@FONT helvetica.font 13"

@WORDWRAP 75
@INDEX "Main"

@NODE "Main" "DiskLibrarian General Information:"

  @{SHINE PURPOSE}
   @{PGMNAME} is a GUI for Generating & Modifying DataBases of disk file 
   contents.  @{" I " LINK "Author"} started on this program in 1997 & shelved it when it became
   obvious that I would have to write some sort of Directory Tree-walking
   program in order to generate a list of the contents of disks to add to
   the DataBase.  Thankfully, I found a program that would do this for me.
   That program is @{" TreeWalk " LINK "DiskDirTree"} by Mike W. Meyer.
   Once this obstacle was out of the way, writing the rest of the program
   was a piece of cake (thanks to @{B}CanDo!@{UB})

   @{" What you get         " LINK "Dist"} - The program component parts.

   @{" Program Logo         " LINK "ProgramLogo"} - The start of it all!

   @{" Editor display       " LINK "Editor"} - I need to change some data.

   @{" View Configuration   " LINK "ViewConfig"} - Just looking at the data.

   @{" Exclusions Editor    " LINK "ExclusionEditor"} - I don't want every filename!

   @{" Select a volume      " LINK "VolumeSelect"} - I don't know which disk! 

   @{" Not so Obvious usage " LINK "SubtleUsage"} - Justification for this help file.

   @{" ToolTypes            " LINK "ToolTypes"} - The Icon junk.

   @{" ToolTypes Editor     " LINK "ToolTypesEditor"} - Configuration stuff.

   @{" ARexx Commands       " LINK "ARexxCommands"} - None yet!

   @{" Vanilla Keys         " LINK "VanillaKeys"} - Satanic KeyPresses

   @{" DiskDirTree program  " LINK "DiskDirTree"} - External program.  

   @{" Author               " LINK "Author"} - Who wrote this great program?


   @{B}HISTORY@{UB}
      1.0 @{PGMNAME} is now working correctly!

   SEE ALSO, @{" ToolTypes " LINK "ToolTypes"}

@ENDNODE

@NODE "SubtleUsage" "Not-so-obvious Usage:"
@PREV "Main"

   You can view this help file at any time by pressing the@{SHINE "Help"}key on
   your keyboard.
   
   In order to guarantee that @{PGMNAME} functions correctly, please
   follow the following guidelines in using the program:

   1. You have to double-click on an item in the Categories ListView Gadget
      in order for it to send your selection to the Category string Gadget.
      Next, you must press & release the @{" UPDATE RECORD " LINK "UpdateRec"} Gadget for your
      change to be added to the DataBase.

   2. If a Gadget containing text appears to be recessed, this indicates 
      that it's a read-only Gadget, or you can only select its contents
      (in the case of ListView Gadgets).  If you attempt to edit their 
      contents, @{PGMNAME} will ignore them.  This is in line with the
      Style guidelines (from Commodore), so you should already know this.

   Sorting by File Size is really useless.  Due to other limitiations in
   the @{B}CanDo!@{UB} program, I was forced to make the filesize field of the 
   DataBase records a string instead of an integer type.  This means that
   the length of the string determines how the records get sorted, so that
   smaller file actually appear AFTER larger files!  I recommend using
   only the Name, Date or Category as sorting criteria.

   If something about @{PGMNAME} isn't clear to you or if you find some
   behavior that's really strange, please send @{" me " LINK "Author"} an e-mail sug-
   gesting what might be added to this help file or the program itself.
@ENDNODE

@NODE "Dist" "Distribution - The files needed by the program:" 

   Either click on the@{SHINE "DiskLibrarian.install"}Icon (from Workbench)
   or type: @{B}Installer DiskLibrarian.install@{UB} in a CLI or Shell.
   
   The following files are necessary & should have been included in the
   distribution file:
   @{FG SHINE}   
   DiskLibrarian.install@{FG TEXT}    - The installation script. @{FG SHINE}
   DiskLibrarian.install.info

   DiskLibrarian@{FG TEXT}            - The main program. @{FG SHINE}
   DiskLibrarian.info

   DiskLibrarian.bsh@{FG TEXT}        - The Program logo. @{FG SHINE}

   DiskLibrarian.guide@{FG TEXT}      - This Help guide file. @{FG SHINE}
   DiskLibrarian.guide.info@{FG TEXT}

   Place these in your Command Path (such as the @{B}C:@{UB} directory):
   @{FG SHINE}
   DeckBrowser@{FG TEXT}              - External program to Run @{PGMNAME} @{FG SHINE}
   DiskDirTree@{FG TEXT}              - External program to generate disk contents.

@ENDNODE

@NODE "ProgramLogo" "The Program Logo (the start of it all!):"
@PREV "Main"
@NEXT "Editor"

   Simply press & release the@{BOLD "START!"}button gadget in order to proceed
   with the @{PGMNAME} (C)1997-2000 program.  Pressing & releasing the 
  @{SHINE "Help"}key on your keyboard will show you this part of the @{PGMNAME}
   help file.
   
@ENDNODE

@NODE "Editor" "The Editor - Where you'll spend most of your time:"
@PREV "Main"
@NEXT "ViewConfig"

   The@{BOLD "Main Editor"}consists of the following Gadgets & Menu Items:
      @{FG SHINE}
      GADGETS: @{FG TEXT}

      @{" Records " LINK "RecordsLV"} ListView Gadget
      Record Navigation Button Gadgets (@{"||<" LINK "FirstRG"}, @{" Prev " LINK "PrevRG"}, @{" Rec # " LINK "RecNumRG"}, @{" Next " LINK "NextRG"}, @{">||" LINK "LastRG"})

      @{" ADD DISK      " LINK "AddDisk"} Button Gadget
      @{" ADD RECORD    " LINK "AddRec"} Button Gadget
      @{" DELETE RECORD " LINK "DeleteRec"} Button Gadget
      @{" UPDATE RECORD " LINK "UpdateRec"} Button Gadget
      
      @{" Categories " LINK "CategoriesLV"} ListView Gadget
      
      @{" Dir  Name:    " LINK "DirNameStr"} String Gadget      
      @{" File Name:    " LINK "FileNameStr"} String Gadget      
      @{" File Date:    " LINK "FileDateTxt"} Text   Gadget (Read-only) 
      @{" File Size:    " LINK "FileSizeTxt"} Text   Gadget (Read-only)
      @{" File Comment: " LINK "FileCmtStr"} String Gadget      
      @{" Category:     " LINK "CategoryStr"} String Gadget      
      @{" Process:      " LINK "ProcessStr"} String Gadget      

      @{" You Selected: " LINK "YourSelect"} Text   Gadget (Read-only)
      @{FG SHINE}
      MENUS: @{FG TEXT}
      @{B}
      PROJECT@{UB}             @{" SORTING " LINK "SortMenu"}     @{" PRINT_FIELDS " LINK "PrintFieldMenu"} @{B}PREFERENCES @{UB}

      @{"New " LINK "NewMI"}                By FileName   Directory Name  @{" Load Categories.. " LINK "LoadCats"}
      @{"Open.. " LINK "OpenMI"}        A-L  By Disk       File Name       @{" Save Categories   " LINK "SaveCats"}
      @{"Close " LINK "CloseMI"}              By File Date  File Date       @{" Sort Categories   " LINK "SortCats"}
      @{"Save As.. " LINK "SaveAsMI"}          By File Size  File Size       ~~~~~~~~~~~~~~~~~~~
      @{"Data Viewer... " LINK "ViewConfig"}     By Comment    File Comment    @{" Edit ToolTypes... " LINK "ToolTypesEditor"}
      @{"Edit Exclusions... " LINK "ExclusionEditor"} By Category   Category
      @{"Print >> " LINK "PrintMI"}           By Process    Process
        To PAR:
        To SER:
        To File

      @{"Quit           A-Q " LINK "QuitMI"}
      ~~~~~~~~~~~~~~~~~~~
      @{"About..        A-I " LINK "AboutMI"}
      @{"Help!          A-H " LINK "HelpMI"}

@ENDNODE

@NODE "CategoriesLV" "Categories ListView Gadget:"

   The Categories ListView Gadget is an @{B}Editable@{UB} list of file categories
   known to the program.  Now you can classify your files (maybe there are
   pictures, sounds, icons, etc., on one disk).
   
   SEE ALSO, @{" Load Categories " LINK "LoadCats"} Menu Item
             @{" Save Categories " LINK "SaveCats"} Menu Item
             @{" Category String " LINK "CategoryStr"} Gadget
@ENDNODE

@NODE "AddDisk" "ADD DISK Button Gadget:"

   When you press & release this button, @{PGMNAME} will display the 
   window where you can select which disk to add to the DataBase.  Once you
   press & release the @{B}OKAY@{UB} Gadget, you will be returned to the 
   @{" Main Editor " LINK "Editor"} & @{PGMNAME} will proceed to read the
   contents of the selected disk into the program memory.

   Perhaps in a later version, I'll remove this button & just use the
   DiskChange event handler in @{B}CanDo!@{UB} to automate this @{FG SHINE}(but only if you
   pay me loads of money). @{FG TEXT}

@ENDNODE

@NODE "AddRec" "ADD RECORD Button Gadget:"

   When you press & release this button, space will be inserted into the
   program memory & all the String & Text Gadgets will be cleared, allowing
   you to enter some new data into the string gadgets.  Since the @{" Size " LINK "FileSizeTxt"} &
   @{" Date " LINK "FileDateTxt"} cannot be edited, this is not a good way to expand the DataBase
   (unless you don't care about these fields).  This button is only 
   included in the program for completeness.

@ENDNODE

@NODE "DeleteRec" "DELETE RECORD Button Gadget:"

   Pressing & releasing this button will remove the Record currently dis-
   played in the String Gadgets from program memory.
   @{FG SHINE}
   NOTE: @{FG TEXT} Your sanity will be checked by @{PGMNAME} first!

@ENDNODE

@NODE "DirNameStr" "Dir Name: String or Text Gadget:"

   When this Gadget doesn't have a recessed border, you can enter a
   Volume:PathName/ into it, indicating where the Current Record is located
   in your collection of Disks.

@ENDNODE

@NODE "FileNameStr" "File Name String or Text Gadget:"

   When this Gadget doesn't have a recessed border, you can enter a
   FileName into it, indicating the name of the Current Record.

@ENDNODE

@NODE "FileDateTxt" "File Date Text Gadget (Read-only):"

   This Gadget displays the Date & Time the file was last written to.
   @{FG SHINE}
   NOTE: @{FG TEXT} This Gadget is Read-only!

@ENDNODE

@NODE "FileSizeTxt" "File Size Text Gadget (Read-only):"

   This Gadget displays the Size (in bytes) of a file.
   @{FG SHINE}
   NOTE: @{FG TEXT} This Gadget is Read-only!

@ENDNODE

@NODE "FileCmtStr" "File Comment String Gadget:"      

   When this Gadget doesn't have a recessed border, you can enter a
   File Comment into it, indicating some inforamtion about the file
   (beyond the description of the file name).

@ENDNODE

@NODE "CategoryStr" "Category String Gadget:"

   When this Gadget doesn't have a recessed border, you can enter a
   File Category into it, indicating what type of file you have.

@ENDNODE 

@NODE "ProcessStr" "Process String Gadget:"

   When this Gadget doesn't have a recessed border, you can enter a
   Process or Program that uses the file currently being displayed.

@ENDNODE

@NODE "YourSelect" "You Selected Text Gadget (Read-only):"

   This Text Gadget is normally empty until you press & release the
   @{" ADD DISK " LINK "AddDisk"} Button Gadget.  @{PGMNAME} will then display the window 
   where you can select which disk to add to the DataBase.  Once you press 
   & release the @{B}OKAY@{UB} Gadget, you will be returned to the @{" Main Editor " LINK "Editor"} &
   this Gadget will now contain the name of the disk you selected.

@ENDNODE

@NODE "NewMI" "New Menu Item:"

   @{FG SHINE}
   WARNING: @{FG TEXT} This menu item will clear all program memory.  This action
             is @{B}NON-Recoverable@{UB}, so I suggest that you @{" save " LINK "SaveAsMI"} your DataBase
             first!

   Your Sanity will checked by @{PGMNAME} before memory is cleared.

@ENDNODE

@NODE "OpenMI" "Open Menu Item:"

   This menu item will load the contents of the filename you select into
   program memory & setup the display of the Record contents.
   
   @{FG SHINE}
   WARNING: @{FG TEXT} This menu item will clear all program memory.  This action
             is @{B}NON-Recoverable@{UB}, so I suggest that you @{" save " LINK "SaveAsMI"} your DataBase
             first!

@ENDNODE

@NODE "CloseMI" "Close Menu Item:"

   If @{PGMNAME} already knows the name of the DataBase being used, it
   will save the current Records into that filename, otherwise it will ask
   you to supply a filename for your data.
   
@ENDNODE

@NODE "SaveAsMI" "Save As.. Menu Item:"

   Selecting this menu item will tell @{PGMNAME} to display a File 
   Requester, asking you for a filename to save your DataBase into.
   @{FG SHINE}   
   NOTE: @{FG TEXT} You will be given a chance to back out of Changing your DataBase
          file permamently by this Menu Item.

@ENDNODE

@NODE "PrintMI" "Print >> Menu Sub-Items:"

   Selecting one of @{B}Print >>@{UB}'s Sub-Items allows you to send the
   set of Records currently in memory to one of the following:
   @{FG SHINE}
   To PAR: @{FG TEXT} - Sends the output to the PAR: device (usually a printer). 
   @{FG SHINE}
   To SER: @{FG TEXT} - Sends the output to the SER: device (usually a printer). 
   @{FG SHINE}
   To File @{FG TEXT} - Sends the output to a file you select (for later editing).

@ENDNODE

@NODE "QuitMI" " Menu Item:"
 
   This menu item will tell @{PGMNAME} to @{" save " LINK "SaveAsMI"} the current DataBase &
   shut down the program.

@ENDNODE

@NODE "AboutMI" "About.. Menu Item:"

   This menu item simply displays a Requester with some information about
   the program's origins.
   
@ENDNODE

@NODE "HelpMI" "Help! Menu Item:"

   This menu item will open this Documentation file at the appropriate 
   page for each display window in @{PGMNAME}.

@ENDNODE

@NODE "LoadCats" "Load Categories.. Menu Item:"

   This menu item will load the contents of the filename you give the 
   program into the @{" Categories " LINK "CategoriesLV"} ListView Gadget.

@ENDNODE

@NODE "SaveCats" "Save Categories Menu Item:"

   This menu item will save the contents of the @{" Categories " LINK "CategoriesLV"} ListView Gadget
   into the filename you give the program.

@ENDNODE

@NODE "SortCats" "Sort Categories MenuItem:"

   This menu item will sort the contents of the @{" Categories " LINK "CategoriesLV"} 
   ListView Gadget in ascending order.

@ENDNODE

@NODE "SortMenu" "SORT Menu:"
   
   Selecting one of the following (indicated by a check-mark) will sort the
   contents of the DataBase in memory:
   @{FG SHINE}
   By FileName  @{FG TEXT}- Sort by the name of the file (most common). @{FG SHINE}
   By Disk      @{FG TEXT}- Sort by the name of the Volume:directory. @{FG SHINE}
   By File Date @{FG TEXT}- Sort by the datestamp of the file. @{FG SHINE}
   By File Size @{FG TEXT}- Sort by the size (in bytes) of the file (broken).  @{FG SHINE}
   By Comment   @{FG TEXT}- Sort by the file comment. @{FG SHINE}
   By Category  @{FG TEXT}- Sort by the file category. @{FG SHINE}
   By Process   @{FG TEXT}- Sort by the process associated with each file.
   @{B}
   NOTE: @{UB} Only one menu item can be checked at a time.   

@ENDNODE

@NODE "PrintFieldMenu" "PRINT_FIELDS Menu:"

   Selecting one or all of the following (indicated by a check-mark) will 
   tell @{PGMNAME} which fields to print when a @{" Print >> " LINK "PrintMI"} sub-item is
   selected:
   @{FG SHINE}
   FileName  @{FG TEXT}     - Add the name of the file to print-out. @{FG SHINE}
   Directory Name @{FG TEXT}- Add the name of the Volume:directory to print-out. @{FG SHINE}
   File Date @{FG TEXT}     - Add the datestamp of the file to print-out. @{FG SHINE}
   File Size @{FG TEXT}     - Add the size (in bytes) of the file to print-out. @{FG SHINE}
   Comment   @{FG TEXT}     - Add the file comment to print-out. @{FG SHINE}
   Category  @{FG TEXT}     - Add the file category to print-out. @{FG SHINE}
   Process   @{FG TEXT}     - Add the process associated with each file to print-out.

@ENDNODE

@NODE "UpdateRec" "UPDATE RECORD - Add your changes to the DataBase:"
   @{FG SHINE}
   WARNING:  @{FG TEXT}Pressing & releasing this button will change data internal
             to the program!  There is @{B}NO@{UB} recovery mechanism.

   Once you've made any changes to the editable portions of a DataBase
   Record, you have to press & release this Button in order to update
   the internal program data.
   @{B}   
   NOTE:  @{UB}Your DataBase only gets updated if you select the @{" Save As.. " LINK "SaveAsMI"} 
          Menu Item.
@ENDNODE

@NODE "DiskDirTree" "DiskDirTree - an external program:"
@PREV "Main"

   @{B}DiskDirTree@{UB} is a program written by@{SHINE "Mike W. Meyer"}
   (TreeTest, Copyright (C) 1989) that's been renamed to@{BOLD "DiskDirTree."}
   It's used internally by @{PGMNAME} in order to generate a temporary 
   file of disk directory contents when the@{BOLD "ADD DISK"}button on the 
   @{" Main Editor " LINK "Editor"} is pressed & released.

@ENDNODE

@NODE "ViewConfig" "The Viewer - Examine the database:"
@PREV "Main"
@NEXT "ExclusionEditor"

   The@{BOLD "Data Viewer"}consists of the following Gadgets & Menu Items:
      @{FG SHINE}     
      GADGETS: @{FG TEXT}

      @{" Records " LINK "RecordsLV"} ListView Gadget
      Record Navigation Button Gadgets (@{"||<" LINK "FirstRG"}, @{" Prev " LINK "PrevRG"}, @{" Rec # " LINK "RecNumRG"}, @{" Next " LINK "NextRG"}, @{">||" LINK "LastRG"})

      @{" Dir  Name:    " LINK "DirNameStr"} Text Gadget      
      @{" File Name:    " LINK "FileNameStr"} Text Gadget      
      @{" File Date:    " LINK "FileDateTxt"} Text Gadget
      @{" File Size:    " LINK "FileSizeTxt"} Text Gadget
      @{" File Comment: " LINK "FileCmtStr"} Text Gadget      
      @{" Category:     " LINK "CategoryStr"} Text Gadget @{" Apply View Config " LINK "ApplyVC"} Button Gadget
      @{" Process:      " LINK "ProcessStr"} Text Gadget      

      @{FG SHINE}
      MENUS: @{FG TEXT}
      @{B}
      PROJECT@{UB}               @{" SORTING " LINK "SortMenu"}    @{" VIEW " LINK "ViewMenu"}

      @{"Exclusion Editor... " LINK "ExclusionEditor"}  By FileName   Directory Name
      @{"Print View >> " LINK "PrintMI"}        By Disk       File Name
        To PAR:             By File Date  File Date
        To SER:             By File Size  File Size
        To File             By Comment    File Comment
      @{"Quit            A-Q " LINK "QuitMI"}  By Category   Category
      ~~~~~~~~~~~~~~~~~~~~  By Process    Process
      @{"About..         A-I " LINK "AboutMI"}
      @{"Help!           A-H " LINK "HelpMI"}

@ENDNODE

@NODE "ApplyVC" "'Apply View Config' Button:"
@PREV "ViewConfig"

   When this button is pressed & released, @{PGMNAME} will clear the
   @{" Records " LINK "RecordsLV"} ListView Gadget & display only those fields that have a check-
   mark beside them in the Records ListView Gadget.  This does NOT alter
   the contents of the DataBase, only the display.

   SEE ALSO, @{" View Menu " LINK "ViewMenu"}   

@ENDNODE

@NODE "ViewMenu" "Data Viewer VIEW Menu:"

   Selecting one or all of the following (indicated by a check-mark) will 
   tell @{PGMNAME} which fields to display when 
   @{" Apply View Config " LINK "ApplyVC"} is pressed & released:
   @{FG SHINE}
   FileName  @{FG TEXT}     - Add the name of the file to display. @{FG SHINE}
   Directory Name @{FG TEXT}- Add the name of the Volume:directory to display. @{FG SHINE}
   File Date @{FG TEXT}     - Add the datestamp of the file to display. @{FG SHINE}
   File Size @{FG TEXT}     - Add the size (in bytes) of the file to display. @{FG SHINE}
   Comment   @{FG TEXT}     - Add the file comment to display. @{FG SHINE}
   Category  @{FG TEXT}     - Add the file category to display. @{FG SHINE}
   Process   @{FG TEXT}     - Add the process associated with each file to display.
@ENDNODE

@NODE "RecordsLV" "Records ListView Gadget, Behavior:"

   Clicking on & releasing an item in this ListView Gadget will tell the
   program to display the selected Record in the string/text Gadgets
   attached to the window (if there are any).

@ENDNODE

@NODE "FirstRG" "||< - The Go to the First Record Gadget:"

   Pressing & releasing this button gadget will display the contents of the
   first record in the current database.

@ENDNODE

@NODE "PrevRG" "Prev - The Go to the Previous Record Gadget:"

   Pressing & releasing this button gadget will display the contents of the
   previous record in the current database.

@ENDNODE

@NODE "RecNumRG" "The Record Number display Gadget:"

   This gadget displays the number of the Record currently being displayed.
   It is @{B}NOT@{UB} editable.

@ENDNODE

@NODE "NextRG" "Next - The Go to the Next Record Gadget:"

   Pressing & releasing this button gadget will display the contents of the
   next record in the current database.

@ENDNODE

@NODE "LastRG" ">|| - The Go to the Last Record Gadget:"

   Pressing & releasing this button gadget will display the contents of the
   last record in the current database.

@ENDNODE

@NODE "ExclusionEditor" "The Exclusion Editor - Exclude garbage records:"
@PREV "Main"
@NEXT "VolumeSelect"

   The@{BOLD "Exclusion Editor"}consists of the following Gadgets & Menu Items:
      @{FG SHINE}
      GADGETS: @{FG TEXT}

      @{" Records " LINK "RecordsLV"} ListView Gadget

      @{" Load Exclusion File .. " LINK "LoadExclude"} Button Gadget
      @{" Save Exclusion File    " LINK "SaveExclude"} Button Gadget
      @{" Apply Exclusions       " LINK "ApplyExclude"} Button Gadget
      @{" Load DataBase ..       " LINK "LoadDB"} Button Gadget
      @{" Save DataBase ..       " LINK "SaveDB"} Button Gadget
      
      @{" Exclusions " LINK "ExcludeLV"} ListView Gadget
      @{FG SHINE}      
      MENUS: @{FG TEXT}
      @{B}
      PROJECT@{UB}          @{" SORTING " LINK "SortMenu"}

      @{"Print View >>  " LINK "PrintMI"}  By FileName
        To PAR:        By Disk
        To SER:        By File Date
        To File        By File Size
      ~~~~~~~~~~~~~~~  By Comment
      @{"About..    A-I " LINK "AboutMI"}  By Category
      @{"Help!      A-H " LINK "HelpMI"}  By Process

@ENDNODE

@NODE "ExcludeLV" "Exclusions ListView Gadget:"

   The @{B}Exclusions@{UB} ListView Gadget contains a list of files or wildcard
   patterns to exclude from the DataBase.  When the @{" Apply Exclusions " LINK "ApplyExclude"} 
   button is pressed & released, @{PGMNAME} will remove all records from
   the DataBase which match any of the Exclusion patterns listed.

@ENDNODE

@NODE "ApplyExclude" "Apply Exclusions Button Gadget:"

   In order to use exclusions effectively, you should know how AmigaDOS
   wildcard patterns are used.
   
   @{FG SHINE}
   WARNING: @{FG TEXT} Records will be deleted from program memory once this button
             is pressed & released.  Make sure that you @{" save " LINK "SaveDB"} your 
             DataBase first!
@ENDNODE

@NODE "LoadExclude" "Load Exclusion File .. Button Gadget:"

   Pressing & releasing this button will make @{PGMNAME} ask you for
   a filename with Exclusion information to load into the @{" Exclusions " LINK "ExcludeLV"}
   ListView Gadget. 
@ENDNODE

@NODE "SaveExclude" "Save Exclusion File Button Gadget:"
   
   Pressing & releasing this button will save the contents of the 
   @{" Exclusions " LINK "ExcludeLV"} ListView Gadget into the filename defined by 
   the @{" DefaultExclusion " LINK "ToolTypes"} ToolType.  If this is not defined, you will be 
   asked to supply a filename.
@ENDNODE

@NODE "LoadDB" "Load DataBase .. Button Gadget:"

   Pressing & releasing this button will clear the current records from
   program memory & ask you for a DataBase filename to load into
   @{PGMNAME}.

   SEE ALSO, @{" Open menu item " LINK "OpenMI"}

@ENDNODE

@NODE "SaveDB" "Save DataBase .. Button Gadget:"

   Pressing & releasing this button will save the Current DataBase contents
   into the filename you supply (if needed).

   SEE ALSO, @{" Save As menu item " LINK "SaveAsMI"}

@ENDNODE

@NODE "VolumeSelect" "Select a Volume - Adding to the database:"
@PREV "Main"
@NEXT "ToolTypesEditor"

   The@{BOLD "Volume Selector"}consists of the following Gadgets & Menu
   Items:
      @{FG SHINE}     
      GADGETS:                      MENUS @{FG TEXT}

      Volumes    ListView Gadget    PROJECT
      
      Disk Name: String Gadget      @{" About.. A-I " LINK "AboutMI"} 
                                    @{" Help!   A-H " LINK "HelpMI"}
      OKAY!      Button Gadget
      CANCEL     Button Gadget

   Select which disk (from the @{B}Volumes@{UB} ListView Gadget) you wish to add to 
   your DataBase, or enter a Volume name into the @{B}Disk Name:@{UB} String Gadget.
   
   Then press & release the @{B}OKAY!@{UB} button.  Pressing & releasing 
   the @{B}CANCEL@{UB} button will abort your attempt to add another disk of
   filenames to the DataBase.

@ENDNODE

@NODE "ToolTypes" "ToolTypes recognized by DiskLibrarian:"

   @{B}ToolTypes recognized by @{PGMNAME}:@{UB}

      @{SHINE DEFAULTDBASE}     = "DiskList"             (Default)
      @{SHINE HOMEDIR}          = "DiskLibrarian:"       (Default)
      @{SHINE DEFAULTACTION}    = "MultiView"            (Default)
      @{SHINE DEFAULTSORT}      = "Name"                 (Default)
      @{SHINE DIRCMD}           = DiskDirTree            (Default)
      @{SHINE HELPCMD}          = "MultiView"            (Default)
      @{SHINE INFOCMD}          = STANDARD               (Default)
      @{SHINE AREXXPORTNAME}    = "DiskLibrarianPort"    (Default)

      @{SHINE DEFAULTEXCLUSION} = ""                     (Default)

      @{SHINE VIEWCONFIG} = Disk|Name|Category|Size|Date|Process|Comment (Default)
   _______________________________________________________________________

   DEFAULTDBASE  - The name of the first database to open the program with.

   HOMEDIR       - The name of the directory where the program resides.

   DEFAULTACTION - The name of the Process to use where undefined.
   
   DEFAULTSORT   - The field to sort the DataBase with.  Valid values are: @{FG SHINE}
                   NAME
                   DISK
                   SIZE
                   DATE
                   COMMENT
                   CATEGORY
                   PROCESS @{FG TEXT}
                   
   DIRCMD        - The program that generates the list of disk contents.

   HELPCMD       - The name of the program that displays this helpfile.

   INFOCMD       - A Flag that tells the program how Volume information
                   is displayed (either CUSTOM or STANDARD).
                   STANDARD indicates that you're using the @{B}Amiga OS info@{UB}
                   command, & not an unknown one.
                   
   AREXXPORTNAME - The Name of @{PGMNAME}'s ARexx Port.

   DEFAULTEXCLUSION - The filename of the exclusions to use.

   VIEWCONFIG    - Which fields to display in the @{" Data Viewer's " LINK "ViewConfig"} Records
                   ListView Gadget.
   _______________________________________________________________________
   
   There is only one way (inside the Program) to edit the ToolTypes.
   From the Editor display (the window right after the START button is
   pressed), select the @{B}Edit ToolTypes...@{UB} menu item.
   A new window will open, allowing you to view/edit the Program ToolTypes.

   SEE ALSO, @{" ToolTypes editing " LINK "ToolTypesEditor"}      
@ENDNODE

@NODE "ToolTypesEditor" "Editing ToolTypes:"
@PREV "Main"
@NEXT "ToolTypes"

   You may edit any ToolType from the@{BOLD "ToolTypes"}ListView Gadget.  It gets
   written into the Icon only after the@{BOLD "Done, Save!"}button is 
   clicked on & released.

   If you make a mistake, you can press & release the@{BOLD "Restore!"}
   Gadget - the program will then Re-enter the ToolTypes from the Icon
   into the ListView Gadget.

   The@{BOLD "CANCEL!"}Button returns you to the Editor display window
   & does@{BOLD "NOT"}save any changes to the Icon.
     
   Any changes made to the ToolTypes won't be sent to the Icon until the
  @{BOLD "Done, Save!"}button is clicked on & released.

   SEE ALSO @{" ToolTypes " LINK "ToolTypes"}
@ENDNODE

@NODE "ARexxCommands" "ARexx Commands recognized by DiskLibrarian:"
@PREV "Main"
   @{FG SHINE}
                       None written so far!! @{FG TEXT}

@ENDNODE

@NODE "VanillaKeys" "Keys that DiskLibrarian recognizes:"
@PREV "Main"

  @{SHINE "h or H:"}Show the user some info on the program (same as selecting the
           @{"Help! " LINK "HelpMI"} menu item).

  @{SHINE "i or I:"}Same as selecting the @{" About.. " LINK "AboutMI"} menu item.

  @{SHINE "q or Q:"}Same as pressing the Close Window Gadget or selecting
           the @{" Quit " LINK "QuitMI"} menu item..

@ENDNODE

@NODE "Author" "The Author (what a hoopy guy!):"
@PREV "Main"

  If your conscience is bugging you to contribute some cash for my
  programming efforts, please send $5 (US) or more for the program to:
  
  @{B}The Author@{UB} @{FG SHINE}(a real cool frood!)@{FG TEXT}:

  James T. Steichen
  2217 N. Tamarack Dr. 
  Slayton, Mn. 56172-1155 (USA)

  email: @{FG SHINE} jsteic1957@aol.com @{FG TEXT}  (best place to send bug reports)

  @{PGMNAME} was written using @{B}CanDo V3.008@{UB}.

  SEE ALSO, @{" Other parts " LINK "DiskDirTree"}

@ENDNODE