[sgt/halibut] / inputs / test.but

\title Halibut: A Test Document With A Stupidly Long Title Just To
See If Wrapping Titles Works OK. In Fact This Title Will Span Three
Lines, Not Just Two. How's That For Ludicrous?

\cfg{xhtml-leaf-smallest-contents}{2}
\cfg{xhtml-leaf-contains-contents}{true}
\cfg{info-dir-entry}{Sillinesses}{test.but}{Halibut test document}
\cfg{info-dir-entry}{Florbles}{test.but}{Subsection of Halibut test
document}{sub-sub}
\cfg{man-headnumbers}{true}

This paragraph is not labelled \q{preamble}, but should still appear
as it.

\preamble This manual is a small joke effort, designed to use every
feature \#{ comment } that Halibut's input format supports. Creation
date \date{%Y.%m.%d} (default format is \date).

\c Here is a code paragraph in the preamble, just to stress that all
\c things are possible. Ooh!

\copyright Copyright 1999 Simon \#{second comment}Tatham. All rights
reserved.

Here's another \i{preamble paragraph}, which goes after the copyright.

\define{metacoopt} [this is a nested,
multi-line macro, talking about \coopt
a bit]

\define{coopt} co\u00F6{-o}pt

\define{eur} \u20AC{EUR }

\versionid $Id$

\C{ch\\ap} First chapter title; for similar wrapping reasons this
chapter title will be ludicrously long. I wonder how much more
chapter title I can write before feeling silly.

This is a para\#{another{} comment}graph of text. It
has line\#{yet another one} breaks in   between words, multiple
  spaces (ignored), and \e{emphasised text} as well as \c{code
fragments}.

\#{This is an inline comment alone in a paragraph.}

\cw{This} is weak code; \cq{this} is quoted code. And \k{head}
contains some other stuff. \K{subhead} does too.

To test the man page back end:

.Directive

'Directive

\cw{.Directive}

\cw{'Directive}

\\Sping\\Spong\\Spoing

\H{head} First section title (very long again, no prizes for
guessing the reason why this time, and here's yet more text to pad
it out to three lines of output)

\cfg{winhelp-topic}{M359HPEHGW}

Here's a code paragraph:

\c No leading spaces
\c  One leading space
\c Two blank lines follow this one.
\c
\c
\c Two blank lines precede this one.
\c   Two leading spaces
\c We can use \ { and } with impunity here.
\c We can use discretionary bold and italic in code paragraphs!
\e                          bbbb     iiiiii
\c Isn't that ludicrous?

This is a list:

\b Ooh.

\b Aah.

\lcont{

This bulletted list contains a list continuation. This is an
additional paragraph, or more than one, indented at the same level
as the list items, and able to contain nested sublists and other
features. For example, here's a code paragraph:

\c spingle:~$ whoami
\c spoggler

And here's a sublist. Numbered, just for variety.

\n One.

\lcont{

\n 1a.

\n 1b.

\lcont{
\c Code
\c Paragraph
}

\n 1c.

\lcont{This is an even sillier one: a continuation of a list item in
a continuation of a list item in a continuation of a list item!}

}

\n Two.

\n Threeeee!

}

\b Eek.

This is a horizontal rule:

\rule

This is a numbered list:

\n Ooh.

\n{keyword} Aah.

\n Eek. \q{Aah} is point \k{keyword}.

This is a description list:

\dt FISH

\dd A piscine creature, often to be found swimming aimlessly around
in the sea eating things and not contributing to the global economy.

\lcont{

Here's another of those funky list continuation things, just to keep
Halibut on its toes.

}

\dt BADGER

\dd A non-piscine creature, often to be found snuffling around on
land, not contributing to the global economy, and not even swimming
to make up for it. I don't know. These mammals. Pa-thetic.

\dt "SAUSAGE SALESMAN"

\dd An exemplary contributor to the global economy. Unless he's CMOT
Dibbler.

This is a much more interesting description list, testing
consecutive \c{\\dt}s and consecutive \c{\\dd}s:

\dt One

\dt Two

\dt Three

\dd Ay

\dt Four

\dd Bee

\dd Cee

\dd Dee

A-paragraph-full-of-hyphens-to-test-the-idea-that-word-wrapping-can-happen-somewhere-in-all-this-hyphenatory-nonsense.

A\-paragraph\-full\-of\-nonbreaking\-hyphens\-to\-test\-the\-idea\-that\-word\-wrapping\-misses\-them.

A\_paragraph\_full\_of\_nonbreaking\_spaces\_to\_test\_the\_idea\_that\_word\_wrapping\_misses\_them\_too.

Use of macros: let's talk about \coopt. And about \coopt some more.
And a nested macro: \metacoopt.

A slightly more difficult macro: \eur\.2500.

Test of input character set switching.
Commit	Line	Data
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}
13561057	7	\cfg{info-dir-entry}{Sillinesses}{test.but}{Halibut test document}
	8	\cfg{info-dir-entry}{Florbles}{test.but}{Subsection of Halibut test
	9	document}{sub-sub}
4b3c5afb	10	\cfg{man-headnumbers}{true}
d7482997	11
8902e0ed	12	This paragraph is not labelled \q{preamble}, but should still appear
	13	as it.
	14
d7482997	15	\preamble This manual is a small joke effort, designed to use every
	16	feature \#{ comment } that Halibut's input format supports. Creation
	17	date \date{%Y.%m.%d} (default format is \date).
	18
8902e0ed	19	\c Here is a code paragraph in the preamble, just to stress that all
	20	\c things are possible. Ooh!
	21
d7482997	22	\copyright Copyright 1999 Simon \#{second comment}Tatham. All rights
	23	reserved.
	24
56a99eb6	25	Here's another \i{preamble paragraph}, which goes after the copyright.
9057a0a8	26
d7482997	27	\define{metacoopt} [this is a nested,
	28	multi-line macro, talking about \coopt
	29	a bit]
	30
	31	\define{coopt} co\u00F6{-o}pt
	32
672e4626	33	\define{eur} \u20AC{EUR }
672e4626	34
a1677855	35	\versionid $Id$
d7482997	36
	37	\C{ch\\ap} First chapter title; for similar wrapping reasons this
	38	chapter title will be ludicrously long. I wonder how much more
	39	chapter title I can write before feeling silly.
	40
	41	This is a para\#{another{} comment}graph of text. It
	42	has line\#{yet another one} breaks in between words, multiple
	43	spaces (ignored), and \e{emphasised text} as well as \c{code
	44	fragments}.
	45
c9b4e60f	46	\#{This is an inline comment alone in a paragraph.}
c9b4e60f	47
b7747050	48	\cw{This} is weak code; \cq{this} is quoted code. And \k{head}
b7747050	49	contains some other stuff. \K{subhead} does too.
d7482997	50
7136a6c7	51	To test the man page back end:
	52
	53	.Directive
	54
	55	'Directive
	56
a1677855	57	\cw{.Directive}
	58
	59	\cw{'Directive}
	60
7136a6c7	61	\\Sping\\Spong\\Spoing
7136a6c7	62
d7482997	63	\H{head} First section title (very long again, no prizes for
	64	guessing the reason why this time, and here's yet more text to pad
	65	it out to three lines of output)
	66
	67	\cfg{winhelp-topic}{M359HPEHGW}
	68
	69	Here's a code paragraph:
	70
	71	\c No leading spaces
	72	\c One leading space
	73	\c Two blank lines follow this one.
	74	\c
	75	\c
	76	\c Two blank lines precede this one.
	77	\c Two leading spaces
	78	\c We can use \ { and } with impunity here.
4b3c5afb	79	\c We can use discretionary bold and italic in code paragraphs!
	80	\e bbbb iiiiii
	81	\c Isn't that ludicrous?
d7482997	82
	83	This is a list:
	84
	85	\b Ooh.
	86
	87	\b Aah.
	88
7136a6c7	89	\lcont{
	90
	91	This bulletted list contains a list continuation. This is an
	92	additional paragraph, or more than one, indented at the same level
	93	as the list items, and able to contain nested sublists and other
	94	features. For example, here's a code paragraph:
	95
	96	\c spingle:~$ whoami
	97	\c spoggler
	98
	99	And here's a sublist. Numbered, just for variety.
	100
	101	\n One.
	102
	103	\lcont{
	104
	105	\n 1a.
	106
	107	\n 1b.
	108
780f45d4	109	\lcont{
	110	\c Code
	111	\c Paragraph
	112	}
	113
7136a6c7	114	\n 1c.
	115
	116	\lcont{This is an even sillier one: a continuation of a list item in
	117	a continuation of a list item in a continuation of a list item!}
	118
	119	}
	120
	121	\n Two.
	122
	123	\n Threeeee!
	124
	125	}
	126
d7482997	127	\b Eek.
	128
	129	This is a horizontal rule:
	130
	131	\rule
	132
	133	This is a numbered list:
	134
	135	\n Ooh.
	136
	137	\n{keyword} Aah.
	138
	139	\n Eek. \q{Aah} is point \k{keyword}.
	140
7136a6c7	141	This is a description list:
	142
	143	\dt FISH
	144
	145	\dd A piscine creature, often to be found swimming aimlessly around
	146	in the sea eating things and not contributing to the global economy.
	147
	148	\lcont{
	149
	150	Here's another of those funky list continuation things, just to keep
	151	Halibut on its toes.
	152
	153	}
	154
	155	\dt BADGER
	156
	157	\dd A non-piscine creature, often to be found snuffling around on
	158	land, not contributing to the global economy, and not even swimming
	159	to make up for it. I don't know. These mammals. Pa-thetic.
	160
	161	\dt "SAUSAGE SALESMAN"
	162
	163	\dd An exemplary contributor to the global economy. Unless he's CMOT
	164	Dibbler.
	165
02478c4f	166	This is a much more interesting description list, testing
	167	consecutive \c{\\dt}s and consecutive \c{\\dd}s:
	168
	169	\dt One
	170
	171	\dt Two
	172
	173	\dt Three
	174
	175	\dd Ay
	176
	177	\dt Four
	178
	179	\dd Bee
	180
	181	\dd Cee
	182
	183	\dd Dee
	184
d7482997	185	A-paragraph-full-of-hyphens-to-test-the-idea-that-word-wrapping-can-happen-somewhere-in-all-this-hyphenatory-nonsense.
	186
	187	A\-paragraph\-full\-of\-nonbreaking\-hyphens\-to\-test\-the\-idea\-that\-word\-wrapping\-misses\-them.
	188
	189	A\_paragraph\_full\_of\_nonbreaking\_spaces\_to\_test\_the\_idea\_that\_word\_wrapping\_misses\_them\_too.
	190
	191	Use of macros: let's talk about \coopt. And about \coopt some more.
	192	And a nested macro: \metacoopt.
	193
672e4626	194	A slightly more difficult macro: \eur\.2500.
672e4626	195
e34ba5c3	196	Test of input character set switching.
e34ba5c3	197
ff0ee988	198