mdw@git.distorted.org.uk Git - sgt/halibut/blob - inputs/test.but

   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