The [doctools] processor. An application for handling and showcasing the doctools format.
The sources are in tcllib, module ''tclapps''.
A starkit can be found in the [sdarchive].
[[Describe the purpose of dtp and provide examples of its use.
Point to online documentation. Point to a description of the formatting ''language'' itself.]]

The languages are specified in 

   * http://tcllib.sourceforge.net/doc/doctoc_fmt.html ---- doctools language (manpages)
   * http://tcllib.sourceforge.net/doc/doctools_fmt.html -- doctoc language (table of contents)
   * http://tcllib.sourceforge.net/doc/docidx_fmt.html ---- docidx language (indices)

Note that DTP in the outside world mostly is understood as Desktop Publishing, which this is not.
----
How to output man ...
   * Get dtp from sdarchive.
   * Get tcllib sources as source of .man files
   * Then:
            dtp doc html tcllib/modules/struct/graph.man
   * generates HTML from the manpage for struct/graph. And
            dtp doc nroff tcllib/modules/struct/graph.man
   * generates nroff

"dtp script" returns a shell script using some of the advanced features of dtp itself (toc and indices)


----

Note: Discussion of documentation issues is encouraged,
either here, on the [doctools] page, or the [user documentation project].

----
[LV] Note that, in the examples above, the file.man may surprise/mislead old Unix hackers.  That is because through the years, file.man was one way of specifying that the contents were nroff -man formatted files.

tcllib currently uses file.man file naming convention to imply that the contents are to be formatted with [dtp] (no, I can't explain why .dtp wasn't used...).

[AK]: Usage of the ''.man'' extension for the doctools files predates the existence of dtp.


----
[Category Application] |
[Category Documentation]