$Id$

PhpDocumentor Version 1.3.1
################################################################################
http://www.phpdoc.org
Gregory Beaver cellog@php.net
Joshua Eichorn jeichorn@phpdoc.org
################################################################################
################################################################################

The phpDocumentor team would like to announce the release of phpDocumentor
1.3.1.  This release fixes a critical bug in the sourceforge release of
phpDocumentor, and several small bugs.

The peardoc2 converter no longer uses funky PHP source highlighting, leaving
that to the peardoc build instead.

------
IMPORTANT: phpDocumentor 1.3.1 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.  PHP version 5.1.0 or newer is recommended to take
advantage of PHP5-only features.
------

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.

A full listing of all closed bugs and feature requests can be found in the 
next section of the notes

phpDocumentor 1.3.1 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.1
 [ 1544977 ] Command line arguments split by spaces (fix included)
 [ 1545927 ] HTMLSmartyConverter logo not in package
 [ 1573807 ] CHM Convertor does not strip full path for all TOC entries
 [ 1575145 ] '-q on' quiet mode not fully quiet
 [ 1581487 ] subdirectory include another subdirectory doc error.

 - fixed these bugs reported in PEAR:
  Bug #8520: Broken XML when XML_Beautifier is installed
  Bug #8533: require() broken in a lot of places - cannot run!
  Bug #8539: Parser error in create_examples.php
  Bug #8746: XML:DocBook generates warning with function/parameters without @param tag
  Bug #8773: PDF Convertor fails due to being unable to find fonts
  Bug #8914: returning non varibale reference ParserData.inc#500

You can view the bug details or reopen one if
you think it's not totally fixed at:
http://sourceforge.net/tracker/?group_id=11194&atid=111194
http://pear.php.net/bugs/search.php?cmd=display&package_name%5B%5D=PhpDocumentor

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

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://cvs.php.net/viewvc.cgi/pear/PhpDocumentor/ChangeLog?view=markup

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
-gregory beaver <cellog@php.net>
-joshua eichorn <jeichorn@phpdoc.org>


vim: set expandtab :
