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?
5 \cfg{xhtml-leaf-smallest-contents}{2}
6 \cfg{xhtml-leaf-contains-contents}{true}
7 \cfg{man-headnumbers}{true}
9 This paragraph is not labelled \q{preamble}, but should still appear
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).
16 \c Here is a code paragraph in the preamble, just to stress that all
17 \c things are possible. Ooh!
19 \copyright Copyright 1999 Simon \#{second comment}Tatham. All rights
22 Here's another paragraph, which goes after the copyright.
24 \define{metacoopt} [this is a nested,
25 multi-line macro, talking about \coopt
28 \define{coopt} co\u00F6{-o}pt
30 \define{eur} \u20AC{EUR }
32 \versionid $Id: test.but,v 1.25 2004/03/30 20:22:00 simon Exp $
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.
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
43 \cw{This} is weak code. And \k{head} contains some other stuff.
46 To test the man page back end:
52 \\Sping\\Spong\\Spoing
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)
58 \cfg{winhelp-topic}{M359HPEHGW}
60 Here's a code paragraph:
64 \c Two blank lines follow this one.
67 \c Two blank lines precede this one.
69 \c We can use \ { and } with impunity here.
70 \c We can use discretionary bold and italic in code paragraphs!
72 \c Isn't that ludicrous?
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:
90 And here's a sublist. Numbered, just for variety.
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!}
120 This is a horizontal rule:
124 This is a numbered list:
130 \n Eek. \q{Aah} is point \k{keyword}.
132 This is a description list:
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.
141 Here's another of those funky list continuation things, just to keep
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.
152 \dt "SAUSAGE SALESMAN"
154 \dd An exemplary contributor to the global economy. Unless he's CMOT
157 A-paragraph-full-of-hyphens-to-test-the-idea-that-word-wrapping-can-happen-somewhere-in-all-this-hyphenatory-nonsense.
159 A\-paragraph\-full\-of\-nonbreaking\-hyphens\-to\-test\-the\-idea\-that\-word\-wrapping\-misses\-them.
161 A\_paragraph\_full\_of\_nonbreaking\_spaces\_to\_test\_the\_idea\_that\_word\_wrapping\_misses\_them\_too.
163 Use of macros: let's talk about \coopt. And about \coopt some more.
164 And a nested macro: \metacoopt.
166 A slightly more difficult macro: \eur\.2500.
168 Oh, while I'm here: some special characters. The \\, \{ and \}
169 characters, to be precise. And their code equivalents, \c{\\},
172 \S{subhead} First subheading
174 So here's a \I{subheading}\I{subsection}subsection. Just
175 incidentally, \q{this} is in quotes. \ii{Those} quotes had better work
178 We'll try for some Unicode here: \i{Schr\u00F6{oe}dinger}.
180 An index tag containing non-alternatived Unicode: \i{\u00BFChe?}
182 An invisible index tag: \I{she seems to have an invisible tag}yeah.
184 \S2{sub-sub}{Florble} Smaller heading still
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}.
189 \A{app} Needless appendix
191 \# \cfg{winhelp-topic}{Y5VQEXZQVJ} (uncomment this and it clashes)
193 Here's an \i{appendix}, for no terribly good reason at all. See
194 __\k{book}__ (please excuse those underscores, I'm testing
197 It also contains a \W{http://www.tartarus.org/}{hyperlink}.
201 \B{book} Some text describing a book.
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.
206 \BR{book} [SillyCitation]
211 \B{uncited} If this text appears, there's an actual error.
213 \# This is a comment.
215 \# Now for the index section.
217 \IM{she seems to have an invisible tag}{appendix} Invisible tags