Short:        Search tool for amigaguide docs
Author:       cfou@whdload.de (Bertrand JARDEL)
Uploader:     cfou whdload de
Type:         text/hyper
Version:      1.1
Replaces:     text/hyper/SearchGuideCF
Requires:     OS 3.0+, Reqtools.library v2.0+
Architecture: m68k-AmigaOS >= 3.0
Distribution: Aminet

History:
-------
 V1.1 (21.08.05)
 Some bugs fixed:
       - Crash with NoWindow argument if no keyword was found
       - All set arguments are token in result files now
       - Requester's window size fixed to see full title

 V1.0 (17.08.05)
 First public release

Description:
-----------
SearchGuide's replacement command coded with BARFLY
(SearchGuide was created by Gérard CORNU)

Needed:
------
- OS 3.0+
- Reqtools.library v2.0+

Features:
--------
- Button search with selected arguments is added in result
  (so 999 successif researches are possibles ;-))
- Search routine more speed for big amigaguide's files using an optional buffer
  (in this case dos.library function Fgets() is replaced by own reading routine)
- 'SeeNodeLink' argument used to add in result node's source of found items
- 'NoWindow' argument used to not open windows for research's messages
- 'NoDelete' argument used to not delete temporary amigaguide's result in T:
- 'Viewer' argument used to define tool used to display result
- 'PubScreen' argument used to define name of pubscreen to display result
- This command is compatible with SearchGuide's catalogs
  (named 'SearchGuide.catalog' and not 'SearchGuideCF.catalog')
- amigaguide's functions skipped during research
  (@prev @next @endnode,...)


Installation:
------------
copy 'SearchGuideCF' in your workbench folder 'C:'


Usage:
------
Arguments:
V=VIEWER/K,PS=PUBSCREEN/K,G=GUIDE/A,NOWINDOW/S,SEENODELINK/S,B=BUFFERS/N,NODELETE/S

 VIEWER: to define replacement viewer (default amigaguide & multiview)
 PUBSCREEN: to define PUBSCREEN name for display result and message's windows
 GUIDE: to define name of the source amigaguide's file
 NOWINDOW: set it to not open window for messages (found/not fount/looking for)
 SEENODELINK: set it to add node source link of found lines in result
 BUFFERS: to define size of read buffer in Koctets (0 to 100)
 NODELETE: set it to not delete result (named 'T:TMP_xxx.guide')

Example:
SearchGuideCF MyGuide.guide PS=DOPUS.1 B=100 NOWINDOW

SearchGuideCF G=MyGuide.guide VIEWER=c:powerguide BUFFERS=5

SearchGuideCF GUIDE=MyGuide.guide PS=DOPUS.1 NODELETE SEENODELINK


Error beeps:
-----------
1 beep  :key not found
2 beeps :reqtools.library's  'cancel' button selected
3 beeps :Source amigaguide's file not found
4 beeps :result amigaguide's file can't be open
5 beeps :no needed arguments found
6 beeps :viewer not found or viewer's error


This package contents following files:
-------------------------------------
  C/SearchguideCF
  SearchGuideCF.readme