home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / clarion / showtree.zip / SHOWTREE.DOC < prev    next >
Text File  |  1989-04-13  |  2KB  |  52 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           Hi everyone!   This  is just a little program I threw together to
  8.           create a full  function/procedure  calling  tree  using Clarion's
  9.           cross  reference  files.    I  use  it to help me create maps for
  10.           overlays.
  11.  
  12.           There are a number of stipulations which must  be adhered  to for
  13.           the program to work properly.
  14.  
  15.           1.   The main  source file (APPNAME.CLA) and cross reference file
  16.                (APPNAME.XRF) must exist  in  the  current  directory.   The
  17.                program will  show the  tree on the screen as it is created,
  18.                as well as write it to a disk file (APPNAME.XRT).
  19.  
  20.           2.   The syntax for executing  ShowTree is  "ShowTree <appname>".
  21.                Make sure  you don't  add any file extension (and don't type
  22.                the quotation marks).
  23.  
  24.           3.   The XRF file and CLA file must have the same  filename.  For
  25.                example, your  CLA file cannot be called VIDEO1 if the first
  26.                line of the file  is  VIDEO  PROGRAM.    (That's  right, the
  27.                Clarion-supplied  VIDEO  example  would  not  work.)    This
  28.                shouldn't be a problem for most applications.
  29.  
  30.           4.   The XRF file must be complete and correct.   If  this is not
  31.                the case,  a recursive  loop may  occur and you will have to
  32.                re-boot to exit.
  33.  
  34.           ShowTree was written using Turbo C.  I haven't spent a great deal
  35.           of time  trying to  optimize the  code, so  don't expect it to be
  36.           really fast (Clarion's Crossrefer is much faster).  As well, I am
  37.           not certain  that the  code is  fully debugged.   I will probably
  38.           improve it in the future, but this is a start.  I  am including a
  39.           copy of  the source  code, but be forewarned:  there are very few
  40.           comments in the code,  so you  may have  trouble understanding it
  41.           (although I've  tried to use descriptive function names).  If you
  42.           have any  suggestions of  ways to  improve the  code, please feel
  43.           free to  leave me  a note on the board; I'm always pleased to get
  44.           feedback of any kind.
  45.  
  46.           I hope this helps  some  people  out  there.    If  you  have any
  47.           questions, just  send me  a message  or call me at (306)777-4461.
  48.           Happy CLARIONing!
  49.  
  50.           -=> Mike Hanson <=-
  51.  
  52.