home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT002.ZIP / F-HELP < prev    next >
Text File  |  1988-05-05  |  78KB  |  2,351 lines
  1. General Introduction
  2.  
  3.    AnyWord, formerly called "Total Recall", is a
  4. general text indexing and retrieval program.  It
  5. consists of two parts:    Indexer and Finder.  When
  6. Indexer is run against a set of text files, it
  7. produces an index much like the index of a book.
  8. These index files can then be read by Finder to
  9. quickly locate any word or combination of words in
  10. the text.
  11.  
  12.    Again, like a book index, your text is untouched.
  13. All of the indexing information is carried
  14. separately and your text files are not modified or
  15. re-arranged in any way.  This means that you can
  16. "play around" with AnyWord as much as you want
  17. to without the worry of making an inadvertent change
  18. to your text files.
  19.  
  20.    AnyWord assumes nothing about the placement
  21. of your text files or the organization, if any, of
  22. your text.  Your text data can be in any format or
  23. no format at all; your files can be any size, on any
  24. disk, with any names.  Of course, there are
  25. practical limits.  This version of AnyWord will
  26. probably max out at somewhat over 1 MB (1 million
  27. bytes) of text spread across 254 files.
  28.  
  29.    You supply information about your files through
  30. the profile file, used by both Indexer and Finder.
  31.  
  32.    Some AnyWord features:
  33. - searching by any word or combination of words
  34. - display of selected text
  35. - extraction of selected text into new files
  36. - searching with simple Boolean logic,
  37.   i.e., AND - OR - NOT
  38. - searching with "wild cards", e.g., comput?  for
  39.   references to computers,computing, etc.
  40. - exit to DOS and return without disturbing selected
  41.   text or search results
  42. - review of previous search results within a session
  43. - view of all of the words that have been indexed
  44. - automatic file location via the DOS PATH operation
  45.  
  46.    What AnyWord cannot do:
  47. - make sense out of special formatting codes within
  48.   word processing files.  AnyWord works best
  49.   with ordinary ASCII files.  It will also work well
  50.   with Wordstar files in document mode.  It will
  51.   work less well, though it will still operate, with
  52.   files that contain binary data, such as Microsoft
  53.   Word files.  Most word processing programs have an
  54.   option to save a document as an ordinary ASCII
  55.   text file -- you'll probably want to take
  56.   advantage of this.
  57. - any kind of numeric calculation or comparison.  To
  58.   AnyWord everything is text -- just text.
  59.  
  60.  
  61.    AnyWord is useful for:
  62. - Locating simple information.    If you had our Movie
  63.   Database, for instance, you could instantly locate
  64.   all of Debra Winger's movies or director John
  65.   Carpenter's movies.
  66. - Locating combinations of text.  Using the Movie
  67.   Database as an example again, you could look for
  68.   all of the movies Clint Eastwood made with
  69.   Sondra Locke during the 1970s.
  70. - Extracting chunks of text into new files.  Have
  71.   a lot of research notes that you want to
  72.   organize?  You can build new files out of segments
  73.   of the old ones -- and without changing any
  74.   existing text.
  75. - Rapidly browsing through a collection of files.
  76.   From any point within any file, you can page
  77.   backwards, forwards, across files, to the
  78.   beginning, to the end, etc.
  79. - and more.
  80.  
  81.    AnyWord was formerly sold as a commercial
  82. product (for $49.50) under the name "Total Recall".
  83. You may still see occasional references to that
  84. name -- but AnyWord and the old Total Recall are
  85. the same.  (We sold our trademark and now sell
  86. a different product called Total Recall.)
  87.  
  88.    Now read on to find out how to get started.
  89. How to Use This Manual
  90.  
  91.    If you're in a hurry to get started, read the
  92. Installation section and the two "Getting Started"
  93. sections.  These should provide enough information
  94. for you to index some text files and do rapid
  95. lookups on the words in those files.
  96.  
  97.    However, if you believe that:  "If you don't have
  98. time to do it right, when will you have time to do
  99. it over?", then skim through the manual completely.
  100. If you do this, you'll understand how the system
  101. works, what you can expect from it, and what it
  102. expects from you.  Then, try the system out, using
  103. the manual for reference.
  104.  
  105.    AnyWord is a fairly complex, powerful
  106. system.  It probably has far more features than
  107. you'll ever use, but if you acquaint yourself with
  108. what those features are, you'll be less likely to
  109. spend much time scratching your head trying to
  110. figure out how to get the system to do what you want
  111. it to do.
  112. Installation
  113.  
  114.    First, look on the program disk.  If there is a
  115. file called README.1ST, then do so.  (E.g., enter:
  116. type readme.1st)
  117.  
  118. For Hard Disk Users:
  119. 1.  Copy all of the files over to your hard disk.
  120.     Recommended:  create one subdirectory for
  121.     everything on the AnyWord disk.
  122.     For instance:
  123.        C> mkdir \anyword
  124.        insert the AnyWord disk into the A: drive
  125.        C> copy a:*.* \anyword
  126.  
  127.     Alternatively, you can copy FINDER.EXE and
  128.     INDEXER.EXE to a subdirectory in your DOS
  129.     execution PATH.
  130.  
  131. For floppy-disk users:
  132. 1.  Make back-up copies of the distribution disks
  133.     and store the originals in a safe place.
  134. 2.  If you have a two-disk system, verify that you
  135.     have an AUTOEXEC.BAT file on the diskette that
  136.     you normally boot up with.    Check that it
  137.     contains:
  138.        PATH=A:\;B:\
  139.     (The backslashes are required for AnyWord.)
  140.     AnyWord (optionally) uses the DOS PATH to
  141.     find files, so specifying both A & B will allow
  142.     you to put your files in either drive.
  143.  
  144. For all users:
  145. 1.  Verify that you have a CONFIG.SYS file in your
  146.     root subdirectory or on the diskette that you
  147.     boot up with.  If you do not have a CONFIG.SYS
  148.     file, then you must create one.  The
  149.     instructions to do so are in your DOS manual,
  150.     but all that is actually required is that you
  151.     create a file with this name and put in the
  152.     ASCII text lines:
  153.       files=20
  154.       buffers=24
  155.  
  156. 2.  If you already have a CONFIG.SYS file, then
  157.     verify that you have specified files=20 (or some
  158.     higher number.) If not, then add it.
  159.     Recommended for better performance of DOS in
  160.     general:
  161.        buffers=24   (or some other number between 20
  162.              and 30)
  163. Getting Started with Finder
  164.  
  165.    If you have not already done so, copy the files
  166. on your distribution diskette(s) onto your hard disk
  167. or onto backup floppy disks.
  168.  
  169.    Finder requires a "profile" file for all file
  170. collections, indexed or not.  This profile file
  171. contains information that Finder needs to run.    For
  172. The Movie Database, the file is PROFILE.MOV.
  173. A sample profile, PROFILE.SMP is also included to
  174. help you create your own profiles.  (The simplest
  175. way to proceed on this is to make changes
  176. to a copy of one of our profiles.)  A profile
  177. file must be specified each time you run
  178. Finder, so the command from DOS to run Finder can
  179. be:
  180.   FINDER PROFILE.MOV
  181. or, more generically:
  182.   FINDER profilename.ext
  183.  
  184.    Before starting Finder, verify that the contents
  185. of F-FILES.MOV (or F-FILES.ext) specifies the
  186. correct drive and/or path name for each of your text
  187. files.    THe F-FILES file is normally created by
  188. Indexer and no further changes are necessary.
  189. However, if you have moved your files since Indexer
  190. was run, then you may have to correct their
  191. directory or drive designation in F-FILES.  (If your
  192. text files are in a subdirectory that has been
  193. specified with the DOS PATH command, then a drive or
  194. path name may not be required.)
  195.  
  196.    Once in Finder, you will find that many of the
  197. commands are self-explanatory.    There is also a Help
  198. file that you can access.  Keep in mind that you can
  199. try almost anything without worrying about making
  200. inadvertent changes to your text files, because
  201. Finder reads but does not write to your text files.
  202. The only exception to this try-anything rule is
  203. swapping diskettes in the midst of a Finder session.
  204. This is only permissible in certain circumstances.
  205. More on that in the "Files" section.
  206.  
  207.    The key to getting the most out of Finder is in
  208. controlling the Finder environment with either the
  209. profile or the [M]ode command.    For more on that,
  210. see the section "Controlling the Environment".
  211.  
  212.    Just to get you started, try this:
  213. ([ENTER] means press the Enter/Return key)
  214.   finder profile.mov [ENTER]
  215.    s
  216.    John Wayne [ENTER]
  217.    d [ENTER]
  218. AnyWord will find all references to "John Wayne"
  219. Each time you press:  d [ENTER]   you'll
  220. see the next reference, until there are no more.
  221. Use the Home, End, PgUp and PgDn keys to browse
  222. around in the file.  (The files you're looking at
  223. are LF, LN, and LZ.)
  224.  
  225.    There are options on the search and display
  226. commands, as well as other commands, but you'll
  227. probably be able to retrieve much of what you
  228. want by just knowing a few simple operations.
  229.  
  230.    Let's try another search, with more explanation.
  231.  
  232.    S
  233.        - to begin another search.  Finder will ask
  234.      you what you want to search for.
  235.  
  236.    1962[ENTER]
  237.        - to search for all references to
  238.      "1962" in the database.
  239.      Finder will report 6 references.
  240.  
  241.    D
  242.        - to display the results of your search.  Finder
  243.      will ask you which reference you want to look at.
  244.  
  245.    2/1[ENTER]
  246.        - to look at the first reference in your
  247.      search, which was the second search you did.
  248.      Finder will display the first movie it
  249.      found.
  250.  
  251.    D
  252.        - to do another display.  Finder will ask you
  253.             which one.
  254.  
  255.    2/2[ENTER]
  256.        - to look at the next movie.
  257.  
  258.    D
  259.        - to do another display.
  260.  
  261.    [ENTER]
  262.        - will automatically display the next
  263.      reference, in this case, set 2, element 3.
  264.  
  265.    S
  266.        - to do another search.
  267.  
  268.    Diane Keaton[ENTER]
  269.        -  to find Diane's movies.
  270.  
  271.    D
  272.        - to look at the results.
  273.  
  274.    3/1-3  ;l=a1[ENTER]
  275.        - will show you the titles of Diane's
  276.      movies.  (What this command means is:
  277.      display search set #3,elements 1 through
  278.      3, but just the first line of each.)
  279.  
  280.    If you're not used to this set/element concept,
  281. it may seem strange.  But after you've played around
  282. with the commands for a while, it'll become
  283. familiar.  Remember, you can't hurt anything by
  284. putting in the "wrong" command.
  285.  
  286.    If you have problems with a particular command,
  287. pressing the [Esc] key will generally bring you back
  288. to the command menu.
  289. Getting Started with Indexer
  290.  
  291.    Indexer is an independent program that analyzes a
  292. collection of text files.  The location(s) of each
  293. valid word in each file are assembled into a set of
  294. index files, for later use by the Finder lookup
  295. program.  (These files are described in detail in
  296. the Files Appendix.)
  297.  
  298.    Indexer is controlled by means of the "profile"
  299. file, samples of which are included on your
  300. distribution diskette, as PROFILE.MOV, PROFILE.HLP,
  301. and PROFILE.SMP.  (Your profile file can have any name.)
  302.  
  303.    Indexer is called from the DOS command line as:
  304.     INDEXER profilename.  E.g. indexer profile.mov
  305.  
  306.    All of the options used by Indexer are
  307. provided in the profile file.  These options are
  308. described in the Indexer Profile section and in
  309. the supplied profile themselves, as comments.
  310.  
  311.    You can run Indexer against your own text files
  312. with the sample profile, PROFILE.SMP.  A better way
  313. to go, though, is to spend some time studying the
  314. options so that you can create a profile that will
  315. maximize the usefulness of AnyWord.  Indexer
  316. can take all night to run (on a 1M byte database),
  317. so give it some thought before starting it up.
  318.  
  319.    While Indexer is running it will show you some
  320. statistics.  These are not necessary, but are
  321. presented for those of us who like to see what is
  322. going on during long programs.    Basically, Indexer
  323. will make 1-2 passes of each of your text files for
  324. each of the characters that you've specified in the
  325. profile.  (That's why it can take all night.) In its
  326. basic form, the numbers on the left of the screen
  327. show you memory usage while the numbers on the right
  328. half show you how much disk space is being used for
  329. the index files.  (The keyword file contains an
  330. entry for each unique word in your database; the
  331. location file contains an entry for each occurrence
  332. of each word.)
  333.  
  334.    Here are the steps you will have to take to start
  335. indexing files, once you've installed the software,
  336. modified CONFIG.SYS, if necessary, etc.  This is the
  337. minimum necessary:  (As you get more familiar with
  338. the system, you'll be making additional changes)
  339.  
  340.      1 - Starting with a copy of PROFILE.SMP
  341.      and using any text editor that can operate
  342.      with ASCII files and no tab characters,
  343.      change the FILES parameter in the profile
  344.      to specify the files you want indexed.  (It
  345.      currently refers to some sample files
  346.      included on the diskette.  If you wanted to
  347.      index all of the files in a particular
  348.      directory, you would use:
  349.           FILES=\dirname\*.*
  350.      If you wanted to index files called "abc"
  351.      and "xyz", then:
  352.           FILES=abc
  353.           FILES=xyz
  354.      If you have a floppy-based system and wish
  355.      to specify a drive designation, then:
  356.           FILES=B:\abc.ext
  357.           FILES=B:\*.cor
  358.  
  359.      If you wanted all of the files on a
  360.      particular diskette, then:
  361.           FILES=b:\*.*
  362.      (IMPORTANT: The backslash "\" MUST be
  363.      specified after a drive letter.)
  364.      If you have Wordstar files in "document"
  365.      mode, use:
  366.           WSFILES=filename
  367.  
  368.      2 - Recommended for floppy disk systems:
  369.      Set your DOS path to A & B.  That is,
  370.      enter:  path A:\;B:\
  371.      (Again, don't leave out the backslash.)
  372.  
  373.      3 - Run Indexer, specifying the sample Profile
  374.      file:    indexer profile.smp
  375.  
  376.      4 - Go out for lunch.  (The program will
  377.      take about 40 minutes to index 100K, about
  378.      8 hours to index 1M.) You'll know the
  379.      program is running because status
  380.      information on the screen will continually
  381.      be updated.
  382.  
  383.      5 - When you get back from lunch, you will
  384.      find a set of files in your current
  385.      directory -- unless you assigned them
  386.      elsewhere with the PLOC/PKEY/PFENCE/PDLM
  387.      parameters.  (See below.)
  388.  
  389.      These files will have, in size, about a 1:1
  390.      correspondence with your original text
  391.      files.  If this takes up more space than
  392.      you have available on a disk, then you will
  393.      have to juggle files.    For instance, you
  394.      can remove the program disk after the
  395.      program has been loaded or you can use a
  396.      RAM (virtual) disk or ....
  397.  
  398.      The biggest file is the location file, the
  399.      keyword file may be 1/3 of that, the fence
  400.      file, if the fencing (Record Option) was
  401.      selected, is 1/4 of the location file size.
  402.  
  403.      The following Profile parameters can be
  404.      specified to assign the output files to
  405.      appropriate drives or subdirectories.
  406.      For instance:
  407.        PLOC=C:\    prefix for location file
  408.        PKEY=C:\    prefix for keyword file
  409.        PFENCE=C:\    prefix for fence file
  410.        PTEMP=D:\    prefix for temporary work files
  411.        PDLM=C:\    prefix for delimiter file
  412.      Don't forget the backslash.
  413. System Flow
  414.  
  415.    AnyWord can be used in either of two ways:
  416. in the normal text lookup mode or in a special
  417. browse-only mode.  (You would use the browse-only
  418. mode when the text files have not been indexed.)
  419.  
  420.    Two examples are shown.  Both use sample files
  421. supplied on the program disk.
  422.  
  423.    This first example shows typical processing for
  424. doing lookups.    The second is a scenario for
  425. browse-only processing.
  426.  
  427. Look-Up Processing
  428.  
  429. Input to Indexer:
  430. 1. Text Files
  431.      lf
  432.      lz
  433.      ln
  434. 2. Stop list of words not to index
  435.      exclude.mov
  436. 3. Profile File
  437.      profile.mov
  438.       - containing:
  439.      SUFFIX=.mov
  440.      FILES=??.
  441.      INDEX=YES
  442.      ...
  443. _______________________________
  444.  
  445. C>  Indexer profile.mov
  446. _______________________________
  447.  
  448. Output from Indexer, input to Finder:
  449.     f-files.mov
  450.     f-ik.mov
  451.     f-ix.mov
  452.     f-tab.mov
  453.     f-fence1.mov (optional)
  454.     f-dlmloc.mov (optional)
  455.  
  456. Also output from Indexer but not used by Finder:
  457.     f-stats.mov
  458. And, the Help file:
  459.      f-help
  460. _______________________________
  461.  
  462. C>  finder profile.mov
  463. _______________________________
  464.  
  465. Output from Finder:
  466.   - Any extract files that you specifically create
  467.  
  468. Browse-Only Processing
  469.  
  470.    The alternate method of using AnyWord is to
  471. skip the indexing phase and just browse the files.
  472. (A simple character-by-character search is also
  473. available in this mode.)
  474.  
  475.  
  476. Input to Finder:
  477.  
  478. 1. Text Files
  479.      lf
  480.      lz
  481.      ln
  482.  
  483. 2. Help file
  484.      f-help
  485.  
  486. 3. Profile File
  487.      profile.mov
  488.       - containing:
  489.       SUFFIX=.mov
  490.       INDEX=NO
  491.       ...
  492.  
  493. 4. List of files to browse
  494.      f-files.mov
  495.  
  496. _______________________________
  497.  
  498. C>  finder profile.mov
  499. _______________________________
  500.  
  501. Output from Finder:
  502.   - Any extract files that you specifically create.
  503. Record Option (Fencing)
  504.  
  505.    Normally, AnyWord uses byte (character)
  506. offsets within a file to keep track of where a word
  507. appears.  Optionally, the system will also track
  508. what "record" a word is in.
  509.  
  510.    A record, as far as AnyWord is concerned, is
  511. anything between two markers (delimiters).  These
  512. markers can be any character or sequence of
  513. characters.  The Movie Database, for instance, uses
  514. two dots (..) to separate movie records.  These two
  515. dots appear after every movie entry so as to
  516. separate the information for one movie from
  517. that for another movie.
  518.       Plan 9 from Outer Space
  519.       skdjk
  520.       erioe
  521.       ..
  522.       Porky's
  523.       sdkfj
  524.       ekrer
  525.       ..
  526.  
  527.    Actually, because every line in the Movie
  528. Database ends with a carriage-return/line-feed
  529. (CR/LF) combination, the actual sequence of
  530. characters between two movies is:
  531.       [CR][LF][.][.][CR][LF]
  532. If you specify this sequence in the profile, then
  533. Indexer and Finder will always know where one record
  534. starts and the next begins.  This also means that
  535. the system will know where the first line of a
  536. record is, where the second is, etc.  This is used
  537. effectively in the Movie Database to find movie
  538. titles, because the title is always on the first
  539. line.
  540.  
  541.    The only requirements for a marker are that the
  542. character sequence be unique.  If the Movie
  543. Database had used two dots on a line by themselves
  544. for anything else, then the system would have
  545. gotten confused.
  546.  
  547.    A blank line can be used.  The actual sequence
  548. to specify, then, would be:
  549.    [CR][LF][CR][LF]
  550. You could use something like that on a file like
  551. this, where the paragraphs are separated by blank
  552. lines.    Each paragraph would then be a record.
  553.  
  554.    If your text files have two blank lines to
  555. separate sections, for instance, then this would be
  556. specified as:
  557.    [CR][LF][CR][LF][CR][LF]
  558. because every line, even null (blank) lines have a
  559. non-printable CR/LF on the end.
  560.  
  561.    Another possibility is the page separator
  562. used by some word processing software.    This
  563. might be the sequence
  564.     .pa  or
  565.     .bp  or perhaps
  566.     the formfeed character CTL-L.
  567.  
  568.    The marker you want to use is specified in the
  569. profile file.  See the Indexer Profile section for
  570. details.
  571. The Profile
  572.  
  573.    As with Finder, the profile file controls the
  574. way Indexer operates.  Three sample profile files are
  575. included with AnyWord:
  576.       profile.mov  - for use with the Movie Database
  577.       profile.hlp   - for use with the Help file
  578.       profile.smp  - as a prototype for your own use
  579.  
  580.    Profile files can have any name.  By convention,
  581. the ones supplied with AnyWord have the name
  582. "profile" with an extension designating the
  583. collection of files they pertain to.  You can, of
  584. course, establish your own convention, such as
  585. calling the movie profile:  movies.pro.  Picking a
  586. convention and sticking to it will make life easier.
  587.  
  588.    The same profile file is used by both Indexer and
  589. Finder.  That is, you set the profile file up before
  590. indexing your textbase and you specify the same file
  591. when you invoke Finder.
  592.  
  593.    The profile contains information that is used by
  594. Indexer only, other information used by Finder only,
  595. and still other information that is shared by both
  596. Indexer and Finder.  You can change any of the
  597. Finder-only information before doing a Finder run,
  598. but you should not change any of the shared
  599. information between running Indexer and running
  600. Finder.  That is, change the shared information
  601. only before running Indexer.
  602.  
  603.    The information in the profile is in the form of
  604. keyword parameters.  Indexer and Finder read this
  605. file when they start up and pull out the information
  606. they need.
  607.  
  608.    The parameters are specified according to the
  609. following rules:
  610. 1. Each parameter occupies a line by itself and
  611.    MAY NOT spill over onto another line.
  612. 2. Any line that starts with an * is a comment and
  613.    is not processed by Indexer.
  614. 3. Any text preceded by a space will be treated
  615.    as a comment.
  616. 4. Parameters may be supplied in any order.
  617. 5. Parameters must begin in column 1.
  618.  
  619.    The format is:  PARAMETER=value
  620.  
  621.  
  622. FILES
  623.      The FILES parameter is used to specify
  624.      which text files are to be indexed.  Any
  625.      valid DOS name is acceptable, including
  626.      wild card characters.    For instance:
  627.          FILES=\movies\??.
  628.      would index all files in subdirectory
  629.      "movies" that had a two-letter file name.
  630.  
  631.      There can be as many FILES statements as
  632.      necessary, though no more than
  633.      254 individual files can be indexed in
  634.      any one textbase.
  635.      For instance:
  636.           FILES=\autoexec.bat
  637.           FILES=*.c
  638.           FILES=a*.doc
  639.      Also legal:
  640.           WSFILES=xyz
  641.      for files that have high-order bits
  642.      turned on, e.g. Wordstar files in document
  643.      mode.
  644.  
  645.      Note:    If pathchecking is specified (see
  646.      below) and the files parameter looked like:
  647.           FILES=*.c
  648.      then Indexer would expect to find all of
  649.      the "*.c" data files in the same
  650.      sub-directory.
  651.  
  652.  
  653. PATHCHECK
  654.      If PATHCHECK=Y, the DOS PATH will be used
  655.      to find files.  That is, if a file is not
  656.      found in the current or specified
  657.      directory, it will be searched for in each
  658.      of the directories specified in your system
  659.      path.    (See the DOS manual for more
  660.      information about PATH.)
  661.  
  662. XFILE
  663.      Text file containing words that are not
  664.      to be processed, e.g.,
  665.          XFILE=exclude.mov
  666.      This "stoplist" is an ordinary ASCII
  667.      list of words, one word per line.
  668.  
  669. SUFFIX
  670.      All of the files created by Indexer will
  671.      have a common file extension.    For
  672.      instance, if you specify
  673.          SUFFIX=.mov
  674.      then the location file will be called
  675.      f-ix.mov, the keyword file will be
  676.      called f-ik.mov, etc.
  677.  
  678. FENCE
  679.      If FENCE=1, then the Record Option will be
  680.      used.    If FENCE=0, then it will not.  If
  681.      the record option is used, then the
  682.      MARKER parameter must be specified.
  683.  
  684. MARKER
  685.      This specifies the marker or delimiter used
  686.      to separate (fence off) records when the
  687.      Record Option is used.  The number
  688.      specified here is a menu selection number.
  689.      That is,
  690.          MARKER=1    means:    a blank line between
  691.                     records
  692.          MARKER=2    means:    two blank lines
  693.                     between records
  694.          MARKER=3    means:    two dots on a line
  695.                     by themselves
  696.          MARKER=4    means:    .pa on a line by
  697.                     itself
  698.          MARKER=5    means:    .bp on a line by
  699.                     itself
  700.          MARKER=9    means:    the CHAR parameter
  701.                     is used to
  702.                     specify the
  703.                     characters
  704.                     making up the
  705.                     marker
  706.  
  707. CHARn
  708.      If MARKER=9 is specified, then CHAR is used
  709.      to specify the exact characters, in hex,
  710.      making up the marker.    CHAR0 is the length
  711.      of the marker, CHAR1, CHAR2, etc., is
  712.      each character of the marker.    For
  713.      instance,
  714.  
  715.          MARKER=9       use CHAR parameters
  716.          CHAR0=6       3 characters:
  717.          CHAR1=0d       CR
  718.          CHAR2=0a       LF
  719.          CHAR3=0c       a form feed (CTL-L)
  720.  
  721.      This would make a record out of everything
  722.      from the beginning of a file up to a form
  723.      feed, the next record out of everything
  724.      from there to the next form feed, and so
  725.      on.
  726.  
  727. UPPER
  728.      If UPPER=Y, then the case of the text is
  729.      ignored.  That is, the text will be
  730.      internally converted to upper case
  731.      characters and indexed that way.  So, the
  732.      words COMPUTER and computer would be mixed
  733.      together and in Finder, a search would
  734.      turn up both.
  735.  
  736. PLOC
  737. PKEY
  738. PFENCE
  739. PTEMP
  740. PDLM
  741.      Several files are created by Indexer.
  742.      Normally, these files will be constructed
  743.      in the current disk and directory.
  744.      However, you can assign these files to
  745.      different disks or different
  746.      subdirectories.  For instance, if you had a
  747.      RAMDISK D:, you might want to specify
  748.          PTEMP=D:\
  749.      (The slash is important.) This would assign
  750.      the temporary work files to your RAMDISK.
  751.      Or perhaps you want to assign the location
  752.      file to subdirectory 'ABC'.  Then you would
  753.      specify:  PLOC=\ABC.  Whatever you specify
  754.      becomes a prefix for the file name.  So,
  755.      the full name of the location file in this
  756.      example would be:
  757.          \ABC\F-IX.LOC
  758.      The movable files are:
  759.          PLOC    - location file
  760.          PKEY   - keyword file
  761.          PFENCE - fence file
  762.          PTEMP  - temporary work files
  763.          PDLM   - delimiter file
  764.  
  765. ACTION
  766.      A particular action to be taken on each
  767.      character.  (Characters include letters,
  768.      numbers, punctuation, special codes, etc.)
  769.      The allowable specifications for a
  770.      character are:
  771.          I - ignore this character completely
  772.          K - process this character as a
  773.          unique value
  774.          S - process this character as a space
  775.          (blank)
  776.  
  777.      For instance, assume the following:
  778.          2D=I      (hex for '-')
  779.          2F=S      (hex for '/')
  780.          30=K      (hex for '0')
  781.  
  782.      (A complete set of hex characters and
  783.      typical K/S/I values are included in the
  784.      sample profiles.) So, the string:
  785.      000/000-0000 would be indexed as:  000 and
  786.      0000000 because the '/' is treated as a
  787.      space and would separate the string into
  788.      two words.  The '-' is ignored, i.e.,
  789.      treated as not there, so the 000-0000 is
  790.      run together.    Let's say, instead, that:
  791.      2F=K Now, Indexer will index 000/0000000 as
  792.      one string, because the '/' is treated as a
  793.      normal character.
  794. Interrupting Indexer
  795.  
  796.    Indexing a collection of files can take quite a
  797. while.    And, in this version, there is no way to
  798. terminate Indexer and have it later pick up from
  799. where it left off.  However, you can temporarily
  800. pause it, do some minor operation, such as a DIR
  801. command, and then let Indexer continue.
  802.  
  803.    By pressing [Esc] when Indexer is running, the
  804. program will pause and ask you what to do.  You then
  805. have three choices:
  806.     I - do nothing (return to Indexer)
  807.     D - temporarily jump out to DOS
  808.     Q - quit
  809.  
  810.  
  811. [I]
  812.   Selecting the [I] option simply allows
  813. Indexer to continue running.
  814.  
  815.  
  816. [D]
  817.    If you enter a [D], then DOS will get control.
  818. However, Indexer will remain in your PC memory and
  819. will be able to start back up when you type in the
  820. word "exit" on the DOS command line.  This is
  821. explained (somewhat) in your DOS manual, under the
  822. COMMAND command. (In the DOS 3.2 manual, it's
  823. p.7-53.)
  824.  
  825.    What is happening here is that a second copy of
  826. the DOS command processor has been loaded.
  827. Naturally, with this second copy, plus Indexer, in
  828. your system, the amount of memory you'll have
  829. available will be reduced.  (By roughly 150K, in
  830. this version.)    But this should still give you
  831. enough to use for many programs and all DOS
  832.  
  833. commands.  The big benefit here is that when you
  834. type in [exit], the secondary copy of DOS will go
  835. away and you'll be returned back to the point in
  836. Indexer where you left off.
  837.  
  838. NOTE:  You may interrupt Indexer as frequently as
  839. you desire.  Indexer remains in a suspended
  840. state until allowed to continue.
  841.  
  842.  
  843. [Q]
  844.   Pressing [Q] will permanently terminate this
  845. Indexer run.  All results will be discarded.
  846. FInder Command List
  847.  
  848.    All commands are entered by typing in the
  849. first letter of the command whenever the menu
  850. is on the screen.
  851.  
  852. Help
  853.     - Displays portions of this manual
  854.  
  855. Search
  856.     - Find an indexed word (or words)
  857.       among the text files
  858.  
  859. Display
  860.     - View the results of a search
  861.  
  862. Call
  863.     - Call a DOS command or other program
  864.  
  865. Interrupt
  866.     - Temporarily exit to DOS.
  867.       (Return is by typing EXIT)
  868.  
  869. Review
  870.     - Display past search results
  871.       (for this Finder session)
  872.  
  873. View
  874.     - Display all indexed words
  875.  
  876. Kill
  877.     - Free up memory for additional searches
  878.  
  879. Where
  880.     - Display the locations where the
  881.       search terms were found
  882.  
  883. Find
  884.     - Alternate search method: simple
  885.       string matching
  886.  
  887. Mode
  888.     - Change the Finder environment;
  889.       i.e. change how Finder works
  890.  
  891. Quit
  892.     - Terminate Finder
  893.  
  894.  
  895.  
  896.    The following keys also have special meaning:
  897.  
  898. PgDn
  899.     - Display the next text segment (the one after
  900.       the one that was most recently displayed)
  901.  
  902. PgUp
  903.     - Display the previous text segment (the one
  904.       that immediately precedes the most recently
  905.       displayed text page)
  906.  
  907. Home
  908.     - Display the first text segment in the database
  909.  
  910. End
  911.     - Display the last text segment in the database
  912.  
  913. Ctrl/Home
  914.     - Display the first text segment in
  915.       the current file
  916.  
  917. Ctrl/End
  918.     - Display the last text segment in
  919.       the current file
  920.  
  921. Ctrl/PgUp
  922.     - Display the first segment of the
  923.       previous text file
  924.  
  925. Ctrl/PgDn
  926.     - Display the first segment of the
  927.       next text file
  928.  
  929. Note:  The size of the segment to be displayed
  930. can be set via the profile file or the mode command.
  931. Remember that the number of bytes specified is HALF
  932. of what will be seen on the screen.
  933. Record Option (Fencing)
  934.  
  935.    Normally, AnyWord uses byte (character)
  936. offsets within a file to keep track of where a word
  937. appears.  Optionally, the system will also track
  938. what "record" a word is in.
  939.  
  940.    A record, as far as AnyWord is concerned, is
  941. anything between two markers (delimiters).  These
  942. markers can be any character or sequence of
  943. characters.  The Movie Database, for instance, uses
  944. two dots (..) to separate movie records.  These two
  945. dots appear after every movie entry so as to
  946. separate the information for one movie from
  947. that for another movie.
  948.       Plan 9 from Outer Space
  949.       skdjk
  950.       erioe
  951.       ..
  952.       Porky's
  953.       sdkfj
  954.       ekrer
  955.       ..
  956.  
  957.    Actually, because every line in the Movie
  958. Database ends with a carriage-return/line-feed
  959. (CR/LF) combination, the actual sequence of
  960. characters between two movies is:
  961.       [CR][LF][.][.][CR][LF]
  962. If you specify this sequence in the profile, then
  963. Indexer and Finder will always know where one record
  964. starts and the next begins.  This also means that
  965. the system will know where the first line of a
  966. record is, where the second is, etc.  This is used
  967. effectively in the Movie Database to find movie
  968. titles, because the title is always on the first
  969. line.
  970.  
  971.    The only requirements for a marker are that the
  972. character sequence be unique.  If the Movie
  973. Database had used two dots on a line by themselves
  974. for anything else, then the system would have
  975. gotten confused.
  976.  
  977.    A blank line can be used.  The actual sequence
  978. to specify, then, would be:
  979.    [CR][LF][CR][LF]
  980. You could use something like that on a file like
  981. this manual, where the paragraphs are separated by
  982. blank lines.  Each paragraph would then be a record.
  983.  
  984.    If your text files have two blank lines to
  985. separate sections, for instance, then this would be
  986. specified as:
  987.    [CR][LF][CR][LF][CR][LF]
  988. because every line, even null (blank) lines have a
  989. non-printable CR/LF on the end.
  990.  
  991.    Another possibility is the page separator
  992. used by some word processing packages.    This
  993. might be, for instance, the sequence:
  994.     .pa    or
  995.     .bp    or perhaps
  996.     the formfeed character CTL-L.
  997. The Finder Profile
  998.  
  999.    As with Indexer, the profile file controls the
  1000. way Finder operates.  Three of these profile files
  1001. are included with AnyWord:
  1002.       profile.mov  - for use with the Movie Database
  1003.       profile.hlp   - for use with the Help file
  1004.       profile.smp  - as a prototype for your own use
  1005.  
  1006.    Profile files can have any name.  By convention,
  1007. the ones supplied with AnyWord have the name
  1008. "profile" with an extension designating the
  1009. collection of files they pertain to.  You can, of
  1010. course, establish your own convention, such as
  1011. calling the movie profile:  movies.pro.  Picking a
  1012. convention and sticking to it will make life easier.
  1013.  
  1014.    The same profile file is used by both Indexer and
  1015. Finder.  That is, you set the profile file up before
  1016. indexing your textbase and you specify the same file
  1017. when you invoke Finder.
  1018.  
  1019.    The profile contains information that is used by
  1020. Indexer only, other information used by Finder only,
  1021. and still other information that is shared by both
  1022. Indexer and Finder.  You can change any of the
  1023. Finder-only information before doing a Finder run,
  1024. but you should not change any of the shared
  1025. information between running Indexer and running
  1026. Finder.  That is, change the shared information
  1027. only before running Indexer.
  1028.  
  1029.    The information in the profile is in the form of
  1030. keyword parameters.  Indexer and Finder read this
  1031. file when they start up and pull out the information
  1032. they need.
  1033.  
  1034.    The parameters are specified according to the
  1035. following rules:
  1036. 1. Each parameter occupies a line by itself and
  1037.    MAY NOT spill over onto another line.
  1038. 2. Any line that starts with an * is a comment and
  1039.    is not processed by Indexer.
  1040. 3. Any text preceded by a space will be treated
  1041.    as a comment.
  1042. 4. Parameters may be supplied in any order.
  1043. 5. Parameters must begin in column 1.
  1044.  
  1045.    The format is:  PARAMETER=value
  1046.  
  1047.    Many of the Finder parameters can be changed
  1048. while running Finder, by using the [M]ode command.
  1049. Those parameters will only be briefly mentioned here
  1050. with more detail in the Changing the Environment
  1051. section.
  1052.  
  1053. DRANGE
  1054.    - Display range: amount of text to show.
  1055.      Ex.:  DRANGE=8L
  1056.  
  1057. LIMIT
  1058.    - Number of characters between search terms.
  1059.      Ex.:  LIMIT=20
  1060.  
  1061. OR
  1062.    - Character to be used for OR searches.
  1063.      Ex.:  OR=|
  1064.  
  1065. AND
  1066.    - Character to be used for AND searches.
  1067.      Ex.:  AND=&
  1068.  
  1069. NOT
  1070.    - Character to be used for NOT searches.
  1071.      Ex.:  NOT=!
  1072.  
  1073. OPTIONS
  1074.    - Character on a command line that
  1075.      denotes optional information follows.
  1076.       Ex.: OPTIONS=;
  1077.  
  1078. RESULT
  1079.    - Character that indicates the following
  1080.      number is the number of a search set.
  1081.       Ex.:  RESULT=-
  1082.  
  1083. WILD
  1084.    - The character that will match any text
  1085.      character(s).
  1086.      Ex.:  WILD=?
  1087.  
  1088. WORDS
  1089.    - If Y, indicates that the words AND, OR, NOT
  1090.      will be reserved for internal use and will
  1091.      not be searchable.
  1092.      Ex.:  WORDS=Y
  1093.  
  1094. EXTRFILE
  1095.    - File into which extracted text will be
  1096.      placed.
  1097.      Ex.:  EXTRFILE=subfile.mov
  1098.  
  1099. EXTRTYPE
  1100.    - Indicates on what basis text extraction will
  1101.      be done.
  1102.      Ex.:  EXTRTYPE=N
  1103.  
  1104. INDEX
  1105.    - If YES, then Indexer has been (or will
  1106.      be) run on the files specified in the FILES
  1107.      parameter.  This will create the index
  1108.      files that Finder uses for looking up words.
  1109.  
  1110.      If NO, then Finder is to be used on
  1111.      files that have not been indexed.    The
  1112.      FILES parameter, which is used only by
  1113.      Indexer, will of course be ignored.
  1114.      Instead, a list of files (with no wild
  1115.      cards) must be put into a file called
  1116.      F-FILES.ext (where ext is specified by
  1117.      SUFFIX=).    Note: Without indexing,
  1118.      Search, Display and some other
  1119.      commands will not work.  However, you
  1120.      can still browse the files and use other
  1121.      commands such as [F]ind.
  1122.  
  1123. Function Keys F1 through F10
  1124.    - Assign a character string or special
  1125.      operation to a function key.
  1126.      Ex.:  F3=/1-10 ;l=a1
  1127.  
  1128. PATHCHECK
  1129.    - If Y, the DOS PATH will be used to find files.
  1130.      Ex.:  PATHCHECK=Y
  1131.  
  1132. SUFFIX
  1133.    - Filename extension used in this textbase
  1134.      for files created by Indexer.
  1135.      Ex.:  SUFFIX=.mov
  1136.  
  1137. FENCE
  1138.    - If FENCE=1, then the record option will be
  1139.      used, if FENCE=0, then it will not.  If the
  1140.      record option is used, then the MARKER
  1141.      parameter must be specified.
  1142.  
  1143. MARKER
  1144.    - If the Record (fencing) Option is used,
  1145.      this specifies what characters are used to
  1146.      separate (delimit) records, i.e., fence off
  1147.      each segment of text from other segments.
  1148.      See the Indexer Profile section for more
  1149.      information.
  1150.  
  1151. CHAR
  1152.    - The specification of the delimiter for the
  1153.      Record Option.  See the Indexer Profile
  1154.      section for more information.
  1155.  
  1156. UPPER
  1157.    - If all searches are to ignore the case
  1158.      of the text, then specify UPPER=Y, otherwise if
  1159.      lowercase characters are to be treated
  1160.      differently than uppercase characters, specify
  1161.      UPPER=N.
  1162.  
  1163. XFILE
  1164.    - The name of the file containing the list of
  1165.      words that have not been indexed.
  1166.      Example:  XFILE=exclude.hlp
  1167. Changing the Environment
  1168.  
  1169.    You can easily control many of the things that
  1170. AnyWord does.  The primary way to do this is
  1171. through the profile file, discussed elsewhere.
  1172. Another way, which you can do after the program has
  1173. begun running, is via the MODE command.  The MODE
  1174. command allows run-time access to things that would
  1175. normally be specified in the profile.  This lets you
  1176. change things on the fly as well as allowing you to
  1177. make temporary changes to the way AnyWord runs
  1178. without affecting future runs.
  1179.  
  1180.    The parameters that can be changed with the
  1181. [M]ode command are:
  1182.  
  1183. Display range
  1184.      The number of characters of text to display
  1185.      on each side of a search term when showing
  1186.      the results of a search.  If followed by an
  1187.      L, then it is the number of lines.  Zero
  1188.      (0) means display an entire delimited
  1189.      (fenced) record instead of a character
  1190.      count.
  1191.      Examples:  100  - 100 characters
  1192.              8L  - 8 lines
  1193.  
  1194. Limit
  1195.      The number of characters that search terms
  1196.      connected by an operand (AND, OR, NOT)
  1197.      must be within.  A zero means that the
  1198.      search terms must simply be within the same
  1199.      record.
  1200.  
  1201.      Example 1:  With limit at 20, a search for:
  1202.            Universit?  and Illinois
  1203.      would get:
  1204.            University of Illinois
  1205.      (The beginning of the word University is
  1206.      within 20 characters of the word Illinois.)
  1207.      It would also retrieve:
  1208.            universities in Illinois
  1209.      but would not retrieve:
  1210.            "universities and other institutions
  1211.         in Illinois"
  1212.  
  1213.      Example 2:  The reverse situation
  1214.      would hold for:
  1215.            Universit?  not Illinois
  1216.      This would not retrieve "Unversity of
  1217.      Illinois" but would retrieve "universities
  1218.      and other institutions in Illinois".
  1219.  
  1220. Fudge
  1221.      The number of characters that search words
  1222.      within one term can be within.
  1223.  
  1224.      Example:  search for University of
  1225.      Illinois with Fudge set at 15.  Assuming
  1226.      "of" is not a searchable word (i.e., it was
  1227.      specified in the exclude list), then the
  1228.      words University and Illinois must be
  1229.      within 15 characters of each other.  The
  1230.      results would then be the same as for a
  1231.      Limit set to 10, explained previously.
  1232.  
  1233. Marker
  1234.      The delimiter used for the Record
  1235.      Option ("fencing").  You will be prompted
  1236.      to enter a character string.
  1237.  
  1238. Pathcheck
  1239.      If Yes, then the subdirectories in the DOS
  1240.      PATH will be searched (if necessary) to
  1241.      find files.
  1242.  
  1243. And character
  1244.      The character, normally "&", to use for
  1245.      AND.
  1246.  
  1247. Or  character
  1248.      The character, normally "|", to use for OR.
  1249.  
  1250. Not character
  1251.      The character, normally "!", to use for
  1252.      NOT.
  1253.  
  1254. Set character
  1255.      The character, normally "-", to use to
  1256.      refer to a previous search set
  1257.  
  1258. Wild character
  1259.      The character, normally "?", to cause
  1260.      Finder not to match characters in the
  1261.      search argument past this point
  1262.  
  1263. Option marker
  1264.      The character, normally ";", to tell Finder
  1265.      that a special option follows on the
  1266.      command line
  1267.  
  1268. Reserved words
  1269.      The words AND, OR, NOT will be used in
  1270.      addition to the special characters defined
  1271.      for these functions.
  1272.  
  1273. Uppercase
  1274.      Yes, if all searches are to ignore the case
  1275.      of the text; No, if lowercase characters
  1276.      are to be treated differently than
  1277.      uppercase characters
  1278.  
  1279. Type of Extract
  1280.      If automatic, extracts all displayed text.
  1281.      If semi-automatic, asks before extracting.
  1282.      If manual, allows comments with each
  1283.      extraction.  Or none.    (With "none"
  1284.      specified, Extract will only be done with
  1285.      the ;E option or [E]xtract command.)
  1286.  
  1287. Com file drive
  1288.      The drive designation, e.g.  A, C, etc.,
  1289.      where your DOS COMMAND.COM file is located.
  1290.      (If not changed, will be the one specified
  1291.      in the DOS COMSPEC environment variable.)
  1292.  
  1293. Extract file
  1294.      File to be used for extracted text, unless
  1295.      over-ridden by the [E]xtract or [D]isplay
  1296.      commands
  1297.  
  1298. Index
  1299.      If No, then the filenames in f-files.xxx
  1300.      have not been indexed and only the
  1301.      browse/find commands will be operative on
  1302.      them.
  1303. Searching
  1304.  
  1305.    The [S] option off the main menu is used to do
  1306. text lookups.  Once you've pressed the "S", Finder
  1307. will prompt you for a search string and allowable
  1308. options.
  1309.  
  1310.    Finder uses the "set" concept of search and
  1311. retrieval.  That is, when you do a search, Finder
  1312. keeps a list of the places in the text where your
  1313. search word or phrase was located.  This list is
  1314. kept until you decide, with the [K]ill command, to
  1315. throw it away.
  1316.  
  1317.    For instance, let's say your first search was for
  1318. the word 'future' and that it appears 5 times in
  1319. your text files.  All 5 occurrences are called a
  1320. "set".  Let's say further that the first time it
  1321. appeared was in file abc, the second time in file
  1322. def, the third time in file ghi, and so on.  If you
  1323. just wanted to look at the word "future" in file
  1324. ghi, then what you would want would be the third
  1325. "element" in the first search set.  When you wanted
  1326. to display the text, you would specify this
  1327. particular appearance of 'future' as '1/3' -- set 1,
  1328. element 3.
  1329.  
  1330.    Let's say your second search would be for the
  1331. word 'past' and there are 9 occurrences of this word
  1332. in your files.    These words could be specified as
  1333. 2/1 through 2/9.
  1334.  
  1335.    Of course, the results for search set 1 are still
  1336. around and can still be retrieved or re-used.  With
  1337. this method, each place your requested word(s) have
  1338. been found will have a unique designation.
  1339.  
  1340.    When would you want to go back to the results of
  1341. a particular search?  If you wanted to look at the
  1342. results again, perhaps.  Or if you wanted to narrow
  1343. down a search.    Suppose for instance, that a search
  1344. for the word "future" reported 200 occurrences.  You
  1345. probably don't want to read all 200 text segments,
  1346. particularly if you're only looking for one in
  1347. particular.
  1348.  
  1349.    Maybe you're only interested in those text
  1350. segments where the word "future" also appears with
  1351. the word past.    You could do a search for:
  1352.       future and past
  1353. Or, you could do:
  1354.       -1 and past
  1355. What this means is:  use the results of search 1
  1356. as part of a new search.  This was a trivial
  1357. example, but you might see how this can be quite
  1358. powerful.  Because AnyWord "remembers" as many
  1359. as 100 search requests, some complex searches can be
  1360. done.  For instance:
  1361.  
  1362. Set #      Terms           Results
  1363. 1.     future not time     200 occurrences
  1364. 2.     -1 and past          11
  1365. 3.     -2 or Dickens          14
  1366. 4     Christmas           6
  1367. 5.     -3 and -4           2
  1368.  
  1369.    Just as an aside, for those who have used
  1370. a mainframe
  1371. search service, this is the same as:
  1372.   (((future not time) and past) or Dickens)
  1373.        and Christmas
  1374. With that method, it's easy to make errors with
  1375. the parentheses and get an erroneous result -- which
  1376. may not be spotted right away.    The method Finder
  1377. uses, which is modeled after Lockheed's Knowledge
  1378. Index, is more flexible and less error-prone.
  1379.  
  1380.    Multi-word searches are also possible.  For
  1381. instance, using the Movie Database for our examples,
  1382. 'Louis Gossett, Jr.' can be searched for.  Or Edgar
  1383. G.  Robinson.  'Edgar Robinson' would also produce
  1384. the same results, because Finder will match all the
  1385. Edgars with all the Robinsons, rather than doing a
  1386. match for a single piece (string) of text.
  1387.  
  1388.    Actually, Finder would have reported a match if
  1389. it found the string:  Robinson, Edgar G. -- because
  1390. the order of the search words doesn't matter to
  1391. Finder.  What does matter is the "fudge factor", set
  1392. in the Mode command, which can be used to control
  1393. how far afield Finder will go in trying to produce a
  1394. match.
  1395.  
  1396.    A single "wild-card" character is permissible per
  1397. search term.  (A "term" would be 'future' or 'Edgar
  1398. G.  Robinson' in the above examples.  'Debra Winger
  1399. & Nick Nolte' would be 2 search terms.  Note that
  1400. '&' is equivalent to 'and'.)  The wild-card
  1401. character, denoted by a '?', allows a match for
  1402. anything.  For instance, John?    would produce
  1403. matches for John, Johnson, Johnston, etc.
  1404.  
  1405.    You can specify the number of bytes (characters)
  1406. that search terms can be separated by.    This can be
  1407. specified in the Environment for an entire session
  1408. or on the search statement as ;R=nnn, For instance:
  1409.       winger & nolte ;R=50
  1410. would tell Finder to mark only text sections
  1411. in which these terms were separated by 50 bytes or
  1412. less.
  1413.  
  1414.    Searches can be restricted to particular lines
  1415. within records, if the Record (fencing) Option had
  1416. been used when the files were run through Indexer.
  1417. A semi-structured collection of text files, like The
  1418. Movie Database, might have particular information in
  1419. the first line of an entry (record), such as a
  1420. title.    You can therefore restrict your search that
  1421. way.  For instance, a search for:
  1422.       York ;L=A1
  1423. would return the movie entry with the title
  1424. "Sergeant York", but not any movies with Susannah
  1425. York.
  1426.  
  1427.    The semi-colon (;) above indicates that an option
  1428. follows.  (You can change all of the special
  1429. characters if you desire.)  The 'L' means a
  1430. particular line is requested.  The 'A' is always
  1431. present in this version of Finder.  The '1' means
  1432. that you want the search restricted to the first
  1433. line of a record.
  1434.  
  1435.    Another line option is ;L=S.  For instance,
  1436.        D & Woody Allen ;l=s
  1437. would mean that you wanted to select all movie
  1438. records with Woody Allen listed as the director.
  1439. Search Examples
  1440.  
  1441.    The following searches, using The Movie Database,
  1442. are marked by [OK] if legal, [BAD] if not legal.
  1443.  
  1444. 1. Debra Winger   [OK]
  1445.  
  1446. 2. winger and nolte  [OK]
  1447.  
  1448. 3. schwarz?   [OK]
  1449.       (Find all keywords starting with SCHWARZ)
  1450.  
  1451. 4. arnold schwarz?   [BAD]
  1452.       (Can't have multiple words & a wild card in
  1453.        the same search term)
  1454.  
  1455. 5. arnold and schwarz?    ;r=7    [OK]
  1456.       (An alternative to #4; the r=7 means
  1457.        the two terms must be within 7
  1458.        characters of each other.)
  1459.  
  1460. 6. woody allen & diane keaton    [OK] ("&" is "and")
  1461.  
  1462. 7. woody allen | diane keaton     [OK] ("|" is "or")
  1463.  
  1464. 8. woody allen ! diane keaton  [OK] ("!" is "not")
  1465.  
  1466. 9. allen & keaton & hemingway  [BAD]
  1467.       (Can't have more than 2 search terms/line)
  1468.  
  1469. 10. toshiro mifune   [OK]
  1470.  
  1471. 11. -9 & Akira Kurosawa    [OK]
  1472.       (Use the result of a previous
  1473.        search, search set #9)
  1474.  
  1475. 12. -11 & 1981     [OK]
  1476.       (Narrow a search down further)
  1477.  
  1478. 13. james ;l=a1    [OK]
  1479.       (To find the name James only on the
  1480.        first line of a record, which, in the
  1481.        Movie Database, is the title line)
  1482.  
  1483. 14. time & time ;l=s    [OK]
  1484.       (To find a movie with the word "time"
  1485.        repeated twice on the same line).
  1486.  
  1487. 15. Robert Redford ;l=a1   [BAD]
  1488.       (Can't do multiword search & line
  1489.        option together)
  1490.  
  1491. 16. james not -13  [OK]
  1492.       (To find james not on a title line)
  1493. Displaying Text
  1494.  
  1495.    Once text has been located with the [S]earch
  1496. command, you can use the [D]isplay command to view
  1497. it.  (See the "Browsing" section for additional
  1498. commands.)
  1499.  
  1500.    The [D]isplay command works on the same
  1501. set/element concept that [S]earch does.  That is,
  1502. using the Movie Database for an example, if
  1503. search set #1 reported 6 movies with Debra Winger,
  1504. you can view each separately by doing a display for
  1505. 1/1, 1/2, 1/3, etc.  You can also display them
  1506. continuously, e.g. 1/1-4.
  1507.  
  1508.    Another option lets you display only particular
  1509. lines of each record, e.g., 1/1-6 ;L=A1.  (The L
  1510. means line, the A means the first delimiter type,
  1511. always an "A" in this version of Finder, and the 1
  1512. means the first line of the specified records, which
  1513. for The Movie Database, would be the title of the
  1514. movie.    Please note that your files must have been
  1515. indexed with the Record Option in order to select
  1516. particular lines of particular records.)
  1517.  
  1518.    Using the [M]ode command lets you change the
  1519. amount of text that you can display at one time.
  1520. (You can also specify this in the profile file.)
  1521. Text display can be by record, by a character (byte)
  1522. count or by a line/paragraph count -- actually a
  1523. count of carriage returns.  For The Movie Database,
  1524. the delimiter display method is the default.
  1525.  
  1526.    Note:  if you set a value too low, you'll find
  1527. that the browsing functions will seem to be stuck.
  1528. In this case, just reset the display range to a
  1529. larger number.    Conversely, if the displayed text
  1530. consistently spills over to another screen, set the
  1531. range to a lower number.
  1532.  
  1533.    Displayed text can also be copied (extracted)
  1534. into other files.  This can be done automatically or
  1535. individually.  See the "Extracting Text" section and
  1536. the "Display Examples" section for further
  1537. information.
  1538. Display Examples
  1539.  
  1540.    The following examples show you how to
  1541. display the results of particular searches.  First,
  1542. press [D] from the main menu, then you will be
  1543. prompted for a set/element number.  Enter the
  1544. information and press [ENTER].
  1545.  
  1546. 1.
  1547.        (A null line, i.e., a RETURN/ENTER by itself.)
  1548.        Display the first or next element of the last
  1549.      (current) search set.
  1550.  
  1551.  
  1552. 2.  3
  1553.        Display the first or next element of set #3
  1554.  
  1555.  
  1556. 3.  4/2-5
  1557.        Display the 2nd through 5th occurrences of
  1558.      the search terms specified in set 4.
  1559.  
  1560.  
  1561. 4.  2/1-9  ;l=a1
  1562.        Display the first line of each of elements
  1563.      1-9 in set 2.
  1564.        (Assumes Record Option in use)
  1565.  
  1566.  
  1567. 5.  10/3  ;l=a2
  1568.        Display only the 2nd line of the third
  1569.      element in set 10.
  1570.        (Assumes Record Option in use)
  1571.  
  1572.  
  1573.  
  1574. 6.  1/1-999
  1575.        Display the full range of occurrences for
  1576.      set #1. (If there aren't 999 elements
  1577.      in set 1, then Finder will come back with
  1578.      the correct number.)
  1579.  
  1580.  
  1581. 7.  13/6  ;E=M
  1582.        Extract this text into a file and prompt
  1583.      for a file name and additional comments.
  1584.  
  1585.  
  1586. 8.  13/1-7  ;E=S
  1587.        Using a pre-selected file name and
  1588.      prompting you only for a yes/no, extract
  1589.      the text associated with elements numbered
  1590.      1 through 7.
  1591.  
  1592.  
  1593. 9.  15/10-30  ;E=A
  1594.        Without asking, extract all displayed text
  1595.      as it is put to the screen.
  1596.  
  1597.  
  1598.  
  1599. Some illegal display responses:
  1600.    0/1-999         (Set numbers start with 1)
  1601.    1/0-999         (Element numbers start with 1)
  1602.    5/1-8  ;E=A ;L=A1 (This version of Finder allows
  1603.               only one option per display
  1604.               command; if you need to set
  1605.               both, use the [M]ode command.)
  1606. Identifying Located Files
  1607.  
  1608.    After you've done a search, you may want to see
  1609. where the search term[s] were found.  For instance,
  1610. if a search for the word 'future' reports 100
  1611. occurrences in the database -- too many to look at
  1612. -- you may want to see which files the word was
  1613. found in.
  1614.  
  1615.     The [W]here command produces output that
  1616. looks like:
  1617.  
  1618. 4/1: at   703 (hex    2BF) within file OZ
  1619. 4/2: at  2001 (hex    7D1) within file TF
  1620. ...
  1621.  
  1622.  
  1623.    Here's what this means:
  1624.  
  1625. 4    - The number of the search set.
  1626. 1    - An element within the set.  There will be one
  1627.         line of output for each element (occurrence
  1628.         of the search terms) within the set.
  1629. 703    - The number of characters (offset) from the
  1630.         start of the file where the term(s) were
  1631.         found.
  1632. 2BF    - The offset, expressed in hexadecimal
  1633.         notation.  (This can be useful with other
  1634.         programs that let you access parts
  1635.         of a file by location.)
  1636. OZ    - The name of the file in which the search
  1637.         term(s) were found.
  1638.  
  1639.    Similarly, the second line of the output shows
  1640. you the second occurrence of the search terms.
  1641.  
  1642.    When you press [W] on the main menu, you will
  1643. be prompted for the number of a search set to look
  1644. at.  You may also specify a particular element or
  1645. range of elements, such as:
  1646.   2/1-10
  1647.   3/4
  1648. (This is similar to what you'd enter for the
  1649. [D]isplay command.)
  1650. Printing
  1651.  
  1652.    There are three ways to get a printout of what
  1653. Finder displays on the screen.
  1654. a) Shift/PrtSc
  1655. b) CTL/P  or CTL/PrtSc
  1656. c) Re-directing I/O
  1657.  
  1658.    At any time in the course of running Finder
  1659. you can press the Shift/PrtSc keys and send the
  1660. contents of the screen to your printer.
  1661.  
  1662.    If you want to run your printer simultaneously
  1663. with the screen display, then "toggle" the CTL/P or
  1664. CTL/PrtSc keys.  This is a little-known but very
  1665. useful feature of PC-DOS.  For instance, if you want
  1666. to print some text that your search has found, press
  1667. the CTL/P keys before the text starts to display on
  1668. your screen.  After the text has been displayed, you
  1669. can press those same keys again to turn the printer
  1670. off.  Of course, unless you have an extremely fast
  1671. printer, this will slow down the rate at which
  1672. output will be displayed on your screen.
  1673. Nonetheless, this method can provide a useful log of
  1674. your session.
  1675.  
  1676.    The third method is to redirect normal Finder
  1677. output to the printer when starting up the program.
  1678. Through DOS redirection, all text that Finder
  1679. locates can be automatically printed or saved into a
  1680. file or sent to another device, e.g., a
  1681. communications port.  This is done by starting
  1682. Finder with:
  1683.      finder profile.mov > LPT1:
  1684. or     finder profile.mov > out.mov
  1685. Extracting Text
  1686.  
  1687.    Anything in your text files that can be displayed
  1688. can be copied into new file(s).  For instance, let's
  1689. say that, using The Movie Database, you have done a
  1690. search for Edward Woodward and then displayed the
  1691. entry for "Breaker Morant".  You have also
  1692. specified, in your profile or with the [M]ode
  1693. command, that text is to be sent to file AMOV.TXT.
  1694. Now, if you select [E]xtract from the menu, the
  1695. information on "Breaker Morant" will be added to
  1696. file AMOV.TXT.
  1697.  
  1698.    You can use the same output file for each
  1699. extraction, or you can change output files when the
  1700. [E]xtract command asks you for a file name.
  1701.  
  1702.    You can also precede each data extraction with
  1703. comments or other information typed in from the
  1704. keyboard.  For instance, you could have typed in:
  1705.  
  1706. ===>  Australian movie about a Boer War
  1707.       incident.[ENTER]
  1708.       cf. "Gallipoli". [ENTER]
  1709.       [ENTER]
  1710.  
  1711. and this would go into the output file, followed by
  1712. the entry on "Breaker Morant".
  1713.  
  1714.    Extractions can also be done via the [D]isplay
  1715. command.  Within the profile, or using the [M]ode
  1716. command or in the [D]isplay command itself, you can
  1717. specify:  "manual", "semi-automatic" or "automatic"
  1718. extraction -- as well as "none".
  1719.  
  1720.    "Manual" means that Finder will ask you if you
  1721. want to extract the text every time a search element
  1722. has been displayed.  It will also ask you to enter
  1723. comments and a file name.  In semi-automatic mode,
  1724. Finder will only ask you if you want to perform the
  1725. extraction on a particular display or not; if yes,
  1726. it will be written into the same extract file as was
  1727. the previous.  In automatic mode, Finder doesn't
  1728. even ask -- it just copies the text into the
  1729. pre-selected file.
  1730.  
  1731.    Note:  Specifying a device, like LPT1:, instead
  1732. of a file name is perfectly legal, and would send
  1733. the extracted text to that device.  (LPT1: is the
  1734. printer connected to parallel port 1.)
  1735. Viewing Searchable Keywords
  1736.  
  1737.    The [V]iew command lets you look at all of the
  1738. words in the database that have been indexed.  You
  1739. can start at any point and continue for as long as
  1740. you like.  The number of times an indexed word
  1741. occurs in the database is displayed next to that
  1742. word.
  1743.  
  1744.    For instance, to see all the words starting with
  1745. 'b', just enter:  b[RETURN] when asked for a
  1746. starting point.  Press Esc when ready to stop.
  1747.  
  1748.    To see all of the words in the index, enter a
  1749. null line when asked for a starting point.  (A null
  1750. line is just the RETURN/ENTER key by itself, with
  1751. nothing proceeding it.
  1752.  
  1753.    Like the output of the Display command, the
  1754. output of View can be redirected to a file or to
  1755. another device, such as a printer.  For instance, if
  1756. you start Finder with:
  1757.      finder profile.mov > movielst
  1758. and then, when the menu comes up, press V, the list
  1759. of words will be written out to a file called
  1760. "movielst" (instead of being written to the screen.)
  1761. You will still get the "Press Esc or any other key
  1762. to continue" message.  Continue pressing a key
  1763. whenever this message comes up.  When the
  1764. complete list has been written out, the main menu
  1765. will return to the screen.
  1766.  
  1767.    Alternatively, like the output of the Display
  1768. command, you can press CTL-P or CTL-PrtSc at any
  1769. time to send the results of a View command to the
  1770. printer, in addition to seeing it on the screen.
  1771. (Press CTL-P or CTL-PrtSc again to turn off the
  1772. output to the printer.)
  1773. Reviewing Previous Searches
  1774.  
  1775.    All of the searches in a Finder session are kept
  1776. in memory.  You can look at the results of these
  1777. searches with the [R]eview command.
  1778.  
  1779.    Complicated searches can be built using the
  1780. results of previous searches.  See the "Search"
  1781. section for further information.
  1782.  
  1783.    The actual output of the [R]eview command might
  1784. look like:    (Using the Movie Database)
  1785.  
  1786. Set 1
  1787.      6 occurrences for Debra Winger
  1788.     13 occurrences for Nick Nolte
  1789.      1 occurrence for Debra Winger & Nick Nolte
  1790.  
  1791. Set 2  (Error)
  1792.      0 occurrences for L?
  1793.  
  1794. set 3  (Interrupted)
  1795.        100 occurrences for L?
  1796.        200 occurrences for B?
  1797.      0   occurrences for L? | B?
  1798.  
  1799. set 4
  1800.      1 occurrence for -1
  1801.      2 occurrences for John Steinbeck
  1802.      1 occurrence for -1 & John Steinbeck
  1803.  
  1804.    The search terms and results for each set are
  1805. listed.  If processing of a search did not go to
  1806. completion, then the set will be marked as being in
  1807. Error or having been Interrupted.
  1808.  
  1809.    The [R]eview command will prompt, like the
  1810. [D]isplay command, for the number of the set you
  1811. want to look at.  It will also accept a range, such
  1812. as 1-10, or the letter 'a' (for all sets).
  1813. Browsing Through Text
  1814.  
  1815.    Your "database" consists of a collection of
  1816. files.    Finder understands that and provides a
  1817. flexible means of browsing these files.  From any
  1818. starting place, you can navigate in any direction
  1819. within the database.  Your starting place is
  1820. determined by the last [D]isplay command you've done
  1821. or, if no [D]isplay was done, then the beginning of
  1822. the first file.  You can use the following keys to
  1823. navigate:
  1824.  
  1825.   PgUp    - previous record or text block
  1826.   PgDn    - next record or text block
  1827.   Home    - beginning of the database
  1828.   End    - end of the database
  1829.   Ctrl/Home    - beginning of the current file
  1830.   Ctrl/PgUp    - beginning of the previous file
  1831.   Ctrl/PgDn    - beginning of the next file
  1832.   Ctrl/End    - end of the current file
  1833.  
  1834.    The amount of text displayed on the screen, the
  1835. text block, depends on what has been set in the
  1836. environment, i.e., with the profile file or the mode
  1837. command.
  1838.  
  1839.    For instance, if the display range has been set
  1840. to 50, then 100 characters (approximately) will be
  1841. displayed.  If the range has been set to 0, then the
  1842. display will be one "record", e.g.  all of the text
  1843. between two delimiters.  You may find it more
  1844. convenient to specify a line count:  9L would show
  1845. 18 lines of text on the screen.  (Note:  the number
  1846. specified in the range is the number of characters
  1847. or lines BEFORE the midpoint and a similar number
  1848. after.    This was done to be compatible with the
  1849. [D]isplay command.
  1850.  
  1851.    It is possible to browse files other than ones
  1852. that have been indexed.  If you have run Indexer, a
  1853. file was created called F-FILES.ext, where "ext" is
  1854. a unique extension.  If you edit F-FILES.ext and add
  1855. additional files at the end, you will be able to
  1856. browse them.  Of course, none of the commands that
  1857. rely on indexing -- e.g.  search, display -- will
  1858. function will these added files.
  1859.  
  1860.    It is also possible to create an entire
  1861. collection of files, a "textbase" without indexing
  1862. it.  First, create a F-FILES.ext, where "ext" is a
  1863. unique extension.  Place into this file the names of
  1864. your unindexed text files (no wild cards).  Create a
  1865. profile file specifying:
  1866.     SUFFIX=ext     and
  1867.     INDEX=NO
  1868. in addition to the usual parameters.  Now you can go
  1869. into Finder specifying this profile and be able to
  1870. perform browsing operations, as well be able to use
  1871. the [F]ind command.
  1872. When Text Files Change
  1873.  
  1874.    Finder works best when the text files are static,
  1875. at least between Indexer runs.    But all is not lost
  1876. when you change your files without having a chance
  1877. to run Indexer on them again.
  1878.  
  1879.    Of course, if you add new text into a new file
  1880. then AnyWord's indexing won't be disturbed.
  1881. The second best thing is to add new text at the end
  1882. of existing indexed files.  This will not change the
  1883. locations of already indexed keywords.    (Of course,
  1884. in both cases, the new material won't be indexed.)
  1885.  
  1886.    New text that is substituted for old on a
  1887. character-for-character basis won't affect the
  1888. majority of your text, but the indexes will still
  1889. point to the old, deleted material.  The worst
  1890. thing, as far as maintaining usable indexes goes, is
  1891. to delete or insert material at the beginning of
  1892. files.    This will throw the indexes to everything
  1893. else in that file off by the number of characters
  1894. you've inserted or deleted.  Still, you can use
  1895. Finder to go to the approximate spot where it thinks
  1896. it located a search string and then browse
  1897. or use [F]ind to locate its exact position.
  1898.  
  1899.    Another solution, and one that I've used in a
  1900. crunch, is to save the original text files in a
  1901. separate subdirectory or on separate floppies.    Use
  1902. this set of text files with Finder, noting the
  1903. filenames and offsets of the found search terms.
  1904. Then use Finder (or other browse/edit program)
  1905. against the newest files, using these offsets.    This
  1906. allows you to narrow down a search pretty well
  1907. before locating the keyword in the new files.  You
  1908. can combine this approach with the technique
  1909. mentioned in the "Browse" section -- the names of
  1910. any unindexed file can be added to the end of the
  1911. f-files file.
  1912. Alternate Search Method
  1913.  
  1914.    O.K., you know something is in there somewhere,
  1915. but the Search command doesn't find it.  Maybe it
  1916. was excluded during the indexing process.  Perhaps
  1917. it's been added to the database after it was
  1918. indexed.  Perhaps you want to find something that's
  1919. not a complete word, but just a string of characters
  1920. that appear in the text.  Or maybe you just don't
  1921. believe the Search command works correctly.  (Shame
  1922. on you!)
  1923.  
  1924.    Well, wonder no more.  The [F]ind command
  1925. will accept your text string and try to match it
  1926. against the text in the database.  It will take
  1927. whatever you type in and, starting with wherever you
  1928. currently are in the database, will look for exactly
  1929. that text.  For instance:
  1930.  
  1931. F   The Who    will do a match for The[b]Who
  1932.                (where [b] is a blank)
  1933. F   ...     will do a match for three dots
  1934.                (an ellipsis)
  1935. F   porting    will find references to importing,
  1936.                exporting, etc.
  1937.  
  1938.    Each line or paragraph in the database is
  1939. individually searched.    Please note, because
  1940. searching is on a line by line basis, that the
  1941. search phrase can not span a [CR][LF]
  1942. (carriage-return/line-feed) boundary, even if CRs
  1943. and LFs are marked for keyword processing in the
  1944. profile.  (By "line" or "paragraph", we mean
  1945. anything delimited by CR/LFs.
  1946.  
  1947.    When [F]ind gets a match, it will display the
  1948. text surrounding the located string.  (The amount
  1949. that is displayed depends on the environment; i.e.
  1950. the DRANGE parameter set in the profile file or the
  1951. [M]ode command.) Having displayed the first
  1952. occurrence of the text, [F]ind will ask you whether
  1953. you want to go on.
  1954.  
  1955.    Note that this is a "brute force" character-by-
  1956. character search and that there is no way of
  1957. knowing how many occurrences of the search argument
  1958. you will find within the database.  You also need to
  1959. give it time to run, as this type of search can be
  1960. slow.
  1961.  
  1962.    Note also that if the current environment
  1963. specifies "uppercase", then case will be ignored
  1964. during the matching process.
  1965. Help
  1966.  
  1967.    Selecting 'H' from the menu loads the F-HELP file
  1968. and puts up a list of topics on the screen.  Select
  1969. a topic by striking its designated letter or number.
  1970. Use the Esc key to exit out of a particular topic
  1971. and put the topic list back up on the screen.
  1972. Strike Esc again, and you will go back to the main
  1973. menu.
  1974.  
  1975.    You can put your own information into Help, giving
  1976. you a useful means of recalling notes.    For instance,
  1977. you might want to put information about a specific
  1978. database into the help file.
  1979.  
  1980.    Because the Help file is a simple ASCII (text)
  1981. file, you can easily modify it using any text editor
  1982. that can read/write ASCII files and which will put a
  1983. "hard" carriage return at the end of each line.
  1984. This includes Edlin, PE, Edix, Wordstar
  1985. (non-document mode), PMATE, Brief, etc.
  1986.  
  1987.    All headings that show up on the Help screen are
  1988. taken from lines in this file with a form feed
  1989. (CTL-L) in the first column.  So, new headings can
  1990. easily be added and old ones changed or removed.
  1991.  
  1992.    Finder does not care what the order of the topics
  1993. is, so your only constraint is what will fit on the
  1994. Help screen.  Topic titles, for instance, can only
  1995. be 30 characters long and there can be no more than
  1996. 34 topics (2 columns of 17) total.  Reminder:
  1997. don't forget to take the border into account when
  1998. adding text:  restrict each line to 72 characters.
  1999. Freeing Memory
  2000.  
  2001.    As you do each search, Finder internally records
  2002. all of the text locations that match your search.
  2003. This location information is kept in memory for
  2004. potential use in later searches.
  2005.  
  2006.    If you reach a point where a search (or other
  2007. operation) fails because of a lack of memory, you
  2008. will probably want to get rid of any old search
  2009. results that you don't need.  Use the [K]ill command
  2010. to do this.
  2011.  
  2012.    By "killing" a search set, the memory devoted to
  2013. that set can be re-used.
  2014.  
  2015.    When prompted for a number, enter the number
  2016. of a search set that you don't need.  (In order to
  2017. free up enough memory for particular operations, you
  2018. may need to use the [K]ill command several times.)
  2019.  
  2020.    Use the [R]eview command to look at your previous
  2021. searches to see which ones you don't need to keep
  2022. around.
  2023. Interrupting Finder
  2024.  
  2025.    Normal Finder processing can be interrupted in
  2026. two ways.  The CALL command allows you to run a
  2027. program of your own choosing.  The INTERRUPT command
  2028. allows you to temporarily go to DOS, execute
  2029. whatever commands and programs you want to, and then
  2030. return to Finder with all of your previous search
  2031. results still intact.  Note:  either option requires
  2032. you to have enough memory space in your machine to
  2033. load the PC-DOS command processor (COMMAND.COM) or
  2034. its equivalent.
  2035.  
  2036.    The MODE command, with the 'C' option, allows you
  2037. to tell Finder that COMMAND.COM is on a different
  2038. drive from the one you booted with.  However, DOS
  2039. will still want to use the original COMMAND.COM, so
  2040. you may find, after using the INTERRUPT command,
  2041. that the new DOS session won't work quite the way
  2042. you expect.  Put another way:  if you don't need to
  2043. change the drive, don't.
  2044.  
  2045.    Two things you might want to interrupt
  2046. Finder to do are:
  2047. - look at a file with the DOS TYPE command
  2048. - run a second copy of Finder with a different
  2049.   textbase.
  2050. Calling Other Programs
  2051.  
  2052.    The [C]all command allows you to enter the name
  2053. of a program or DOS command, just as you would type
  2054. it in on the DOS command line.    This can be any
  2055. program.  The only restriction is memory.  You will
  2056. not have as much memory available as you would if
  2057. Finder were not running.  As with the [I]nterrupt
  2058. command, Finder stays in memory.  Unlike [I],
  2059. however, a second copy of the DOS command processor
  2060. is not loaded, so there will be somewhat more memory
  2061. available with [C]all than with [I]nterrupt.
  2062. Specifications
  2063.  
  2064. Text Capacity/Type
  2065. ------------------
  2066.    Maximum text per database:  1 MB (500K when Record Option used)
  2067.    Maximum number of files: 254
  2068.    Maximum text per file:  1 MB (500K when Record Option used)
  2069.    Maximum number of drives/subdirectories: 254
  2070.    Preferred file type: ASCII file or Wordstar document
  2071.    Secondary type (usable with limitations):
  2072.      WordPerfect, Microsoft Word, others
  2073.    Allowable text characters:  Any (binary 0 to binary FF)
  2074.    Maximum number of words beginning with the same character: 16384
  2075.  
  2076. Search Capabilities
  2077. -------------------
  2078.    Wild card:  for suffixes (e.g. "comput?" gets
  2079.      computer, computing, etc.)
  2080.    Mix a wild-card and multi-word terms in the same
  2081.      search statement: No
  2082.    Boolean operators:  AND, OR, NOT
  2083.    Proximity searches:    By number of characters
  2084.    Maximum number of terms (operands) per search
  2085.      request:  2 (e.g.  black cat and dog)
  2086.    Maximum number of operators per request:  1
  2087.    Maximum number of search options per request: 1
  2088.    Maximum number of words per search term: 20
  2089.    Maximum number of characters per word: 80
  2090.    Recombine previous search requests into more
  2091.      complex searches:  Yes
  2092.    Maximum number of search requests per session: 100
  2093.    Review previous search requests: Yes
  2094.  
  2095. Display Capabilities
  2096. --------------------
  2097.    In-context text display:  By number of lines,
  2098.      number of characters, or entire record
  2099.    Display instances of located text:  one at a time
  2100.      or range of occurrences
  2101.    Highlight located text:  First character (on most machines)
  2102.    Re-display previously located text: Yes
  2103.    View list of file names where word/phrase was located:  Yes
  2104.    Browse across multiple files: Yes
  2105.    Maximum number of occurrences of a word: 1000
  2106.  
  2107. Browsing Files
  2108. --------------
  2109.    Page Up/Down: Yes
  2110.    Go to beginning/end of current file: Yes
  2111.    Go to beginning of next/previous file: Yes
  2112.    Go to beginning/end of entire textbase:  Yes
  2113.    Paging options (e.g. PgDn) highlight
  2114.      search terms: No
  2115.  
  2116. Optional Record Processing
  2117. --------------------------
  2118.    Acceptable record separators:  any character or
  2119.      string of characters
  2120.    Maximum number of lines per record: 255
  2121.    Maximum number of occurrences per keyword for which
  2122.      record information will be kept: 576
  2123.  
  2124. Miscellaneous
  2125. -------------
  2126.    View alphabetical list of indexed words:  Yes
  2127.    Extraction of located text into new files:  Yes,
  2128.      automatically or one text segment at a time
  2129.    Ability to suspend operation to execute DOS commands:  Yes
  2130.    Ability to suspend operation to run other programs:    Yes
  2131.    Function keys: optional - user definable
  2132.    Ability to use DOS PATH to locate files: Yes
  2133.  
  2134. Indexing
  2135. --------
  2136.    Index all words in specified files:    Yes, except for
  2137.      user-modifiable (stop) list of words not to index
  2138.    Maximum number of words in the stop list:  500
  2139.  
  2140. User Customization
  2141. ------------------
  2142.    Re-define reserved words (e.g.  and, or, not, ?):  Yes
  2143.    Re-define concept of a "word" for special processing:  Yes
  2144.    Set proximity between multiple words in a search term:  Yes
  2145.  
  2146.  
  2147.  
  2148. Idiosyncrasies/Bugs
  2149. -------------------
  2150. 1. The 'OR' search operation may
  2151.    produce a match count larger than what
  2152.    you might expect.  That is, a search
  2153.    for:
  2154.     Clint Eastwood or Sondra Locke
  2155.  
  2156.    will count all of Eastwood's movies and
  2157.    all of Locke's movies -- thus counting
  2158.    some movies twice.
  2159.  
  2160. 2. Indexer has been known to occasionally incorrectly
  2161.    compute a line location when the Record Option is used.
  2162.    That is, when you do a Finder search that is
  2163.    restricted by line, you may occasionally miss a
  2164.    record because its line number is off by 1 or
  2165.    got incorrectly set to 0.  Also, keep in mind
  2166.    that only the first 500 occurrences for a keyword
  2167.    will have line information.
  2168.  
  2169. Files
  2170.  
  2171.    Several files, besides your own text files, are
  2172. required to run Finder.  These may be in the current
  2173. subdirectory or, unless pathchecking has been turned
  2174. off, in any of the subdirectories specified with the
  2175. DOS PATH function.
  2176.  
  2177. Required files:
  2178.  
  2179. profile file
  2180.      The file that contains the parameters and
  2181.      options that control both Indexer and
  2182.      Finder.  Detailed information on the
  2183.      profile can be found in the appropriate
  2184.      sections of this manual and also in the
  2185.      sample files, PROFILE.xxx.
  2186.  
  2187. F-FILES.ext
  2188.      The list of text files that have been
  2189.      indexed.  You may edit this file to change
  2190.      the drive and directory designation of a
  2191.      file, or to add additional non-indexed
  2192.      files at the end.  DO NOT remove file names
  2193.      or change the order of the files, or Finder
  2194.      will get confused.
  2195.  
  2196. F-IX.ext
  2197.      A file containing the locations in the
  2198.      text of the keywords.
  2199.  
  2200. F-IK.ext
  2201.      A file containing the keywords, the number
  2202.      of occurrences in the "database", and where
  2203.      in F-IX.ext those occurrences are.
  2204.  
  2205. F-TAB.ext
  2206.      A control file with information about the
  2207.      other files.
  2208.  
  2209. exclude file
  2210.      A list of words that are not searchable.
  2211.      This list should be built prior to using
  2212.      Indexer and should not be changed for
  2213.      Finder.  It is an ordinary text file, with
  2214.      each word to be excluded placed on a line
  2215.      by itself.
  2216.  
  2217. Optional files:  (These are not necessary to run
  2218.              Finder.)
  2219.  
  2220. F-DLMLOC
  2221.      If the Record option is being used, this
  2222.      file contains the location in the
  2223.      "database" of each record.
  2224.  
  2225. F-FENCE1
  2226.      If the Record option is being used, this
  2227.      file contains the record offsets
  2228.      of each keyword.
  2229.  
  2230. F-HELP
  2231.      The Help file.  This is an ordinary text
  2232.      (ASCII) file that you can modify to meet
  2233.      your needs.  See the Help section for more
  2234.      information.
  2235.  
  2236.    You do not need to have all of your text files
  2237. online at all times.  If you have only a
  2238. floppy-based system, for instance, you can load your
  2239. text files only as they're called for.  If you do
  2240. swap diskettes, however, you should write-protect
  2241. the diskettes by covering the write-notch.  This is
  2242. to ensure that if Finder accidentally terminates and
  2243. DOS tries to update the directory on your text
  2244. diskettes, that it will not be able to do so.
  2245. License
  2246.  
  2247.    Carefully read the following terms and
  2248. conditions.  If you do not agree with them, you
  2249. should not use the package.  Use of this software
  2250. package indicates your acceptance of the terms and
  2251. conditions.
  2252.  
  2253.    Eric Balkan, dba "Packet Press", hereinafter
  2254. "Publisher", provides this software and licenses
  2255. its use.  Your use of the software acknowledges
  2256. that you have read this agreement, understand it
  2257. and agree to be bound by its terms and conditions.
  2258.  
  2259.    You may use this software for any purpose,
  2260. subject to the following restrictions:
  2261. 1 - You may copy the contents of this diskette for
  2262.     yourself or for others, but the entire diskette
  2263.     must be copied without change;
  2264. 2 - You may charge for copies of this diskette, but
  2265.     not more than $8;
  2266. 3 - You may not modify any of the files on this
  2267.     diskette without the permission of the Publisher;
  2268. 4 - You may not incorporate this package, or any part
  2269.     of this package, in a commercial product, without
  2270.     prior arrangement with Packet Press.  (Typically,
  2271.     we will ask for a nominal royalty fee.)
  2272.  
  2273.    This license is effective until terminated.    You
  2274. may terminate it at any time by destroying the
  2275. software together with all copies.  The license also
  2276. terminates if you fail to comply with the terms and
  2277. conditions of this agreement.
  2278.  
  2279.    This software and accompanying documentation are
  2280. protected by United States copyright law and also
  2281. by international treaty provisions.
  2282.  
  2283.    The publisher makes no warranties in regard to
  2284. this software.    No claim is made that functions
  2285. contained in this software will meet your
  2286. requirements or that the software operation will be
  2287. uninterrupted or error free.
  2288.  
  2289.    In no event will the publisher be liable to you
  2290. for any damages, including any lost profits, lost
  2291. savings or other incidental or consequential
  2292. damages arising out of the use or inability to use
  2293. this software, or for any claim by any other party.
  2294.  
  2295.    This agreement shall be construed, interpreted
  2296. and governed by the laws of the state of Maryland.
  2297. you agree that this is the complete and exclusive
  2298. statement of this agreement which supersedes any
  2299. prior agreement or other communication between us on
  2300. this subject.
  2301. Registration
  2302.  
  2303.    The software on this diskette has been provided
  2304. on an honor system "try-before-you-buy" basis.
  2305. (If you paid less than $9 for this diskette,
  2306. your payment was simply for a duplication/handling
  2307. charge and for the diskette itself, not for its
  2308. contents.)
  2309.  
  2310.    As much as we'd like to provide this software
  2311. for free, its development took approximately 800
  2312. hours.    (That's 800 hours I could have spent making
  2313. some money to meet my mortgage payments.)  If you
  2314. like AnyWord and would like to continue using it,
  2315. then please pay for it.  Of course, this is all on
  2316. the honor system and we won't be checking up on
  2317. anyone.  However, if you do send us a check for
  2318. $35, you will be supporting our past and future
  2319. efforts in developing affordable information
  2320. retrieval software.  We'll also make it worth
  2321. your while.
  2322.  
  2323.    By sending in your $35, you will automatically
  2324. become a member of our AnyWord users group (AUG).
  2325. Members of AUG get:
  2326. - a $15 credit towards other products
  2327. - a free DOSCARD
  2328. - technical support for problems
  2329. - assistance and advice with particular applications
  2330. - programming support at a discount
  2331. - free bug fixes
  2332. - inexpensive update disks with new features
  2333. - other benefits from time to time.
  2334.  
  2335.    We also give bonuses to members when
  2336. they bring in other members.
  2337.  
  2338.    To join, just send us a check or money
  2339. order, with your name and address, and the AnyWord
  2340. serial number (which you can get by doing
  2341. SHOWID at the DOS prompt -- this is how we credit
  2342. whomever you got your disk from).  If you think you
  2343. will be distributing copies to others, give us your
  2344. social security number (or other identifier) as well,
  2345. so we can give you credit.  (And run MAKEID to record
  2346. your number on the disk.)
  2347.  
  2348.  
  2349.                   Eric Balkan
  2350.                   Developer/Publisher
  2351.