home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource1 / xref / history.doc < prev    next >
Encoding:
Text File  |  1993-12-27  |  6.2 KB  |  187 lines
  1.  
  2.  
  3.  
  4.              - Xref Version 3.1 - HISTORY.DOC -
  5.  
  6.  
  7.             Changes and updates:
  8.  
  9.             Version 2.01
  10.  
  11.             o    Did some tweaking, and reduced the program size about
  12.                  35% and increased execution speed about 15%.
  13.  
  14.             o    Fixed a small bug in the function tree output. Also,
  15.                  function names are now output in the order they are
  16.                  referenced in the function.
  17.  
  18.             Version 3.0
  19.  
  20.             o    Fixed a small bug that sometimes tagged a global
  21.                  variable's type in a function listing as being
  22.                  "unknown" when it really wasn't.
  23.  
  24.             o    C xref now looks for the "res_word.txt" file in the
  25.                  same directory it is run from. Before it looked in the
  26.                  default directory.
  27.  
  28.             o    Removed the limit on the number of include files deep
  29.                  that C xref will open. It will now open files until the
  30.                  system runs out of handles, at which time it tells you
  31.                  that it is unable to open the file.
  32.  
  33.             o    Improved (at least I think so) the output of the local
  34.                  and global variables in the "function" section. Got rid
  35.                  of the module name where a global variable originates
  36.                  (I didn't think that it was really necessary here), and
  37.                  made the line numbers for the local variables line-up
  38.                  like the global variables do.
  39.  
  40.             o    Improved the "function tree" output section by making
  41.                  it put a blank line between function calls that fall
  42.                  directly below each other in the same column.
  43.  
  44.             o    C xref can now cross-reference many more modules at one
  45.                  time. C xref creates a temporary file in the directory
  46.                  that C xref is run from, and saves most of the
  47.                  function's information in it, which frees a lot of
  48.                  memory. (I cross-reference over 1/2 meg. of source code
  49.                  without running out of memory.) If you still run out of
  50.                  memory, and you are cross- referencing header files,
  51.                  try it without the headers (header files make a lot of
  52.                  global declarations, which are kept in memory and are
  53.                  not saved to the temporary file. This can use a lot of
  54.                  memory).
  55.  
  56.             o    Struct variables are now labeled with their tag type,
  57.                  when possible, instead of [struct].
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                             HISTORY Information   Page 1
  64.  
  65.  
  66.              - Xref Version 3.1 - HISTORY.DOC -
  67.  
  68.  
  69.             o    The only C++ compatiblity enabled at this time is that
  70.                  C++ keywords and comments (i.e. "//") are ignored. C++
  71.                  compatiblity will be added in a future update.
  72.  
  73.             o    The RES_WORD.TXT file has been updated to include all
  74.                  ansi C and C++ key words.
  75.  
  76.             o    If a function name is over 20 characters long, then it
  77.                  is truncated when it is output in the "CALLS" section
  78.                  of the "FUNCTION" report. When this occures, the
  79.                  truncated name will be followed with three elispses.
  80.                  [i.e. {filename.c}Very_very_long_na...()]
  81.  
  82.             o    You can now format the output in the verbose function
  83.                  listing with the '-f' command. The command recognizes
  84.                  C's standard formatting commands, '\f' and '\n'. A
  85.                  space must separate the command and the format string,
  86.                  and no spaces should appear in the formatting string.
  87.                  For example:   -f \n\n\n This command would output
  88.                  three newlines after each function's cross- reference.
  89.  
  90.             Version 3.0a
  91.  
  92.             o    A list of a function's input parameters is now included
  93.                  in the verbose cross-reference listing. It follows the
  94.                  "CALLS" section.
  95.  
  96.             o    Functions that have no line of origin are no longer
  97.                  referenced in the verbose listing or the function tree
  98.                  output. (They continue to be referenced in the function
  99.                  summary, however.)
  100.  
  101.             o    The wild card character "*" can now be used in the
  102.                  RES_WORD.TXT file. Operates the same as with DOS
  103.                  filenames.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                             HISTORY Information   Page 2
  126.  
  127.  
  128.              - Xref Version 3.1 - HISTORY.DOC -
  129.  
  130.  
  131.             Version 3.1
  132.  
  133.             o    If a header file command line included a path name
  134.                  (i.e. #include "c:\text\myheader.h") C xref ignored it.
  135.                  Fixed that. C xref will now use the path if given.
  136.  
  137.             o    In the same vein, added a new command (-p
  138.                  path;path;...) that lets you input alternate search
  139.                  paths. These paths will be searched when looking for C
  140.                  modules and header files.
  141.  
  142.             o    Eliminated the "P" (path names) command that follows
  143.                  the "-i" command. No longer needed because of above.
  144.  
  145.             o    Added the "-o" command. This command allows you to
  146.                  output in the verbose and tree sections those functions
  147.          that have no line-of-origin.
  148.  
  149.         o    To save memory (and loading time) when not cross-
  150.          referencing Windows' programs I split the RES_WORD file
  151.          into a C file (RES_WORD.TXT) and a "Windows" file
  152.          (WIN_RES.TXT). The WIN_RES file is only loaded when the
  153.          "-m" command is entered (the RES_WORD file is always
  154.          loaded). The "-m" command also improves the tree output
  155.          for Windows' programs. The calling hierarchy is output
  156.          for the "WinMain" procedure and for any procedure
  157.          name(s) that are assigned to a WNDCLASS structure (i.e.
  158.          wndcls.lpfnWndProc = WindowProc).
  159.  
  160.         o    Changed the program's name to "Xref," because I
  161.          discovered that there is another cross-reference
  162.          program that uses the name "C xref."
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                             HISTORY Information   Page 3