phpDocumentor
[ class tree: phpDocumentor ] [ index: phpDocumentor ] [ all elements ]

Source for file config.php

Documentation is available at config.php

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <?php
  3. /**
  4.  * phpDocumentor :: docBuilder Web Interface
  5.  * 
  6.  * Advanced Web Interface to phpDocumentor
  7.  *
  8.  * PHP versions 4 and 5
  9.  *
  10.  * Copyright (c) 2003-2006 Andrew Eddie, Greg Beaver
  11.  * 
  12.  * LICENSE:
  13.  * 
  14.  * This library is free software; you can redistribute it
  15.  * and/or modify it under the terms of the GNU Lesser General
  16.  * Public License as published by the Free Software Foundation;
  17.  * either version 2.1 of the License, or (at your option) any
  18.  * later version.
  19.  * 
  20.  * This library is distributed in the hope that it will be useful,
  21.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  22.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  23.  * Lesser General Public License for more details.
  24.  * 
  25.  * You should have received a copy of the GNU Lesser General Public
  26.  * License along with this library; if not, write to the Free Software
  27.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  28.  *
  29.  * @category   ToolsAndUtilities
  30.  * @package    phpDocumentor
  31.  * @author     Andrew Eddie
  32.  * @author     Greg Beaver <cellog@php.net>
  33.  * @copyright  2003-2006 Andrew Eddie, Greg Beaver
  34.  * @license    http://www.opensource.org/licenses/lgpl-license.php LGPL
  35.  * @version    CVS: $Id$
  36.  * @filesource
  37.  * @see phpdoc.php
  38.  */
  39.  
  40. if (!function_exists'version_compare' )) {
  41.     print "phpDocumentor requires PHP version 4.1.0 or greater to function";
  42.     exit;
  43. }
  44.  
  45. if ('@DATA-DIR@' != '@'.'DATA-DIR@')
  46. {
  47.     $root_dir 'PhpDocumentor';
  48.     $path '@WEB-DIR@/PhpDocumentor/docbuilder/images/';
  49.  
  50.     /**
  51.     * common file information
  52.     */
  53.     include_once("PhpDocumentor/phpDocumentor/common.inc.php");
  54.     include_once("@WEB-DIR@/PhpDocumentor/docbuilder/includes/utilities.php" );
  55.  
  56.     // find the .ini directory by parsing phpDocumentor.ini and extracting _phpDocumentor_options[userdir]
  57.     $ini phpDocumentor_parse_ini_file('@DATA-DIR@/PhpDocumentor/phpDocumentor.ini'true);
  58.     if (isset($ini['_phpDocumentor_options']['userdir'])) {
  59.         $configdir $ini['_phpDocumentor_options']['userdir'];
  60.     else {
  61.         $configdir =  '@DATA-DIR@/PhpDocumentor/user';
  62.     }
  63. else {
  64.     $root_dir dirname(dirname(__FILE__));
  65.     $path 'images/';
  66.  
  67.     // set up include path so we can find all files, no matter what
  68.     $GLOBALS['_phpDocumentor_install_dir'dirname(dirnamerealpath__FILE__ ) ));
  69.     // add my directory to the include path, and make it first, should fix any errors
  70.     if (substr(PHP_OS03== 'WIN'{
  71.         ini_set('include_path',$GLOBALS['_phpDocumentor_install_dir'].';'.ini_get('include_path'));
  72.     else {
  73.         ini_set('include_path',$GLOBALS['_phpDocumentor_install_dir'].':'.ini_get('include_path'));
  74.     }
  75.  
  76.     /**
  77.     * common file information
  78.     */
  79.     include_once("$root_dir/phpDocumentor/common.inc.php");
  80.     include_once("$root_dir/docbuilder/includes/utilities.php" );
  81.  
  82.     // find the .ini directory by parsing phpDocumentor.ini and extracting _phpDocumentor_options[userdir]
  83.     $ini phpDocumentor_parse_ini_file($_phpDocumentor_install_dir PATH_DELIMITER . 'phpDocumentor.ini'true);
  84.     if (isset($ini['_phpDocumentor_options']['userdir'])) {
  85.         $configdir $ini['_phpDocumentor_options']['userdir'];
  86.     else {
  87.         $configdir $_phpDocumentor_install_dir '/user';
  88.     }
  89. }
  90.  
  91. // allow the user to change this at runtime
  92. if (!empty$_REQUEST['altuserdir')) {
  93.     $configdir $_REQUEST['altuserdir'];
  94. }
  95.  
  96. // assign the available converters
  97. $converters = array(
  98.     "HTML:frames:default"            =>    'HTML:frames:default',
  99.     "HTML:frames:earthli"            =>    'HTML:frames:earthli',
  100.     "HTML:frames:l0l33t"            =>    'HTML:frames:l0l33t',
  101.     "HTML:frames:phpdoc.de"            =>    'HTML:frames:phpdoc.de',
  102.     "HTML:frames:phphtmllib"        =>    'HTML:frames:phphtmllib',
  103.     "HTML:frames:phpedit"            =>    'HTML:frames:phpedit',
  104.     "HTML:frames:DOM/default"        =>    'HTML:frames:DOM/default',
  105.     "HTML:frames:DOM/earthli"        =>    'HTML:frames:DOM/earthli',
  106.     "HTML:frames:DOM/l0l33t"        =>    'HTML:frames:DOM/l0l33t',
  107.     "HTML:frames:DOM/phpdoc.de"        =>    'HTML:frames:DOM/phpdoc.de',
  108.     "HTML:frames:DOM/phphtmllib"    =>    'HTML:frames:DOM/phphtmllib',
  109.     "HTML:Smarty:default"            =>    'HTML:Smarty:default',
  110.     "HTML:Smarty:HandS"                =>    'HTML:Smarty:HandS',
  111.     "HTML:Smarty:PHP"               =>    'HTML:Smarty:PHP',
  112.     "PDF:default:default"            =>    'PDF:default:default',
  113.     "CHM:default:default"            =>    'CHM:default:default',
  114.     "XML:DocBook/peardoc2:default"    =>    'XML:DocBook/peardoc2:default'
  115. );
  116.  
  117. // compile a list of available screen shots
  118. $convScreenShots = array();
  119.  
  120. if ($dir opendir($path)) {
  121.     while (($file readdir$dir )) !== false
  122.         if ($file != '.' && $file != '..'{
  123.             if (!is_dir$path $file )) {
  124.                 if (strpos$file'ss_' === 0{
  125.                     $key substr$file);
  126.                     $key str_replace'_'':'$key );
  127.                     $key str_replace'-''/'$key );
  128.                     $key str_replace'.png'''$key );
  129.                     $convScreenShots[$key$file;
  130.                 }
  131.             }
  132.         }
  133.     }
  134. }
  135.  
  136. ?>
  137. <html>
  138. <head>
  139.     <title>
  140.         Form to submit to phpDocumentor v<?php print PHPDOCUMENTOR_VER?>
  141.     </title>
  142.     <style type="text/css">
  143.         body, td, th {
  144.             font-family: verdana,sans-serif;
  145.             font-size: 9pt;
  146.         }
  147.         .text {
  148.             font-family: verdana,sans-serif;
  149.             font-size: 9pt;
  150.             border: solid 1px #000000;
  151.         }
  152.         .small {
  153.             font-size: 7pt;
  154.         }
  155.     </style>
  156.  
  157.     <script src="includes/tabpane.js" language="JavaScript" type="text/javascript"></script>
  158.     <link id="webfx-tab-style-sheet" type="text/css" rel="stylesheet" href="includes/tab.webfx.css" />
  159.  
  160. <script type="text/javascript" language="Javascript">
  161. /**
  162.    Creates some global variables
  163. */
  164. function initializate() {
  165. //
  166. //The "platform independent" newLine
  167. //
  168. //Taken from http://developer.netscape.com/docs/manuals/communicator/jsref/brow1.htm#1010426
  169.     if (navigator.appVersion.lastIndexOf('Win') != -1) {
  170.       $pathdelim="\\";
  171.       $newLine="\r\n";
  172.     } else {
  173.       $newLine="\n";
  174.       $pathdelim="/";
  175.     }
  176. }
  177.  
  178. /**Adds the contents of the help box as a directory
  179. */
  180. function addDirectory($object) {
  181.     //$a = document.helpForm.fileName.value;
  182.     $a = parent.ActionFrame.document.actionFrm.fileName.value;
  183.     $a = myReplace( $a, '\\\\', '\\' );
  184.     if ($a[$a.length - 1] == $pathdelim) {
  185.         $a = $a.substring(0, $a.length - 1);
  186.     }
  187.     if ($a.lastIndexOf('.') > 0) {
  188.         $a = $a.substring(0,$a.lastIndexOf($pathdelim));
  189.     }
  190.     $object.value = prepareString($object.value)+$a;
  191. }
  192. /**Adds the contents of the converter box to the converters list
  193. */
  194. function addConverter($object) {
  195.  $object.value = prepareString($object.value)+document.dataForm.ConverterSetting.value;
  196. }
  197. /**Replaces the converters list with the contents of the converter box
  198. */
  199. function replaceConverter($object) {
  200.  $object.value = document.dataForm.ConverterSetting.value;
  201. }
  202. /**Adds the contents of the help box as a file to the given control
  203. */
  204. function addFile($object) {
  205.     //$a = document.helpForm.fileName.value;
  206.     $a = parent.ActionFrame.document.actionFrm.fileName.value;
  207.     $a = myReplace($a,'\\\\','\\');
  208.     $object.value = prepareString($object.value)+$a;
  209. }
  210. /**Takes a given string and leaves it ready to add a new string
  211.    That is, puts the comma and the new line if needed
  212. */
  213. function prepareString($myString) {
  214.  //First verify that a comma is not at the end
  215.  if($myString.lastIndexOf(",") >= $myString.length-2) {
  216.   //We have a comma at the end
  217.   return $myString;
  218.  }
  219.  if($myString.length > 0) {
  220.   $myString+=","+$newLine;
  221.  }
  222.  return $myString;
  223. }
  224. /**Do the validation needed before sending the from and return a truth value indicating if the form can be sent
  225. */
  226.  function validate() {
  227.   //Take out all newLines and change them by nothing
  228.   //This could be done by using javascript function's replacebut that was implemented only until Navigator 4.0 and so it is better to use more backward compatible functions like substr
  229.   document.dataForm.elements[0].value= stripNewLines(document.dataForm.elements[0].value);
  230.   document.dataForm.elements[1].value= stripNewLines(document.dataForm.elements[1].value);
  231.   document.dataForm.elements[2].value= stripNewLines(document.dataForm.elements[2].value);
  232.   document.dataForm.elements[3].value= stripNewLines(document.dataForm.elements[3].value);
  233.   document.dataForm.elements[4].value= stripNewLines(document.dataForm.elements[4].value);
  234.   document.dataForm.elements[5].value= stripNewLines(document.dataForm.elements[5].value);
  235.   document.dataForm.elements[6].value= stripNewLines(document.dataForm.elements[6].value);
  236.   document.dataForm.elements[7].value= stripNewLines(document.dataForm.elements[7].value);
  237.   //By returning true we are allowing the form to be submitted
  238.   return true;
  239.  }
  240. /**Takes a string and removes all the ocurrences of new lines
  241. Could have been implemented a lot easier with replace but it's not very backwards compatible
  242. */
  243. function stripNewLines( $myString ) {
  244.     return myReplace($myString,$newLine,'');
  245. }
  246.  
  247. function myReplace($string,$text,$by) {
  248.     // Replaces text with by in string
  249.     var $strLength = $string.length, $txtLength = $text.length;
  250.     if (($strLength == 0) || ($txtLength == 0)) {
  251.         return $string;
  252.     }
  253.     var $i = $string.indexOf($text);
  254.     if ((!$i) && ($text != $string.substring(0,$txtLength))) {
  255.         return $string;
  256.     }
  257.     if ($i == -1) {
  258.         return $string;
  259.     }
  260.     var $newstr = $string.substring(0,$i) + $by;
  261.     if ($i+$txtLength < $strLength) {
  262.         $newstr += myReplace($string.substring($i+$txtLength,$strLength),$text,$by);
  263.     }
  264.     return $newstr;
  265. }
  266.  
  267. var screenShots = new Array();
  268. <?php
  269.     $temp = array();
  270.     foreach ($converters as $k=>$v{
  271.         if (array_key_exists$k$convScreenShots )) {
  272.             echo "\nscreenShots['$k'] = '{$convScreenShots[$k]}'";
  273.         else {
  274.             echo "\nscreenShots['$k'] = ''";
  275.         }
  276.     }
  277. ?>
  278.  
  279.  
  280. /** Swaps the converted screen shot image
  281. */
  282.     function swapImage( key ) {
  283.         document.screenshot.src = 'images/' + screenShots[key];
  284.     }
  285.  
  286. </script>
  287.  
  288. </head>
  289.  
  290. <body bgcolor="#ffffff" onload="javascript:initializate()" topmargin="0" leftmargin="0" marginheight="0" marginwidth="0">
  291.  
  292. <!-- onsubmit="return validate()"  -->
  293.  
  294. <form name="dataForm" action="builder.php" method="get" target="OutputFrame">
  295.  
  296. <div class="tab-pane" id="tabPane1">
  297. <script type="text/javascript">
  298.     var tp1 = new WebFXTabPane( document.getElementById( "tabPane1" ));
  299. </script>
  300.     <div class="tab-page" id="tab_intro">
  301.         <h2 class="tab">Introduction</h2>
  302.         Welcome to <b>docBuilder</b>.
  303.         <p>This is the new web-interface for running, in our opinion, the best in-code documentation compiler there is: <b>phpDocumentor</b>.</p>
  304.         <p>What's new in this release?  Heaps of things, but here are the headlines:</p>
  305.         <ul>
  306.             <li>Much greater support for PEAR on both windows and linux</li>
  307.             <li>CHM, PDF and XML:DocBook/peardoc2 converters are all stable!</li>
  308.             <li>New tokenizer-based parser is literally twice as fast as the old parser (requires PHP 4.3.0+)</li>
  309.             <li>New external user-level manual parsing and generation allows cross-linking between API docs and DocBook-format tutorials/manuals!</li>
  310.             <li>Color syntax source highlighting and cross-referencing with documentation of source code in HTML, CHM and PDF with customizable templating</li>
  311.             <li>New Configuration files simplify repetitive and complex documentation tasks</li>
  312.             <li>Brand new extensive manual - which can be generated directly from the source using makedocs.ini!</li>
  313.             <li>Many improvements to in-code API documentation including new tags, and better handling of in-code html tags</li>
  314.             <li>New XML:DocBook/peardoc converter makes generating PEAR manual formats easy for PEAR developers along with the --pear command-line switch</li>
  315.             <li>Many new HTML templates, all of them beautiful thanks to Marco von Ballmoos</li>
  316.             <li>A brand new web interface thanks to Andrew Eddie!</li>
  317.         </ul>
  318.     </div>
  319.  
  320.     <div class="tab-page" id="tab_config">
  321.         <h2 class="tab">Config</h2>
  322.         <table cellspacing="0" cellpadding="3" border="0">
  323.         <tr>
  324.             <td colspan="2"><b>Use a pre-created config file for form values.</b></td>
  325.         </tr>
  326.         <tr>
  327.             <td nowrap="nowrap">
  328.                 <b>change config directory:</b>
  329.             </td>
  330.             <td width="100%">
  331.                 <input size="20" type="text" name="altuserdir" value="" /><input type="SUBMIT" value="Change" name="submitButton" onclick="document.dataForm.target='DataFrame'; document.dataForm.action = 'config.php';document.dataForm.submit();">
  332.         <?php
  333.             if (!empty($_REQUEST['altuserdir'])) {
  334.                 print '<br><i>changed to <b>"'.$_REQUEST['altuserdir'].'"</b></i>';
  335.             }
  336.         ?>
  337.             </td>
  338.         </tr>
  339.         <tr>
  340.             <td nowrap="nowrap">
  341.                 <b>Choose a config:</b>
  342.             </td>
  343.             <td>
  344.  
  345.                 <select name="setting_useconfig">
  346.                       <option value="" <?php if (empty($_REQUEST['altuserdir'])) print 'selected'?>>don't use config file</option>
  347.                       <?php
  348.                       $dirs = array();
  349.                       $dirs phpDocumentor_ConfigFileList($configdir);
  350.                       $path '';
  351.                       $sel ' selected';
  352.                       if (!empty($_REQUEST['altuserdir'])) $path $configdir PATH_DELIMITER;
  353.                       else $sel '';
  354.                       foreach($dirs as $configfile)
  355.                       {
  356.                           print '<option value="'.$path.$configfile.'"'.$sel.'>'.$configfile.".ini</option>\n";
  357.                           $sel '';
  358.                       }
  359.                       ?>
  360.                 </select>
  361.                 <input type="SUBMIT" value="Go" name="submitButton">
  362.             </td>
  363.         </tr>
  364.         <tr>
  365.             <td colspan="2">
  366.                 Normally, phpDocumentor uses the form values from this form to set up parsing.  In version 1.2, phpDocumentor allows you to "save" form values in configuration files so that you can replicate common complicated documentation tasks with only one time.  Just choose a config file below or create a new one and refresh this page to choose it.
  367.             </td>
  368.         </tr>
  369.         </table>
  370.     </div>
  371.  
  372.     <div class="tab-page" id="tab_files">
  373.         <h2 class="tab">Files</h2>
  374.         <table cellspacing="0" cellpadding="3" border="0">
  375.         <tr>
  376.             <td align="right" valign="top" nowrap="nowrap">
  377.                 <b>Files<br />to parse</b>
  378.                 <br />
  379.                 <a href="javascript:addFile(document.dataForm.setting_filename)" title="Add the file in the help box">
  380. <?php
  381.     echo showImage'images/rc-gui-install-24.png''24''24' );
  382. ?></a>
  383.             </td>
  384.             <td valign="top">
  385.                 <textarea rows="5" cols="60" name="setting_filename" class="text"></textarea>
  386.             </td>
  387.             <td valign="top" class="small">
  388.                 This is a group of comma-separated names of php files or tutorials that will be processed by phpDocumentor.
  389.             </td>
  390.         </tr>
  391.         <tr>
  392.             <td align="right" valign="top" nowrap="nowrap">
  393.                 <b>Directory<br />to parse</b>
  394.                 <br />
  395.                 <a href="javascript:addFile(document.dataForm.setting_directory)" title="Add the file in the help box">
  396. <?php
  397.     echo showImage'images/rc-gui-install-24.png''24''24' );
  398. ?></a>
  399.             </td>
  400.             <td valign="top">
  401.                 <textarea rows="5" cols="60" name="setting_directory" class="text" title=""></textarea>
  402.             </td>
  403.             <td valign="top" class="small">
  404.                 This is a group of comma-separated directories where php files or tutorials are found that will be processed by phpDocumentor. phpDocumentor automatically parses subdirectories
  405.             </td>
  406.         </tr>
  407.         <tr>
  408.             <td align="right" valign="top" nowrap="nowrap">
  409.                 <b>Files<br />to ignore</b>
  410.                 <br />
  411.                 <a href="javascript:addFile(document.dataForm.setting_ignore)" title="Add the file in the help box">
  412. <?php
  413.     echo showImage'images/rc-gui-install-24.png''24''24' );
  414. ?></a>
  415.             </td>
  416.             <td valign="top">
  417.                 <textarea rows="5" cols="60" class="text" name="setting_ignore"></textarea>
  418.             </td>
  419.             <td valign="top" class="small">
  420.                 A list of files (full path or filename), and patterns to ignore.  Patterns may use wildcards * and ?.  To ignore all subdirectories named "test" for example, using "test/"  To ignore all files and directories with test in their name use "*test*"
  421.             </td>
  422.         </tr>
  423.         <tr>
  424.             <td align="right" valign="top" nowrap="nowrap">
  425.                 <b>Packages<br />to parse</b>
  426.             </td>
  427.             <td valign="top">
  428.                 <textarea rows="4" cols="60" class="text" name="setting_packageoutput"></textarea>
  429.             </td>
  430.             <td valign="top" class="small">
  431.                 The parameter packages is a group of comma separated names of abstract packages that will be processed by phpDocumentor. All package names must be separated by commas.
  432.             </td>
  433.         </tr>
  434.         </table>
  435.     </div>
  436.  
  437.  
  438.     <div class="tab-page" id="tab_output">
  439.         <h2 class="tab">Output</h2>
  440.         <table cellspacing="0" cellpadding="3" border="0">
  441.         <tr>
  442.             <td align="right" valign="top" nowrap="nowrap">
  443.                 <b>Target</b>
  444.                 <br />
  445.                 <a href="javascript:addFile(document.dataForm.setting_target)" title="Add the file in the help box">
  446. <?php
  447.     echo showImage'images/rc-gui-install-24.png''24''24' );
  448. ?></a>
  449.             </td>
  450.             <td valign="top">
  451.                 <input type="text" name="setting_target" size="60" class="text" />
  452.             </td>
  453.             <td valign="top" class="small">
  454.                 Target is the directory where the output produced by phpDocumentor will reside.
  455.             </td>
  456.         </tr>
  457.         <tr>
  458.             <td align="right" valign="top" nowrap="nowrap">
  459.                 <b>Output<br />Format</b>
  460.             </td>
  461.             <td valign="top">
  462.                 <textarea cols="60" rows="3" name="setting_output" class="text">HTML:Smarty:default</textarea>
  463.                 <br />
  464.                 Output type:Converter name:template name
  465.                 <br />
  466. <?php
  467.     echo htmlArraySelect$converters'ConverterSetting''size="1" class="text" onchange="swapImage(this.options[this.options.selectedIndex].value);"''HTML:Smarty:default' );
  468. ?>
  469.                 <br />
  470.                 <a href="javascript:addConverter(document.dataForm.setting_output)">
  471.                     Add the converter in the help box
  472.                 </a>
  473.                 <br />
  474.                 <br />
  475.                 <img name="screenshot" src="images/ss_HTML_Smarty_default.png" width="200" height="200" border="2" alt="Screen Shot">
  476.             </td>
  477.             <td valign="top" class="small">
  478.                 Outputformat may be HTML, XML, PDF, or CHM (case-sensitive) in version 1.2.
  479.                 <br />There is only one Converter for both CHM and PDF:<br /><i>default</i>.
  480.                 <br />There are 2 HTML Converters:<br /><i>frames</i> or <i>Smarty</i>.
  481.                 <br /><b>frames templates</b> may be any of:
  482.                 <br />
  483.                 <i>default, earthli, l0l33t, phpdoc.de, phphtmllib, phpedit, DOM/default, DOM/earthli, DOM/l0l33t, DOM/phphtmllib, or DOM/phpdoc.de</i>.
  484.                 <br />
  485.                 <b>Smarty templates</b> may be any of:
  486.                 <br />
  487.                 <i>default, HandS, or PHP</i>
  488.                 <br />
  489.                 <strong>XML:DocBook/peardoc2:default</strong> is the only choice for XML in 1.2.2
  490.             </td>
  491.         </tr>
  492.         </table>
  493.     </div>
  494.  
  495.     <div class="tab-page" id="tab_options">
  496.         <h2 class="tab">Options</h2>
  497.         <table cellspacing="0" cellpadding="3" border="0">
  498.         <tr>
  499.             <td align="right" nowrap="nowrap">
  500.                 <b>Generated Documentation Title</b>
  501.             </td>
  502.             <td>
  503.                 <input type="text" name="setting_title" size="40" value="Generated Documentation" class="text">
  504.             </td>
  505.             <td class="small">
  506.                 Choose a title for the generated documentation
  507.             </td>
  508.         </tr>
  509.         <tr>
  510.             <td nowrap="nowrap">
  511.                 <b>Default Package Name</b>
  512.             </td>
  513.             <td>
  514.                 <input type="TEXT" name="setting_defaultpackagename" size="40" value="default" class="text" />
  515.             </td>
  516.             <td class="small">
  517.                 Choose a name for the default package
  518.             </td>
  519.         </tr>
  520.         <tr>
  521.             <td nowrap="nowrap">
  522.                 <b>Default Category Name</b>
  523.             </td>
  524.             <td>
  525.                 <input type="TEXT" name="setting_defaultcategoryname" size="40" value="default" class="text" />
  526.             </td>
  527.             <td class="small">
  528.                 Choose a name for the default category.  This is only used by the peardoc2 converter
  529.             </td>
  530.         </tr>
  531.         <tr>
  532.             <td nowrap="nowrap">
  533.                 <b>Custom Tags</b>
  534.             </td>
  535.             <td>
  536.                 <input type="text" name="setting_customtags" size="40" class="text" />
  537.             </td>
  538.             <td class="small">
  539.                 Custom Tags is a comma-separated list of tags you want phpDocumentor to include as valid tags in this parse.  An example would be 'value, size' to allow @value and @size tags.
  540.             </td>
  541.         </tr>
  542.         <tr>
  543.             <td nowrap="nowrap">
  544.                 <b>Parse @access private and @internal/{@internal}}</b>
  545.             </td>
  546.             <td nowrap="nowrap">
  547.                 <input type="checkbox" name="setting_parseprivate" value="on" />
  548.             </td>
  549.             <td class="small">
  550.                 The parameter Parse @access private tells phpDocumentor whether to parse elements with an '@access private' tag in their docblock.  In addition, it will turn on parsing of @internal tags and inline {@internal}} sections
  551.             </td>
  552.         </tr>
  553.         <tr>
  554.             <td nowrap="nowrap">
  555.                 <b>Generate Highlighted Source Code</b>
  556.             </td>
  557.             <td nowrap="nowrap">
  558.                 <input type="checkbox" name="setting_sourcecode" value="on" />
  559.             </td>
  560.             <td class="small">
  561.                 The parameter Generate Highlighted Source Code tells phpDocumentor whether to generate highlighted XRef source code similar to PHP-XRef output.
  562.             </td>
  563.         </tr>
  564.         <tr>
  565.             <td nowrap="nowrap">
  566.                 <b>JavaDoc-compliant<br />Description parsing.</b>
  567.             </td>
  568.             <td>
  569.                 <input type="checkbox" name="setting_javadocdesc" value="on" />
  570.             </td>
  571.             <td class="small">
  572.                 Normally, phpDocumentor uses several rules to determine the short description.  This switch asks phpDocumentor to simply search for the first period (.) and use it to delineate the short description.  In addition, the short description will not be separated from the long description.
  573.             </td>
  574.         </tr>
  575.         <tr>
  576.             <td nowrap="nowrap">
  577.                 <b>PEAR package repository parsing</b>
  578.             </td>
  579.             <td>
  580.                 <input type="checkbox" name="setting_pear" value="on" />
  581.             </td>
  582.             <td class="small">
  583.                 PEAR package repositories have specific requirements:
  584.                 <ol>
  585.                     <li>Every package is in a directory with the same name.</li>
  586.                     <li>All private data members and methods begin with an underscore (function _privfunction()).</li>
  587.                     <li>_Classname() is a destructor</li>
  588.                 </ol>
  589.                 This option recognizes these facts and uses them to make assumptions about packaging and access levels.  Note that with PHP 5, the destructor option will be obsolete.
  590.             </td>
  591.         </tr>
  592.         </table>
  593.     </div>
  594.  
  595.     <div class="tab-page" id="tab_credits">
  596.         <h2 class="tab">Credits</h2>
  597.         phpDocumentor written by Joshua Eichorn
  598.         <br />Web Interface originally written by Juan Pablo Morales, enhanced by Greg Beaver and super-charged by Andrew Eddie
  599.         <p>
  600.         Joshua Eichorn <a href="mailto:jeichorn@phpdoc.org">jeichorn@phpdoc.org</a>
  601.         <br>Juan Pablo Morales <a href=
  602.         "mailto:ju-moral@uniandes.edu.co">ju-moral@uniandes.edu.co</a>
  603.         <br>Gregory Beaver <a href=
  604.         "mailto:cellog@php.net">cellog@php.net</a>
  605.         <br>Andrew Eddie <a href=
  606.         "mailto:eddieajau@users.sourceforge.net">eddieajau@users.sourceforge.net</a>
  607.         </p>
  608.         <p>
  609.         If you have any problems with phpDocumentor, please visit the website: 
  610.         <a href='http://phpdoc.org'>phpdoc.org</a>, or 
  611.         <a href="http://pear.php.net/bugs/search.php?cmd=display&package_name[]=PhpDocumentor&status=Open">
  612.         submit a bug at PEAR</a>.
  613.         </p>
  614.         <!-- Created: Tue Jun 26 18:52:40 MEST 2001 -->
  615.         <!-- hhmts start -->
  616.         <pre>
  617.         Last modified: $Date$
  618.         Revision: $Revision$
  619.         </pre>
  620.     </div>
  621.     <div class="tab-page" id="tab_links">
  622.         <h2 class="tab">Links</h2>
  623.         <ul>
  624.             <li><a target="_top" href="http://www.phpdoc.org/manual.php">phpDocumentor manual</a> - Learn how to use phpDocumentor to document your PHP source code</li>
  625.             <li><a target="_top" href="http://pear.php.net/package/PhpDocumentor/">phpDocumentor homepage</a> on PEAR</li>
  626.             <li><a target="_top" href="http://phpdocu.sourceforge.net/">phpDocumentor homepage</a> on SourceForge</li>
  627.             <li><a target="_top" href="http://freshmeat.net/projects/phpdocu">Freshmeat record</a> - subscribe here</li>
  628.         </ul>
  629.     </div>
  630. </div>
  631. <input type="hidden" name="interface" value="web">
  632. <input type="hidden" name="dataform" value="true">
  633.  
  634. </form>
  635.  
  636. <script type="text/javascript">
  637.  
  638.     tp1.addTabPage( document.getElementById( "tab_intro" ) );
  639.     tp1.addTabPage( document.getElementById( "tab_config" ) );
  640.     tp1.addTabPage( document.getElementById( "tab_files" ) );
  641.     tp1.addTabPage( document.getElementById( "tab_output" ) );
  642.     tp1.addTabPage( document.getElementById( "tab_options" ) );
  643.     tp1.addTabPage( document.getElementById( "tab_credits" ) );
  644.     tp1.addTabPage( document.getElementById( "tab_links" ) );
  645.     setupAllTabs();
  646. </script>
  647.  
  648. </body>
  649. </html>

Documentation generated on Mon, 11 Mar 2019 15:50:12 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.