# Generating the Code Reference

When Doxygen is present, the build offers a docs target that generates the API and source reference from the documentation comments carried in the headers and sources. Two output formats are available as configure-time options:

- **-DDPM_DOCS_PDF** (default ON) — PDF reference, via Doxygen's native LaTeX output; requires pdflatex and makeindex
- **-DDPM_DOCS_HTML** (default OFF) — HTML reference

Generate and compile the PDF reference:

```
cmake --build <build-dir> --target docs-pdf
```

The PDF lands at <build-dir>/docs/latex/refman.pdf.

With DPM_DOCS_HTML enabled at configure time, the docs target additionally produces the HTML reference in <build-dir>/docs/html:

```
cmake -B <build-dir> -DDPM_DOCS_HTML=ON
cmake --build <build-dir> --target docs
```