home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / txtutl / look4_28.arc / LOOKFOR.DOC < prev   
Encoding:
Text File  |  1988-09-27  |  4.9 KB  |  100 lines
  1. TITLE OF PROGRAM: LOOKFOR.COM (version 2.8).
  2.  
  3. UTILITY: Search text files for words and phrases that may be
  4. connected with AND and OR relationships.  Display pertinent areas of
  5. text in easily readable format.
  6.  
  7. MACHINE REQUIREMENTS: PC, XT, AT, PS/2 running under DOS 2.0+.
  8.  
  9. DESCRIPTION: Enter a search query consisting of multiple words or
  10. phrases.  ORs and ANDs are treated as logical relations and are not
  11. searched for as words themselves unless they start or end a query.
  12. They may be replaced by the marks "/" and "+", respectively which
  13. likewise have only logical significance when embedded in a query.
  14. Parentheses have no logical effect.
  15.  
  16. The wildcard character "*" may be used as a prefix for the first
  17. word of any search term i.e. "*comput or *process" will find the
  18. occurrences of "microcomputer, minicomputer, compute, computer,
  19. computations, microprocessor, multiprocessor, processing", etc.
  20.  
  21. Ending a search term with a surplus " " (space) will require that
  22. the term end at that point in the text with a nulled character
  23. (i.e. space, control code, punctuation, etc).  Thus, "*a" will
  24. find all words containing the letter "a" or "A" whereas "*a  "
  25. will find only the words ending in "a" or "A".
  26.  
  27. The search query may be entered on the command line at the system
  28. prompt.  That is, "LOOKFOR this or that and the other thing".
  29.  
  30. Files of nearly unlimited size may be searched, or, if no search
  31. query is entered, files may be viewed from their beginnings.
  32. .COM, .EXE, and .ARC files are not searched.  When answering the
  33. prompt to enter a filename to search, the default drive and
  34. directory may be changed by entering commands in standard DOS
  35. format.  Pathnames and the wildcards "*" and "?" may be used with
  36. the filenames.  Thus, all files in a directory may be
  37. sequentially searched with pauses for viewing the files with
  38. "hits".  Searching resumes when the "+" key is pressed.
  39.  
  40. A directory of files may be obtained using the ordinary DOS
  41. syntax at the filename input prompt.  The program returns to the
  42. prompt upon return from the directory showing.
  43.  
  44. When viewing text, scrolling and paging are permitted.  The words
  45. searched for are highlighted.  Highlighting may be turned off and
  46. on by pressing the <-> key.  Unshifted <PrtSc> may be used to
  47. obtain a printout with the top and bottom screen data omitted.
  48. The words searched for are highlighted.  Highlighting may be
  49. turned off and on by pressing the <-> key.
  50.  
  51. LOOKFOR's character set is the same as that of the host computer
  52. except all spaces, punctuation, control codes, and some non-
  53. alphabetic graphics codes are nulled out and ignored.  Also, all
  54. lower case letters are translated to upper case to prevent
  55. case-sensitivity in the search.  If a literal search must be
  56. made, the translation table can be changed to restore nulled or
  57. altered characters, but for general use this is extremely
  58. inefficient.  The control codes ASCII 0 to 32 (including the
  59. space) are permanently nulled and may not be searched for. The
  60. translation table is pre-configured based on IBM's Multilingual
  61. character code page 850.
  62.  
  63. Press <F1> at the prompt to view and modify the translation
  64. table.  Letters with diacritic marks should be translated to
  65. upper case following the instructions presented.  If the
  66. appropriate language keyboard is not installed, depress the ALT
  67. key while entering a character's decimal code on the numeric
  68. keypad.
  69.  
  70. Included with the table configuration procedure is the option of
  71. displaying or not displaying graphics characters (codes 128-255).
  72. Some word processors use certain graphics characters for control
  73. codes, and it is desirable to not display them.  Also, the range
  74. of text within which the ANDed expressions must occur is
  75. adjustable from the setup menu.
  76.  
  77. When the table is modified, the changes may be used and
  78. optionally rewritten into LOOKFOR.COM.  Do not rename this
  79. program.  Also, be sure another LOOKFOR.COM does not exist in the
  80. current directory or it will be altered in a rewriting attempt.
  81. The choice on the graphics display option and the AND range will
  82. be saved with the translation table if the save option is
  83. selected.  Otherwise, the changes will be in effect only until
  84. the program is terminated.
  85.  
  86. The <ESC> key may be used to escape any of LOOKFOR's program
  87. functions.
  88.  
  89. If you cannot get highlighting with LOOKFOR when using a
  90. monochrome display, the common reason is that your screen at the
  91. system level does not have the standard monochrome attribute
  92. (07h or 70h).  This can happen if a PROMPT command specifies
  93. color or if a previous program leaves a color attribute on exit.
  94. Correct the prompt command and do a CLS before running LOOKFOR.
  95.  
  96. AUTHOR: David L. Trafton, 6309 Stoneham Rd, Bethesda, Md. 20817.
  97. Copyright 1988.  Free distribution is permitted.  If LOOKFOR is
  98. adopted for use, the price per individual user is $10 to the
  99. author.
  100.