home *** CD-ROM | disk | FTP | other *** search
/ Enter 2004 June / ENTER.ISO / files / xampp-win32-1.4.5-installer.exe / xampp / manual.pkg < prev    next >
Encoding:
Text File  |  2004-03-24  |  5.3 KB  |  123 lines

  1. <refentry id="{@id}">
  2.  <refnamediv>
  3.   <refname>{@link http://phpdocu.sourceforge.net phpDocumentor 1.2.2} Manual</refname>
  4.   <refpurpose>Introduction to phpDocumentor</refpurpose>
  5.  </refnamediv>
  6.  <refsynopsisdiv>
  7.   <para>phpDocumentor authors</para>
  8.   <authorgroup>
  9.    <author>
  10.     Joshua Eichorn
  11.     <authorblurb>
  12.      {@link mailto:jeichorn@phpdoc.org jeichorn@phpdoc.org}
  13.     </authorblurb>
  14.    </author>
  15.    <author>
  16.     Gregory Beaver
  17.     <authorblurb>
  18.      {@link mailto:cellog@sourceforge.com cellog@sourceforge.com}
  19.     </authorblurb>
  20.    </author>
  21.    <author>
  22.     Kellin
  23.     <authorblurb>
  24.      {@link mailto:passionplay@hotmail.com passionplay@hotmail.com}
  25.     </authorblurb>
  26.    </author>
  27.    <author>
  28.     Juan Pablo Morales
  29.     <authorblurb>
  30.      {@link mailto:ju-moral@uniandes.edu.co ju-moral@uniandes.edu.co}
  31.     </authorblurb>
  32.    </author>
  33.    <author>
  34.     Florian Clever
  35.     <authorblurb>
  36.      {@link mailto:fclever@verinform.com fclever@verinform.com}
  37.     </authorblurb>
  38.    </author>
  39.    <author>
  40.     Dennis Kehrig
  41.     <authorblurb>
  42.      {@link mailto:TheGeek@web.de TheGeek@web.de}
  43.     </authorblurb>
  44.    </author>
  45.    <author>
  46.     Robert Hoffmann
  47.     <authorblurb>
  48.      {@link mailto:half-dead@users.sourceforge.net half-dead@users.sourceforge.net}
  49.     </authorblurb>
  50.    </author>
  51.    <author>
  52.     Roberto Berto
  53.     <authorblurb>
  54.      {@link mailto:darkelder@users.sourceforge.net darkelder@users.sourceforge.net}
  55.     </authorblurb>
  56.    </author>
  57.    <author>
  58.     Dave Viner
  59.     <authorblurb>
  60.      {@link mailto:dviner@yahoo-inc.com dviner@yahoo-inc.com}
  61.     </authorblurb>
  62.    </author>
  63.    <author>
  64.     Walter A Boring IV
  65.     <authorblurb>
  66.      {@link mailto:hemna@users.sourceforge.net hemna@users.sourceforge.net}
  67.     </authorblurb>
  68.    </author>
  69.    <author>
  70.     Mark van Reunswolde
  71.     <authorblurb>
  72.      {@link mailto:support@esdsoftware.net support@esdsoftware.net}
  73.     </authorblurb>
  74.    </author>
  75.    <author>
  76.     Julien Damon
  77.     <authorblurb>
  78.      {@link mailto:julien.damon@free.fr julien.damon@free.fr}
  79.     </authorblurb>
  80.    </author>
  81.    <author>
  82.     Harald Fielker
  83.     <authorblurb>
  84.      {@link mailto:fielker@informatik.fh-augsburg.de fielker@informatik.fh-augsburg.de}
  85.     </authorblurb>
  86.    </author>
  87.    <author>
  88.     Marco von Ballmoos
  89.     <authorblurb>
  90.      {@link mailto:mvonballmo@users.sourceforge.net mvonballmo@users.sourceforge.net}
  91.     </authorblurb>
  92.    </author>
  93.    <author>
  94.     Andrew Eddie
  95.     <authorblurb>
  96.      {@link mailto:eddieajau@users.sourceforge.net eddieajau@users.sourceforge.net}
  97.     </authorblurb>
  98.    </author>
  99.    <author>
  100.     William K. Hardeman
  101.     <authorblurb>
  102.      {@link mailto:william_hardeman@hands-solutions.com william_hardeman@hands-solutions.com}
  103.     </authorblurb>
  104.    </author>
  105.   </authorgroup>
  106.  </refsynopsisdiv>
  107.  <refsect1 id="{@id intro}">
  108.   <refsect2 id="{@id documentation}">
  109.    <title>Documentation</title>
  110.    <para>The release of phpDocumentor 1.2.0+ marks a radical shift in the design philosophy of phpDocumentor.  No longer is this tool intended only to generate documentation from the source code.  Now it facilitates generating user-level documentation for people who only wish to use your software, and not to modify it.  This allows complete integration of all the documentation for the software project, and that means even greater ease of documenting, and ultimately more time to work on making the software work!</para>
  111.    <para>The old functionality of phpDocumentor has not been changed, only extended.  The old HTMLdefaultConverter has been ported to a new HTMLframesConverter.  The output looks the same, or better, but the templates are now {@link smarty.php.net Smarty}-based templates, and allow much greater customization.  To start out right away, read {@tutorial phpDocumentor.howto.pkg}.</para>
  112.   </refsect2>
  113.   <refsect2 id="{@id bug-reporting}">
  114.    <title>Bugs and Features (guaranteed to be separate entities...)</title>
  115.    <para>If you think you've found a bug in phpDocumentor, please check our bug tracker online at {@link http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=111194 http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=111194}, the bug may have already been fixed (we develop at a rapid rate).  If you don't find it, please submit a bug, and we will attempt to fix it as quickly as possible.</para>
  116.    <para>If there is a feature you're dying to have, check our feature tracker at {@link http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=361194 http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=361194}.  Please don't hesitate to look right at the source code and help apply your feature.  We love that, and can easily give you access to the cvs.</para>
  117.   </refsect2>
  118.   <refsect2 id="{@id helping-out}">
  119.    <title>How to Help Out</title>
  120.    <para>If you would like to help out with phpDocumentor, don't be shy.  Email {@link mailto:jeichorn@phpdoc.org Joshua Eichorn} right away and say you'd like to be added to the developer team.  We need people who are willing to develop Converters, translate documentation, and handle various bugs and feature requests as they come up.  phpDocumentor is fast becoming the de facto standard of automatic documentors in PHP, so it is in your best interest to make sure it works the way you need it to work.</para>
  121.   </refsect2>
  122.  </refsect1>
  123. </refentry>