sgt/halibut
20 years agoOops; uninitialised variable.
simon [Wed, 31 Mar 2004 17:56:22 +0000 (17:56 +0000)]
Oops; uninitialised variable.

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

20 years agoAfter so much fuss was made about this being an _XHTML_ back end
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

20 years agoBah, there's always one. Missing file.
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

20 years ago\lcont and \quote were being confused by whitespace (in particular,
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

20 years agoFix index sorting so that it collates in a sensible order.
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

20 years agoMake \ii work!
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

20 years agoThe navigation links now contain a link to the index page.
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

20 years agoSimplify treatment of the copyright notice, now I've also simplified
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

20 years agoI always meant to remove emphasis in the index by default. Now I do
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

20 years agoThe manual is now fully indexed.
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

20 years agoCouple of extra points: forgot about the \i\cw special case, and
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

20 years agoFix bug in HTML index generation: any index tags appearing in a
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

20 years agoSecond instalment of the manual: added a chapter on output formats.
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

20 years agoIntroduce \. as a NOP command. The purpose of this is to act as a
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

20 years agoObsoleted the `\preamble' command. Preamble text is now taken to be
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

20 years agoFirst instalment of a manual for Halibut. This lot covers the
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

20 years agoAdd a \quote{...} directive, working like <blockquote> in HTML.
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

20 years agoApparently we must include the .TH directive in a man page even when
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

20 years agoCleanups to complete the man page backend. Also, an additional new
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

20 years agoOops, nearly forgot. Nesting one numbered list inside another should
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

20 years agoMan-page back end for Halibut. Also, a couple of additional markup
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

21 years agoWinHelp backend segfaults when it finds a nonexistent cross-
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

21 years agoOf course, when I start freeing things in response to valgrind's
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

21 years agoJust had a play with this newfangled `valgrind' memory debugger
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

21 years agoAdd configurability for section heading formats, in much the same
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

21 years agoAdd configurability for the suffix after the section number and
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

21 years agoArrange for multiple \cfg, \IM and \BR paragraphs to not require
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

21 years agoFix the bug in the text back end whereby bulletted paragraphs' width
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

21 years agoAdd `topclean' target to the top-level Makefile, to remove the
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

21 years agoSlightly improve the handling of headings in HTML single-file mode.
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

21 years agoUpgrade to Halibut xhtml backend, to allow leaf_level to be zero (in
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

21 years agoRename Buttress to Halibut. I _think_ I've caught everything in this pass.
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