lip 29
Tworzenie dokumentacji kodu w PHP – phpDocumentor
—
TI @ 29-07-2009 18:47
Tworzenie dokumentacji do kodu jest bardzo nudne i uciażliwe. Jak można zautomatyzować ten proces?
Od dłuższego czasu pewnym standardem jest phpDocumentor.
Tworzenie dokumentacji polega na napisanie komentarza w kodzie:
/** * */
w takim komentarzy można zawrzeć niżej wymienione znaczniki.
Dostępne znaczniki oraz przykłady do nich:
- @abstract
- @access
- @author
- @category
- @copyright
- @deprecated
- @example
- @final
- @filesource
- @global
- @ignore
- @internal
- @license
- @link
- @method
- @name
- @package
- @param
- @property
- @return
- @see
- @since
- @static
- @staticvar
- @subpackage
- @todo
- @tutorial
- @uses
- @var
- @version
Linki:
