blob: ee28753fef9558509707561f0f95df99cae5f801 (
plain)
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
================
A document title
================
-------------------
A document subtitle
-------------------
:Author: Stefan Merten
.. header:: The document header is once only.
.. footer:: And the document footer.
PCDATA
======
Some elements may contain only #PCDATA. They need to propagate changes
up. These are the references of [CITA]_ and footnotes [1]_.
Only once only
==============
Other elements may occur only once and thus need to propagate their
changes up or down.
* Titles and subtitles of any kind
See this section and document title / subtitle
* Transitions
They have no children which could change.
* Parts of definition lists
Defined term
Explanation
Unknown term
Definition of term is also only once
* Parts of field lists
:Only once: Some content
:Another field: Field body is also only once
* The attribution of a citation
To be or not to be!
-- Mozart
* Parts of a figure
.. figure:: image.gif
The caption of a figure
And its legend
* Several parts of a table
+-----+-----+
|Left |Right|
+=====+=====+
|Row |Entry|
| |only |
| |once |
+-----+-----+
Also colspec, thead and tbody but they are ignored here.
PCDATA *and* only once
======================
Some elements are of both types.
--same Some old description - still description may
appear only once
--option A changing option_string must propagate to option
-o, --option_group The option_group and the description may also appear
only once
.. [CITA] The label of a citation.
.. [1] The label of a footnote.
|
