Permalink
Browse files

rest of import

git-svn-id: http://svn.php.net/repository/pear/packages/PhpDocumentor/trunk@198623 c90b9560-bf6c-de11-be94-00142212c4b1
  • Loading branch information...
1 parent 7840640 commit 4e8c1733d7b5c13edb5296a1d18f8fb32d0a7ea7 Joshua Eichorn committed Oct 17, 2005
Showing 1,618 changed files with 197,493 additions and 0 deletions.
@@ -0,0 +1,32 @@
+PhpDocumentor Version 0.2.4
+
+First i would like to thank Juan Pablo Morales <ju-moral@uniandes.edu.co> for the
+improved web interface that he wrote. I would also like to thank Stefan Hojer
+(redcube at sf) for submitting so many bugs. I'm sure everyone will appreciate
+all the fixes that got into this release because of him.
+
+Release 0.2.4 is mainly composed of bug fixes but it also contains one major new
+feature, the @package tags and @subpackage tags are now used. This allows you
+to divide your code into groups which makes the documentation from large applications
+much more usable.
+
+I'm sorry if i didn't get the new feature you wanted added out there in this release
+I've been pretty busy at my real job so i haven't been able to put the hours into
+phpdoc that I've wanted to. If you have something you would like added to phpdoc
+please file at bug report at sourceforge. This will keep things from getting lost
+and will annoy me into getting my butt in gear and adding what you want.
+
+Also if you haven't noticed yet I'm starting to write some documentation the howto is
+available at http://phpdocu.sourceforge.net/howto.php
+
+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/
+(phpdoc.org might not be back up yet, since i haven't taken the time to move stuff over to the
+new server but sf has the same content)
+
+Hope you enjoy,
+-Joshua Eichorn
+jeichorn@phpdoc.org
@@ -0,0 +1,63 @@
+PhpDocumentor Version 0.2.5
+################################################################################
+################################################################################
+
+The focus of this release was mainly bug fixes and new features for handling the
+which files phpdoc will parse.
+
+hidden directories and files and now ignored by default, there is a command line
+option for changing this behavior if needed
+
+files not to parse can be specified
+directories not to parse can be specified
+Both of these options only work in php 4.0.5 or greater, but everything should
+still work with 4.0.2 or greater, php version 4.0.5 or greater is recommened
+for this verision
+
+The template directory can now be changed allowing for custom templates to be
+used without overwriting files in the templates/default directory
+
+Not all of these options are available through the web-interface, though it was
+updated to allow files and directories to be ignored to be specified
+
+This will be the last 0.2.x release that contains new features, the new 0.3.x
+series will contain new features that i have been putting off, including:
+ XML output
+ Default HTML template that makes more use of css and html4 complaint
+ Alternate HTML template similar to Ulf Wendel's phpdoc
+ Clean up of template class to allow for new features
+ Autogeneration of web interface so that it keeps upto date with cli
+ A web and php-gtk based class browser that uses the xml output files
+ A test framework to use for regression and bug testing
+
+
+################################################################################
+
+The following bugs are fixed in version 0.2.5:
+ [ #441433 ] Escape-Characters in Strings...
+ [ #441778 ] Empty stylesheet.css
+ [ #442011 ] Provide options for skipping directories (partial fix)
+ [ #445305 ] Multi-line desc. for @param not working.
+ [ #443153 ] multiple authors not showing up
+ [ #445298 ] Multiple @see tages not showing up.
+ [ #445820 ] Parser broken on "array" ...
+
+
+
+################################################################################
+
+Also if you haven't noticed yet I'm starting to write some documentation the
+howto is available at http://phpdocu.sourceforge.net/howto.php
+
+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
+jeichorn@phpdoc.org
@@ -0,0 +1,73 @@
+PhpDocumentor Version 0.2.6
+################################################################################
+################################################################################
+
+Well I haven't got a chance to start the 0.3.x series. But that works out the
+best since a new php extension that produces xml using the zend engine as
+surfaced. At some point this will become a parser for this xml and a front-end
+for running things. At the moment the extension isn't stable but there some
+hope for having a really good parse engine built into php somewhere in the
+php 4.1.x series.
+
+Now onto the changes in the new version. I've got quite a bit activity from
+others in the last few months including a patch fixing the rest of the win32
+directory problems by Florian Clever. There is also a small patch added by
+Gerard CANTEGRIL <CANTEGRIL_Gerard@stna.dgac.fr> that updates the web interface.
+
+Thanks to Dennis Kehrig <TheGeek@web.de> for his new template, to use just
+add -td templates/l0l33t/ when you run phpdoc. The template doesn't use tables
+and has a nice clean look. Here is Dennis intro to it
+ I have created an alternate template for phpDoc. Because I often used
+ <UL> and <LI> and did not use <TABLE>, I first thought of Ul-Li-Ta and
+ therefore of Lolita. And since we are computer geeks, l0l33t@ would be
+ funny, too ;) So that's the name...
+
+Thanks to Gregory Beaver <cellog at users.sourceforge.net> for all the recent
+bug filing, and patches
+
+Keep the patchs coming its great to see improvments and bug fixes coming from
+someone else.
+
+################################################################################
+
+The following bugs are fixed in version 0.2.6:
+ [ #460180 ] @remarks things
+ [ #460182 ] multiple vars declaration on one line
+ [ #472445 ] error parsing my file
+ [ #511336 ] .php4 files not scanned
+ [ #489398 ] Error displaying default value correctly
+ [ No bug# ] {sdesc} and {desc} showing on procedural pages with no top
+ of page docblock
+ [ #539593 ] more than 1 @see not parsed right
+ [ #540341 ] BUGFIX '\'whatever' parsed wrong
+ [ #540368 ] BUGFIX } followed by } in class
+ [ #540388 ] BUGFIX } followed by } in class - duplicate
+ [ #489260 ] Function being placed into class
+ [ #519768 ] php4.0.6 gives Warning about array_map
+
+
+ There of course might be a number of other things i fixed but didn't record
+
+Know Issues in version 0.2.6:
+ Procedural code after a class is not documented, there were thrown into
+ the class before I fixed bug #540368
+
+
+
+################################################################################
+
+Also if you haven't noticed yet I'm starting to write some documentation the
+howto is available at http://phpdocu.sourceforge.net/howto.php
+
+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
+jeichorn@phpdoc.org
@@ -0,0 +1,50 @@
+PhpDocumentor Version 0.3.0
+################################################################################
+################################################################################
+
+This release brigns us close to being feature complete, all we need now are some
+more indexes. If anyone wants to help out, thats a good task to work on.
+
+Now onto the changes in the new version. This release is mainly the addition
+of linking @see comments, and creating full inheirtance trees. Showing methods
+inheirited from parent class has also been added. Howto.html has also been
+updated so the documentation is much better.
+
+Each template can have its own stylesheet.css file and it is automaticaly copied
+to the output directory. PHPDocumentor ships with 2 different templates, the
+default one, which uses a table layout, and looks like JavaDoc, and non tabled
+version template called l0l33t@ to use it just add -td templates/l0l33t/.
+
+Thanks to Gregory Beaver <cellog@users.sourceforge.net> for writing the linking
+stage, parse so @see tags work, and for updating the howto.php
+
+
+################################################################################
+
+The following bugs are fixed in version 0.3.0:
+ [ No bug # ] Fix for odd escaping combinations in quotes
+
+
+Know Issues in version 0.3.0:
+ Procedural code after a class is not documented, there were thrown into
+ the class before I fixed bug #540368
+
+
+
+################################################################################
+
+Also if you haven't noticed yet I'm starting to write some documentation the
+howto is available at http://phpdocu.sourceforge.net/howto.php
+
+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
+jeichorn@phpdoc.org
@@ -0,0 +1,73 @@
+PhpDocumentor Version 0.4.0 The BETA Release
+################################################################################
+################################################################################
+
+With this release were into the beta cycle. All important features are there
+and there shouldn't be any big bugs left. Were of course always looking for
+great new features and bug fixes, keep up the support.
+
+Thanks to Gregory Beaver <cellog@users.sourceforge.net> for all his help on
+making this release possible. He will be gone until late May so development
+will slow down for a bit, but don't worry 1.0 will be released before he gets
+back.
+
+In 0.4.1 im planing on updating to template engine to somethign with a couple
+more features. This will change the basic syntax for loops and includes,
+I will provide documentation so anyone who has custom templates should be able
+to make a quick update to the new engine. Also if you have a custom template
+and you think others would enjoy email it to me, or post it on the SF site
+and i'll include it in the main release.
+
+################################################################################
+
+The following bugs are fixed in version 0.4.0:
+ [ 541890 ] Non default templates out of date
+ [ 542586 ] @access private shouldn't document
+ [ 541283 ] needs htmlspecialchars
+ [ 541900 ] Some PHP echo syntax not covered
+ [ 541899 ] Javascript functions documented as PHP
+ [ 541893 ] Web interface should be index.php
+ [ 542348 ] function links currently by page
+ [ 542349 ] constants indexed incorrectly in CVS
+ [ 541887 ] Should work at E_ALL
+ [ 542223 ] parsing of defines breaks
+ [ 541891 ] @package for procedural pages
+ [ 460181 ] Links into comments
+ [ 541892 ] Update Howto
+ [ 541889 ] file extensions should be easy to change
+ [ 540795 ] default globals
+ [ 527252 ] multiple classes in a single file
+ [ 489259 ] Nav Frame Dups
+ [ 445299 ] @see values not being linked. (Really in 0.3.0)
+
+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 its not totaly fixed at:
+http://sourceforge.net/tracker/?group_id=11194&atid=111194
+
+Just change the filters to see all Bugs.
+
+Features added that had Feature Request entries in SF:
+ [ 541895 ] Create a PHPDOC spec
+ [ 541905 ] Global Package Page
+ [ 541898 ] Parse Packages into individual directori
+ [ 441435 ] Class hierarchy
+ [ 541901 ] Use first @package for procedural (wont implement)
+
+################################################################################
+
+The documentation has been updated for this release you can view it at
+http://phpdocu.sourceforge.net/howto.php
+
+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
+jeichorn@phpdoc.org
@@ -0,0 +1,83 @@
+PhpDocumentor Version 0.4.1 The BETA Release
+################################################################################
+################################################################################
+
+This release brings PhpDocumentor to a new level. PhpDocumentor is now capable of
+parsing any project documented with the parser from phpdoc.de in mind, as well
+as projects that will make phpdoc.de's parser choke.
+
+PhpDocumentor is fully ready for parsing of any project.
+
+We added support for:
+* documenting include/require/include_once/require_once
+* @param without a variable name (phpdoc.de style), the parser is smart and fills it in
+* @var to specify a class variable's type
+* inheritance of package/subpackage to classes, so you don't have to add a DocBlock with @package to every child class
+* class trees by package
+* default package is not documented if nothing is in it, generated docs can be used right out of the box
+
+We changed the parser from a long switch statement to a lookup function table, with a
+slight improvement in speed, which is dramatic for large projects, as well as allowing
+much more detailed documentation of the parser.
+
+Thanks to Gregory Beaver <cellog@users.sourceforge.net> for all his help on
+making this release possible. He will be gone until late May so development
+will slow down for a bit, but don't worry 1.0 will be released before he gets
+back.
+
+The plan to update the template engine has been pushed to 1.0. This will change
+the basic syntax for loops and includes, I will provide documentation so anyone
+who has custom templates should be able to make a quick update to the new engine.
+Also if you have a custom template and you think others would enjoy email it to
+me, or post it on the SF site and i'll include it in the main release.
+
+TODO for 1.0:
+* add warnings/errors like phpdoc.de with line number information.
+* add template HOWTO
+* continue to improve and update documentation as features are added
+* improve the web interface
+* make a spiffy new default template, perhaps a few others
+* specific ordering of tag output
+
+################################################################################
+
+The following bugs are fixed in version 0.4.1:
+ [ 547212 ] document new event handler functions
+ [ 547435 ] @see subdirectory still broken
+ [ 547433 ] l0l33t inherited templates broken
+ [ 546987 ] inheritance from diff package broken
+ [ 547233 ] generated docs online have linker bug
+ [ 547225 ] some classes parsed many, some none
+ [ 547224 ] procedural page name disappears
+ [ 546994 ] @tags in mid-short desc broken
+ [ 543608 ] @tag with multiple-line description warn
+ [ 545516 ] 0.4.0-Beta DataDocBlock::listKeywords()
+
+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 its not totaly fixed at:
+http://sourceforge.net/tracker/?group_id=11194&atid=111194
+
+Just change the filters to see all Bugs.
+
+Features added that had Feature Request entries in SF:
+ [ 541901 ] Use first @package for procedural
+
+
+################################################################################
+
+The documentation has been updated for this release you can view it at
+http://phpdocu.sourceforge.net/howto.php
+
+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
+jeichorn@phpdoc.org
Oops, something went wrong.

0 comments on commit 4e8c173

Please sign in to comment.