File: concept.inc

package info (click to toggle)
tcllib 1.20%2Bdfsg-1
  • links: PTS
  • area: main
  • in suites: bullseye
  • size: 68,064 kB
  • sloc: tcl: 216,842; ansic: 14,250; sh: 2,846; xml: 1,766; yacc: 1,145; pascal: 881; makefile: 107; perl: 84; f90: 84; python: 33; ruby: 13; php: 11
file content (47 lines) | stat: -rw-r--r-- 1,271 bytes parent folder | download | duplicates (9)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
[comment {
	 Description of the concepts used in tables of contents and how
	 their relate to each other. This is useful to understand the
	 serialization chosen for tables of contents.
}]
[list_begin enumerated]
[enum]

A [term {table of contents}] consists of a (possibly empty) list of
[term elements].

[enum]
Each element in the list is identified by its label.

[enum]
Each element is either a [term reference], or a [term division].

[enum]
Each reference has an associated document, identified by a symbolic
id, and a textual description.

[enum]
Each division may have an associated document, identified by a
symbolic id. 

[enum]
Each division consists consists of a (possibly empty) list of
[term elements], with each element following the rules as specified in
item 2 and above.

[list_end]

A few notes

[list_begin enumerated]
[enum]
The above rules span up a tree of elements, with references as the
leaf nodes, and divisions as the inner nodes, and each element
representing an entry in the whole table of contents.

[enum]
The identifying labels of any element E are unique within their
division (or toc), and the full label of any element E is the list of
labels for all nodes on the unique path from the root of the tree to
E, including E.

[list_end]