X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/halibut/blobdiff_plain/f6220253b2e31a88862b8beae822ff11cc5576ab..22e33bbadced87bb648d8038291cc2e88afe74b5:/bk_info.c

diff --git a/bk_info.c b/bk_info.c
index 5b82177..4a6ea73 100644
--- a/bk_info.c
+++ b/bk_info.c
@@ -21,6 +21,27 @@
  *        * Section 1.2: Nodename. Title of section.
  * 
  *  - 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:
+ *      * toner cartridge, replacing:              Toner.
+ *    It does a horrid job on multiply-referenced entries, though,
+ *    perhaps because the name before the colon is meant to be unique.
+ *    Info's 'i' command requires the use of a menu -- it fails to
+ *    find any index entries at all with Halibut's current index format.
+ *
+ *  - The string "*note" is matched case-insensitively, so we could
+ *    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.
  */
 
 #include <stdio.h>