summaryrefslogtreecommitdiff
path: root/doc/texinfo/rendition.texi
blob: e7a4a5d9fba03c111904bf169862f3cdd3359574 (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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
@c This file is part of GNU Mailutils.
@c Copyright (C) 2001-2004, 2006-2007, 2009-2012, 2014-2015 Free
@c Software Foundation, Inc.
@c
@c GNU Mailutils is free software; you can redistribute it and/or
@c modify it under the terms of the GNU General Public License as
@c published by the Free Software Foundation; either version 3, or (at
@c your option) any later version.
@c
@c GNU Mailutils is distributed in the hope that it will be useful, but
@c WITHOUT ANY WARRANTY; without even the implied warranty of
@c MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
@c General Public License for more details.
@c
@c You should have received a copy of the GNU General Public License
@c along with GNU Mailutils.  If not, see
@c <http://www.gnu.org/licenses/>.

@c This file implements Fra@,{c}ois Pinard's concept of 'renditions'.

@c ======================================================================
@c This document has three levels of rendition: PUBLISH, DISTRIB or PROOF,
@c as decided by @set symbols. The PUBLISH rendition does not show
@c notes or marks asking for revision. Most users will prefer having more
@c information, even if this information is not fully revised for adequacy,
@c so DISTRIB is the default for distributions. The PROOF rendition
@c show all marks to the point of ugliness, but is nevertheless useful to
@c those working on the manual itself.
@c ======================================================================

@c Set this symbol if you wish FIXMEs to appear in footnotes, instead
@c of being inserted into the text.
@c @set PROOF_FOOTNOTED

@ifclear PUBLISH
@ifclear DISTRIB
@ifclear PROOF
@set DISTRIB
@end ifclear
@end ifclear
@end ifclear

@ifset PUBLISH
@set RENDITION The book, version
@end ifset

@ifset DISTRIB
@set RENDITION FTP release, version
@end ifset

@ifset PROOF
@set RENDITION Proof reading version
@end ifset

@macro WRITEME
@ifclear PUBLISH
@cartouche
@center @emph{@strong{Editor's note:} This node is to be written.}
@end cartouche
@end ifclear
@end macro

@c Output marks for nodes needing revision, but not in PUBLISH rendition.

@macro UNREVISED
@ifclear PUBLISH
@cartouche
@emph{Editor's note:} The information in this node may be obsolete or
otherwise inaccurate.  This message will disappear, once this node revised.
@end cartouche
@end ifclear
@end macro

@c Output various FIXME information only in PROOF rendition.

@macro FIXME{string}
@ifset PROOF
@sp 1
@cartouche
@strong{Editor's note:} \string\
@end cartouche
@end ifset
@w{}
@end macro

@macro deadlink{}
(@strong{Editor's note: dangling link})
@end macro

@macro FIXMEREF{text,string}
@ifset PROOF
@html
\text\ <span class="deadlink">\string\</span> 
@end html
@ifnothtml
\text\ @i{\string\}
@end ifnothtml
@deadlink{}
@end ifset
@w{}
@end macro

@macro FIXME-ref{string}
@FIXMEREF{,\string\}
@end macro

@macro FIXME-pxref{string}
@FIXMEREF{see,\string\}
@end macro

@macro FIXME-xref{string}
@FIXMEREF{See,\string\}
@end macro

Return to:

Send suggestions and report system problems to the System administrator.