home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / c / c2man-2.0pl33.lha / c2man-2.0 / CHANGES < prev    next >
Encoding:
Text File  |  1995-01-14  |  4.0 KB  |  128 lines
  1. Version 1.1:
  2.     This was the first release, so there were no changes yet.
  3.  
  4. Version 1.2:
  5.     The README in 1.1 incorrectly stated that c2man was public domain. It
  6.     is in fact copyright, but freely redistributable. See the updated
  7.     README for details.
  8.  
  9.     You can use flex instead of lex now.
  10.  
  11.     Comments on parameters in old-style function definitions work OK now.
  12.  
  13.     Generates man pages for global variables (with -v) as well as
  14.     functions.
  15.  
  16.     Major mods to parser to support comments at the end of lines; this
  17.     makes it much more tolerant about comment placement.
  18.  
  19.     c2man will now parse its own source!. The manual pages it generates are
  20.     pretty bad since the comments haven't been strategically placed, but
  21.     it's better than you might expect without trying.
  22.  
  23.     Rewrote a lot of the manual page to make it comprehensible.
  24.  
  25. Version 1.3:
  26.     Ignores all comments in included files, except those in enum
  27.     specifications; this should virtually eliminate trouble with errors in
  28.     files you may have no control over, like system headers.
  29.  
  30.     Add "-o -" functionality to write manual pages to stdout.
  31.  
  32.     Run /lib/cpp when reading from stdin too.
  33.  
  34.     Rewrite comment parsing to be neater & easier to modify.
  35.  
  36.     Replace -DSYSV option with its inverse -DBSD so ANSI string functions
  37.     are used by default.
  38.  
  39.     enum tag/description spacing in output varies automatically.
  40.  
  41.     Sprinkle output heavily with Bold for troff.
  42.  
  43. Version 1.4:
  44.     Recognise that an end-of-line comment after a function definition or
  45.     declaration applies to the last parameter of a function, so we handle:
  46.  
  47.         /* try to do something that requires 2 parameters */
  48.         int try(int a,    /* description of first parameter */
  49.             int b);    /* description of second parameter */
  50.  
  51.     Fix comment lexing problem that sometimes rejected the '# ...' lines
  52.     that cpp generates on the line immediately after a comment.
  53.  
  54.     Don't capitalise n/troff dot commands.
  55.  
  56.     make -V option act verbosely.
  57.  
  58.     By popular demand, added -G option to group manual pages from the
  59.     same file together, ala ctype(3).
  60.  
  61.     Output function prototype on a single line for all functions with one
  62.     or less parameters (ignoring -f...).
  63.  
  64. Version 1.5:
  65.     Recognise end-of-line comments after K&R style function parameters.
  66.  
  67.     Specify C-preprocessor command in Makefile and add -P option to specify
  68.     a different preprocessor at runtime.
  69.  
  70.     Add -g option like -G, but read the terse description from the file.
  71.  
  72.     Don't disable nroff line filling in SYNOPSIS section so very long lines
  73.     still get broken.
  74.  
  75.     Require a white-space after a period before capitalising the next
  76.     letter. i.e. Don't damage "i.e.".
  77.  
  78. Version 1.6:
  79.     Don't reduce pointer-to-pointers down to a single indirection level;
  80.     eg: "char **argv" got output as "char *argv". Ugh!.
  81.  
  82. Version 1.7:
  83.     Don't try to free a string constant right at the very end!.
  84.  
  85.     Rename old -i option to -H, and add new -i option so user can specify
  86.     extra #include lines for the SYNOPSIS section, and prerequisites for .h
  87.     file compilation.
  88.  
  89.     Work around Sun acc -E problem where .h files were ignored.
  90.  
  91.     Semantic change: multiple input files all get cross-referenced in the
  92.     SEE ALSO section (or grouped together if -g or -G).
  93.  
  94. Version 1.8:
  95.     Add -lPW I'd dropped from HPUX configuration.
  96.     
  97.     Fix multiple -i arguments appearing on the one line.
  98.  
  99. Version 1.9:
  100.     Fix silly missing fprintf arguments in c2man.c
  101.  
  102.     Ignore trailing spaces after a comment at the end of a line.
  103.  
  104.     Don't error on "typedef int NewType; NewType a;"
  105.  
  106.     -Ssection option added by jerry@kesa24.kesa.com (Jerry E. Dunmire).
  107.  
  108. Version 1.10:
  109.     Accept comments around a final ellipsis parameter.
  110.  
  111.     Make parameter declarations in the prototype and the PARAMETERS section
  112.     identical.
  113.  
  114. Version 2.0:
  115.     Major modifications to use Configure for easy installation.
  116.  
  117.     Many, many portability fixes; converted to K&R 1 C.
  118.  
  119.     Accept stdin even if preprocessor doesn't.
  120.  
  121.     Don't error on:        int fred() {
  122.                 } /* fred */
  123.  
  124.     Allow extra manual page sections not recognized by c2man.
  125.  
  126. From version 2.0 onwards, the change log for each patch is contained in the
  127. top of the patch itself.  This file is no longer updated.
  128.