Re: Re: [ANNOUNCEMENT] PhpDocumentor-1.2.0beta2 (beta) Released.

That means its running using the default configuration. Checkout http://phpdoc.org/docs/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html for details, if you have more questions feel free to use the help forum on SourceForge http://sourceforge.net/forum/forum.php?forum_id=35065. -joshua eichorn project admin phpDocumentor electroteque wrote:

i just tried it , what does this mean ? Parsing configuration file phpDocumentor.ini... done using default (slower) Parser - get PHP 4.3.0+ and load the tokenizer extension for faster parsing i've had no luk to run phpdoc on my machine yet, i have the binary installed "Pear Announce" <pear-dev@lists.php.net> wrote in message news:20030120013540.48389.qmail@pb1.pair.com...

The new PEAR package PhpDocumentor-1.2.0beta2 (beta) has been released at

http://pear.php.net/.

Release notes ------------- The phpDocumentor team would like to announce the release of phpDocumentor 1.2.0 BETA 2. This is a beta release and may have bugs and may have a

different

structure from the final release The phpDocumentor team would like to announce the release of phpDocumentor 1.2.0 BETA 2. This is a beta release and may have bugs and may have a

different

structure from the final release. This beta differs from 1.2.0Beta in

that it

should work from pear install PhpDocumentor, and has a few bugs fixed and

a few

extra features. phpDocumentor is a JavaDoc-like automatic documentation generator for PHP written in PHP. It is the most versatile tool for documenting PHP. Once again, phpDocumentor brings a great increase in usability with the

1.2

branch. The addition of a tokenizer-based parser increases parsing speed

by

up to 4 times (that's 400% faster) compared to previous versions. In

addition,

scalability has been improved, allowing generation of documents in

multiple

output formats with one command. The usage of config files makes

repetitive

parsing tasks straightforward and reduces the chance for error. The addition of DocBlock templates, extended documentation (tutorials)

parsing,

and many other new features make this release the most useful automatic documentor for any programming language. The default HTML Converter has been ported to a new Smarty-based

converter,

HTMLframesConverter, and all of the old templates have been ported to the

new

Smarty-based format. The HTMLdefaultConverter has been deprecated since

its

functionality is redundant. Due to the time it takes to convert a

template to

the new format, the phpDocumentor team extends an offer to do this

conversion

for anyone who has a brand new template. We may also include the template

in a

future release, if permission is granted. Due to interest from PEAR programmers, there is a new beta-quality

XML:DocBook

converter with peardoc2 templates. This converter could also generate

other

DocBook formats, if desired, but does not generate indexing for this

release.

The PDF Converter has stepped up to beta-quality, is fully templatable,

and

has most bugs completely fixed. The CHM converter has also taken major

strides

and is close to beta quality. As predicted, the Smarty template engine is the primary template engine

for

all converters. For users new to phpDocumentor, phpDocumentor uses an event-driven parser and intermediary data structures that allow it to perform at a level other automatic documentors for PHP cannot achieve: --parsing any php file, with multiple classes and functions in the same

file

--fully compliant with even the most esoteric php syntax ($string = <<< EOF, for example) --ability to generate multiple output formats --extremely fast parsing --error/warnings by line number and file to allow for debugging of documentation tags --multiple output templates to easily customize the look of generated documentation --extensive documentation of the package, including a detailed

specification

for tags and the included template engine --open source, GPL A full listing of all closed bugs and feature requests can be found in the next section of the notes phpDocumentor 1.2.0BETA2 is not ready for production use documenting any

PHP

project, although it is very stable. Download it and try the most

advanced

solution for PHP documentation today to help us find the last persistent

bugs.

There are MANY in the new XML DocBook Converter. Please try it out and

find

them so we can begin to fix them. HTML Converters are both very stable,

as is

the Parser. Package Info ------------- The phpDocumentor tool is a standalone auto-documentor similar to JavaDoc. It differs from PHPDoc in that it is much faster, parses a much wider

range of

php files, and comes with many customizations including 10 HTML templates, windows help file CHM output, PDF output, and XML DocBook peardoc2 output for use with documenting PEAR. The project is in beta cycle, and will be adding new features before the

final

release of 1.2.0. However, the parser is very stable, the HTML Converters

are

very stable, the PDF Converter is beta-quality, the CHM Converter is

stable,

and the XML Converter is alpha and needs testing from users to find bugs.

Output

is generated with no PHP errors, what we need is to find errors in the

generated

output. Related Links ------------- Package home: http://pear.php.net/package-info.php?package=PhpDocumentor Changelog:

http://pear.php.net/package-changelog.php?package=PhpDocumentor

Download: http://pear.php.net/get/PhpDocumentor-1.2.0beta2.tgz Authors ------------- Greg Beaver (lead)