LinuxCommandLibrary

doctum

API documentation generator for PHP

TLDR

Generate documentation

$ doctum update [doctum.php]
copy
Parse and render documentation
$ doctum render [doctum.php]
copy
Update and render in one step
$ doctum update [doctum.php] --force
copy
Show verbose output
$ doctum update -v [doctum.php]
copy

SYNOPSIS

doctum command [options] config-file

DESCRIPTION

Doctum is an API documentation generator for PHP projects. It parses PHP source code and generates browsable HTML documentation with class hierarchies, method signatures, and docblock comments.
The tool is a fork of Sami, providing continued maintenance and improvements. It supports modern PHP features including traits, namespaces, and type declarations. Configuration is done through PHP files allowing flexible customization.
Doctum creates searchable documentation with cross-references between classes and methods, making it valuable for documenting libraries and frameworks.

PARAMETERS

COMMAND

Operation: update, render, parse.
CONFIG-FILE
PHP configuration file.
update
Parse source and render documentation.
render
Render from cached parse data.
parse
Parse source without rendering.
--force
Force complete regeneration.
-v, --verbose
Verbose output.
--help
Display help information.

CONFIGURATION

doctum.php

Configuration file defining source directories, build paths, themes, and parsing options.

CAVEATS

Requires PHP 7.2+. Large codebases may have slow initial parse. Configuration requires PHP knowledge. Some PHP edge cases may not parse correctly.

HISTORY

Doctum is a fork of Sami, originally created by Fabien Potencier (creator of Symfony). When Sami was deprecated, Doctum emerged as the community-maintained continuation, providing API documentation for PHP projects.

SEE ALSO

phpdoc(1), doxygen(1), php(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community