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 Here's another paragraph, which goes after the copyright.
  23
  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
  30 \define{eur} \u20AC{EUR }
  31
  32 \versionid $Id: test.but,v 1.25 2004/03/30 20:22:00 simon Exp $
  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
  46 To test the man page back end:
  47
  48 .Directive
  49
  50 'Directive
  51
  52 \\Sping\\Spong\\Spoing
  53
  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.
  70 \c We can use discretionary bold and italic in code paragraphs!
  71 \e                          bbbb     iiiiii
  72 \c Isn't that ludicrous?
  73
  74 This is a list:
  75
  76 \b Ooh.
  77
  78 \b Aah.
  79
  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
 100 \lcont{
 101 \c Code
 102 \c Paragraph
 103 }
 104
 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
 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
 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
 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
 166 A slightly more difficult macro: \eur\.2500.
 167
 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
 194 __\k{book}__ (please excuse those underscores, I'm testing
 195 whitespace).
 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]
 207 \BR{uncited} Badger.
 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