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