@database "FileFindDatabaseSystem_Help"
@$VER FileFindDatabaseSystem Version1.2
@Author (c) 1997,98 by Lars Unger

@NODE MAIN "FileFindDatabaseSystem - HELP Guide"
@PREV "faq"
@NEXT "intro"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}


    @{" Introduction and Requirements " link "intro"}

    @{" Copyright and Author          " link "cop_auth"}

    @{" Help for Main Menu            " link "mmhilfe"}

    @{" Shellscripts and Binaries     " link "shell_bin"}


    @{" Asked Questions               " link "faq"}


    @{" Read Me First                 " link "ffds:readme.first/MAIN"}



 Don`t Panic ! FFDS is very user friendly. You`ll be asked very
 often, if you really want to do the specified action or if you
 want to cancel it. Please take a minute to email @{" me " link "cop_auth"}.
 You`ll find updates on Aminet and the FFDS Website:
 <http://www.amigaworld.com/lars/ffds.html>
						Best wishes, Lars.

@{JCENTER}

 @{" RETURN to GUI Guide " link "ffds:ffds.guide/main"}


@ENDNODE

@NODE intro "FFDS Help: Introduction"
@TOC "main"
@NEXT "cop_auth"
@PREV "main"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}


@{b} Welcome to FFDS or FileFindDatabaseSystem Version 1.2 ! @{ub}

@{JLEFT}

 @{u} Introduction @{uu}


   If you ever search a file/directory, you know the problem. You have
   to scan your Harddisk(s) every time you search one and if you use
   a wrong pattern you have to do it again ... I`ve six partitions and
   4 of them, doesn`t change within a month or two. So i decide to write
   a couple of ARexx-Scripts and AmigaGuides to build databases of every
   volume. Now i can use a simply textsearcher to search a file/directory,
   which is must faster than a scan of every volume. If there are a lot of
   changes on a volume i can update it :)


 @{u} Requirements @{uu}


   - An Amiga with OS3.0 or higher
     (could work with OS>2.04 as well, but i haven`t tested this)

   - RexxReqTools.library
     (download it from Aminet util/rexx)

   - about 100kB for the program and some more free space for the
     databases on your harddisk
     (could work on floppy-disk(s) as well, but i haven`t tested this)

   - about 0.5-2 MB free RAM (every database is first created in RAM)

   If you want to pack your databases you need:

   - XPK-System installed and xpk command in a valid DOS path
     (Use @{"preferences/XPK-Compressor/Set packer to NONE" link "ffds:ffds.guide/packer"} to switch packing off)


 @{u} History @{uu}

	Version	Date	Comment

	1.0	Nov`97	first public release
	1.01	Nov`97  changes: installer, ffds-help.guide, ffds.guide
			add: CDROM databases
	1.02    Nov`97  changes: installer, fifi

	1.1	Dec`97  add: Helpmanager V1.0
			changes: ffds.guide, ffds-help.guide, readme.first
				 installer (update option)
	1.2	Dec`97	add: Print`n`Sort, Show new files
                        changes: ffds.guide, ffds-help.guide, .config,
				 readme.first, build_db.rexx
			bugfix: search_file.rexx (thanx to Wolfgang Lug)

@ENDNODE

@NODE "cop_auth" "FFDS HELP: Copyright and Author"
@TOC "main"
@NEXT "mmhilfe"
@PREV "intro"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}

   Author
  --------

   Name:   Lars Unger
   EMail:  l.unger@tu-bs.de
   IRC:    Ynthan
   WWW:    http://www.amigaworld.com/lars


   FFDS Homepage
  ---------------

   http://www.amigaworld.com/lars/ffds.html



  @{" Warranty & Distribution Text " link "ffds:legalstuff.txt/MAIN"}


@ENDNODE

@NODE "mmhilfe" "FFDS HELP: Main Menu"
@TOC "Main"
@PREV "cop_auth"
@NEXT "shell_bin"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}

@{u}  Help for Main Menu @{uu}

 @{" Database Operation  " link "mm_db_op"}

 @{" File Operation      " link "mm_fi_op"}




@{JCENTER}

 @{" RETURN to Main Menu " link "main"}

 @{" RETURN to GUI Guide " link "ffds:ffds.guide/main"}



@ENDNODE

@NODE "mm_db_op" "FFDS HELP: Main Menu/Database Operation"
@TOC "Main"
@PREV "mmhilfe"
@NEXT "mmhilfe"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}

 @{"Add or update HDD database ... " link "h_build_db"}

 @{"Add CDROM database ...         " link "h_build_cd_db"}

 @{"Delete database ...            " link "h_del_db"}

 @{"Update all HDD databases ...   " link "h_update_all"}


 @{"Print`n`Sort database ...      " link "h_print_db"}



 @{" Back to Main Menu Help " link "mmhilfe"}

@ENDNODE

@NODE "mm_fi_op" "FFDS HELP: Main Menu/File Operation"
@TOC "Main"
@PREV "mmhilfe"
@NEXT "mmhilfe"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}


 @{"Search File/Directory ...      " link "h_search_file"}

 @{"Show new files on volume ...   " link "h_show_new"}


 @{" Back to Main Menu Help " link "mmhilfe"}


@ENDNODE

@NODE "h_build_db" "FFDS HELP: Add or update HDD Database"
@TOC "mm_db_op"
@NEXT "mm_db_op"
@PREV "mm_db_op"

 @{u} "Add or update Database" @{uu}

 After you choose a volume, FFDS scan the volume to avoid reading
 Hard/Soft-Links (LinkScan). FFDS will create a database with all file`s and
 directories of this volume. (list) If you choose modus "Update & Show new
 files", another list will scan the directories for new files since the
 creation date of the database. This is only avaiable, if a database exists
 (update).
 If the XPK-Packer is not set to NONE, FFDS will compress the database.


@{JCENTER} @{" Back " link "mm_db_op"}


@ENDNODE

@NODE "h_build_cd_db" "FFDS HELP: Add CDROM Database"
@TOC "mm_db_op"
@NEXT "mm_db_op"
@PREV "mm_db_op"

 @{u} "Add CDROM Database" @{uu}

 After you choose a CDROM volume, FFDS scan the volume to avoid reading
 Soft-Links (LinkScan). FFDS will create a database with all file`s and
 directories of this volume. (list) If a database already exists it`ll be updated.
 If the XPK-Packer is not set to NONE, FFDS will compress the database.

@{JCENTER} @{" Back " link "mm_db_op"}


@ENDNODE

@NODE "h_del_db" "FFDS HELP: Delete Database"
@TOC "mm_db_op"
@NEXT "mm_db_op"
@PREV "mm_db_op"

 @{u} "Delete Database" @{uu}

 Each database is saved in the directory DBPATH (you set it in the
 preferences). The name structure is <Volname>.ffds . Choose the
 database you want to delete.

@{JCENTER} @{" Back " link "mm_db_op"}


@ENDNODE

@NODE "h_update_all" "FFDS HELP: Update all HDD Databases"
@TOC "mm_db_op"
@NEXT "mm_db_op"
@PREV "mm_db_op"

 @{u} "Update all Databases" @{uu}

 FFDS update all HDD Databases automaticly. Look @{"Add or Update" link "h_build_db"} for
 more information. The modus "Update & Show new files" isn`t avaiable.

 @{i} Warning ! @{ui} This procedure can take a long time. And your Harddisk
 is working all the time.

@{JCENTER} @{" Back " link "mm_db_op"}

@ENDNODE

@NODE "h_print_db" "FFDS HELP: Print`n`Sort database"
@TOC "mm_db_op"
@NEXT "mm_db_op"
@PREV "mm_db_op"

 @{u} "Print`n`Sort Database" @{uu}

 You`ll be able to sort the database. After that you can choose, if you want
 to print it, save it to a file or copy it back. If you copy it back, you
 don`t need to sort it up to the next Update call.

@{JCENTER} @{" Back " link "mm_db_op"}

@ENDNODE



@NODE "h_search_file" "FFDS HELP: Search File"
@TOC "mm_fi_op"
@NEXT "mm_fi_op"
@PREV "mm_fi_op"

 @{u} "Search File/Directory" @{uu}

 After you enter a search string (please refer the doc of the installed
 Textsearcher for the syntax and the use of wildcards !), a FFDS-Rexx-Script
 will search in all Databases for this string and run the installed Textviewer
 to show you the results.

 FFDS will not stop your Textviewer, even if you start a new search !


@{JCENTER} @{" Back " link "mm_fi_op"}

@ENDNODE

@NODE "h_show_new" "FFDS HELP: Show new files"
@TOC "mm_fi_op"
@NEXT "mm_fi_op"
@PREV "mm_fi_op"

 @{u} "Show new files on volume" @{uu}

 You`ve to choose a volume and enter a date (or take it from the ffds
 database, if there exists one). After that a FFDS-Rexx-Script will scan the
 volume for files, which are newer than the given date.


@ENDNODE

@NODE "shell_bin" "FFDS HELP: Shellscripts and Binaries"
@TOC "main"
@NEXT "faq"
@PREV "mmhilfe"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}

 @{u} Shellscripts @{uu}

 @{i} You have to assign ffds: in your user-startup to use these scripts ! @{ui}

 @{" fifi       " link "sb_fifi"}   FileFind

 @{" help       " link "sb_help"}   Help (search)

 @{u} Binaries @{uu}

 @{i} All Binaries compiled in 68k code and should work on every system. @{ui}

 @{" LinkScan   " link "sb_lisc"}   Link/Directory Scanner

 @{" SystemDay  " link "sb_sysd"}   Outputs File-Date in internal format

 @{" VolName    " link "sb_vona"}   Volume Name

 @{" WBtoFront  " link "sb_wbtf"}   Workbench to Front



@{JCENTER}

 @{" RETURN to Main Menu " link "main"}

 @{" RETURN to GUI Guide " link "ffds:ffds.guide/main"}


@ENDNODE

@NODE "sb_fifi" "FFDS HELP: FileFind Shellscript"
@TOC "shell_bin"
@NEXT "shell_bin"
@PREV "shell_bin"

 @{b} fifi <searchpattern> @{ub}

 This script is creating a search-script to search <searchpattern> in
 all FFDS Databases. After that it runs the Textviewer (set in the
 Preferences) to show you the results. The results are saved in
 t:_ffdsresult. Attention ! FFDS don`t delete t:_ffdsresult. If you
 are low of memory, you`ve to do it by yourself after you leave your
 textviewer.

 Example:

  1> fifi lars
  >  Scanning for Databases ...
  >  Writing shellscript for SEARCH ...
  >  Executing shellscript SEARCH ...

    (now fifi run the textviewer)


@{JCENTER} @{" RETURN to Shellscripts & Binaries Menu" link "shell_bin"}

@ENDNODE

@NODE "sb_help" "FFDS HELP: Help Shellscript"
@TOC "shell_bin"
@NEXT "shell_bin"
@PREV "shell_bin"

 @{b} help <search> <method> <modus> <filter> @{ub}

 This script is part of the @{"Helpmanager" link "ffds:hm.guide/MAIN"}. It search
 helpfiles for you.

 The arguments:

	<search>        a part of the name of the helpfile you search

        <method>	Two methods are avaiable:
			× INDEX searches in all paths of Helpmanager
			× FFDS searches in FFDS databases

	<modus>		You only need this for method FFDS. Three modi are
			avaiable:
			× HDD only search in Harddisk databases
			× CDROM only search in CDROM databases
			× BOTH (default) search in both databases

        <filter>	You can define a filter for method FFDS to make your
			result smaller. Example: If you only search guide-files,
			you set the filter to ".guide"


@{JCENTER} @{" RETURN to Shellscripts & Binaries Menu" link "shell_bin"}

@ENDNODE


@NODE "sb_lisc" "FFDS HELP: LinkScan Binary"
@TOC "shell_bin"
@NEXT "shell_bin"
@PREV "shell_bin"

 @{b} LinkScan <directory> SUBDIRS/S REPORT/S @{ub}

 This program scan the <directory> for Hard/Softlinks. Switches:

  SUBDIRS     If SUBDIRS is set, all directories down from <directory>
              will be scanned. Except of Hard/Softlinks.

  REPORT      If REPORT is set, LinkScan produce a REPORT to standard
              output.

              Format: "directory" [ok]    normal directory
                      "directory" [link]  Hard/Softlink

  Examples:

   1> linkscan dh0:

   2> linkscan dh0: SUBDIRS
      dh0:locale/help

   3> linkscan dh0: SUBDIRS REPORT
      .
      .
      "dh0:locale" [ok]
      "dh0:locale/help" [link]
      .
      .


@{JCENTER} @{" RETURN to Shellscripts & Binaries Menu" link "shell_bin"}

@ENDNODE

@NODE "sb_sysd" "FFDS HELP: SystemDay Binary"
@TOC "shell_bin"
@NEXT "shell_bin"
@PREV "shell_bin"

 @{b} SystemDay <file or directory> FILE/S or SUBDIRS/S @{ub}

 This program scan the <file/directory> and prints the file and their
 last modification date in internal format.

  FILE        If FILE is set, systemday only print this one file.

  SUBDIRS     If SUBDIRS is set, all directories down from <directory>
              will be scanned.

  Examples:

   1> systemday ram:
      "ram:t.info" 7290
      "ram:env.info" 7290

   2> systemday ram:t.info FILE
      "ram:t.info" 7290

   3> systemday ram: SUBDIRS
      .
      .
      "ram:env/sys/def_drawer.info" 7290
      "ram:env/KickStart" 7290
      .
      .


@{JCENTER} @{" RETURN to Shellscripts & Binaries Menu" link "shell_bin"}

@ENDNODE

@NODE "sb_vona" "FFDS HELP: VolName Binary"
@TOC "shell_bin"
@NEXT "shell_bin"
@PREV "shell_bin"

 @{b} VolName <volume> @{ub}

 This program look for the name of a given volume.

 Examples:

  1> volname dh0:
     System

  2> volname dh0:locale
     Locale

@{JCENTER} @{" RETURN to Shellscripts & Binaries Menu" link "shell_bin"}

@ENDNODE

@NODE "sb_wbtf" "FFDS HELP: VolName Binary"
@TOC "shell_bin"
@NEXT "shell_bin"
@PREV "shell_bin"

 @{b} WBtoFront @{ub}

 Simply switches the Workbench to front.

@{JCENTER} @{" RETURN to Shellscripts & Binaries Menu" link "shell_bin"}

@ENDNODE

@NODE "faq" "FFDS HELP: Asked Questions"
@TOC "main"
@NEXT "main"
@PREV "shell_bin"

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.2 @{ui}
@{i} (c) 1997,98 by Lars Unger @{ui}

@{u} HELP Guide @{uu}

@{JLEFT}

 @{u} Asked Questions @{uu}

  @{" FFDS don`t list a directory    " link "faq_list_dir"}


@{JCENTER}

 @{" RETURN to Main Menu " link "main"}

 @{" RETURN to GUI Guide " link "ffds:ffds.guide/main"}


@ENDNODE

@NODE "faq_list_dir" " FFDS don`t list a directory "
@TOC faq
@NEXT faq
@PREV faq

 @{u} FFDS don`t list a directory @{uu}


 Q:

 Why stops FFDS listing to the database at the directory AllMainLHA(A-L) ?


 A:

 If you use AmigaDOS patterns (like #?, (.info), etc.) in your directory names
 the AmigaDOS-command `list` can`t find these directories. A directory called
 AllMainLHA(A-L) produces AllMainLHAA, AllMainLHAB, AllMainLHAC, etc.. Please
 rename your directory and FFDS list these directories as well.


 @{i} Thanx to Les Morgan for his emails and screen grabs. @{ui}

@ENDNODE