home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug028.arc / FIND2.DOC < prev    next >
Text File  |  1979-12-31  |  2KB  |  75 lines
  1.     FIND.ASM    VERSION 2.0    10/05/82
  2.  
  3.     Requires MAC for Assembly
  4.  
  5.     ORIGINALLY WRITTEN BY WARD CHRISTENSEN
  6.     ENHANCED AND REWRITTEN BY RICH ANGELO - 10-05-82
  7.  
  8.     'FIND's ASCII, character strings in a file.
  9.  May take a generic file name, thus may search all *.ASM files
  10.  on a disk.  Also very useful for finding things in MAST.CAT - 
  11.  for example if you are looking for all MODEM or BYE Programs
  12.  you could FIND MAST.CAT MOD|BYE TO see them all.
  13.  
  14.     Another useful function is for Documentation. For example;
  15.  
  16.     Print all of this, enter:    FIND FIND.ASM *;
  17.  
  18.     Print Mainline comments,    FIND FIND.ASM *>
  19.  
  20.     Print Subroutines comments,    FIND FIND.ASM *S>
  21.  
  22.     Or try this,            FIND FIND.ASM *>|*S>
  23.  
  24.     Print Macros used,        FIND FIND.ASM *M>
  25.  
  26.  Documenting a Program in this fashion is an easy way to seperate
  27.  comments from code. There are many ways to Identify a portion of
  28.  a Program.  Maybe a standard can be established, that we all can
  29.  share. This is the first step in that direction.
  30.  
  31.         Any comments use,
  32.         One of the Popular Chicago area RBBS or CBBS Systems.
  33.  
  34.                 Rich Angelo
  35.  
  36.     Used with  LIST.COM  which  takes a starting line number,
  37.  you can:  1)  use  find to find a particular part of the code,
  38.  then 2) use LIST specifying a starting line number just before
  39.  the part of the code you wanted to see.
  40.  
  41.     Note that  FIND  now has a DEFAULT File Name and the ability
  42.  to PROMPT for SEARCH STRING. This feature is handy if you want to
  43.  search for specific characters only, whereas entering the  search
  44.  string on the command line will display both upper and lower case.
  45.  
  46.     Special Search features of FIND are;
  47.  
  48.     1.    Make "_" match a Tab
  49.     2.    Make "|" AN "OR"
  50.         AS IN: FIND B:*.ASM  _IN_|_OUT_
  51.  
  52.  
  53.     COMMAND FORMATS;
  54.  
  55.     FIND        <--- Defaults to Filename In DFLTNAM.
  56.             Will Prompt for Search String Lower Case Valid.
  57.             Also will search for any character seq. passed
  58.             thru CPM Read String Function.
  59.  
  60.     FIND fn.ft    <--- Prompt for Search String.
  61.  
  62.     FIND fn.ft str    <--- Will Display Upper & Lower Case of string
  63.             Using File specified.
  64.  
  65.     fn.ft may be Ambiguous, *.ASM OR CBBS*.ASM
  66.  
  67.  
  68.   Thats about all I have for now. I want to give thanks to all the SYSOPs
  69. and Program  Authors that have contributed to the  Public Domain Network,
  70. From which came most of the good programs that I use.
  71.  
  72.                         Rich Angelo
  73.                         Lisle, Il.
  74.  to the  Public Domain Network,
  75. From which came most of the good progr