@DATABASE SimpleFind_English.guide
@$VER: SimpleFind_English.guide 1.1 (21.04.97)
@Author Sebastian Bauer
@(C) ©1997

@NODE main "SimpleFind Documentation"
@SMARTWRAP
@{b}SimpeFind 1.1 @{AMIGAGUIDE}@{ub}


Note that the authors native language is german, so please forgive
bad spelling, grammar mistakes and so on (I know that there are many). Or better - correct them
and @{" contact " link SB } me.

Attention! This guide is designed for the version 40 of the
amigaguide.datatype which is supplied with AmigaOS 3.1. Under other
versions this guide may look very terrible.
@{CODE}

@{" Copyright " link COPYRIGHT}              Copyright and disclamer
@{" Introduction " link INTRO}           What is it ?
@{" Requirements " link REQUIRE}           What does it need ?
@{" Installation " link INSTALL}           How to install ?
@{" Usage " link USAGE}                  How to use ?
@{" Future " link FUTURE }                 What is comeing next ?
@{" History " link HISTORY }                What has be done ?
@{" Author " link SB }                 Where to send bug reports ?
@ENDNODE

@NODE COPYRIGHT "Copyright and disclamer"
@SMARTWRAP
@{b}Copyright@{ub}


(c) Copyright 1997 @{" Sebastian Bauer " link SB }


SimpleFind is Freeware. You can give it to anybody you want as long as
all the files are complete and in a unchanged form. You also aren't
allowed to make any profit with it.


@{b}Standard Disclamer@{ub}


THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.


IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.

@ENDNODE

@NODE INTRO "Introduction"
@SMARTWRAP
@{b}Introdution@{ub}


SimpleFind is a Search-Tool for your Amiga. It scans a selected
directory for a entered name pattern and shows them. You can
copy, delete, rename or view this files.

@{CODE}
Features
  - allows searching by name (AmigaOS namepatterns), size, date
  - Indexfiles for faster searching
  - allows to copy, delete, view and rename
  - easy to use GadTools-GUI
  - and much more
@{BODY}

I know that there are some good tools there, but the some of them use MUI
and other have no GUI.
I want to have one which have an easy to use GUI, which don't need MUI.
(but this means not that I'm gerneraly against MUI. It is very powerful and helps
developers by createing there software, for example without MUI some good WWW-Browser
wouldn't exists).

An other reason was that I want to test my programing knowledge (this is my first 'real'
program I wrote)
@ENDNODE

@NODE REQUIRE "Requirements"
@SMARTWRAP
@{b}Requirements@{ub}


SimpleFind needs at least Kickstart 3.0. It should work with a MC68000
processor but this is not recommended.
@ENDNODE

@NODE INSTALL "Installation of SimpleFind"
@SMARTWRAP
@{b}How to install SimpleFind@{ub}


Currently there is no installer script. To install SimpleFind simply copy the whole
drawer where you want.
@ENDNODE

@NODE USAGE "Usage"
@{b}Usage@{ub}

@{" Tooltypes " link TTYPES }
@{" Menu " link MENU }
@{" Main Window " link MAINWND }
@{" Result Window " link RESULTWND }
@ENDNODE

@NODE TTYPES "ToolTypes"
@{b}Tool Types@{ub}

Currently there is only one ToolType

@{u}PREFSFILE@{uu}

Here you can specify the path and the name of prefs
file which is created when you select @{" SaveSettings " link MENU} in the @{" menu " link MENU}.

(Default PROGDIR:SimpleFind.prefs)

@ENDNODE

@NODE MENU "Menu"
@{CODE}@{b}Menu@{ub}

Project    @{tab}Indexfiles      @{tab}  Settings
@{"About...  ?" link "MENU" 19 }@{tab}@{"Create Indexfile...    " link MENU 27}@{tab}  @{"  Case sensitive?  C " link MENU 46}
-----------@{tab}@{"Update Indexfile...    " link MENU 33}@{tab}  @{"  Exact?           E " link MENU 50 }
@{"Quit      Q" link "MENU" 22 } @{tab}-----------------------@{tab}  @{"  Show size?       H " link MENU 53}
           @{tab}@{"Available Indexfiles..." link MENU 37}@{tab}  @{"  Show date?       D " link MENU 57}
           @{tab}-----------------------@{tab}  @{"  Sort List?         " link MENU 61}
           @{tab}@{"Delete Indexfile...    " link MENU 40}@{tab}  @{"  Use Indexfiles ?   " link MENU 64}
           @{tab}                    @{tab}  ---------------------
           @{tab}                    @{tab}  @{"Select Viewer...   V " link MENU 68}
           @{tab}                    @{tab}  @{"Select IndexDir...   " link MENU 73}
           @{tab}                    @{tab}  ---------------------
           @{tab}                    @{tab}  @{"Save Settings      S " link MENU 77}


@{B}The 'Project' Menu@{UB}

 @{U}About ?@{UU}
  Shows information about the Author (hey, that's me).

 @{U}Quit Q@{UU}
  Quits the program.

@{B}The 'Indexfiles' Menu@{UB}

 @{u}Create Indexfile...@{uu}
  Here you can create a new IndexFile for an specified
  directory. When this indexfile already exists a requester
  is shown where you an select between create, update or
  cancel.

 @{u}Update Indexfile...@{uu}
  This brings up a requester where you can select the
  indexfile which should be updated.

 @{u}Available Indexfiles...@{uu}
  Here you can see the available Indexfiles.

 @{u}Delete Indexfile...@{uu}
  This brings up a requester where you can select the
  indexfile which should be deleted.

@{B}The 'Settings' Menu@{UB}

 @{U}Case sensitive?  C@{UU}
  If this option is checked, SimpleFind takes care of the
  case of the filenames.

 @{U}Exact?  E@{UU}
  If it is checked, SimpleFind looks for whole words.

 @{U}Show size?  H@{UU}
  If this option is checked, SimpleFind shows the size
  of the visible files

 @{U}Show date?  D@{UU}
  If this option is checked, SimpleFile will show date
  of the files.

 @{U}Sort List?@{UU}
  This will sort the results alphabetically.

 @{U}Use Indexfiles?@{UU}
  Only if this option in checked SimpleFind will use
  Indexfiles, if available.

 @{U}Select Viewer...  V@{UU}
  This opens a window where you an specify your prefered
  viewer. %s is replaced by the selected file name, otherwise
  the name is added at the end of the line.

 @{U}Select IndexDir...@{UU}
  This will open an asl requester where you can specify the
  directory for the indexfiles (Default to PROGDIR:Indexfiles)

 @{U}Save Settings  S@{UU}
  Save the settings you have made.



























@ENDNODE

@NODE MAINWND "Main Window"
@{b}Main Window@{ub}

The Main window is the window where you specify the
criteries of a searching process. You will find followed
gadgets or gadgetgroups in this window.

@{u}Search Path@{uu}

Path where SimpleFind start its search. You can
enter this path by keyboard or by clicking the button («)
right to the string gadget which brings up a
filerequester.

@{u}Pattern@{uu}

Standard AmigaOS Pattern.

@{u}Min Size(kb)@{uu}

When the Checkbox is checked you can specify the minimum
size in kbytes (1024 bytes)

@{u}Max Size(kb)@{uu}

When this option is checked you can specify the maximum
size in kbytes (1024 bytes).

@{u}Within the last@{uu}
d
Here you can specify how many days/month ago (maximal) a
file should have been created/changed.

@{u}Start Search...@{uu}

This will start the scanning process. The results are
shown in the @{" Result Window " link RESULTWND }

@ENDNODE

@NODE RESULTWND "Result Window"
@{b}Result Window@{ub}

Here you see a listview which shows the found files.
Simply select a file by clicking on its name. When you
enter a new name in the string gadget the file will be
renamed to this name.
You will find following other gadgets here.

@{u}Show...@{uu}

When you click this button the actual selected file will
be shown via MultiView.

@{u}Copy...@{uu}

Here you can copy the seleted file. It brings up a
requester where you an select a destination.

@{u}Delete...@{uu}

This will delete the selected file from disk, after
you have agreed it in a requester.
@ENDNODE

@NODE FUTURE "Future"
@PREV USAGE
@SMARTWRAP
@{b}Future@{ub}


I plan to add following features:
@{CODE}
  - work with Kickstart 2.0 if wanted
  - some GUI improvements
  - more buttons
  - a better guide (also an german version) and fewer mistakes
  - maybe an installer script
  - any other suggentions if I think they are good (for example
    I will not add a racing game or a function plotter ;-) )
@ENDNODE

@NODE HISTORY "History"
@SMARTWRAP
@{b}History@{ub}


And now the very long history of SimpleFind:
@{CODE}

  @{b}Version 1.0 (06.04.97)@{ub}
    - first Aminet release

  @{b}Version 1.1 (21.04.97)@{ub}
    - Oops, SimpleFind frees its memory twice.
      This is fixed now (I hope)
    - Now can use Indexfiles to speed up searching

@ENDNODE

@NODE SB "How can you reach me ?"
@SMARTWRAP
There can be many bugs because this is the second version of
SimpleFind and also my first programm for Amiga. If you find
some bugs (also in this guide) or have suggestions to
improve SimpleFind, you should contact me.

If you want, you could send me a really good Icon for SimpleFind.
(I know my one is ugly but I'm a doc, aeh program(m)er not an artist...)

Also feel free to send me harddisks, gfxcards, disks, CDs or
money ;-)
@{CODE}

Address:
   Sebastian Bauer
   Neustädter Str. 45
   07768 Kahla
   Germany

You can also contact me via E-Mail:
   sebauer@t-online.de

@{BODY}
I have an homepage in the WWW, too. It is currently in german only
and in a very early state. But you will find the latest version of SimpleFind
and also other projects for Amiga there.
@{CODE}

   http://home.t-online.de/home/sebauer/

@ENDNODE