simon [Wed, 31 Mar 2004 17:28:55 +0000 (17:28 +0000)]
After so much fuss was made about this being an _XHTML_ back end
rather than merely HTML, I thought it might be instructive to run it
through the W3C's XHTML validator. Consequent changes in this
checkin...
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4010
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 22:29:36 +0000 (22:29 +0000)]
Bah, there's always one. Missing file.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4007
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 20:22:00 +0000 (20:22 +0000)]
\lcont and \quote were being confused by whitespace (in particular,
a single newline) immediately after their opening brace; this was
causing a normal paragraph to be started, thus making it fiddly and
annoying to arrange the first paragraph of a \lcont to be a code
para or anything else special. Now fixed.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4005
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 20:12:37 +0000 (20:12 +0000)]
Fix index sorting so that it collates in a sensible order.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4004
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 20:01:44 +0000 (20:01 +0000)]
Make \ii work!
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4003
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 19:49:42 +0000 (19:49 +0000)]
The navigation links now contain a link to the index page.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4002
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 19:40:56 +0000 (19:40 +0000)]
Simplify treatment of the copyright notice, now I've also simplified
the preamble: \copyright paragraphs are now treated identically to
normal paragraphs (so they appear precisely where they're put
instead of in a fixed location), _except_ that the Windows Help
backend also copies their text into the help file's copyright slot.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4001
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 19:32:00 +0000 (19:32 +0000)]
I always meant to remove emphasis in the index by default. Now I do
so. It's restorable using \IM.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@4000
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 30 Mar 2004 19:22:19 +0000 (19:22 +0000)]
The manual is now fully indexed.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3999
cda61777-01e9-0310-a592-
d414129be87e
simon [Sat, 27 Mar 2004 17:09:13 +0000 (17:09 +0000)]
Couple of extra points: forgot about the \i\cw special case, and
Jacob points out that I didn't specify whether inline formatting
commands can surround line breaks (they can).
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3994
cda61777-01e9-0310-a592-
d414129be87e
simon [Sat, 27 Mar 2004 09:59:41 +0000 (09:59 +0000)]
Fix bug in HTML index generation: any index tags appearing in a
section title (which is not remotely unreasonable) got index
references added to them not only when the section title was
processed as part of its section, but also when it was processed as
part of contents navigation displays - in which situation it tended
to cause a link to, for example, the last section in the _previous_
file. Now we keep constant track of whether or not we're supposed to
be indexing things as we process text.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3991
cda61777-01e9-0310-a592-
d414129be87e
simon [Fri, 26 Mar 2004 18:18:57 +0000 (18:18 +0000)]
Second instalment of the manual: added a chapter on output formats.
I _think_ the manual now contains all the information a user should
need, even if not yet in an optimal order for a beginner to learn
from.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3989
cda61777-01e9-0310-a592-
d414129be87e
simon [Thu, 25 Mar 2004 19:27:12 +0000 (19:27 +0000)]
Introduce \. as a NOP command. The purpose of this is to act as a
zero-width delimiter between a macro invocation and text beyond it,
so that you can define (say) a macro which expands to a Euro sign
and then write `\eur\.2500' to avoid having space between the Euro
sign and the number.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3982
cda61777-01e9-0310-a592-
d414129be87e
simon [Thu, 25 Mar 2004 19:16:28 +0000 (19:16 +0000)]
Obsoleted the `\preamble' command. Preamble text is now taken to be
any ordinary displayable paragraph(s) appearing before the first
chapter heading, meaning in particular that you can put lists, code
paragraphs etc in preambles. Of course, `\preamble' is still
supported for backwards compatibility, but it's now a zero-effect
paragraph marker.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3981
cda61777-01e9-0310-a592-
d414129be87e
simon [Thu, 25 Mar 2004 18:33:02 +0000 (18:33 +0000)]
First instalment of a manual for Halibut. This lot covers the
(nearly nonexistent) invocation syntax and the input format.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3979
cda61777-01e9-0310-a592-
d414129be87e
simon [Thu, 25 Mar 2004 18:32:05 +0000 (18:32 +0000)]
Add a \quote{...} directive, working like <blockquote> in HTML.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3978
cda61777-01e9-0310-a592-
d414129be87e
simon [Thu, 25 Mar 2004 18:31:45 +0000 (18:31 +0000)]
Apparently we must include the .TH directive in a man page even when
there's nothing to go in it.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3977
cda61777-01e9-0310-a592-
d414129be87e
simon [Wed, 24 Mar 2004 19:23:21 +0000 (19:23 +0000)]
Cleanups to complete the man page backend. Also, an additional new
markup feature: a \c line in a code paragraph can now be followed by
an optional \e line indicating emphasised bits of its preceding \c.
This allows discretionary bolding and (italic/underline) emphasis
within code paragraphs, but without introducing an escape character
or breaking any existing input files. Users are warned that not all
backends are required to actually render these hints, and so they
should avoid depending on them 100% to convey semantic information
unless they know they're writing for a restricted range of backends.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3965
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 23 Mar 2004 20:19:01 +0000 (20:19 +0000)]
Oops, nearly forgot. Nesting one numbered list inside another should
not break the numbering of the outer one!
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3955
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 23 Mar 2004 20:10:23 +0000 (20:10 +0000)]
Man-page back end for Halibut. Also, a couple of additional markup
features commonly used in man pages: (a) the ability to nest
paragraph breaks, code paragraphs and other lists inside list items,
and (b) description lists as normally used in man pages to describe
command-line options.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@3954
cda61777-01e9-0310-a592-
d414129be87e
simon [Thu, 9 Jan 2003 12:04:01 +0000 (12:04 +0000)]
WinHelp backend segfaults when it finds a nonexistent cross-
reference. (The broken link will already have been reported in the
mid-end, but this won't inhibit output generation, so the onus is
still on us to at the very least not go *crash*.)
git-svn-id: svn://svn.tartarus.org/sgt/halibut@2507
cda61777-01e9-0310-a592-
d414129be87e
simon [Tue, 3 Sep 2002 09:26:58 +0000 (09:26 +0000)]
Of course, when I start freeing things in response to valgrind's
complaints, it would probably help if I arranged that those things
had been _allocated_ in all cases, otherwise we merely exchange a
memory leak for a core dump. Duh.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1916
cda61777-01e9-0310-a592-
d414129be87e
simon [Fri, 23 Aug 2002 14:02:01 +0000 (14:02 +0000)]
Just had a play with this newfangled `valgrind' memory debugger
thingy, which seems moderately cool and has reported a few very
small memory leaks. Now apparently fixed.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1863
cda61777-01e9-0310-a592-
d414129be87e
simon [Mon, 12 Aug 2002 11:25:42 +0000 (11:25 +0000)]
Add configurability for section heading formats, in much the same
way as bk_text already does it (you can choose to have or not have
the "Section" at the start, and you can configure the suffix between
number and title).
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1839
cda61777-01e9-0310-a592-
d414129be87e
simon [Mon, 12 Aug 2002 11:24:59 +0000 (11:24 +0000)]
Add configurability for the suffix after the section number and
before the section title (the ": " in "Section 1: Introduction").
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1838
cda61777-01e9-0310-a592-
d414129be87e
simon [Mon, 12 Aug 2002 11:24:28 +0000 (11:24 +0000)]
Arrange for multiple \cfg, \IM and \BR paragraphs to not require
blank-line separators (config directives visually _want_ to be in a
single chunk).
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1837
cda61777-01e9-0310-a592-
d414129be87e
simon [Sun, 11 Aug 2002 18:20:32 +0000 (18:20 +0000)]
Fix the bug in the text back end whereby bulletted paragraphs' width
failed to be decreased to compensate for the additional indent.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1834
cda61777-01e9-0310-a592-
d414129be87e
simon [Sun, 11 Aug 2002 16:04:42 +0000 (16:04 +0000)]
Add `topclean' target to the top-level Makefile, to remove the
output from running Halibut on a test input file.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1833
cda61777-01e9-0310-a592-
d414129be87e
simon [Sun, 11 Aug 2002 16:02:43 +0000 (16:02 +0000)]
Slightly improve the handling of headings in HTML single-file mode.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1832
cda61777-01e9-0310-a592-
d414129be87e
simon [Sun, 11 Aug 2002 15:28:24 +0000 (15:28 +0000)]
Upgrade to Halibut xhtml backend, to allow leaf_level to be zero (in
which case the whole of the HTML output will be in a single file,
currently called Manual.html in the absence of configurability).
This includes the index, if present.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1831
cda61777-01e9-0310-a592-
d414129be87e
simon [Mon, 5 Aug 2002 10:31:35 +0000 (10:31 +0000)]
Rename Buttress to Halibut. I _think_ I've caught everything in this pass.
git-svn-id: svn://svn.tartarus.org/sgt/halibut@1800
cda61777-01e9-0310-a592-
d414129be87e