d7482997 |
1 | \title Halibut: A Test Document With A Stupidly Long Title Just To |
2 | See If Wrapping Titles Works OK. In Fact This Title Will Span Three |
3 | Lines, Not Just Two. How's That For Ludicrous? |
4 | |
5 | \cfg{xhtml-leaf-smallest-contents}{2} |
d7482997 |
6 | \cfg{xhtml-leaf-contains-contents}{true} |
4b3c5afb |
7 | \cfg{man-headnumbers}{true} |
d7482997 |
8 | |
8902e0ed |
9 | This paragraph is not labelled \q{preamble}, but should still appear |
10 | as it. |
11 | |
d7482997 |
12 | \preamble This manual is a small joke effort, designed to use every |
13 | feature \#{ comment } that Halibut's input format supports. Creation |
14 | date \date{%Y.%m.%d} (default format is \date). |
15 | |
8902e0ed |
16 | \c Here is a code paragraph in the preamble, just to stress that all |
17 | \c things are possible. Ooh! |
18 | |
d7482997 |
19 | \copyright Copyright 1999 Simon \#{second comment}Tatham. All rights |
20 | reserved. |
21 | |
9057a0a8 |
22 | Here's another paragraph, which goes after the copyright. |
23 | |
d7482997 |
24 | \define{metacoopt} [this is a nested, |
25 | multi-line macro, talking about \coopt |
26 | a bit] |
27 | |
28 | \define{coopt} co\u00F6{-o}pt |
29 | |
672e4626 |
30 | \define{eur} \u20AC{EUR } |
31 | |
780f45d4 |
32 | \versionid $Id: test.but,v 1.25 2004/03/30 20:22:00 simon Exp $ |
d7482997 |
33 | |
34 | \C{ch\\ap} First chapter title; for similar wrapping reasons this |
35 | chapter title will be ludicrously long. I wonder how much more |
36 | chapter title I can write before feeling silly. |
37 | |
38 | This is a para\#{another{} comment}graph of text. It |
39 | has line\#{yet another one} breaks in between words, multiple |
40 | spaces (ignored), and \e{emphasised text} as well as \c{code |
41 | fragments}. |
42 | |
43 | \cw{This} is weak code. And \k{head} contains some other stuff. |
44 | \K{subhead} does too. |
45 | |
7136a6c7 |
46 | To test the man page back end: |
47 | |
48 | .Directive |
49 | |
50 | 'Directive |
51 | |
52 | \\Sping\\Spong\\Spoing |
53 | |
d7482997 |
54 | \H{head} First section title (very long again, no prizes for |
55 | guessing the reason why this time, and here's yet more text to pad |
56 | it out to three lines of output) |
57 | |
58 | \cfg{winhelp-topic}{M359HPEHGW} |
59 | |
60 | Here's a code paragraph: |
61 | |
62 | \c No leading spaces |
63 | \c One leading space |
64 | \c Two blank lines follow this one. |
65 | \c |
66 | \c |
67 | \c Two blank lines precede this one. |
68 | \c Two leading spaces |
69 | \c We can use \ { and } with impunity here. |
4b3c5afb |
70 | \c We can use discretionary bold and italic in code paragraphs! |
71 | \e bbbb iiiiii |
72 | \c Isn't that ludicrous? |
d7482997 |
73 | |
74 | This is a list: |
75 | |
76 | \b Ooh. |
77 | |
78 | \b Aah. |
79 | |
7136a6c7 |
80 | \lcont{ |
81 | |
82 | This bulletted list contains a list continuation. This is an |
83 | additional paragraph, or more than one, indented at the same level |
84 | as the list items, and able to contain nested sublists and other |
85 | features. For example, here's a code paragraph: |
86 | |
87 | \c spingle:~$ whoami |
88 | \c spoggler |
89 | |
90 | And here's a sublist. Numbered, just for variety. |
91 | |
92 | \n One. |
93 | |
94 | \lcont{ |
95 | |
96 | \n 1a. |
97 | |
98 | \n 1b. |
99 | |
780f45d4 |
100 | \lcont{ |
101 | \c Code |
102 | \c Paragraph |
103 | } |
104 | |
7136a6c7 |
105 | \n 1c. |
106 | |
107 | \lcont{This is an even sillier one: a continuation of a list item in |
108 | a continuation of a list item in a continuation of a list item!} |
109 | |
110 | } |
111 | |
112 | \n Two. |
113 | |
114 | \n Threeeee! |
115 | |
116 | } |
117 | |
d7482997 |
118 | \b Eek. |
119 | |
120 | This is a horizontal rule: |
121 | |
122 | \rule |
123 | |
124 | This is a numbered list: |
125 | |
126 | \n Ooh. |
127 | |
128 | \n{keyword} Aah. |
129 | |
130 | \n Eek. \q{Aah} is point \k{keyword}. |
131 | |
7136a6c7 |
132 | This is a description list: |
133 | |
134 | \dt FISH |
135 | |
136 | \dd A piscine creature, often to be found swimming aimlessly around |
137 | in the sea eating things and not contributing to the global economy. |
138 | |
139 | \lcont{ |
140 | |
141 | Here's another of those funky list continuation things, just to keep |
142 | Halibut on its toes. |
143 | |
144 | } |
145 | |
146 | \dt BADGER |
147 | |
148 | \dd A non-piscine creature, often to be found snuffling around on |
149 | land, not contributing to the global economy, and not even swimming |
150 | to make up for it. I don't know. These mammals. Pa-thetic. |
151 | |
152 | \dt "SAUSAGE SALESMAN" |
153 | |
154 | \dd An exemplary contributor to the global economy. Unless he's CMOT |
155 | Dibbler. |
156 | |
d7482997 |
157 | A-paragraph-full-of-hyphens-to-test-the-idea-that-word-wrapping-can-happen-somewhere-in-all-this-hyphenatory-nonsense. |
158 | |
159 | A\-paragraph\-full\-of\-nonbreaking\-hyphens\-to\-test\-the\-idea\-that\-word\-wrapping\-misses\-them. |
160 | |
161 | A\_paragraph\_full\_of\_nonbreaking\_spaces\_to\_test\_the\_idea\_that\_word\_wrapping\_misses\_them\_too. |
162 | |
163 | Use of macros: let's talk about \coopt. And about \coopt some more. |
164 | And a nested macro: \metacoopt. |
165 | |
672e4626 |
166 | A slightly more difficult macro: \eur\.2500. |
167 | |
d7482997 |
168 | Oh, while I'm here: some special characters. The \\, \{ and \} |
169 | characters, to be precise. And their code equivalents, \c{\\}, |
170 | \i\c{\{}, \c{\}}. |
171 | |
172 | \S{subhead} First subheading |
173 | |
174 | So here's a \I{subheading}\I{subsection}subsection. Just |
175 | incidentally, \q{this} is in quotes. \ii{Those} quotes had better work |
176 | in all formats. |
177 | |
178 | We'll try for some Unicode here: \i{Schr\u00F6{oe}dinger}. |
179 | |
180 | An index tag containing non-alternatived Unicode: \i{\u00BFChe?} |
181 | |
182 | An invisible index tag: \I{she seems to have an invisible tag}yeah. |
183 | |
184 | \S2{sub-sub}{Florble} Smaller heading still |
185 | |
186 | A tiny section. Awww. How cute. Actually, this one's a \e{florble}, |
187 | and here's a reference to it: \k{sub-sub}. |
188 | |
189 | \A{app} Needless appendix |
190 | |
191 | \# \cfg{winhelp-topic}{Y5VQEXZQVJ} (uncomment this and it clashes) |
192 | |
193 | Here's an \i{appendix}, for no terribly good reason at all. See |
b3c80b25 |
194 | __\k{book}__ (please excuse those underscores, I'm testing |
195 | whitespace). |
d7482997 |
196 | |
197 | It also contains a \W{http://www.tartarus.org/}{hyperlink}. |
198 | |
199 | \U Bibliography |
200 | |
201 | \B{book} Some text describing a book. |
202 | |
203 | \B{nocite} Some text describing a book. This text should appear in |
204 | the document even though there is no \cw{\\k} citing it. |
205 | |
206 | \BR{book} [SillyCitation] |
b3c80b25 |
207 | \BR{uncited} Badger. |
d7482997 |
208 | |
209 | \nocite{nocite} |
210 | |
211 | \B{uncited} If this text appears, there's an actual error. |
212 | |
213 | \# This is a comment. |
214 | |
215 | \# Now for the index section. |
216 | |
217 | \IM{she seems to have an invisible tag}{appendix} Invisible tags |
218 | and/or appendices |