updating phpDocumentor, part 2: add new version

1 files changed, 101 insertions, 98 deletions

diff --git a/buildscripts/PhpDocumentor/user/default.ini b/buildscripts/PhpDocumentor/user/default.ini
index 4915f607..9b5714f2 100644
--- a/buildscripts/PhpDocumentor/user/default.ini
+++ b/buildscripts/PhpDocumentor/user/default.ini
@@ -1,98 +1,101 @@
-;; phpDocumentor parse configuration file

-;;

-;; This file is designed to cut down on repetitive typing on the command-line or web interface

-;; You can copy this file to create a number of configuration files that can be used with the

-;; command-line switch -c, as in phpdoc -c default.ini or phpdoc -c myini.ini.  The web

-;; interface will automatically generate a list of .ini files that can be used.

-;;

-;; default.ini is used to generate the online manual at http://www.phpdoc.org/docs

-;;

-;; ALL .ini files must be in the user subdirectory of phpDocumentor with an extension of .ini

-;;

-;; Copyright 2002, Greg Beaver <cellog@users.sourceforge.net>

-;;

-;; WARNING: do not change the name of any command-line parameters, phpDocumentor will ignore them

-

-[Parse Data]

-;; title of all the documentation

-;; legal values: any string

-title = phpDocumentor 1.3.0 Manual

-

-;; parse files that start with a . like .bash_profile

-;; legal values: true, false

-hidden = false

-

-;; show elements marked @access private in documentation by setting this to on

-;; legal values: on, off

-parseprivate = off

-

-;; parse with javadoc-like description (first sentence is always the short description)

-;; legal values: on, off

-javadocdesc = off

-

-;; add any custom @tags separated by commas here

-;; legal values: any legal tagname separated by commas.

-;customtags = mytag1,mytag2

-

-;; This is only used by the XML:DocBook/peardoc2 converter

-defaultcategoryname = Documentation

-

-;; what is the main package?

-;; legal values: alphanumeric string plus - and _

-defaultpackagename = phpDocumentor

-

-;; output any parsing information?  set to on for cron jobs

-;; legal values: on

-;quiet = on

-

-;; parse a PEAR-style repository.  Do not turn this on if your project does

-;; not have a parent directory named "pear"

-;; legal values: on/off

-;pear = on

-

-;; where should the documentation be written?

-;; legal values: a legal path

-target = /home/cellog/output

-

-;; Which files should be parsed out as special documentation files, such as README,

-;; INSTALL and CHANGELOG?  This overrides the default files found in

-;; phpDocumentor.ini (this file is not a user .ini file, but the global file)

-readmeinstallchangelog = README, INSTALL, CHANGELOG, NEWS, FAQ, LICENSE

-

-;; limit output to the specified packages, even if others are parsed

-;; legal values: package names separated by commas

-;packageoutput = package1,package2

-

-;; comma-separated list of files to parse

-;; legal values: paths separated by commas

-;filename = /path/to/file1,/path/to/file2,fileincurrentdirectory

-

-;; comma-separated list of directories to parse

-;; legal values: directory paths separated by commas

-;directory = /path1,/path2,.,..,subdirectory

-;directory = /home/jeichorn/cvs/pear

-directory = /home/cellog/phpdoc

-

-;; template base directory (the equivalent directory of <installdir>/phpDocumentor)

-;templatebase = /path/to/my/templates

-

-;; directory to find any example files in through @example and {@example} tags

-;examplesdir = /path/to/my/templates

-

-;; comma-separated list of files, directories or wildcards ? and * (any wildcard) to ignore

-;; legal values: any wildcard strings separated by commas

-;ignore = /path/to/ignore*,*list.php,myfile.php,subdirectory/

-ignore = templates_c/,*HTML/default/*,spec/

-

-;; comma-separated list of Converters to use in outputformat:Convertername:templatedirectory format

-;; legal values: HTML:frames:default,HTML:frames:l0l33t,HTML:frames:phpdoc.de,HTML:frames:phphtmllib,

-;;               HTML:frames:earthli,

-;;               HTML:frames:DOM/default,HTML:frames:DOM/l0l33t,HTML:frames:DOM/phpdoc.de,

-;;               HTML:frames:DOM/phphtmllib,HTML:frames:DOM/earthli

-;;               HTML:Smarty:default,HTML:Smarty:PHP,HTML:Smarty:HandS

-;;               PDF:default:default,CHM:default:default,XML:DocBook/peardoc2:default

-output=HTML:frames:earthli,HTML:frames:default,HTML:frames:l0l33t,HTML:frames:phpdoc.de,HTML:frames:phphtmllib,HTML:frames:DOM/default,HTML:frames:DOM/l0l33t,HTML:frames:DOM/phpdoc.de,HTML:frames:DOM/earthli,HTML:frames:DOM/phphtmllib,HTML:frames:phpedit,HTML:Smarty:default,HTML:Smarty:PHP,HTML:Smarty:HandS,CHM:default:default,PDF:default:default

-

-;; turn this option on if you want highlighted source code for every file

-;; legal values: on/off

-sourcecode = on
\ No newline at end of file
+;; phpDocumentor parse configuration file
+;;
+;; This file is designed to cut down on repetitive typing on the command-line or web interface
+;; You can copy this file to create a number of configuration files that can be used with the
+;; command-line switch -c, as in phpdoc -c default.ini or phpdoc -c myini.ini.  The web
+;; interface will automatically generate a list of .ini files that can be used.
+;;
+;; default.ini is used to generate the online manual at http://www.phpdoc.org/docs
+;;
+;; ALL .ini files must be in the user subdirectory of phpDocumentor with an extension of .ini
+;;
+;; Copyright 2002, Greg Beaver <cellog@php.net>
+;;
+;; WARNING: do not change the name of any command-line parameters, phpDocumentor will ignore them
+
+[Parse Data]
+;; title of all the documentation
+;; legal values: any string
+title = phpDocumentor Manual
+
+;; parse files that start with a . like .bash_profile
+;; legal values: true, false
+hidden = false
+
+;; show elements marked @access private in documentation by setting this to on
+;; legal values: on, off
+parseprivate = off
+
+;; parse with javadoc-like description (first sentence is always the short description)
+;; legal values: on, off
+javadocdesc = off
+
+;; add any custom @tags separated by commas here
+;; legal values: any legal tagname separated by commas.
+;customtags = mytag1,mytag2
+
+;; This is only used by the XML:DocBook/peardoc2 converter
+defaultcategoryname = Documentation
+
+;; what is the main package?
+;; legal values: alphanumeric string plus - and _
+defaultpackagename = phpDocumentor
+
+;; output any parsing information?  set to on for cron jobs
+;; legal values: on
+;quiet = on
+
+;; parse a PEAR-style repository.  Do not turn this on if your project does
+;; not have a parent directory named "pear"
+;; legal values: on/off
+;pear = on
+
+;; where should the documentation be written?
+;; legal values: a legal path
+;target = /home/cellog/output
+target = /you-MUST/change-me/to-fit/your-environment
+
+;; Which files should be parsed out as special documentation files, such as README,
+;; INSTALL and CHANGELOG?  This overrides the default files found in
+;; phpDocumentor.ini (this file is not a user .ini file, but the global file)
+readmeinstallchangelog = README, INSTALL, FAQ, LICENSE, Release-1.4.0
+
+;; limit output to the specified packages, even if others are parsed
+;; legal values: package names separated by commas
+;packageoutput = package1,package2
+
+;; comma-separated list of files to parse
+;; legal values: paths separated by commas
+;filename = /path/to/file1,/path/to/file2,fileincurrentdirectory
+
+;; comma-separated list of directories to parse
+;; legal values: directory paths separated by commas
+;directory = /path1,/path2,.,..,subdirectory
+;directory = /home/jeichorn/cvs/pear
+;directory = /home/cellog/workspace/phpdoc
+directory = /you-MUST/also-change-me/to-fit/your-environment
+
+;; template base directory (the equivalent directory of <installdir>/phpDocumentor)
+;templatebase = /path/to/my/templates
+
+;; directory to find any example files in through @example and {@example} tags
+;examplesdir = /path/to/my/templates
+
+;; comma-separated list of files, directories or wildcards ? and * (any wildcard) to ignore
+;; legal values: any wildcard strings separated by commas
+;; remember, this pathing is RELATIVE to the top-most directory in your "directory" value
+;ignore = path/to/ignore*,*list.php,myfile.php,subdirectory/
+ignore = pear-*,templates/,Documentation/,test*.php,Lexer.inc
+
+;; comma-separated list of Converters to use in outputformat:Convertername:templatedirectory format
+;; legal values: HTML:frames:default,HTML:frames:l0l33t,HTML:frames:phpdoc.de,HTML:frames:phphtmllib,
+;;               HTML:frames:earthli,
+;;               HTML:frames:DOM/default,HTML:frames:DOM/l0l33t,HTML:frames:DOM/phpdoc.de,
+;;               HTML:frames:DOM/phphtmllib,HTML:frames:DOM/earthli
+;;               HTML:Smarty:default,HTML:Smarty:PHP,HTML:Smarty:HandS
+;;               PDF:default:default,CHM:default:default,XML:DocBook/peardoc2:default
+output=HTML:frames:earthli,HTML:frames:default,HTML:frames:l0l33t,HTML:frames:phpdoc.de,HTML:frames:phphtmllib,HTML:frames:DOM/default,HTML:frames:DOM/l0l33t,HTML:frames:DOM/phpdoc.de,HTML:frames:DOM/earthli,HTML:frames:DOM/phphtmllib,HTML:frames:phpedit,HTML:Smarty:default,HTML:Smarty:PHP,HTML:Smarty:HandS
+
+;; turn this option on if you want highlighted source code for every file
+;; legal values: on/off
+sourcecode = on