/*
- * info backend for Halibut
+ * Info backend for Halibut
+ *
+ * The Info file format isn't well-specified, and what specification
+ * there is is scattered all over the place. Sources include:
+ * (info), from GNU Texinfo.
+ * (texinfo), also from GNU Texinfo.
+ * (Emacs)Misc Help, and (emacs)Info Lookup, from GNU Emacs.
+ * info.el, from GNU Emacs.
*
* Possible future work:
*
*
* - might be helpful to diagnose duplicate node names!
*
- * - more flexibility in heading underlines, like text backend.
- * + Given info.el's fontifier, we'd want the following defaults:
- * \cfg{info-title-underline}{*}
- * \cfg{info-chapter-underline}{=}
- * \cfg{info-section-underline}{0}{-}
- * \cfg{info-section-underline}{1}{.}
- *
* - Indices generated by makeinfo use a menu rather than a bunch of
* cross-references, which reduces visual clutter rather. For
* singly-referenced items, it looks like:
* make things slightly less ugly by using the lower-case version
* when the user asks for \k. Unfortunately, standalone Info seems
* to match node names case-sensitively, so we can't downcase that.
+ *
+ * - The character encoding used in an Info file can be configured using
+ * an Emacs local variables block at the end, like this:
+ * Local Variables:
+ * coding: iso-8859-1
+ * End:
*/
#include <stdio.h>