Improve the naming of fragment IDs for numbered list elements and
bibliography entries.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4305 cda61777-01e9-0310-a592-d414129be87e

Minimal documentation of all the new paper backend \cfg{} directives.

Contains many FIXMEs, both for incomplete documentation and incomplete
code.

Couple of other minor tweaks elsewhere.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4304 cda61777-01e9-0310-a592-d414129be87e

We seem to have ended up with duplicate documentation of --man. Gone.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4303 cda61777-01e9-0310-a592-d414129be87e

Ensure that every \cfg{} directive documented so far has appropriate \IM
directives.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4302 cda61777-01e9-0310-a592-d414129be87e

Fairly wholesale reorganisation of the \cfg{} documentation for the text,
WinHelp, man, and info backends, and organisation into sections (now that
we have rather more directives documented). I've not changed the actual
text much if at all.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4301 cda61777-01e9-0310-a592-d414129be87e

In the text backend, multiple characters can now be used for underlining.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4300 cda61777-01e9-0310-a592-d414129be87e

The Unicode OVERLINE in the text backend documentation was probably supposed
to be quoted.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4299 cda61777-01e9-0310-a592-d414129be87e

Note that \cfg{quotes} and friends apply to the output in its entirety and
can't be changed partway through. Also, add a cross-reference from \q{}.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4298 cda61777-01e9-0310-a592-d414129be87e

Note that no index is generated by the text backend.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4297 cda61777-01e9-0310-a592-d414129be87e

Minor correction to --ps and --pdf descriptions.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4296 cda61777-01e9-0310-a592-d414129be87e

Initial rough documentation of some of the newer \cfg{} directives, namely:
 - \cfg{quotes}
 - text, info, man, and winhelp backends:
   - charset
   - quotes and bullets
   - various WinHelp miscellanea
Could stand some rearrangement and expansion, plus I've yet to address the
paper or HTML backends.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4295 cda61777-01e9-0310-a592-d414129be87e

Moderately nasty workaround for the fact that Windows Help's index
mechanism is case-insensitive with respect to sorting the list of
index entries. We now append nonbreaking spaces to the ends of some
index terms to ensure they are considered distinct. (Nasty, but it
seems to work.)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4294 cda61777-01e9-0310-a592-d414129be87e

Add a batch of assertions to ensure no more index terms fail to have
their anchors generated. Index bugs of this type can be terribly
subtle and go unnoticed for ages; I'm lucky Jacob spotted the first
one of the type, but I'm now going to be careful to avoid any
further ones.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4293 cda61777-01e9-0310-a592-d414129be87e

I had somehow managed to leave index entry anchors out of section
titles. Ahem.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4292 cda61777-01e9-0310-a592-d414129be87e

Add a clash-checking mechanism to ensure we never generate the same
fragment name twice for any reason.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4291 cda61777-01e9-0310-a592-d414129be87e

Support \I\c, \I\cw. (Haven't bothered with \I\e since the emphasis may as
well outweigh the "invisibility".)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4290 cda61777-01e9-0310-a592-d414129be87e

s/text-quotes/man-quotes/. Damn cut and paste. Thanks Jacob.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4288 cda61777-01e9-0310-a592-d414129be87e

The Halibut manual contained at least one instance of two index
terms (intentionally) differing only in case, which were being
silently folded into one by the case-insensitive index tag
comparison. Halibut now warns in this situation (but then folds them
anyway, which I think is better than silently generating an index
containing many case-distinct forms of the same word - I imagine
it's very easy to do that by mistake). The manual has been fixed to
explicitly define distinct keywords (in the case I spotted and in
five other cases picked up by the new warning!), and also documents
this issue and how to work with it.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4279 cda61777-01e9-0310-a592-d414129be87e

Er, don't forget to document the disallowing of \q within \c. Ahem.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4278 cda61777-01e9-0310-a592-d414129be87e

Enforce that \q may not be used anywhere within \c. It shouldn't be
necessary since the whole point of \c should be that the user wants
to exercise exact control over the glyphs used, and forbidding it
has the useful effect of relieving some backends of having to make
difficult decisions: it means the text backend doesn't have to nest
two pairs of identical quotes, and the paper backends don't have to
downgrade their quote characters if (as is perfectly plausible) the
fixed-pitch font doesn't support the same range as the body text
fonts.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4277 cda61777-01e9-0310-a592-d414129be87e

Switch the memory allocation macros from the Halibut ones
(mknew/mknewa/resize) to the PuTTY ones (snew/snewn/sresize). snewn
and mknewa have their arguments opposite ways round; this may make
the change initially painful but in the long term will free me of a
nasty context switch every time I move between codebases. Also
sresize takes an explicit type operand which is used to cast the
return value from realloc, thus enforcing that it must be correct,
and arranging that if anyone tries to compile Halibut with a C++
compiler there should be a lot less pain.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4276 cda61777-01e9-0310-a592-d414129be87e

Initial checkin of the shiny new rewritten-from-scratch HTML back
end. There's a lot more _potentiality_ for new features than there
are actual new features just yet, but future highlights include:
configurable flavour of HTML (3.2, 4, XHTML Transitional or Strict),
proper character set support (this is half way there already), and
more flexible allocation of sections between multiple HTML files.
Meanwhile, immediate benefits include correct handling of special
characters within `author' and `description' strings, omission of
the filename part in hyperlinks within the same HTML file (in
particular, this means a single output file is now totally
independent of its filename), and hyperlinks to the index from the
top-level contents page (I'm amazed nobody has complained at the
lack of this yet!). There are no doubt some shiny new bugs as well,
but I'll never find them unless people start using the thing...

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4275 cda61777-01e9-0310-a592-d414129be87e

rjk's `make install' patch.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4267 cda61777-01e9-0310-a592-d414129be87e

Stop the PDF backend from crashing if no outline elements appear. It
still doesn't _work_ properly if there aren't any contents entries,
but it's a start.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4250 cda61777-01e9-0310-a592-d414129be87e

All measurements in the paper backend are now configurable, as are
bullet and quote characters.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4249 cda61777-01e9-0310-a592-d414129be87e

Character-set-isation and configurability in the WinHelp backend.
Newly configurable things are: bullet and quote characters as usual,
the ": " that goes between a section number and its title, the "."
coming after numbered-list item numbers, and the text "Title page"
that appears at the top of the .cnt file.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4248 cda61777-01e9-0310-a592-d414129be87e

Configurable bullet and quote characters for the man backend.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4247 cda61777-01e9-0310-a592-d414129be87e

Kurt Jung points out that nav menus ought to be WHLP_PARA_SCROLL,
not _NONSCROLL.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4228 cda61777-01e9-0310-a592-d414129be87e

para_Title was confusing the XHTML backend and preventing it from
printing preambles. Not quite sure how I missed that one!

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4201 cda61777-01e9-0310-a592-d414129be87e

Windows Help backend was only accepting \cfg{winhelp-filename} if it
had a parent pointer (owing to putting the test inside the wrong if
block). This meant that the fake config directive added by
--winhelp=foo.hlp worked fine, but the one at the top of PuTTY's
first doc file didn't. Fixed.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4190 cda61777-01e9-0310-a592-d414129be87e

Handle paragraph comments with no space (e.g. "\#waffle"), since these seem
to be permitted (and are used in the PuTTY manual)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4164 cda61777-01e9-0310-a592-d414129be87e

General configurability upgrade for the info back end.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4131 cda61777-01e9-0310-a592-d414129be87e

Ahem; that only didn't cause a segfault by sheer luck.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4130 cda61777-01e9-0310-a592-d414129be87e

Oh, and now the text backend warns about too-long code lines, I'd
better remove the one too-long code line in the manual :-)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4129 cda61777-01e9-0310-a592-d414129be87e

Enhance the text backend to support configurable quote characters,
configurable emphasis characters, various other configurable bits
which have been marked FIXME in the code for a while, and also to
warn when a code paragraph line is too long (because that was the
only other thing labelled FIXME). Fallback options are implemented,
and defaults set accordingly. A UTF-8 text output file now looks
like proper UTF-8.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4128 cda61777-01e9-0310-a592-d414129be87e

Rewrite ustrftime(), so that (a) it uses wcsftime() where available,
and (b) it doesn't trip over strange Unicode characters in the
format string.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4120 cda61777-01e9-0310-a592-d414129be87e

Use wcscoll(), if available, when sorting index terms. (In a
somewhat roundabout and arse-backwards sort of way, due to some
other properties of the sort that I rather wanted to maintain. But I
hope it should still do some good.)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4119 cda61777-01e9-0310-a592-d414129be87e

Use iswalpha and towlower if they're available.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4118 cda61777-01e9-0310-a592-d414129be87e

Instead of traversing a list of paragraphs, mark_attr_ends() now
merely traverses a list of words, and main() takes responsibility
for applying it to each paragraph in the document. This is so that
it can _also_ be applied to the display form of each index entry,
which Jacob spotted wasn't previously being done.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4117 cda61777-01e9-0310-a592-d414129be87e

bk_text and bk_info both need to know the on-screen width of
characters in order to wrap and align them properly. Therefore, they
should be using wcwidth(). So here are a couple of wrappers on
wcwidth(), one which filters out the Unicode characters not
representable in the target charset, and one which converts _from_ a
charset to Unicode before calling wcwidth(). bk_text and bk_info
should now align correctly even in the face of unsupported
characters and Japanese.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4116 cda61777-01e9-0310-a592-d414129be87e

Support the locale-supplied character set where appropriate. It's
used for converting command-line -C directives into Unicode; it's
used for outputting Unicode strings to stderr in error messages; and
it's used as the default character set for input files (although I'd
be inclined to recommend everyone use \cfg{input-charset} in all
their source files to ensure their portability).

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4114 cda61777-01e9-0310-a592-d414129be87e

Charset support for the man page backend (\cfg{man-charset}).

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4112 cda61777-01e9-0310-a592-d414129be87e

Charset support for the info backend (\cfg{info-charset}). (This
checkin touches other files because a function in bk_text.c turned
out to be of more general use so I moved it out into ustring.c.)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4111 cda61777-01e9-0310-a592-d414129be87e

Don't forget to mention the default setting for \cfg{input-charset}.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4106 cda61777-01e9-0310-a592-d414129be87e

Acroread's PDF cut and paste appears to depend on the order in which
text fragments appear in the page graphics stream. Therefore, I
should take care to display the leaders _before_ the page number in
each contents entry.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4105 cda61777-01e9-0310-a592-d414129be87e

Add some tests of Unicode in the PDF document outline.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4104 cda61777-01e9-0310-a592-d414129be87e

Ahem. Fix stupid string handling error in new command-line config
mechanism.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4103 cda61777-01e9-0310-a592-d414129be87e

The Windows Help backend now uses libcharset to the maximum extent
it can. (Which isn't much, since I currently don't know how to
indicate that a help file is encoded in anything other than Win1252,
and so the only use I found for libcharset was to replace the
previous pathetic 8859-1 conversion so that extra things like the
trademark sign are supported.)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4102 cda61777-01e9-0310-a592-d414129be87e

PDF outline headings, it turns out, should be encoded using either
PDFDocEncoding or UTF-16BE. (The PDF specification's index is
terribly bad; I looked under various obvious things such as
`character set' and `string literal' with no success, and I didn't
manage to find out what character set metadata string literals were
intended to be interpreted in until I discovered from another source
that the encoding was called PDFDocEncoding, and _then_ I was able
to look that up in the index. They should have been using Halibut! :-)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4101 cda61777-01e9-0310-a592-d414129be87e

Text backend is now charset-enabled: the entire text file is built
from the ground up in Unicode, and a single charset conversion pass
is done over the data as it's output.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4100 cda61777-01e9-0310-a592-d414129be87e

Add some tests of input charset switching.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4099 cda61777-01e9-0310-a592-d414129be87e

Forgot to add *.ps and *.pdf to the `make clean' list!

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4098 cda61777-01e9-0310-a592-d414129be87e

Infrastructure changes for character set support. ustrtoa,
ustrfroma, utoa_dup and ufroma_dup now take a charset parameter, and
also have a variety of subtly distinct forms. Also, when a \cfg
directive is seen in the input file, the precise octet strings for
each parameter are kept in their original form as well as being
translated into Unicode, so that when they represent filenames they
can be used verbatim.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4097 cda61777-01e9-0310-a592-d414129be87e

Support for \cfg{input-charset}. Input files can now be in ASCII,
8859-*, UTF-8, or a variety of more fun encodings including various
multibyte ones.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4095 cda61777-01e9-0310-a592-d414129be87e

Better robustness when backends encounter a Unicode character not
representable in the output character set.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4094 cda61777-01e9-0310-a592-d414129be87e

Link libcharset into Halibut. (This involved faffing with
CVSROOT/modules, so anyone with a checked-out copy of Halibut will
unfortunately need to do `cvs co' again.)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4088 cda61777-01e9-0310-a592-d414129be87e

Include libcharset into both the Timber and Halibut checkouts.
Unfortunately this means people will have to do `cvs co' again to
get this update, but that appears to be the price I pay for being
able to conveniently share a single source base in this way.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4086 cda61777-01e9-0310-a592-d414129be87e

Add a TODO entry.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4084 cda61777-01e9-0310-a592-d414129be87e

Compacted PS and PDF output files by removing redundant reiterations
of the same font and position designations. Reduced the size of the
Halibut manual PDF to less than half what it started out as, and the
PS one to more like a third of its original size.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4083 cda61777-01e9-0310-a592-d414129be87e

Standardise on using double quotes in HTML attributes. It turns out
that the GNOME help browser is perfectly happy with Halibut's HTML
_except_ that it doesn't approve of single quotes in places such as
<a href='here'>.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4082 cda61777-01e9-0310-a592-d414129be87e

Support the \W{...}\i\c{...} combination used in the NASM manual.
Halibut is now capable of reading the old NASM manual with only
minor modifications, and probably doing a much better job of
formatting it than rdsrc.pl ever did. (Certainly much _faster_!)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4081 cda61777-01e9-0310-a592-d414129be87e

Prevent a tight loop. Oops.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4080 cda61777-01e9-0310-a592-d414129be87e

Put the document's version IDs into comments in the PS and PDF
output files.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4079 cda61777-01e9-0310-a592-d414129be87e

Ahem. If an indexable term appears in a section heading, the index
should not also point to a page in the contents! :-)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4078 cda61777-01e9-0310-a592-d414129be87e

Administrivia: update a TODO and a .cvsignore.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4077 cda61777-01e9-0310-a592-d414129be87e

After printing out the PDF manual and reading it through, here's a
collection of minor edits for clarity, and also quite a few intended
to keep down the length of lines in code paragraphs (because Courier
is not just a thoroughly ugly font but is also WAY TOO WIDE).

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4076 cda61777-01e9-0310-a592-d414129be87e

... oh, except that minimal documentation might be helpful.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4075 cda61777-01e9-0310-a592-d414129be87e

Display the page numbers on every page. Right. I think this is now
basically usable, and certainly it entirely includes the level of
functionality which was provided by our ancestor Perl script. So I
think I'll stop coding frantically and have a rest!

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4074 cda61777-01e9-0310-a592-d414129be87e

And now the page numbers in the index are PDF cross-references too.
Funny, I thought that would be as hard again as the main index
processing, and it turned out to be nearly trivial.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4073 cda61777-01e9-0310-a592-d414129be87e

Implemented an index. Good _grief_, that was hard work to get all
the fine details right.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4072 cda61777-01e9-0310-a592-d414129be87e

Typo during restructuring caused all code paragraphs to be
permanently bold. Fixed.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4071 cda61777-01e9-0310-a592-d414129be87e

The contents section now contains PDF cross-references.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4070 cda61777-01e9-0310-a592-d414129be87e

Support for a contents section.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4069 cda61777-01e9-0310-a592-d414129be87e

Restructuring to remove the requirement for a printed paragraph to
correspond exactly to a source paragraph. Should allow me to create
multiple printed paragraphs from the same source paragraph (i.e. a
contents entry for each heading in addition to the heading itself),
and invent entirely new printed paragraphs of my own (e.g. for index
entries).

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4068 cda61777-01e9-0310-a592-d414129be87e

Implemented PDF outlines.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4067 cda61777-01e9-0310-a592-d414129be87e

Implemented horizontal rules.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4066 cda61777-01e9-0310-a592-d414129be87e

Implemented lines under chapter titles.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4065 cda61777-01e9-0310-a592-d414129be87e

Fine-tuned the page breaking algorithm by adding penalties and
bonuses for breaking in particular places. (For example, it's
especially bad to break just after a heading, and especially good to
break just before one.)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4064 cda61777-01e9-0310-a592-d414129be87e

I wrote the info backend _days_ ago. About time the manpage stopped
listing its absence as a bug :-)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4063 cda61777-01e9-0310-a592-d414129be87e

Fix the TODO comments up a bit.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4062 cda61777-01e9-0310-a592-d414129be87e

Implemented all the missing rendering features (such as different
font selection in headings, mentioning section numbers, bullets,
list item numbers, code paragraphs etc). The PS/PDF output now
actually looks like the document it's supposed to be :-)

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4061 cda61777-01e9-0310-a592-d414129be87e

Implement PDF link annotations: both internal hyperlinks within the
document, and references to external URLs for which acroread will
start a web browser.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4060 cda61777-01e9-0310-a592-d414129be87e

Aha, _that's_ why paragraphs weren't properly justified. Confusion
of semantics as to whether a `last' pointer pointed to the last
relevant thing in a list, or the one beyond that. Oops.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4059 cda61777-01e9-0310-a592-d414129be87e

Initial work on PS and PDF output. Because these two backends share
an enormous amount of preprocessing and differ only in their final
output form, I've introduced a new type of layer called a
`pre-backend' (bk_paper.c is one). This takes all the information
passed to a normal backend and returns an arbitrary void *, which is
cached by the front end and passed on to any backend(s) which state
a desire for the output of that particular pre-backend. Thus, all
the page layout is done only once, and the PS and PDF backends
process the same data structures into two output files.
Note that these backends are _very_ unfinished; all sorts of vital
things such as section numbers, list markers, and title formatting
are missing, the paragraph justification doesn't quite work, and
advanced stuff like indexes and PDF interactive features haven't
even been started. But this basic framework generates valid output
files and is a good starting point, so I'm checking it in.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4058 cda61777-01e9-0310-a592-d414129be87e

Double yikes! I meant to check in just biblio.c, but instead I
checked in all my just-started PS and PDF framework. I'm backing
that lot back out until it actually does something. Ahem.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4057 cda61777-01e9-0310-a592-d414129be87e

Yikes! Stack trash I'd never noticed before. Oops.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4056 cda61777-01e9-0310-a592-d414129be87e

Forgot to mention the info backend in the command-line help. Oops.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4055 cda61777-01e9-0310-a592-d414129be87e

Forgot to mention the info backend in the man page.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4054 cda61777-01e9-0310-a592-d414129be87e

The Emacs and Jed info readers don't like my index format: Info menu
items of the form `* stuff: Section 1.2.' are parsed by standalone
info as `Section 1.2' followed by a period, but are parsed by other
readers as `Section 1' followed by a period and then some spare
text. Therefore, I've changed strategy, and the index is now full of
*Note cross-references rather than menu items. On the plus side,
this means there are no longer any special characters which we can't
tolerate in an index entry; on the minus side, my shiny new
infrastructure for tracking the filepos of index entries is now
rendered pointless. I'll leave it in, though, since it may come in
handy again.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4053 cda61777-01e9-0310-a592-d414129be87e

Add documentation for the info backend.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4052 cda61777-01e9-0310-a592-d414129be87e

Info backend now takes care to avoid magic characters in node names
and index terms (the Info format doesn't like them). In the course
of this I've had to introduce some infrastructure for carrying a
filepos forward from the definition of every RHS index term so that
a particular backend can provide a usefully localised report of
which index term had a problem.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4051 cda61777-01e9-0310-a592-d414129be87e

It would probably help to add a test of the INFO-DIR-ENTRY mechanism
to the test file. Ahem.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4050 cda61777-01e9-0310-a592-d414129be87e

Add a config directive to generate the INFO-DIR-ENTRY things that
appear to be used to automatically construct /usr/info/dir.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4049 cda61777-01e9-0310-a592-d414129be87e

Why hadn't I got round to creating a .cvsignore in the main source
directory before? Silly me.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4048 cda61777-01e9-0310-a592-d414129be87e

Added an info(1) backend, which constructs .info files directly
without going through the .texi source stage. A few things left to
do, notably documentation, but the basics all seem to be there.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4047 cda61777-01e9-0310-a592-d414129be87e

Ahem; let's have all the man page headings at the same level!

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4045 cda61777-01e9-0310-a592-d414129be87e

Add a horrid md5sum manifest mechanism similar to the one I used in
the Unix PuTTY archive, to automatically generate version numbers
for Halibut release builds.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4044 cda61777-01e9-0310-a592-d414129be87e

Add installation instructions.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4043 cda61777-01e9-0310-a592-d414129be87e

Add a man page.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4042 cda61777-01e9-0310-a592-d414129be87e

Jacob pointed out various important facts missing from the Halibut
manual. Added them.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@4038 cda61777-01e9-0310-a592-d414129be87e