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

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

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.02 @{ui}
@{i} (c) 1997 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"}


    @{" 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.lha
						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.02 @{ui}
@{i} (c) 1997 by Lars Unger @{ui}

@{u} HELP Guide @{uu}


@{b} Welcome to FFDS or FileFindDatabaseSystem Version 1.02 ! @{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 serach 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	Dec`97  changes: installer, ffds-help.guide, ffds.guide
			add: CDROM databases



@ENDNODE

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

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.02 @{ui}
@{i} (c) 1997 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


   Warranty
  ----------

    The program is provided "as is":  The author will not be liable for any
    damage, direct or indirect, arising from the use or the impossibility of
    the use of this software.  There is especially no guarantee for the
    correctness, accuracy or validity of data.  The author denies any liability
    or tacit guarantee, especially that FFDS is suitable for a special
    purpose.


   Distribution
  --------------

    FFDS (FileFindDatabaseSystem) v1.01 Copyright © 1997,98 by Lars Unger.
    All rights reserved. This program may be distributed non-commercially
    only providing that the executable, source code, documentation and
    copyright notices remain unchanged and are included with the distribution.
    The archive must contain the following files:

	ffds:rexx
	ffds:bin
	ffds:.config
	ffds:Start-FFDS.info
	ffds:shell-scripts
	ffds:start.rexx
	ffds:Start-FFDS
	ffds:FFDS.guide
	ffds:ffds-help.guide
	ffds:readme.first
	ffds:readme.first.info
	ffds:Install.info
	ffds:Install
	ffds:rexx/build_db.rexx
	ffds:rexx/build_cd_db.rexx
	ffds:rexx/search_file.rexx
	ffds:rexx/del_db.rexx
	ffds:rexx/update_all.rexx
	ffds:rexx/fifi.rexx
	ffds:rexx/change_dbpath.rexx
	ffds:rexx/exit.rexx
	ffds:rexx/show_settings.rexx
	ffds:rexx/change_packer.rexx
	ffds:rexx/none_packer.rexx
	ffds:rexx/change_search.rexx
	ffds:rexx/change_view.rexx
	ffds:bin/LinkScan
	ffds:bin/volname
	ffds:bin/wbtofront
	ffds:shell-scripts/fifi


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

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

@{u} HELP Guide @{uu}

@{JLEFT}

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

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

 @{"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"}



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

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




@ENDNODE

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

 @{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} @{" RETURN to Main Menu Help" link "mmhilfe"}


@ENDNODE

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

 @{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 a database already exists it`ll be updated.
 If the XPK-Packer is not set to NONE, FFDS will compress the database.


@{JCENTER} @{" RETURN to Main Menu Help" link "mmhilfe"}


@ENDNODE

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

 @{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} @{" RETURN to Main Menu Help" link "mmhilfe"}


@ENDNODE

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

 @{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} @{" RETURN to Main Menu Help" link "mmhilfe"}


@ENDNODE

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

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

 FFDS update all HDD Databases automaticly. Look @{"Add or Update" link "h_build_db"} for
 more information.

@{JCENTER} @{" RETURN to Main Menu Help" link "mmhilfe"}

@ENDNODE

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

@{JCENTER}
@{b}@{u} FileFindDatabaseSystem @{uu}@{ub}
@{i} Version 1.02 @{ui}
@{i} (c) 1997 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

 @{u} Binaries @{uu}

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

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

 @{" 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_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_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
