$Id: Release-1.3.0,v 1.2 2004/04/11 17:52:47 jeichorn Exp $ PhpDocumentor Version 1.3.0 ################################################################################ http://www.phpdoc.org Joshua Eichorn jeichorn@phpdoc.org Gregory Beaver cellog@users.sourceforge.net ################################################################################ ################################################################################ The phpDocumentor team would like to announce the release of phpDocumentor 1.3.0. This release adds in PHP 5 support, highlighting of tutorial XML, beautifying of output from the XML:DocBook/peardoc2:default converter, and fixes a few bugs found in 1.2.3.1. In addition, output from source highlighting is much more efficient, resulting in slightly smaller file size for sourcecode=on. Also, multi-national characters are now allowed in a package name - at your own risk. I found that Apache 1.3 could not serve files with multi-national characters, but when loaded directly from disk, web browsers did just fine. ------ IMPORTANT: phpDocumentor 1.3.0 requires PHP version 4.2.0 or greater. phpDocumentor will function best with PHP version 4.3.0 or greater, as it will use of the tokenizer extension if php 4.3.0 is installed for a tremendous increase in parsing speed. ------ WARNING: The PDF Converter will not work in PHP5. The PDF library that it relies upon segfaults with the simplest of files. Generation still works great in PHP4 ------ Speaking of speed, do NOT run the PDF Converter with --sourcecode = on for any medium to large sized projects. I had to kill a PDF generation after 36 hours on a Pentium IV 2.66GHz computer - 36 hours! The design of the PDF generation library is tremendously inefficient, probably on the order of O(n^2). I'd fix this if I knew anything about PDF. If there are any users out there with the time and expertise to look into the algorithms used by CPdf, we would all appreciate it. This version removes the unmaintained and not very useful dia2codeConverter A full listing of all closed bugs and feature requests can be found in the next section of the notes phpDocumentor 1.3.0 is ready for production use documenting any PHP project, download it and try the most advanced solution for PHP documentation today. ################################################################################ The following bugs are fixed in version 1.3.0 [ 834941 ] inline @link doesn't work within [ 839092 ] CHM:default:default produces bad links [ 839466 ] {$array['Key']} in heredoc [ 840792 ] File Missing XML:DocBook/peardoc2:default "errors.tpl" [ 850731 ] No DocBlock template after page-level DocBlock? [ 850767 ] MHW Reference wrong [ 854321 ] web interface errors with template directory [ 856310 ] HTML:frames:DOM/earthli missing Class_logo.png image [ 865126 ] CHM files use hard paths [ 869803 ] bad md5sum [ 871764 ] @global doesn't work properly with whitespace after the $var [ 875525 ]
  • escapes 
     and ignores paragraphs
 [ 876674 ] first line of pre and code gets left trimmed
 [ 877229 ] PHP 5 incompatibilities bork tutorial parsing
 [ 877233 ] PHP 5 incompatibilities bork docblock source highlighting
 [ 878911 ] [PHP 5 incompatibility] argv
 [ 879068 ] var arrays tripped up by comments
 [ 879151 ] HTML:frames:earthli Top row too small for IE
 [ 880070 ] PHP5 visability for member variables not working
 [ 880488 ] '0' file stops processing
 [ 884863 ] Multiple authors get added in wrong order.
 [ 884869 ] Wrong highligthing of object type variables
 [ 892305 ] peardoc2: summary require_once Path/File.php is PathFile.php
 [ 892306 ] peardoc2: @see of method not working
 [ 892479 ] {@link} in // comment is escaped
 [ 893470 ] __clone called directly in PackagePageElements.inc
 [ 895656 ] initialized private variables not recognized as private
 [ 904823 ] IntermediateParser fatal error
 [ 910676 ] Fatal error: Smarty error: unable to write to $compile_dir
 [ 915770 ] Classes in file not showing
 [ 924313 ] Objec access on array

There of course were other small bugs fixed, these were just the bugs with 
entries in source forge.  You can view the bug details or reopen it if
you think it's not totally fixed at:
http://sourceforge.net/tracker/?group_id=11194&atid=111194

Features added that had Feature Request entries in SF for 1.3.0:
 [ 727084 ] Support for custom files to include (README etc).
 [ 749279 ] inline {@example} tag
 [ 799026 ] Images in tutorials
 [ 799232 ] Change behavior of -c key to use any configuration file.
 [ 856770 ] PHP 5 support

################################################################################

The documentation has been updated for this release you can view it at
http://www.phpdoc.org/docs
or in the distribution in the spec directory

The changelog is available in the tarball, or online at 
http://phpdocu.sourceforge.net/Changelog

You can download the newest version from 
http://phpdocu.sourceforge.net/downloads.php

And of course you can reach the webpage at http://phpdocu.sourceforge.net/ or 
http://phpdoc.org/ 

enjoy
-joshua eichorn 
-gregory beaver 


vim: set expandtab :