home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / dev / misc / adoc / changes < prev    next >
Text File  |  1995-04-13  |  5KB  |  133 lines
  1.  
  2. ------------------------------------------------------------------------------
  3.               CHANGES since adoc-0.17 beta 3 (the first release)
  4. ------------------------------------------------------------------------------
  5.  
  6.  
  7. Tue Mar 21 22:13:37 1995
  8.  
  9.   * Autodoc default was `--preserve-order' and there was no switch to
  10.     sort the entries.  ADOC now sorts the entries by default as documented.
  11.  
  12.  
  13. Wed Mar 22 14:32:27 1995
  14.  
  15.   * Removed the undocumented "hidden feature" which allowed combining
  16.     `-1 -o file' to `-o1 file'.
  17.  
  18.   * `--revision' replaces `--edition' and `--edition' now does what it says:
  19.     it defines the REVISION macro.
  20.  
  21.   * `-h' option qualifier added to avoid line breaks on 80 column terminals:
  22.  
  23.       `-h0'   prints only the "usage:" string
  24.       `-h1'   prints only the "short" options (those with one `-')
  25.       `-h2'   printd only the "long" options (those with two `--')
  26.  
  27.     `-h' alone defaults to `-h3' which prints both "long" and "short" options"
  28.  
  29.  
  30. Thu Mar 23 12:58:38 1995
  31.  
  32.   * Added the `-Y' option which allows autodoc comments to begin in any column.
  33.     (They normally have to begin in column 1).
  34.  
  35.     There is no checking yet whether or not the indentation is equal in every
  36.     line of the comment.  (Do we really need that?)
  37.  
  38.   * There is only one warning now for lines in autodoc comments without a white
  39.     space after the first column black character.  These lines are ignored.
  40.  
  41.   * A (char *)0 reference has been fixed which happened in case of an 
  42.     unterminated comment at the end of a file.
  43.  
  44.   * Added `-u' option which allows the removal of the body text indentation.
  45.     This is useful in texinfo mode because the texinfo @example block is
  46.     indented automatically.
  47.  
  48.     Warning: This option removes *all* white spaces at the beginning of a line
  49.              and that might destroy your textual layout.
  50.              This is why this option is not documented and might be removed in
  51.              future revisions.
  52.  
  53.  
  54. Fri Mar 24 13:24:46 1995
  55.  
  56.   * Added `-j' option which might be what you need instead of `-u'.  (-:
  57.  
  58.   * Adoc now replaces the the leading "black" character of body text lines with
  59.     a single space if the black character is followed by a space.  Otherwise
  60.     (if it is followed by a TAB or a NL) adoc only removes the back character.
  61.     This guarantees an equal indentation of body text lines indented with tabs
  62.     and those indented with spaces.  (This was a bug until today)
  63.  
  64.  
  65. ------------------------------------------------------------------------------
  66.                             CHANGES since adoc-0.18
  67. ------------------------------------------------------------------------------
  68.  
  69.  
  70. Fri Mar 24 20:40:49 1995
  71.  
  72.   * Made the period `.' a legal character for an identifier in the comment
  73.     header.  This allows headers of the form
  74.  
  75.                   /****** myfirst.library/greatfun *******...
  76.  
  77.   * Wrote the CODA tool which is now distributed together with adoc
  78.     CODA converts autodocs to C language comments which allows further
  79.     processing with ADOC
  80.  
  81.   * Found another DICE bug which caused crashes on my system :'(
  82.  
  83.            z=((++x) % y)      is not equal to      x++; z= x%y
  84.  
  85.  
  86. Sat Mar 25 10:55:21 1995
  87.  
  88.   * ADOC now adds an untitled section if there is text without a section
  89.     heading at the beginning of an autodoc comment.
  90.  
  91.   * added the `-Z' option which avoids writing the "Function Index" in
  92.     `--texinfo' mode.
  93.  
  94.  
  95. ------------------------------------------------------------------------------
  96.                             CHANGES since adoc-0.19
  97. ------------------------------------------------------------------------------
  98.  
  99.  
  100. Mon Apr  3 17:14:12 1995
  101.  
  102.   * Fixed a bug in the scanner's strip() function which did not remove all
  103.     white spaces from a string which consists entirely of white spaces.
  104.  
  105.   * Documented the @w{} cheat which allows TeX to break the page inside
  106.     indented paragraphs in @example and @smallexample blocks.
  107.  
  108.   * ADOC now uses malloc() instead of of realloc() for initial allocations.
  109.     (This was a problem in a SUN's libc.a)
  110.  
  111.   * References to library @chapter nodes are now recognized by the SEE ALSO 
  112.     parser.  (New problem for the user:  A reference `f' to a function `f' 
  113.     in a library `f' will come out as a reference to the library `f'.  The 
  114.     function can be refered to as `f/f'.)
  115.  
  116.   * Some changes in the texinfo header have been made, especially the page 
  117.     numbering on the title page has been removed and double sided page 
  118.     numbering has been forced for the rest of the document.
  119.  
  120.  
  121. ------------------------------------------------------------------------------
  122.                             CHANGES since adoc-1.01
  123. ------------------------------------------------------------------------------
  124.  
  125. Wed Apr 12 21:47:05 1995
  126.  
  127.   * Now using a space character instead of a slash `/' or a period `.' or a
  128.     colon `:' as a seperator between library and function name because of 
  129.     problems with makeinfo and makeguide which seem convert some slashes in 
  130.     @node names to dashes and some not and then get in trouble later... hmpf!
  131.  
  132.   *
  133.