----------------------------------Release 1.3.0RC4--------------------------------- We didn't up this all that well but the changes are: - Switched to Smarty 2.6.0, now it will work in PHP 5. Other changes made to the code to make it work in PHP 5, including parsing of private/public/static/etc. access modifiers - fixed these bugs: [ not entered ] XMLDocBookpeardoc2 beautifier removes comments [ 896444 ] Bad line numbers [ 937235 ] duplicated /** after abstract method declaration [ 962319 ] Define : don't show the assigned value [ 977674 ] Parser error [ 989258 ] wrong interfaces parsing [ 1150809 ] Infinite loop when class extends itself [ 1151196 ] PHP Fatal error: Cannot re-assign $this [ 1151650 ] UTF8 decoding for DocBook packages [ 1152781 ] PHP_NOTICE: Uninitialized string offset in ParserDescCleanup [ 1153593 ] string id="...." in tutorials [ 1164253 ] Inherited Class Constants are not displayed [ 1171583 ] CHM wrong filesource [ 1180200 ] HighlightParser does not handle Heredoc Blocks. [ 1202772 ] missing parentheses in Parser.inc line 946 [ 1203445 ] Call to a member function on a non-object in Parser.inc [ 1203451 ] array to string conversion notice in InlineTags.inc - fixed these bugs reported in PEAR: Bug #2288: Webfrontend ignores more than one dir in "Files to ignore" Bug #5011: PDF generation warning on uksort ----------------------------------Release 1.3.0RC3--------------------------------- 2004-04-10 Gregory Beaver * fix beautifying for entities and * add new for unmodified html output (form demonstration and the like) 2004-04-09 Gregory Beaver * fix PHP5 warnings * add warning if beautifying fails * XML beautifying for peardoc2 works! * fix typo in HTML:Smarty:PHP class.tpl * fix endless loop with HighlightParser and tab characters 2004-04-04 Gregory Beaver * fix [ 904823 ] IntermediateParser fatal error 2004-04-02 Gregory Beaver * fix [ 924313 ] Objec access on array * fix [ 915770 ] Classes in file not showing * fix [ 910676 ] Fatal error: Smarty error: unable to write to $compile_dir 2004-03-08 Joshua Eichorn * Fix for [ 912064 ] Ugly CLI warning message in safe mode, in safe mode give a warning instead of calling set_time_limit * Possible fix for [ 910690 ] documentation might beed more updating * Added a note about problems with non GNU tar, bug #908920 * Test case for bug [ 904820 ], it already worked 2004-02-20 Gregory Beaver * implement [ 799026 ] Images in tutorials * allow in tutorials * fix @static for peardoc converter 2004-02-19 Gregory Beaver * fix [ 899028 ] source_files unreadable in Opera ----------------------------------Release 1.3.0RC2--------------------------------- 2004-02-12 Gregory Beaver * tokenizer parser is no longer experimental * display PHP/phpDocumentor version to help stop stupid non-bug bug reports (older versions) * fix [ 895656 ] initialized private variables not recognized as private 2004-02-09 Gregory Beaver * fix sourcecode=on in PHP 5, and a bug in PHP 4 if there was a page-level docblock that was moved to a class-level docblock * fix another clone bug, this time in IntermediateParser.inc * fix major highlighting bug - endless loop - with T_DOC_COMMENT token * fix warnings in HighlightParser * fix [ 893470 ] __clone called directly in PackagePageElements.inc ----------------------------------Release 1.3.0RC1--------------------------------- 2004-02-08 Gregory Beaver * fixed warning and severe bug - complete ignore of class docs - caused by a docblock containing a block with a class declaration * multi-national charactrers are now allowed in a package name 2004-02-07 Gregory Beaver * fix [ 892479 ] {@link} in // comment is escaped * fix [ 892306 ] peardoc2: @see of method not working * fix [ 892305 ] peardoc2: summary require_once Path/File.php is PathFile.php 2004-02-04 Gregory Beaver * remove all $this = from ParserElements * add new disambiguating "constant BLAH" and "object BLAH" for Converter::getLink() 2004-02-01 Gregory Beaver * fixed [ 884869 ] Wrong highligthing of object type variables * fixed [ 884863 ] Multiple authors get added in wrong order. * fixed [ 880488 ] '0' file stops processing * fixed [ 880070 ] PHP5 visability for member variables not working 2004-01-31 Gregory Beaver * Make all source highlighting ultra-output efficient. No enclosing thing is repeated unless necessary * implement source highlighting in tutorial for * implement {@example} and @example for peardoc2 converter 2004-01-20 Gregory Beaver * fix bug in highlighting of comments introduced by bugfixing of other bugs 2004-01-19 Gregory Beaver * fix XML:DocBook/peardoc2 in PHP 5 2004-01-18 Gregory Beaver * fix [ 879068 ] var arrays tripped up by comments * fix [ 879151 ] HTML:frames:earthli Top row too small for IE * fix [ 877229 ] PHP 5 incompatibilities bork tutorial parsing 2004-01-17 Gregory Beaver * fix [ 877233 ] PHP 5 incompatibilities bork docblock source highlighting * fix [ 878911 ] [PHP 5 incompatibility] argv 2004-01-14 Gregory Beaver * fix bug in inline example * HUGE php5 incompatibility: get_class() is no longer case-sensitive, so wrap all 109 mentions in phpDocumentor_get_class() * fix [ 876674 ] first line of pre and code gets left trimmed * merge several un-merged fixes into pear-specific Converter.inc, IntermediateParser.inc, Setup.inc.php * fix a few PHP5-related warnings and issues 2004-01-12 Gregory Beaver * fix [ 875525 ]
  • escapes 
     and ignores paragraphs

2004-01-10  Gregory Beaver 
    * implement [ 799232 ] Change behavior of -c key to use any configuration file.
    * implement [ 749279 ] inline {@example} tag
    * implement [ 727084 ] Support for custom files to include (README etc).
    * fix [ 871764 ] @global doesn't work properly with whitespace after the $var

2004-01-09  Gregory Beaver 
    * Hallelujah, thank you "Core CSS" book.  Fix for Mozilla in HTML:Smarty:*.
      Now I just need to transfer the old colors and stuff into the new style.css

2004-01-05  Gregory Beaver 
    * Fix HTML:frames:* source examples.  For some reason, the IDENTICAL fix does
      not work in ANY of the HTML:Smarty:* templates.  I hate CSS with a passion.

2004-01-02  Gregory Beaver 
    WARNING: this change TOTALLY f***s up netscape/mozilla - a
    blank line is in between every line and I have no idea how
    to get rid of it.  Someone else who is smarter will have to fix this,
    or I'll revert it later this week
    * Make source examples in HTML cut-and-pasteable using 
       and 
      
    1. 

2003-12-30  Gregory Beaver 
    * Move to version 1.3.0 since we're adding features

2003-12-28  Gregory Beaver 
	* fixed [ 854321 ] web interface errors with template directory
	* fixed [ 850767 ] MHW Reference wrong
	* fixed [ 865126 ] CHM files use hard paths
	* fixed [ 850731 ] No DocBlock template after page-level DocBlock?
	* fixed [ 839092 ] CHM:default:default produces bad links
	* fixed [ 840792 ] File Missing XML:DocBook/peardoc2:default "errors.tpl"
	* fixed [ 856310 ] HTML:frames:DOM/earthli missing Class_logo.png image
	* fixed [ 839466 ] {$array['Key']} in heredoc
	* fixed [ 834941 ] inline @link doesn't work within 

2003-12-17  Gregory Beaver 
    * full PHP 5 support in all converters, all templates, as well as
      source highlighting support
    * Add in class constants
    * Add in class type hints
    * fix [ 854321 ] web interface errors with template directory
    * Added interface/class constants support to HTML:frames:earthli

2003-12-16  Gregory Beaver 
    * Added template variables "is_interface" and "implements" to handle
      PHP 5
    * Added support for parsing access modifiers and implements
    * Migrated to Smarty 2.6.0

2003-10-19  Gregory Beaver 
    * fixed [ 823018 ]  in list not processed
    * fixed [ 822373 ] global instruction in function, ',' and ';' missing

-------------------------Release 1.2.3------------------------

2003-10-12  Gregory Beaver 
    * fixed [ 771531 ] body styles not explicitly white

2003-10-09  Gregory Beaver 
    * added  to all peardoc files written, for aid to
      translators

2003-10-08  Gregory Beaver 
    * fixed [ 731750 ] Links to unparsed includes shown (2nd time reopened)
    * fixed [ 797066 ] HighlightParser stuffs whitespace in start of string in func
    * fixed [ 795095 ] top_frame.tpl doesn't output single RIC element
    * fixed [ 802891 ] Inline link text does not show up

2003-09-19  Gregory Beaver 
    * fixed [ 792867 ] Call to undefined function
    * fixed [ 795489 ] 
       getting escaped
    * fixed [ 804034 ]  tag not closed for peardoc2

2003-08-31  Gregory Beaver 
    * fixed [ 797989 ] HTML not escaped in examples (PHP < 4.3.0)

-------------------------Release 1.2.2.1 (pear)-------------------
2003-08-20  Marco Von Ballmoos 
    * Added 'abstract' to available properties in the HTMLFramesConverter
	* Updated DOM/earthli and earthli templates with new graphics showing
	  abstract status of classes and methods. Also added icons for classes
	  and pages to page.tpl and class.tpl.
	  
-------------------------Release 1.2.2------------------------
2003-08-19  Gregory Beaver 
    * fixed [ 791030 ] old PHP version bug /t and ' becomes to "
    * fixed [ 791131 ] old PHP version bug in output, if define contains "("
    * fixed [ 791023 ] bug in output: 
    * fixed [ 791023 ] bug in output: , also implemented 
      handling in all html templates

2003-08-18  Gregory Beaver 
    * fixed [ 790685 ] HighlightParser doesn't link class::method() outside methods

2003-08-13  Gregory Beaver 
    * added fix for 781913 for procedural pages
    * really fixed [ 781913 ] usedby not when @uses at class level
    * fixed [ 788271 ] HighlightParser links to methods before classes
    * fixed [ 780332 ] {@link} is closing the link prematurely when a ',' is found
    * fixed [ 788251 ] {@link function blah()} and {@link object blah} fail
    * fixed [ 784810 ] stat failing.
    * peardoc2: added use of &true; &false; and &null; in @param description
    * peardoc2: added word wrapping for the benefit of translators
    * more simple list fixes

2003-08-10  Gregory Beaver 
    * fixed [ 786180 ] simple lists fail if line starts with an inline tag

2003-08-08  Gregory Beaver 
    * fixed bugs in constants/globals peardoc2 generation

2003-08-06  Gregory Beaver 
    * fixed [ 781913 ] usedby not when @uses at class level

2003-08-01  Gregory Beaver 
    * fixed 2 typos in XML:DocBook/peardoc2:default

2003-07-31  Joshua Eichorn 
    * Spell false right

2003-07-30  Joshua Eichorn 
    * Don't die on empty @param or @return

2003-07-29  Gregory Beaver 
    * Fixed bug in PDF Converter, wasn't finding fonts (PEAR install only)
    * Made PEAR do replacements on makedocs.ini so it works out of the box
    * Fixed [ 779552 ] "Documention" instead of "Documentation" in generated pages
    * Remove stupid use of publicweb_uri :)
    * Remove possibility to change back to HTML:default
    * Fixed pear install, to use new publicweb_dir and publicweb_uri
    * added new pear-based docbuilder that relies on publicweb_dir config variable
    * fixed missing {@id} in manual.pkg
    * removed @include_once and now use file_exists/is_readable to catch
      those errors.
    * removed all exception handling code.  We haven't used it since June 2002.
    * added Io::isIncludable() for future use

2003-07-28  Gregory Beaver 
    * fixed the last bug with linking in the PDF Converter, removed debug code
    * fixed bug in global variable linking in PDF Converter
    * fixed [ 778920 ] tutorial link warning
    * fixed CHM Converter, added index generation (CHM index)

2003-07-27  Gregory Beaver 
    * fixed @filesource in PDF Converter
    * fixed index and table of contents
    * added color highlighting to PDF converter source code!
    * started work on CHM converter.  It's generating a couple
      of bad links that need to turn good

2003-07-26  Gregory Beaver 
    * fixed the PDF Converter - it's beeyootiful
    * fixed serious bug - double postprocessing of highlighted
      docblock source.
    * fixed even more serious bug - splitting of tokens into
      line numbers was totally wrong in phpDocumentorTWordParser.
      Now file highlighting works perfectly (and even looks good in Mozilla!)
    * moved around the manual
    * fixed minor bugs in documentation
    * added text color possibility to PDF Converter!  Will be modifying to
      do color syntax highlighting over the next couple of days
    * Modified docbuilder to add option of parsing in external window.  I like to be
      able to just hit refresh.

2003-07-25  Gregory Beaver 
    * fixed some more problems - all done now
    * fixed all the problems in XML:DocBook/peardoc2:default
    * fixed problem with phpdoc.bat in PEAR install
    * ran PEAR_PackageFileManager to create package.xml
    * fixed problems with PEAR!
    * phpDocumentor now officially conflicts with PHPDoc
    * Applied fixes to ignore from PEAR_PackageFileManager

2003-07-24  Gregory Beaver 
    * Changed behavior again: If the first element in a file is a class,
      the docblock belongs to the class.
    * Updated all documentation to reflect this change in behavior
    * Improved error messages for Page-level DocBlocks
    * Changed behavior: if the first docblock in a file contains
      a @package tag, it is a page-level DocBlock

2003-07-22  Gregory Beaver 
    * fixed [ 772441 ] nested arrays fail parser
    * fixed DocBook/peardoc2 generation
    * fixed [ 768947 ] Multiple vars not recognised
    * fixed [ 767251 ] broken links when no files in default package

2003-07-21  Joshua Eichorn 
    * fixed [ 765455 ] phpdoc can't find php if it is in /usr/local/bin

-------------------------Release 1.2.1------------------------
2003-07-03  Gregory Beaver 
    * config.php fixed [ 765765 ] docbuilder can't change ini dir
    * default.ini changed version to 1.2.1 in title
    * DocBlockTags.ini got rid of surrounding 
       for
      single-paragraph @tag descriptions

2003-07-03  William Hardeman 
    * fixed [ 765753 ] Extraneous trailing "-" in @uses when no description

2003-07-02  Gregory Beaver 
    * ready version numbering/package.xml for release 1.2.1
    * fixed [ 753641 ] phpdoc -h output
    * fixed [ 757077 ] smarty templates_c not in release for HTML:frames:default
    * fixed up a few bugs in the @example change
    * fixed bugs in CHMdefault Converter and PDFdefault Converter
    * Applied Sam Blum's fixes to @example (with a few changes)
    * tags.example.pkg updated docs
    * fixed [ 750264 ] @ignore won't work with DocBlock Templates /**#@+
    * fixed [ 731750 ] Links to unparsed includes shown (reopened)
    * fixed [ 735134 ] HTML:Smarty:default Documentation can not be printed,
      added print.css and modified header.tpl to use it for print

2003-07-01  Gregory Beaver 
    * fixed [ 764412 ] Complex class inheritance/package causes endless loop

2003-06-29  Gregory Beaver 
    * applied Josh's fix for 749841 to all errors.tpl

2003-06-29  Joshua Eichorn 
    * fixed [ 754067 ] Use the code from pear to find php

2003-06-29  Gregory Beaver 
    * fixed improper fix for 750392
    * fixed [ 750392 ] Formatting doesn't work in Templates /**#@+
    * fixed [ 752040 ] phpDocumentor 1.2.0 can't parse itself in php < 4.3.0
    * fixed [ 751066 ] Return type of a constructor is not void.
    * fixed [ 751101 ] output error when optional parameters are in use
    * phpDocumentorTParser::handleFunctionParams() removed bizarre double
      statement (not a bug, just inefficient)
    * fixed [ 753278 ] @see parent::_privatefunc causes endless loop

2003-06-28  Gregory Beaver 
    * fixed [ 752015 ] Docbuilder problems
    * fixed [ 755681 ] include error in docbuilder file_dialog.php
    * fixed [ 758387 ] Use of undefined constants in DocBlockTags.inc on line 830
    * fixed [ 757841 ] JavaScript-Error cause of Package-Name
    * updated phpdoc.bat with fix from Sam Blum

2003-06-27  Gregory Beaver 
    * Replaced phpdoc.bat with Sam Blum's phpdoc.bat, fixing 749446
    * Added Release-1.2.1
    * fixed [ 755688 ] lost image(s)
    * fixed [ 756730 ] preview image for HTML:Smarty not found

2003-06-07  William K. Hardeman 
    * Fixed bug [ 750461 ] by modifying HTMLSmartyConverter::WriteSource(),
      HTMLSmartyConverter::getSourceLink(), HTMLSmartyConverter::getSourceAnchor(),
      HTMLSmartyConverter::returnSee(), and HTMLSmartyConverter::convertClass().
    * Fixed bug [ 750441 ] by adding HTMLSmartyConverter::getCurrentPageLink()
      method.
    * Updated HandS template to include a trailing space before the
      closing ) in a function/method definition.

2003-06-04  Gregory Beaver 
    * made parsing stop if target is empty before any parsing is done

-------------------------Release 1.2.0------------------------
2003-06-04  Gregory Beaver 
    * phpDocumentorTParser::usesTagHandler() fixed [ 748837 ] @uses with spaces
    * tags.inlinelink.pkg fixed [ 748850 ] {@link} documentation is unclear

2003-06-04  William K. Hardeman 
    * Added two new tags arrays available for template use:
      $info_tags and $api_tags in Converter.inc [ 748419 ]
    * Updated HandS template to use the new tags arrays.

2003-06-03  Gregory Beaver 
    * phpDocumentor_IntermediateParser::_getSourceLocation()
      fixed [ 748314 ] --pear on php4/pear uses . as dirname
    * parserExampleTag::parserExampleTag fixed [ 747733 ]
      cannot use same filename + different path in @example

2003-06-02  Gregory Beaver 
    * changed in-file license notices to PHP license version 3
    * updated docs to reflect new template/authorship
    * added new HTML:Smarty:HandS template
    * fixed [ 746690 ] DocBlocks not parsed for require_once statements
    * fixed [ 746692 ] makedoc.sh $TITLE bug
    * fixed [ 746674 ] phpedit - vars, methods
    * IntermediateParser.inc fixed minor warning if converter output type not found

2003-05-30  Gregory Beaver 
    * changed version to 1.2.0 readying for release
    * ProceduralPages::pathMatchesParsedFile() fixed [ 731750 ]
      Links to unparsed includes shown

2003-05-29  Gregory Beaver 
    * parserLinkInlineTag fixed [ 744028 ] {@link $el, $notfound}
      returns blank text
    * phpDocumentor_IntermediateParser::_setupUsesList() fixed [ 744026 ]
      @uses breaks on Classes.inc
    * Converter::formatUsesList() removed
    * DescHTML.inc fixed warning if  is used in docblock without
      any contents
    * Parser.inc fixed empty  that prompted discovery of above

2003-05-26  Gregory Beaver 
	* HighlightParser::getInlineTags() fixed bug in handling of the end of
	  {@internal}} in special cases
	* Fixed @uses docs minor typo
	* Fixed @see docs minor typo
    * Fixed @filesource docs to have accurate example

2003-05-25  Gregory Beaver 
    * Cleaned up docbuilder (no more javascript/include errors!)
    * Switched to use of DIRECTORY_SEPARATOR (about time)
    * fix small but significant bugs in XML:DocBook/peardoc2 thanks to A. Merz

2003-05-23  Gregory Beaver 
    * ParserDocBlock fixed [ 740871 ] crash in DocBlockTags.inc line 99
    * IntermediateParser fixed [ 739740 ] Page-level docs are not generated without a @package tag
    * fixed [ 741887 ] case-sensitivity bug

2003-05-20  Gregory Beaver 
	* fixed [ 740859 ] @uses in docblock template crashes parser

2003-05-17  Gregory Beaver 
    * fixed [ 729841 ] Source code only for certain file if same name used
    * fixed [ 730214 ] weird filesource
    * fixed [ 736832 ] Fatal error in phpDocumentorTParser.inc
    * fixed warnings if a tutorial file doesn't exist
    * fixed [ 732642 ] DocBook support broken/incomplete.

2003-05-07  Gregory Beaver 
    * docbuilder fixed 731560 docbuilder include error on linux
    * phpDocumentorhowto.pkg fixed documentation of -it command-line to make
      it clearer
    * ParserDescParser::doSimpleList() fixed 732900 ordered list messes up
    * Io.inc fixed 733100 phpdoc's help output shows 2 times option "quiet"
    * parserLicenseTag::parserLicenseTag() fixed 733352 optional description
      parameter in @license tag

2003-05-02  Gregory Beaver 
    * fixed 729360 - quietMode broken

2003-04-29  Gregory Beaver 
    * ParserDescCleanup.inc fixed 729653, tons of warnings
    * ObjectWordParser::getWord() fixed 729638 - case insensitivity breaks
      tutorial parsing

-----------------Release 1.2.0rc 2-----------------------
2003-04-28  Gregory Beaver 
    * readied for release
    * phpDocumentorTParser::handleDesc() fixed [ 727823 ] "#@+"-block quirck?
    * phpDocumentorTParser::handleJavaDocDesc() fixed [ 727823 ] "#@+"-block
      quirck?
    * ParserDescCleanup.inc fixed [ 728167 ] HTML tags are case sensitive
    * all options.ini fixed [ 728585 ] static keyword

2003-04-25  Gregory Beaver 
    * tags.category.pkg fixed incorrect example (oops)

2003-04-24  Andrew Eddie 
    * Change CHM class icon
    * Added suport for grouping of index entries in CHM converter
    * Made presentation of CHM docblock and methods more like MSDN format
    * Moved 'docBuilder' index to the root directory
    * Added links and introduction pages to docBuilder

2003-04-23  Gregory Beaver 
    * Converter::getFileSourcePath() removed ending PATH_DELIMITER, removing
      annoying extra \ in output
    * HTML:*,CHM:* fixed getFileSourcePath() references that need PATH_DELIMITER
    * ParserDescParser fixed [ 726195 ] Formatting tags breaks lists
      required LOTS of changes
    * set Smarty::$use_sub_dirs to false, removed all the %% dirs from cvs
    * parserLicenseTag added @package to docblock

2003-04-22  Gregory Beaver 
    * docbuilder: changed top.html to top.php, removes warning
    * docbuilder: changed misspelling of phpDocumentor
    * Updated Authors/README, manual.pkg author list
    * Applied Andrew Eddie's templates CHM:default:default method.tpl, hhp.tpl
      and index.hhk.tpl
    * Applied Andrew Eddie's changes to CHMdefaultConverter.inc
    * README updated
    * parserCode::Convert() fixed [ 725742 ] code tag alignment
    * fixed warnings if -po and nothing parsed is in the packages specified
    * phpDocumentor_IntermediateParser::addPageIfNecessary() fixed
     725788 if --packageoutput excludes files with classes

2003-04-21  Gregory Beaver 
    * Converter::getClassesOnPage() fixed 725161, File view displays class
      symbols without names
    * HTMLSmartyConverter::formatLeftIndex() fixed 725745,
      HTML:Smarty:PHP not creating ric_README.html.  Needed call to writeRIC()
    * XMLDocBookpeardoc2Converter fixed non-linking to constants/globals
    * fixed [ 725247 ] Wrong list handling in peardoc converter
    * fixed [ 725251 ] Peardoc converter again
    * XMLDocBookpeardoc2Converter fixed many fatal errors (oops)
    * Errors.inc changed {@inheritdoc} to {@}inheritdoc} in comment (oops)
    * RoadMap updated for 2.0
    * parserExampleTag was no title if @example file.php instead of
      @exampel file.php title, fixed this

2003-04-20  Gregory Beaver 
    * fixed mistake in reworking of getLink()
    * parserLinkTag fixed [ 724857 ] @link URL text broken
    * Classes::processChild() fixed 724701 conflicting package names, inherited
      links fails to show up - this was an OLD bug, and is a good one to fix
    * Converter::getLink() split up the method into several helper methods to
      aid debugging.  Found a potential problem with the use of each on the
      array $packages - moved to use of $package = array_shift(array_keys($packages))
      instead of list ($package,) = each($packages), fixing
      724415 Non-package references not always resolved
    * Smarty-2.5.0/* updated to new phpDocumentor comments from Smarty
      CVS
    * HighlightParser fixed 724417 Multi-level method references not linked
      and I must say it is a beautiful thing
    * ChangeLog removed pre-l.0 changelog, people can get old changelog from cvs
      attic or from previous releases

2003-04-19  Gregory Beaver 
    * HTML:frames:default top_frame.tpl added target="right"
    * implemented feature request 722987 Relative example files
    * implemented --examplesdir command-line for 722987
    * tags.example.pkg updated documentation
    * phpDocumentor.howto.pkg updated docs

2003-04-19  Marco Von Ballmoos 
	* Converter::_processTutorials() Fixed tutorial navigation bug - 
	  The tutorial tree builder first builds a list of tutorials that are
	  named as parents by other tutorials. Then, for each tutorial in that
	  list, it looks to see if each tutorial is named as a child by any other
	  tutorial. If it found that it was, it was removed *from the list of
	  parents*. That meant that any tutorials in the potential parents list
	  that named a removed tutorial as a parent would be incorrectly identified
	  as a root tutorial.
	* Changed HTML:frames:default package selector to stop using JavaScript
	* Small updates to the document trees in all templates

2003-04-18  Gregory Beaver 
    * fixed 723947, RIC parsing not reading the correct README
    * Setup.inc.php removed reference to Template.inc
    * HTMLframesConverter.cls finished documentation entirely
    * removed the HTMLdefaultConverter entirely.  No one has complained about
      it, and we will always convert templates to framesConverter if people ask
      removed old documentation too
    * default.ini updated documentation, added templatebase option
    * added --templatebase command-line to implement feature 704808,
      command-line switch for template directory/converter directory, also
      added documentation for this
    * added all templates_c directories to CVS, to remove the need to have
      write access to anywhere in phpdocumentor, unless you change the source,
      fixing 708928 write permissions needed on some program dirs
    * HighlightParser::retrieveType() fixed 723767 space needed after
      @param type $var
    * migrated to Smarty 2.5.0
    * phpDocumentorTParser::retrieveType() fixed 723320 @param output behaves
      funny
    * blank.tpl fixed {$phpdocver} to {$phpdocversion}
    * HighlightParser::retrieveType() fixed 723230 warning on line 1391,
      HighlightParser
    * blank.tpl made this file a little sexier in all HTML-based templates
    * Converter.inc removed second declaration of var $class (oops)
      now phpDocumentor is PHP5-ready (for documenting php 4, of course)

2003-04-17  Gregory Beaver 
    * common.inc.php changed version to 1.2.0rc2dev
    * Release-1.2.0rc2 added, to prepare for next release

-----------------Release 1.2.0rc 1-----------------------
2003-04-16  Gregory Beaver 
    * Readying for release 1.2.0rc1
    * phpDocumentorTParser::handleGlobal() fixed global line numbering
    * implemented feature 695621, link to section of @filesource from each
      element
    * phpDocumentorTWordParser::addSource() fixed case of blank lines being
      erased from source
    * phpDocumentor_setup::readConfigFile() fixed 710700 empty
      defaultpackagename = caused busy loop
    * HighlightParser::retrieveType() added function to fix 715077,
      HighlightParser needs @tag object classname support
    * phpDocumentorTParser::retrieveType() fixed warning in special case

2003-04-15  Gregory Beaver 
    * Converter::getLink() fixed 718253 Using 'parent' in @example file
      causes crash

2003-04-14  Gregory Beaver 
    * HighlightParser::$tagHandlers added @tutorial and @license as core tags
    * bug698356_Output() removed @todo
    * parserSourceInlineTag::arrayConvert() removed @todo
    * removed double write of example source due to double processing of
      all class-level docblocks in HTML*Converter (small speedup too)
    * applied fixes to CHM converter
    * fixed @license tag
    * HTML*Converter::writeSource/writeExample added \n to output
      to make it prettier, easier to read
    * HTMLSmartyConverter::getSourceLink() removed weird reference to non-
      existing getSourceFilename() method
    * tags.link.pkg updated docs
    * tags.license.pkg new docs for new tag
    * parserLicenseTag added source to DocBlockTags, implementing 714025,
      @license tag
    * phpDocumentorTParser::retrieveType() fixed @param object $var (was parsing
      as "object $var" instead of "object" and "$var" as variable name
    * HighlightParser::handleClassMember() fixed 715084 HighlightParser craps
      out after $var->
    * parserExampleTag::parserExampleTag() fixed 715452 @example doesn't work
      with anything other than .php

2003-04-14  Marco Von Ballmoos 
	* Class access level available in templates
	* Source files no longer overwrite each other
	* Link to file for class available in templates
	* Access level in class icons for HTML:frames:earthli
	* Link from class to file docs in all templates
	* HTMLFramesConverter::writeSource() - updated to used shared file source methods
	* HTMLFramesConverter::getSourceLink() - updated to used shared file source methods
	* HTMLFramesConverter::makeLeft() - added 'access' as a property for classes

2003-04-14  Gregory Beaver 
    * parserFunction::getIntricateFunctionCall() fixed 713954, @param type $var
      when &$var broken
    * default.ini added new templates to example generation

2003-04-13  Marco Von Ballmoos 
    * Updated the HTML:frames:l0l33t and HTML:frames:DOM/l0l33t to the
      same layouter used by the other renderers. Once again, the style
      sheet is different (and there are a couple of small differences
      in the templates).
    * Updated all HTML:frames templates to show other packages in a frame
      at the top, inside a combo-box instead of in the square frame in the
      top-left.
    * Fixed reference to 'Class.png' which was appearing in Opera and IE.

2003-04-13  Marco Von Ballmoos 
    * Converter::$processed_tutorials Added this property to track
      which tutorials are already in the tutorial tree
    * Converter::getTutorialTree() Updated to use the list of already-
      processed tutorials.
    * Converter::_tutorial_path() added to retrieve the string id for
      a tutorial.
    * Converter::_setupTutorialTree() Fixed to use new path and processed
      tutorial functions to generate a tree with one and only one copy of
      each tutorial.
    * Fixed HTML:frames:default and HTML:frames:phphtmllib to handle tutorial
      correctly.
    * Rewrote the tutorial template layouts and XMLDocBook tag matching tables for
      the affected templates.
    * Moved HTML:frames:earthli to HTML:frames:DOM/earthli and added 
      HTML:frames:earthli as a non-DOM version of the template.
    * Integrated tutorials into the main document tree for all DOM and non-DOM
      templates in HTML:frames (except for l0l33t -- coming soon).
    * Updated HTML:frames:default, HTML:frames:phpdoc.de, HTML:frames:phphtmllib
      to use the latest version of the non-DOM templates. Layout is handled by the
      same basic templates as HTML:frames:earthli (there are, after all, only so
      many nice ways to lay out documentation) and specializations are done using
      the stylesheet. This allows documentation to be tweaked to a good degree after
      it has already been generated.
    * Updated HTML:frames:DOM/default, HTML:frames:DOM/phpdoc.de to use the WebFXTree
      to render the tree instead of the previous custom code.
    * Added HTML:frames:DOM/phphtmllib
    * Fixed some bugs in the tutorial nesting for PHPDocumentor's documentation.
    * Moved earthli image source files to 'phpdoc/media/images/earthli' to avoid 
      copying them into each distribution of documentation.

2003-04-03  Gregory Beaver 
    * Setup.inc.php fixed bug if no -o command-line specified, was using default
      instead of frames converter

2003-04-03  Marco Von Ballmoos 
    * Converter::convertMethod() added 'access' property
    * Converter::convertVar() added 'access' property
    * Converter::getFormattedInheritedMethods() added 'access' property
    * Converter::getFormattedInheritedVars() added 'access' property
    * HTMLFramesConverter::getIndexInformation() added 'access' property
    * Updated entire icon set for 'earthli' theme.
    * Removed unused files from 'earthli' template.
    * Cleaned up the HTML:frames:default and HTML:frames:phphtmllib templates.
      Both are now based on the same layout as the HTML:frames:earthli template,
      but use a non-DOM tree and different stylesheets. Otherwise the code for
      all three is the same.

2003-04-02  Gregory Beaver 
    * added bugfix to release notes

2003-04-01  Marco von Ballmoos 
    * Updated earthli template with properly named 'Page.gif' file. (must
      be uppercase so that *nix-based servers can see it.)
    
2003-04-01  Gregory Beaver 
    * XMLDocBookpeardoc2 converter: fixed several template issues
    * Errors.inc added PDERROR_EMPTY_EXAMPLE_TITLE error for empty @example
      title
    * CHM, HTML, PDF converters: added warning if @example title is empty
    * phpDocumentorTParser::handleFuncGlobal() fixed 713201 variable variables
      are not parsed properly in @global
    * ParserDescParser fixed 708914 , ,  broken

2003-03-31	Gregory Beaver 
    * parserDocBlock::replaceInheritDoc() fixed 711569 Fatal Error: Undefined
      Method during write
    * PDERROR_INHERITDOC_DONT_WORK_HERE new warning for {@inheritdoc} in
      non-child class docblock
    * fixed 712704 HTML:Smarty:* drops class level author information
    * ParserDescParser::resetStartList() fixed notice
    * ParserDescParser::setupStates() fixed 710366 -Tag is ignored

2003-03-23	Gregory Beaver 
    * README added more notes of thanks to people who have helped make this
      thingy better
    * PDFdefaultConverter::writeExample() fixed stupid typo thanks to Darren
      Cook
    * made @returns an alias to @return
    * ParserDescParser::handleSimpleList() fixed numbered lists
    * Converter::sourceLine() fixed 701199 extra br in @filesource generation
    * fixed bug 708559, @category tag not really working
    * ParserDescParser::handleEscape() fixed rare case of <<>> not working
      <<<>>> will never work, unless someone needs it. :)
    * tags.abstract.pkg added new docs on @abstract
    * tags.final.pkg added new docs on @final
    * HighlighParser added @final as a core tag
    * phpDocumentor.ini added @final as a valid tag
    * ParserDescParser::handleSimpleList() fixed parsing of simple lists if
      they are the last thing in a docblock
    * phpDocumentorTParser::retrieveType() fixed logic bug if @param object
      and no @param object objectname
    * phpDocumentorTParser::retrieveType() fixed warning
    * XML:DocBook/peardoc2 removed links to class $vars since they are not
      documented in peardoc2

2003-03-22	Gregory Beaver 
    * XMLDocBookpeardoc2Converter implemented the rest of A. Merz's suggestions
      regarding @throws and @access

2003-03-20	Gregory Beaver 
    * HTMLframesConverter fixed doc error
    * phpDocumentor.howto.pkg fixed typo
    * XMLDocBookpeardoc2Converter::endClass() removed write-out of class summary
    * Errors.inc added missing multiple category tags
    * Converter::walk_everything() fixed bug noticed by A. Merz
    * XMLDocBookpeardoc2Converter fixed bugs in package.xml generation
    * XMLDocBookpeardoc2Converter fixed bugs in category.xml generation
    * package.tpl/class_summary.tpl for peardoc2 converter, fixed up to match
      requirements of A. Merz.
    * tags.example.pkg, tags.filesource.pkg added warning about PHP 4.3.0
      requirement
    * phpDocumentor.howto.pkg added docs about phpDocumentor.ini
    * phpDocumentorTParser added more doc comments
    * phpDocumentorTParser cleaned up tag handling code
    * applied feature request for @tag object classname
    * XMLDocBookpeardoc2Converter docblock.tpl - applied A. Merz's fix to
      method parameters

2003-03-17	Gregory Beaver 
    * XMLDocBookConverter added safety catch so nobody can use it until it has
      templates
    * HighlightParser made @category a core tag
    * XMLDocBookpeardoc2Converter fixed lowercasing of @category
    * XMLDocBookpeardoc2Converter fixed directory names if @package contains
      underscores or periods like Spreadsheet_Excel_Writer
    * tags.return.pkg updated docs to reflect changes made in 1.1.0 with smart
      @return value parsing (class names and value|value|classname)

2003-03-14	Gregory Beaver 
    * updated phpdoc.php/new_phpdoc.php to have new peardoc2 --output format
    * updated makedocs.ini to have XML:DocBook/peardoc2:default

2003-03-13	Gregory Beaver 
    * HTMLframesConverter.cls added more docs
    * HTMLframesConverter moved title to elementindex.tpl/pkgelementindex.tpl
      to make I18N easier.
    * Io::Io() fixed 702549, --quiet option not valid?
    * improved phpDocumentor.howto.pkg description of --quiet

2003-03-10	Gregory Beaver 
    * added more docs to HTMLframesConverter.cls
    * add warnings for use of @filesource/sourcecode = on in PHP < 4.3.0
    * HTMLframesConverter.cls fixed typo
    * CHMdefaultConverter::Output() fixed {@source} tag to match new syntax
    * parserSourceInlineTag::arrayConvert() re-fixed 657041 {@source} doesn't
      work right once and for all.
    * ParserFunction::$returnsreference fixed minor error in docs
    * ParserFunction::getFunctionCall() fixed minor error in docs
    * HTMLSmartyConverter::convertTutorials() fixed 695622 HTML:Smarty:* has no
      package-level docs
    * phpDocumentorTParser::getInlineTags() fixed 698356 {@internal} not working
      properly
    * HTMLframesConverter.cls continued the march to completing documentation.

2003-03-08	Gregory Beaver 
    * phpDocumentorTParser fixed 698468 Fatal error when inline tag across two
      lines

2003-03-06	Gregory Beaver 
    * create_package.xml.php fixed typo

2003-03-05	Gregory Beaver 
    * ParserDescParser::handleList() fixed 697644, text outside 
    2.  crashes
    * ParserDescParser::parse() fixed 697644, any unclosed html tag crashes
    * Errors.inc added PDERROR_UNCLOSED_TAG and PDERROR_TEXT_OUTSIDE_LI
    * phpDocumentorTParser::handleLinkInlineTag fixed 698417 {@link element
      descrip} wrong
    * HTMLframesConverter.cls fixed typo
    * Converter::convertTutorial() fixed unterminated {@link} in docblock
    * added new ParserPDF.cls documentation
    * ParserPDF.inc added documentation
    * HTMLframesConverter.cls added documentation
    * template.vars.cls improved documentation, added some omissions

2003-03-04	Gregory Beaver 
    * parserCode::Convert() fixed 696883  in description crashes parser,
      was using ProgramExample() even in PHP 4.2.3
    * fixed 697656 putting a  inside a 
    3.  turns it into a literal
    * PDFdefaultConverter::convertPage()/convertClass() tidied up a bit
    * PDF:default:default pages.tpl - {if includeheader} should be
      {if $includeheader}.  Fixes problem with multiple procedural page
      headers
    * phpdocpdf::ezNewPage() Fixed 697156 PHP Warning with PDF Converter
    * Cezpdf::ezWhatPageNumber() patched to give error if page numbering not
      started instead of just doing a PHP warning on line 311
    * create_package.xml.php added dependency on PHP 4.1.0 or greater to
      package.xml generation, and generic dependency generation
    * Release-1.2.0rc1 update for next release
    * package.xml change description field to be more attractive

2003-03-03	Gregory Beaver 
    * added question to FAQ about inline @example tag (we use )

2003-03-03	Marco Von Ballmoos 
    * Updated index rendering to use more variables instead of just 'listing'. 
      Consolidated package and full index rendering into one function. 'listing'
      property is retained for compatibility with existing templates.
    * Updated HTML:frames:earthli template. Takes advantage of new variables in 
      the HTMLframesConverter.

2003-03-02	Marco Von Ballmoos 
    * fixed a bug in the generated page information. Classes were included
      even if they were marked private and 'parseprivate' was off.

2003-03-01	Gregory Beaver 
    * moved what was once in classname.xml to packagename.xml
    * fixed bugs in new packagename.xml generation
    * XMLDocBookpeardoc2Converter::formatLeftIndex() implemented output of
      packagename.xml file to complete DocBook/peardoc2 converter

2003-02-28	Gregory Beaver 
    * HTML:Smarty:PHP header.tpl fixed {$todolink} to {$subdir}{$todolink}
    * phpDocumentor_IntermediateParser::addUses() fixed 695482, @uses not
      checking to see if element is @access private
    * phpDocumentor.howto.pkg, inlinetags.pkg added docs about {@*}
    * Added use of {@*} to insert */ into a docblock for code examples
    * Converter::formatUsesList() fixed 692552 wasn't checking for class name if
      @uses class::method() or class::$var, so if more than one class contained
      a method named "method()" only the first class in the list would get the
      @usedby tag as a result
    * Converter::formatUsesList() partial fix for 692552, @uses is screwy
      If a @uses methodname() or @uses $varname was used in a class, no @usedby
      would be inserted
    * phpDocumentorTParser::getInlineTags() fixed 693215, {@internal}} on single
      line is broken
    * HighlightParser::getInlineTags() add missing space after {@internal
    * added new @todo for XML:DocBook/peardoc2
    * updated @todo tags
    * HighlightParser::handleClassMember() fixed 687364 highlightparser
      $class->member incorrect
    * IntermediateParser::HandleEvent() fixed bug if --sourcecode on and a file
      has no page-level docblock, no source was being generated
    * IntermediateParser.inc fixed 675871, --pear breaks if non-pear repository
    * class.phpdocpdf.php fixed 694742 PDF converter has no table of contents
    * HTMLSmartyConverter fixed 695291 added todo list to all generated templates
    * phpedit/class.tpl fixed 694594 PEAR mode: destructor image not shown by
      phpedit template

2003-02-27	Gregory Beaver 
    * tutorials.pkg added information about {@toc}, {@id}
    * ParserDescCleanup.inc fixed basics.desc reference
    * phpDocumentor.howto.pkg/IntermediateParser.inc fixed using.command-line.quiet
    * clarified phpDocumentor.pkg and tutorials.pkg slightly

2003-02-25	Gregory Beaver 
    * added earthli template to documentation, updated
      XML:DocBook:peardoc2 to XML:DocBook/peardoc2:default
    * applied 693213 to PDF Converter
    * fixed 693213 tutorials post-processed twice
    * fixed 689874 is_a is not avaliable in PHP 4.1.0
    * fixed 689893 Warnings on PHP 4.1.0

2003-02-24	Gregory Beaver 
    * removed page_summary.tpl, page.tpl, function.tpl from peardoc2 converter
    * added constants.tpl/globals.tpl to XML:DocBook/peardoc2:default
    * added new constants.xml/globals.xml output for peardoc2
    * removed function code from peardoc2 - no PEAR projects can have
      functions
    * removed procedural page code from peardoc2 converter
    * fixed faulty getIncludeValue() call in CHMdefaultConverter
    * remove pear_phpdoc, no longer necessary
    * added tags.category.pkg (forgot last time)

2003-02-18	Marco Von Ballmoos 
    * Added support for method and variable override resolution beyond
      direct descendents and ancestors. That is, redefinitions in ALL descendent
      classes are shown, and overrides are displayed if the signature matches that
      of a method or variable in ANY ancestor class.
    * Added a new template HTML:frames:earthli, which is driven almost purely by
      a stylesheet (media/stylesheet.css).
    * Fixed a bug that always returned false from CONVERTER::getvars.

2003-02-18	Gregory Beaver 
    * Added @category
    * made new XML:DocBook/peardoc2 converter, was too PEAR-specific.
    * added category support to new converter
    * fixed several category-related bugs, may be a few left over
    * directory hierarchy of peardoc2 converter is now 100%

2003-02-17	Gregory Beaver 
    * fixed toc errors in Converter.cls and Converter.methods.cls
    * Defined PDFdefaultConverter::postProcess() 
    * Try out fix to catch all pdf output for debugging

2003-02-16	Gregory Beaver 
    * template.vars.cls - fixed typo
    * ParserDescParser::doSimpleList() - fixed PHP warning
    * ParserDescCleanup.inc - implemented partial 687366, phpEdit-style list
      support
    * phpDocumentorTParser::getInlineTags() - fixed 687403 ,{@source} leaves "}" 

2003-02-15	Gregory Beaver 
    * template.vars.cls added in all default template vars
    * fixed 687091 special characters not encoded

2003-02-14	Gregory Beaver 
    * removed default HTML converter from PEAR release
    * changed role="script" to role="php" for phpdoc script.  the pear
      installer has no recognition for role="script" (checked source code)

2003-02-08	Gregory Beaver 
    * moved convertTutorial() to Converter
    * fixed warning in PDF converter
    * added debug_backtrace() to class.pdf.php, maybe find the Cpdf bug
    * implemented 683101 starting/ending line numbers for uml-related elements

2003-02-07	Gregory Beaver 
    * fixed bug in handling of {@internal}}
    * changed {@source} syntax, updated manual
    * fixed 657041 (again), {@source} not working right
    * created Release-1.2.0rc1 to prepare
    * fixed 680652, optional method/function parameters ignored
    * removed debug code
    * phpDocumentorTParser - fixed 682491, multi-line description fubared in @tag
    * phpDocumentorTParser - fixed bug in getInlineTags() that screwed 
      
    * fixed related bug in phpDocumentorTParser to 682490
    * fixed 682490, {@internal}} not parsed right by highlightparser
    * fixed 681735, need warning for {@source} in sdesc

2003-02-06	Gregory Beaver 
    * fixed unterminated {@internal}} in ParserElements.inc :)
    * added error check for unterminated {@internal}}
    * HTML-based converters - removed unused xml test for package pages
    * Converter.inc - removed PHP warnings if tutorial child not found
    * HighlightParser.inc - made all core tags highlighted as such
    * HighlightParser.inc - removed @todo tags
    * HighlightParser.inc - fixed bug if // comment is on line before
      DocBlock
    * HighlightParser.inc - fixed bug in handling of /**#@-*/
    * fixed more 681470 problems
    * fixed 681470 problems

2003-02-05	Gregory Beaver 
    * stupid thing isn't working, unfixing 681470
    * fixed docblock template errors in parserdesccleanup
    * fixed feature 681470 implementation attempt
    * added beginning of implementation of feature 681470.  Still buggy, but
      works very well for actual highlighting, it's the stuff around it that
      is broken
    * added class knowledge to {@source}
    * fixed 681463, {@source} drops characters
    * fixed 681459, needed strpos instead of strrpos for test, then strrpos
      for getInlineTags()
    * cleaned up XMLpackagePageParser.inc doc comments
    * cleaned up Setup.inc.php doc comments
    * cleaned up Publisher.inc doc comments
    * cleaned up phpDocumentorTWordParser.inc doc comments
    * cleaned up WordParser.inc doc comments
    * cleaned up ParserElements.inc doc comments
    * cleaned up ParserDocBlock.inc doc comments
    * cleaned up ParserDescCleanup.inc doc comments
    * cleaned up ParserData.inc doc comments
    * cleaned up Parser.inc doc comments
    * finished work on PackagePageElements doc comments
    * fixed subtle bug in @tag description conversion if the description had
      multiple paragraphs
    * fixed mistakes in DocBlockTags.inc doc comments
    * fixed 566663, @param &$arg broken

2003-02-04	Gregory Beaver 
    * fixed stupid bug introduced in LinkClasses
    * started work on PackagePageElements doc comments
    * cleaned up LinkClasses.inc doc comments
    * cleaned up Io.inc doc comments
    * cleaned up IntermediateParser.inc doc comments
    * cleaned up InlineTags.inc doc comments
    * finished documentation of HighlightParser.inc

2003-02-03	Gregory Beaver 
    * began documentation of HighlightParser.inc
    * cleaned up EventStack.inc doc comments
    * cleaned up Errors.inc doc comments
    * cleaned up DocBlockTags.inc doc comments
    * cleaned up DescHTML.inc doc comments
    * cleaned up Converter.inc doc comments

2003-02-02	Gregory Beaver 
    * fixed up Converter.inc documentation comments
    * made include linking MUCH smarter
    * changed version to 1.2.0rc1, starting feature freeze

-----------------Release 1.2.0beta 3-----------------------
2003-02-02	Gregory Beaver 
    * prepared release
    * Added Harald Fielker's CSVdia2code converter, updated docs
    * removed possibility of more than one @filesource tag
    * fixed small mistake in IntermediateParser that disabled @filesource
    * cleaned up some mistakes in documentation
    * changed @uses syntax.  Now it accepts a description.  Does not allow
      comma-delimited list, each @uses must have its own element
    * changed every @uses in the source to match the new syntax

2003-02-01	Gregory Beaver 
    * added --sourcecode option, to generate highlighted source for every file
      since source code highlighting is still unstable, this might not work
    * added @package tags to everything, to get rid of phpdoc warnings
    * removed cleanup_for_pear.php, not needed any longer
    * removed --pear sets constructors to @access private as this makes no sense
    * fixed 677826, {@link} in @see should raise error

2003-01-31	Gregory Beaver 
    * made --pear set constructors to @access private
    * clarified --pear docs
    * fixed 677105
    * fixed broken links introduced by yesterday's changes
    * added getId() as standard Converter function
    * removed $local parameter from returnSee() in all HTML-based converters

2003-01-30	Gregory Beaver 
    * fixed 677938, whitespace screwy in highlightparser
    * fixed 677821, define not parsed right
    * fixed 677822, {@source} not showing whole line
    * added docblock back into class parsing
    * re-added missing else in Io.inc (thanks Marko)
    * fixed bugs in inherited vars/methods introduced by last change
    * moved most converter functions to Converter, cut down code size, make
      updating easier

2003-01-27	Gregory Beaver 
    * trying fix for 675871
    * fixed 670440, Io::getBase() error with patch from Marko Kaning
    * moved newSmarty() to Converter
    * fixed todolist.html to {$subdir}todolist.html for HTMLSmarty
    * moved highlightsource/highlightdocblocksource to Converter
    * changed getPPageId() to getTutorialId() so that it makes sense
    * forged ahead on Converter documentation
    * fixed stupid {$todolist} instead of {$todolink}
    * fixed up CHMdefaultConverter, no errors with help workshop 4.4
    * fixed fatal error in CHMdefault
    * added forgotten link to @todo list to left frame
    * added a few @todos

2003-01-26	Gregory Beaver 
    * fixed crash in Converter @todo list generation
    * implemented 675194, -cp (Christian will be happy about this one), added
      docs to phpDocumentor.howto.pkg about it
    * implemented 674470, output a list of all @todos
    * fixed bug in new tokenizer parser when inline tags have no params
      like {@source}, {@inheritdoc}

2003-01-25	Gregory Beaver 
    * fixed trivial warnings in both HTML Converters
    * fixed HighlightSource in HTMLSmarty Converter
    * removed confusing "assuming package XXX" if no @package tag
    * improved look of PDF Converter slightly
    * added @filesource, @example support to PDF Converter
    * fixed 661317, subpackage tutorial links broken in PDF Converter

2003-01-24	Gregory Beaver 
    * fixed 674059, added makedocs.ini
    * fixed 674053, missing require_once support in old Parser
    * started work on single @todo listing for whole project
    * completed inline tag support and {@internal}} support
    * fixed all the weird linebreak problems
    * fixed ghastly green color of core tags in highlighted source
    * fixed hang in HighlightParser

2003-01-23	Gregory Beaver 
    * applied test fix for determining whether we are in PEAR or not
    * add find_phpdoc.php
    * fixed 671620, warning in Parser.inc
    * fixed 672149, @desc broken
    * HIGHLY improved HighlightParser.  It is now stable
    * made all source-related tags use HighlightParser

2003-01-22	Gregory Beaver 
    * improved documentation slightly for inline {@id} and WordParser::getWord()

2003-01-21	Gregory Beaver 
    * improved HighlightParser, it's almost stable now

2003-01-20	Gregory Beaver 
    * improved HighlightParser, it's almost stable now


2003-01-19	Gregory Beaver 
    * added new HighlightParser for doing phpxref-style stuff.  Still unstable
    * removed faulty "fix" for HTML*Converter::PreserveWhiteSpace()
    * added "name" to list of classes on a page, in addition to sdesc, link
    * updated documentation for DocBlock Desc
    * applied recent HTMLframes fixes to CHMdefault
    * fixed stupid HTMLframes_outputfilter usage in Smarty Converter
    * fixed 670205 inherited methods have no links
    * fixed 670350, package-level doc woes in HTMLframes
    * fixed documentation typos pointed out by Darren Cook
    * added inline example using  to tags.example.pkg
    * added <> for escaping tags in desc, so <> instead of
      >code<
    * added , ,  as per request
    * fixed terrible nesting bug(s) in ParserDescCleanup
    * fixed 670903

2003-01-18	Gregory Beaver 
    * changed version to beta3 for next cycle
    * fixed 670341, 
       not quite working for HTML converters

-----------------Release 1.2.0beta 2-----------------------
2003-01-17	Gregory Beaver 
    * implemented 650251, @filesource
    * implemented 670184, @example
    * added @uses documentation
    * fixed 669909, package pages don't work with PDF, by removing package page
      support: all package pages must be in tutorial format to work well anyways
    * added docs for @example, haven't implemented it yet though
    * fixed 669615, methods disappear
    * implemented {@internal}}
    * fixed 669613, fatal error in XML:DocBook
    * fixed 669640 javadocdesc broken
    * fixed 669525, child class sdesc wrong in parent documentation
    * implemented @internal, have to think about how to do {@internal}
    * implemented --ignore-tags feature request
    * fixed 669132, weird @package/@ignore combo causes problems
    * fixed bug in 
       handling pointed out by Dan
    * applied Christian Dickmann's fixes to Smarty Converter

2003-01-16	Gregory Beaver 
    * improved use of tab panes in phpedit template

2003-01-14	Gregory Beaver 
    * fixed wrong linking to package-level page in HTMLframesConverter
    * fixed phpedit template annoying bug tabpane not selected when an anchor is
      selected

2003-01-13	Gregory Beaver 
    * fixed bug caused by not unsetting strings parsed in function body
    * cleaned up inherited vars/methods in phpedit template
    * fixed sorting of methods so constructor/destructor are always first in the list
    * removed element index from subpackage in phpedit template, redundant
    * fixed 666307, whitespace not ignored for @tags that need it
    * added more documentation
    * added pear_phpdoc file for pear release

2003-01-11	Gregory Beaver 
    * added use of ifunction_call to html templates
    * added ifunction_call variable to Smarty/frames converter with intricate
      function call output for customization

2003-01-10	Gregory Beaver 
    * made it 1.2.0beta1b
    * added feature 663439 -p, --pear commandline switch
      - destructor detection
      - $_privatevar/$_privatemethod detection, warning if no @access private
      - guesses package based on dir location relative to pear/ (package DB is
        in pear/DB, package DB subpackage tests is pear/DB/tests)
    * since pear.php.net is foobared, updating beta1a to include new features

2003-01-08	Gregory Beaver 
    * no @package warning was a bit overzealous (reported no @package for every
      file, sometimes twice :).  Now it works
    * fixed silly bug in phpDocumentorTParser.inc, no $this-> in $this->_pv_quote_data
    * readied PEAR 1.2.0beta1a release now that Archive_Tar has been fixed

2003-01-07	Gregory Beaver 
    * implemented feature 663436, title available for all pages in HTMLSmarty/frames
    * implemented feature 663437, error if @package missing
    * fixed bug 664058, @param not displayed in HTMLframesConverter

2003-01-06	Gregory Beaver 
    * fixed bug in checkIgnore for parsing CHANGELOG/README/INSTALL
    * fixed bug in checkIgnore for create_package.xml.php
    * fixed bug 662630, {}-delimited vars in strings in functions screws up new parser

2003-01-04	Gregory Beaver 
    * fixed warning in new tokenizer parser
    * fixed web interface

2003-01-04	Joshua Eichorn 
    * Make lists in Smarty templates have smaller padding/margin

2003-01-04	Gregory Beaver 
    * changed self-location code to dirname(realpath(__FILE__))
    * fixed stupid bug introduced by removing static from frames converter
    * removed static from frames converter
    * fixed bug 661976 - @see broken
    * fixed stylesheet for l0l33t

2003-01-02	Gregory Beaver 
    * removed all html output for xmldocbookconverter except errors.html
    * made all DescHTML classes in DescHTML subpackage
    * made all PackagePageElements classes in Tutorials subpackage
    * moved Documentation/spec/ to Documentation/old/
    * fixed up create_package.xml.php for next release
    * added Release-1.2.0beta1
    * fixed bug in Io.inc for ignore dir/ on windows
    * fixed bug 661316, @tutorial tutorial.ext#section broken
    * modified manual as per Josh's suggestions
    * fixed bug in HTMLSmartyConverter if -o HTML:Smarty:default,HTML:Smarty:PHP
      the second run of smarty wouldn't generate $this->package_index because of
      the use of a static variable.  Switched it to a class variable.
    * removed all static vars from HTMLSmartyConverter, switched them to class
      variables.
    * fixed HTMLSmartyConverter index.html problems

2003-01-01	Gregory Beaver 
    * Happy New Year!
    * fixed new_phpdoc.php clickable helper thingies
    * same fix for phpdoc.php
    * fixed warning in InlineTags.inc
    * fixed warnings in ParserDescCleanup.inc
    * fixed crash in PDFdefaultConverter on unknown tag
    * added media directory for PDF:default:default
    * fixed formatting of converting information display in walk_everything()
    * fixed bug 658120 - PDFdefaultConverter define.tpl typo that was wreaking havoc
    * fixed warnings in phpDocumentorTParser
    * fixed bug 658121 - sorting issues in PDFdefaultConverter
    * fixed bug if multiple templates in -o command-line
    * updated sample .ini files in user/

2002-12-31	Gregory Beaver 
    * made {@source} absolutely kickass for phpDocumentorTParser, now highlights in all output formats!
    * fixed phpDocumentorTParser bug if there is a $variable in a "string"
    * added more documentation, fixed up existing docs
    * reformatted whitespace to spaces, docblocks to PEAR-desired format

2002-12-30	Gregory Beaver 
    * restored refnamediv - broke titles!
    * fixed a few small bugs in new parser
    * fixed @link tag - wasn't linking!
    * fixed missing line number in defines for HTMLframesConverter
    * added missing var_default to HTML:frames:phpedit vars.tpl template
    * finished experimental tokenizer-based parser, disabled for php < 4.3.0
    * tokenizer parser is twice as fast as original parser!
    * updated docs to reflect new parser

2002-12-29	Gregory Beaver 
    * fixed bug in {@id}, tutorial name was not being passed to packagepageparser
    * fixed problems in PDF Converter
    * removed refnamediv from output (it is considered the title of refentry)
    * fixed bug, no refsect1s past the first one were being parsed for {@toc}
    * fixed bug, titles not being parsed out properly in several cases for {@toc}
    * started work on a tokenizer-based parser, phpDocumentorTParser

2002-12-27	Gregory Beaver 
    * added support for  in DocBlock desc (oops)
    * added tag contents detail in tutorials for unmatched tag error
    * added unterminated attribute error in tutorials, very handy!
    * fixed attributes in tutorials, added quote handler
    * added {@toc} tag to allow table of contents (of current file) to be easily
     inserted anywhere in a tutorial

2002-12-26	Gregory Beaver 
    * added conversion of docbook tables into html/chm, fixed bug in attribute parsing
      of tutorials

2002-12-25	Gregory Beaver 
    * Merry Christmas!
    * added automatic retrieval of section/subsection title for {@tutorial tutorial.ext#section.subsection}
    * added missing ; to class.tpl and page.tpl in XML:DocBook:peardoc2
    * fixed getPPageId() for HTML/CHM converters, should have just been returning id so that it
      would allow {@tutorial tutorial.ext#section.subsection} to work
    * fixed prev/next linking for tutorials again (this time actually works)
    * fixed tutorial tree generation, separated it from tutorial order generation
    * fixed tutorial linking for {@tutorial} in tutorials
    * fixed {@tutorial package/subpackage/tutorial.ext}, was passing subpackage as package
    * removed $childless_tutorials, no longer needed
    * fixed wrong start page for package in HTMLframes
    * added sorting to tutorial order, so the first tutorials are always those of the default package
    * fixed sorting of packages in the package list for HTML converters
    * upgraded new_phpdoc.php to HTML_Treemenu-1.1.2, fixed  addslashes($nodeObj->link) needed in TreeMenu.php

2002-12-24	Gregory Beaver 
    * added output of unknown tags to templates.  Nothing is done with it, but it
      allows the option now
    * fixed subtle bug in Converter::getLink(), if parent::method() is referenced,
      sometimes the package was not set to the only possibility, and all the other
      package possibilities were not removed, allowing a potential crash

2002-12-23	Gregory Beaver 
    * added more documentation, starting converting howto to the new manual format
    * fixed 657934, subtrees not processed in Converter
    * added parsing of comments/process instructions to tutorial parser.  For now,
      it just ignores them
    * spruced up the web interface text, it was a bit awkward, added the new
      converters and templates
    * fixed output for HTMLframesConverter::formatPkgIndex()
    * fixed CHM converter so that it looks half-decent
    * tutorials now work in every converter, every template!

2002-12-22	Gregory Beaver 
    * fixed {@id}, works 100% now.
    * fixed a number of warnings in PDF conversion
    * added {@}inlinetag} converted to {@inlinetag} to allow easy use of
      "{@inlinetag}" as text, like "{@link}" for example
    * added documentation for @tutorial/{@tutorial}
    * fixed bug 657739, need separate categories for tutorial/doc inline tags
    * fixed bug 657726, @uses pseudo-tag @usedby not working right
    * fixed bug 657387, parent/child tutorial converted twice
    * XML:DocBook:peardoc2 is 100%!
    * tutorials work in every converter except CHM
    * CHM upgrade is pushed to next release
    * fixed case issue with README/INSTALL/CHANGELOG parsing

2002-12-21	Gregory Beaver 
	* added new demo .ini, generates documentation in all formats on phpDocumentor
	* HTML:default is officially dead!
	* change HTML:default:* to HTML:frames:*, with big warning message to users
	* templates have stabilized, so ported DOM templates to frames converter
	* fixed a few small bugs in HTMLframes Converter
	* 100% of PDF converter is templatized
	* implemented all features that HTML converters have in PDF converter
	* added varname /> option, to use a
	  $this->pdf variable in a function argument
	* fixed bug in PDFdefaultConverter::returnSee()
	* beautified PDF output a bit
	* tutorials are working in everything except XML, CHM converters
	* added 8 new templates for PDF Converter

2002-12-20	Gregory Beaver 
	* stabilized PDFdefaultConverter much more than before
	* moved more formatting out of PDFdefaultConverter and into templates
	* added exciting new 
	  to PDF default converter.  Now any Cezpdf function can be called directly
	  from the templates.  see new footer.tpl/title_page.tpl for example
	* implemented feature 651716, find README/INSTALL/CHANGELOG
	* fixed bug 657041, {@source} not working right
	* fixed Parser::handleLogicBlock() docblock
	* fixed bug 653627 staticvar doesn't work
	* improved sub-tutorial list formatting for other frames templates
	* converted the rest of the tag spec to the new documentation format
	* fixed tree generation of tutorials in Converter
	* fixed HTMLframesConverter tutorial menus
	* fixed bug 654429, prev/next links not working

2002-12-19	Gregory Beaver 
	* fixed problems with PDF Converter output!  needed "wb" in Converter::writefile()
	* fixed phpDocumentor_parse_ini_file(), needed stripcslashes() instead of stripslashes()
	* PDFdefaultConverter is functional, but output is buggy, needs a lot of work
	* added type to global variables, inadvertant omission

2002-12-18	Gregory Beaver 
	* converted documentation for subpackage, var, version to new .pkg docbook format

2002-12-17	Gregory Beaver 
	* moved debug, fancy_debug, alt. def of array_key_exists to common.inc.php
	* Began transfer of PDF converter over to using templates
	* PDF Converter is UNSTABLE at the moment, do not use until bugs are fixed

2002-12-16	Gregory Beaver 
	* 100% tutorial implementation for HTML:*:*!
	* fixed subtle bug in IntermediateParser
	* fixed Prev/Next/Up links
	* 100% tutorial implementation for all HTML:frames templates!

2002-12-15	Gregory Beaver 
	* 100% tutorial implementation for HTML:frames:phpedit!  added next/prev/up links
	  few small bugs with next/prev, will fix later
	* hierarchical tutorial implementation complete for phpedit template, frames converter
	* finished core implementation of hierarchical tutorials in Converter
	* implemented beginning of hierarchical tutorials in Converter, still need
	  to debug it, but it doesn't give any fatal errors
	* added tutorials to left frame of phpedit template so we can see what it
	  looks like

2002-12-14	Gregory Beaver 
	* applied Smarty link fix to frames converter, removed formatUsesList() from both

2002-12-13	Gregory Beaver 
	* fully implemented all but the non-associated tutorials part of feature
	  651275, tutorials, for HTML converters
	* fully implemented feature 651723, @tutorial/{@tutorial} fully work!
	* fixed simple bug in Converter::getTutorialLink()
	* removed annoying DIR_SEP has docblock warning in Smarty.class.php
	* added parsing of  from  as main title of tutorials
	* added  to both Converters.pkg and phpDocumentor.pkg - didn't
	  realize this is a required tag of refentry!
	* moved phpDocumentor_parse_ini_file to common.inc.php so web interface can use it
	* implemented feature 653608, allow user-controlled .ini directory, also allows
	  full path to --useconfig command-line for cases where phpDocumentor is installed
	  by root and used by users with their own config files
	* fixed accidental @tutorial tag in Converter.inc
	* revamped returnSee() to rely on {$subdir}, added output filter function for
	  Smarty Converter to allow removal of annoying $local value
	* fixed Smarty tutorials

2002-12-12	Gregory Beaver 
	* TODO: HTMLSmartyConverter tutorial writing is more complex, gotta fix it
	* fixed Converters.pkg.  Somehow, it was overwritten with phpDocumentor.pkg
	* fixed header.tpl in phpedit template to allow inherited vars to work
	* changed titles of the package-level tutorials Converters.pkg/phpDocumentor.pkg
	* updated all the other HTMLframesConverter templates to use this new functionality
	* added small comment to phpdoc.inc, was complaining about page-level docblock in parse
	* changed PHPEdit tutorial to use tabpanes instead of those annoying + signs
	* fixed Smarty cycle plugin, was adding unnecessary "\n" and screwing up output
	* fixed bug if multiple tutorials (needed to unset $curtag in XMLpackagePageParser)
	* fixed warning when parsing a {@tutorial} inline tag
	* removed accidental {@tutorial} in Errors.inc
	* fixed tutorial linking, added package page association for HTMLframesConverter
	* finished class/procedural page-level tutorial association

2002-12-12	Gregory Beaver 
	* implemented parsing of @tutorial/{@tutorial} and automatic links to
	  class tutorials from the class, and procedural file tutorials.  UNTESTED
	  but if there are no @tutorial/{@tutorial} the parse works normally :)
	* changed format of $tutorials array to match what Converter was expecting.
	  organized now by package/subpackage/tutorial type.

2002-12-11	Gregory Beaver 
	* fixed significant bug 651837, @see package#element, anotherelement breaks
	* implemented core of feature 651275, tutorials.  Tutorials are parsed, and
	  parserTutorials are passed to the Convert() function, but haven't
	  implemented any of the convertTutorial() functions yet
	* implemented parserTutorial, parserTutorialInlineTag, but didn't set up parsing for them
	* added tutorial to the list of allowed tags and inline tags

2002-12-10	Gregory Beaver 
	* fixed bug 650946, open new window for phpdoc.org link
	* removed masterdirectory commandline, implemented MUCH better automatic base
	  determination at the advent of file parsing.
	* removes unintentional duplicate files (if -f filename.ext and -d dir include
	  the same file)

2002-12-09	Gregory Beaver 
	* added htmlentities to  in desc
	* fixed HTMLframesConverter bug in package pages, was outputting into wrong dir for linking
	* fixed bugs in left_frame.tpl of phpedit template, fixed bugs in HTMLframeConverter::makeLeft()
	* added sdesc processing to the list of cool items
	* allow unterminated 
      , now we have 100% javadoc desc compliance :)
	* added 
       to allowed tags in desc/sdesc
	* removed need for adv_htmlentities - with new system, Converter::postProcess() is called
	  on all non-objectified strings, so the appropriate Converter function can be applied
	* fixed nested 
         and 
           parsing of descs, plus allow unterminated 
        • 
	* fixed silly syntax error introduced in Setup.inc.php

2002-12-08	Gregory Beaver 
	* Added the last of the skeleton details to the peardoc2 template, time for testing
	* fixed command-line error in common.inc.php and phpdoc.bat, it should work now
	* fixed bug in @uses formatUsesList for html converters
	* fixed extra ] in method.tpl in phpedit template
	* added Julien Damon's fantastic adaptation of the PHPEdit template to frames converter

2002-12-07	Gregory Beaver 
	* implemented 645775, line numbers
	* finished converting phphtmllib, and tweaked all templates plus HTMLframesConverter
	* fixed bug in default converter introduced by changes to page->name
	* converted phpdoc.de template over to ne frames converter
	* fixed mistakes in l0l33t, default
	* converted l0l33t template over to new frames converter
	* took the <<< out of HTMLframesConverter, added new blank.tpl to allow
	  customizable startup page

2002-12-06	Gregory Beaver 
	* fixed 641334, no support for