changelog

Doc++,可以根据你的C/C++和java的源码文件中的注释行自动生成Html说明文件的工具

        echo 'subscribe my@email' | mail [e-mail]

1998/08/21
   - A full version, Beta-3.3 / 3

1998/08/20
   - Spent the last 1.5 days chasing a daft compiler bug, fixed the source
     so it works with our compiler...

1998/08/18
   - Cut down java TOC to just packas, classes and interfaces.
   - Removed loads of debug
   - Set default option to kill or stick in 'General' file all children
     of root that don't have their own page.
   - Centralised doc/memo output in html.cpp, removing tiresome redundancy.
   - Made the '-J' switch turn HTMLsyntax on.
   - Fixed method declarations to remove redundant class specifier that was
     slipping through eg.
        class name {
          name::method() ;
        };
     method no longer drags a redundant 'name::' prefix with it.

1998/08/18
   - Spent today struggling with java, it seems to be a little broken. The
     different results from parsing the java sourcetree backwards & forewards
     were due to bracket miscounting / poison sources.
   - Major flex change in java.l
   - Killed most general rules, they are the devils tool :-)
     /* This bracket doesnt matter now { */
   - Added a string / char state to handle:
     char a = '{' ;
     String b = new String ("/** Hello") ;
   - Spent a while hunting and fixing:
     /* Isn't it nasty when you start a char initialiser on your isn't */
     char a = '\'' ;
   - Added support for C++ style comments ie. '//'
   - Fixed trivial bug in name of HIERjava file I had introduced.
   - Onwards with getting the '-J' : Javadoc compatibility flag a bit neater.

1998/08/14
   - Added macro 'worthDoing' to findSub such that only the names of entries
     with section CLASS_SEC | UNION_SEC | PACKAGE_SEC | INTERFACE_SEC are
     searched.
   - Fixed bug in environment variable handling, was missing the last argument
   - Removed 'dmsg' routine and calls from cpp.yy, perhaps this'll accelerate
     parsing.
   - Fixed the cache from yesterday, now names are copied into the cache.
   - Turned Gif generation off by default ( this never worked for me )
   - Started looking at the problems my mods have caused Java
   - Added a hash of java keywords
   - Re-wrote my list / sorting mods to deal with heirarchical package display.
   - Noticed the java stuff is somewhat suboptimal, the -J flag doesn't do a
     good job of javadoc compatibility. Will spend time on this.
   - Noticed wierdness with reversing the (originaly alphabetic) order of
     arguments when in java mode, this gets things 'Well wrong' TM.
     Perhaps this is due to some cunningness I've just noticed in findSub that
     assumes they are sorted ? ...

1998/08/13-Evening
   - Tried to test the doc++ automatic manual generation with no success :-(
   - Fixed a bug I'd introduced fixing the fix to a bug I thought I'd
     fixed. Now I hope both array initialisations, and plain numeric ones
     work ( they seem to )
        int variable[]= { 1, 2, 3 };
        int numeric = 3 ;
   - Fixed bug in finding comments after semi-colons, would swallow the 'c'
     in char:
        void function();char anotherfunction();
   - Very slow building list, so implemented several speedups in makeHtml
     and Entry.cpp::getRefEntry.
   - Removed bad speedup in findStubs from yesterday.
   - Changed StrToHtml to check for a null string sent to it before jumping
     into reams of flex.
   - Changed StrToHtml's arguments to take a refence to a McString for rapid
     checking of string lengths.
   - Attacked getRefEntry, examined its typical arguments, and discovered most
     of them were reserved words.
   - Implemented fast McHashTable to quickly remove these without a
     long-winded search.
   - Added a cache of the last few names looked up and whether they were
     found, this catches a large proportion of lookups.
   - Added a check against 'General' entries, these shouldn't have links to
     them anyway as they don't have their own page, their page is huge, and
     there are so few real references versus a huge number of bogus finds.
     This approx. doubled the speed of the doc++ run, from 20->11 secs.

1998/08/13
   - Overhauled the argument parsing bits, now using a McDArray of char*
   - Added support for arguments in the environment variable 'DOC'
   - Noted that readfile's directory handling looks nasty, but is prob.
     too fragile to play with.
   - Profiled code, little success but added a cache that accelerates half
     of findSubs.
   - Removed loads of debugging guff that was coming out all over the place

1998/08/12
   - Made type names appear in General.html, strangely they wern't
   - Fixed stupid flex error, in handling bit widths.
   - Updated index output, such that methods with the same name and class
     are merged, before emitting the duplicate method class list ( in some
     cases this removes the need for one ).
   - Fixed support for whitespace after a #define line continuation eg:
        #define A this_is_line_1 \      \n
        this_is_line2

1998/08/11
   - Discovered several bugs I had introduced thinking I was fixing things
     eg. Array initialisation and removed them. 
   - Fixed / extended syntax to remove altogether statements of the form:
        extern any_declaration (newlines?) ("C") { } ;
   - Fixed bit width specifiers, although this will probably break all other
     name parsing in a subtle way:
        int register_a : 2;
   - Removed limit of 200 characters in 'myOpen' that had escaped me.
   - Fixed loss of type in:
        int a, b, c
     Now we get 'int a', 'int b' ... in the output instead of 'int a', 'b', ...
   - Fixed bug in code I added to search for comments after #defines, since
     I'm not interested in defines removed this.
   - Fixed so that whitespace after a protection declaration works eg.
        private   :
   - Created an extra flex state to remove trailing semicolons after braces
     without generating a blank entry. eg.
        void method() { printf ("Foo") ; };
   - Implemented duplicate resolution in the index, and revised the index
     output system. Now duplicates get a seperate sub list, with a heading of
     the method name, and the class names as links. This still produces odd
     results with lots of overloaded constructors.
   - Added a fast command line parameter, that sacrifices memory re /
     de-allocation for speed.

1998/08/10
   - Spent all morning chasing obscure buffer overflow, caused by some
     'extern' nastiness in the flex ( I think ), anyway resovled to
     erradicate all arbitary buffer sizes...
   - Added large memory saving, of truncating McDArrays ( as used in all
     strings ) to a length of 1 ( carriage null ) when they are cleared
     as opposed to wasting that memory.
   - Today I realised that August is the 8th month.

1998/07/07
   - A big tar-ball of dirty sources ... I am using / testing:
        doc++ -g -l -d html -p -A -c -q <filenames>

1998/07/06
   - A new patch, this time adding support for simple post method comments
     in class instances ie.
        void method(int an_arg) ; // Hello there
     Will be commented with 'Hello There', this means a load of legacy
     comments can be used without conversion.
   - Forward class declarations eg.
        // Declared lower down
        class cForwardClass;
     are now ignored.
   - A new file 'General.html' is being generated which in future will hold
     all the bits we don't know much about eg. '#defines', global variables,
     constants etc.

1998/07/05
   - First patch against version 3.2. This is very alpha code, implementing
     the Quantel extensions for folding comments, and fixing the odd mis-feature.

1998/07/04
   - Put up small list of improvements / un-understood bits to start on
     after code read.

1998/07/03
   - Started code reading and noting bugs as yet uncovered to fix. First
     stop -Wall


   Revision 3.4  1998/07/31 09:31:29  bzfzoeck
   ChangeLog now in doc++ format

   Revision 3.3  1997/10/11 10:59:18  bzfzoeck
   small bug

   Revision 3.2  1997/10/11  10:16:50  bzfzoeck
   Fixed filenames on pages recursively included.
   Fixed " ... method() const;"-bug
  
   Revision 3.1  1997/02/12 10:40:37  bzfzoeck
   Version 3.01. @Param und @return funktionieren jetxt auch
   fuer globale Fkt. Added -m switch.

   Revision 3.0  1997/02/04 17:49:57  bzfzoeck
   released Version 3.0

   Revision 1.7  1997/02/04 16:52:40  bzfzoeck
   *** empty log message ***

   Revision 1.6  1997/02/04 15:17:45  bzfzoeck
   Tech@ Release (3.0).

   Revision 1.4  1997/01/15 11:59:50  bzfwunde
   - improved LaTeX environment for gifs using doc2tex parser.

   Revision 1.3  1996/12/29  13:37:31  bzfzoeck
   bug fixes.

   Revision 1.2  1996/12/16 10:45:11  bzfzoeck
   now really

   Revision 1.2  1996/06/07  15:05:43  bzfzoeck
   McHandable.h:
   Smart pointers are implemented.

   Revision 1.16  1996/11/20 16:13:22  bzfwunde
   Bug fixes mainly in java parser.  Did not parse comments correctly.

   Revision 1.14  1996/11/14 14:10:57  bzfwunde
   Bug fixes: SoPlex documentation now works!

   Revision 1.15  1996/11/18  08:49:24  bzfzoeck

   Revision 1.14  1996/11/14  14:10:57  bzfwunde
   Bug fixes: SoPlex documentation now works!

   Revision 1.13  1996/11/13 14:17:23  bzfwunde
   JavaDoc style comments for C++, C and Java
   New C/C++ parser using only flex

   Revision 1.12  1996/10/15  17:11:37  bzfwunde
   lots of improvements ... at least for the LaTeX output and the
   java and C++ parser.

   Revision 1.12  1996/08/08  16:00:18  bzfzoeck
   McDArray.h:
   replaced realloc(0,size) by malloc.

   Revision 1.11  1996/10/14  15:52:46  bzfwunde
   - fixed Java-parser bug
   - added version etc output for TeX

   Revision 1.11  1996/07/16  13:49:02  bzfstall
   McDArray.h:
   Documentation updated.

   Revision 1.10  1996/10/11  21:03:42  bzfzoeck

   Revision 1.10  1996/07/01  09:44:31  bzfzoeck
   McDArray.h:
   Added static to the declarations of index and rindex to prevent
   the linker from complaining about multiple defined symbols.

   Revision 1.9  1996/10/07  11:46:41  bzfzoeck
   Not yet perfect, but java inheritence is kind of implemented.

   Revision 1.9  1996/07/01  09:15:17  bzfstall
   McDArray.h: Added global template functions index() and rindex().

   Revision 1.8  1996/10/07  09:44:45  bzfzoeck
   These are generated automatically.

   Revision 1.7  1996/10/07  09:40:46  bzfwunde
   java parser included :-))))

   Revision 1.6  1996/09/12  11:29:13  bzfwunde
   completely rewritten parser for C++.
   This one is way easier to understand and contains fewer bugs.

   Revision 1.6  1996/06/17  16:38:32  bzfzoeck
   McDArray.h:
   Very simple string class added.

   Revision 1.2  1996/08/08  16:00:21  bzfzoeck
   McHashTable.h:
   replaced realloc(0,size) by malloc.

   Revision 1.2  1996/06/09  10:15:09  bzfzoeck
   Major changes: doc++ no longer uses dataarray but McDArray instead.
   - now can handle directories correctly.
   - now handles some very simple(!) regular expressions,
     namely anything that looks like '*.h' or '*.hh' or '*dxx' ...

   Revision 1.1.1.1  1996/06/03  17:01:59  bzfzoeck
   Initial doc++ repository

   Revision 1.1  1996/10/12  20:43:27  bzfzoeck
   McHashTable.cc:
   Ist auch im mclib repository drin !

   Revision 1.1  1996/07/17  15:27:06  bzfstall
   McHashTable.cc:
   Hash table added.

Thu Mar 19  1996 ( release 1.05 (beta) ):
      * Fixed bug with C comments /*@{*/ and /*@}*/

Thu Feb 29  1996 :
      *	Added JAVA scripts for generating class graphs in HTML output
      *	Added docify programm
      *	Bug fix for classgraphs with private base classes

Fri Feb 15  1996 ( release 1.04 (beta) ):
      * redesigned class graph generation.
      * New structure of HTML contents page.
      * bug fix for #s in memo strings.

Thu Feb 15  1996 :
      * fixed bug that made some entries disappear in some occations
        for the TeX backend

Wed Feb 14  1996 :
      * fixed bug with character '%' in TeX-documentation
      * changed documentation accordingly

Wed Jan 31  1996 ( release 1.03 (beta) ):
      * fixed a bug with the new shortcuts /**   and //*

Tue Jan 30  1996 ( release 1.02 (beta) ):
      * added options -eo -ef -ep for controlling the LaTeX environment
      * fixed internal bug causing assertation failiour on DOS machines
      * constructors and destructors of baseclasses do no longer show
        up in the HTML-list of inherited members.
      * started a FAQ
      * structs are now treated in the same way as classes 
      
Mon Jan 29  1996 ( release 1.01 (beta) ):
      * renamed doc++.sty -> docxx.sty
      * renamed html-table of contents from classesHIER.html -> HIER.html
      * introduced shortcuts:
        "/// " or "/*/ " for @ManMemo:
        and
        "//* " or "/** " for @Doc:
      * new command line option for short filenames (required for DOS).
      * bugfixes:
        * The & should no longer disapear in HTML.
        * Declarations like 
          array<foo,bar> dummy; should work now.
        * German umlauts like \"a are now converted to HTML.

Wed Jan 25  1996  release 1.0 (beta)