List some documentation sources, and another todo item.
authorben <ben@cda61777-01e9-0310-a592-d414129be87e>
Sun, 8 Apr 2007 20:47:01 +0000 (20:47 +0000)
committerben <ben@cda61777-01e9-0310-a592-d414129be87e>
Sun, 8 Apr 2007 20:47:01 +0000 (20:47 +0000)
git-svn-id: svn://svn.tartarus.org/sgt/halibut@7454 cda61777-01e9-0310-a592-d414129be87e

bk_info.c

index faf691c..d898e61 100644 (file)
--- 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:
  * 
  *    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>