X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/halibut/blobdiff_plain/e32df3e7953d1519f52be001d197fe3d69aac5eb..8f664e7e91c918cd13248f6b684580c4dd2cdb31:/bk_info.c

diff --git a/bk_info.c b/bk_info.c
index d8a3837..d898e61 100644
--- a/bk_info.c
+++ b/bk_info.c
@@ -1,5 +1,12 @@
 /*
- * 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:
  * 
@@ -22,13 +29,6 @@
  * 
  *  - 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:
@@ -42,6 +42,12 @@
  *    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>