1[comment {
2         ASCII diagram of the dependencies between the doctools v2 toc packages
3         ======================================================================
4}][example {
5                                    ~~~~~~~~~~~ doctools::toc ~~~~~~~~~~~
6                                   ~~                   |               ~~
7                doctools::toc::export ~~~~~~~~~~~~~~~~~ | ~~~~~~~~~~~~~ doctools::toc::import
8                        |                               |                       |
9        +---------------+-------------------------+     |    +------------------+---------------+-----------------------+---------------+
10        |               |                         |     |    |                  |               |                       |               |
11doctools::config        =                         |     |    |                  =       doctools::include       doctools::config doctools::paths
12                        |                         |     |    |                  |
13                doctools::toc::export::<*>        |     |    |          doctools::toc::import::<*>
14                        doctoc                    |     |    |                  doctoc, json
15                        json                      |     |    |                  |           \\
16                        html                      |     |    |          doctools::toc::parse \\
17                        nroff                     |     |    |                  |             \\
18                        wiki                      |     |    |  +---------------+              json
19                        text                      |     |    |  |               |
20                                                doctools::toc::structure        |
21                                                                                |
22                                                                        +-------+---------------+
23                                                                        |                       |
24          doctools::html  doctools::html::cssdefaults           doctools::tcl::parse    doctools::msgcat
25                |                                                                               |
26          doctools::text  doctools::nroff::man_macros                                           =
27                                                                                                |
28                                                                                        doctools::msgcat::toc::<*>
29                                                                                                c, en, de, fr
30                                                                                                (fr == en for now)
31        ~~      Interoperable objects, without actual package dependencies
32        --      Package dependency, higher requires lower package
33        =       Dynamic dependency through plugin system
34        <*>     Multiple packages following the given form of naming.
35
36}][comment {
37        yaml                    export, import
38        tmml                    export, import
39        reStructured Text       export
40        latex                   export
41
42        list, desc - old, not needed under new system, replaced by the nested-list serialization
43        null - old, not needed, deserialize doctoc alone provides validation of input.
44}]
45