| 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} |
| 6 | \cfg{xhtml-leaf-contains-contents}{true} |
| 7 | \cfg{man-headnumbers}{true} |
| 8 | |
| 9 | This paragraph is not labelled \q{preamble}, but should still appear |
| 10 | as it. |
| 11 | |
| 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 | |
| 16 | \c Here is a code paragraph in the preamble, just to stress that all |
| 17 | \c things are possible. Ooh! |
| 18 | |
| 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 | |
| 28 | \define{eur} \u20AC{EUR } |
| 29 | |
| 30 | \versionid $Id: test.but,v 1.23 2004/03/25 19:27:12 simon Exp $ |
| 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 | |
| 44 | To test the man page back end: |
| 45 | |
| 46 | .Directive |
| 47 | |
| 48 | 'Directive |
| 49 | |
| 50 | \\Sping\\Spong\\Spoing |
| 51 | |
| 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. |
| 68 | \c We can use discretionary bold and italic in code paragraphs! |
| 69 | \e bbbb iiiiii |
| 70 | \c Isn't that ludicrous? |
| 71 | |
| 72 | This is a list: |
| 73 | |
| 74 | \b Ooh. |
| 75 | |
| 76 | \b Aah. |
| 77 | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| 159 | A slightly more difficult macro: \eur\.2500. |
| 160 | |
| 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 |
| 187 | __\k{book}__ (please excuse those underscores, I'm testing |
| 188 | whitespace). |
| 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] |
| 200 | \BR{uncited} Badger. |
| 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 |