contrib/texinfo/TODO

   1 Copyright (C) 1992, 93, 94, 95, 96, 97, 98, 99, 2000, 01, 02
   2 Free Software Foundation.
   3
   4 Permission is granted to copy, distribute and/or modify this document
   5 under the terms of the GNU Free Documentation License, Version 1.1 or
   6 any later version published by the Free Software Foundation; with no
   7 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.
   8
   9
  10 If you are interested in working on any of these, email bug-texinfo@gnu.org.
  11
  12 * Makeinfo:
  13   - Try directory of main source file.
  14   - Support @`{@dotless{i}} et al. in HTML.
  15   - A detexinfo program, like detex or delatex.  This command would
  16     strip all the texinfo commands out, and would be used as a filter on
  17     the way to a speller.  An option would be to NOT strip comments out.
  18     makeinfo --no-headers comes close.
  19   - If node name contains an @ command, complain explicitly.
  20   - Call Ghostscript to get ASCII/jpg output for the @image command.
  21   - Better HTML output: allow settable background color, table colors
  22     and spacing, <head> meta tags, back link from footnote marker, etc.
  23   - Rewrite completely to simplify generation of different formats.
  24
  25 * TeX:
  26   - Use @ as the escape character, and Texinfo syntax generally, in the
  27     table of contents, aux, and index files.  Eliminate all the crazy
  28     multiple redefinitions of every Texinfo command in different contexts.
  29   - Handle @hsep and @vsep in @multitables.
  30   - Introduce new command to change \bindingoffset.
  31   - Reasonable way to change fonts from the default (some work has been
  32     done), to allow for PostScript fonts, for example.
  33   - How about using latex2html to produce HTML?
  34   - Support 8-bit input characters, perhaps via the ec fonts.
  35   - Repeat table headings if a @multitable is multiple pages long.
  36   - Table of contents gets misaligned if there are 10 or more [sub]sections.
  37
  38 * General:
  39   - Rationalize and improve the dir categories in existing manuals.
  40   - @xindexterm [def] primary [,secondary [,tertiary]]  or some such?
  41   - Support compressed image files.
  42   - Handle reference card creation, perhaps by only paying attention to
  43     sectioning and @def... commands.
  44   - Allow @end (and other?) commands to be indented in the source.
  45   - Get Info declared as a MIME Content-Type.
  46
  47 * Language:
  48   - @figure:
  49 @figure [xref-label]
  50 @figureinclude <filename>, [<height>], [<width>]
  51 @figurehsize <dimen>
  52 @figurevsize <dimen>
  53 @caption ... @end caption
  54 <arbitrary Texinfo commands>
  55 @end figure
  56   - multicolumn * width to take up `the rest'.
  57   - another table command to take N succeeding items and split them
  58     into M columns (see eplain).
  59   - support bibliographies with BibTeX (see web2c/doc for kludge prototype).
  60   - @flushboth to combine @flushleft and @flushright, for RFC's.
  61   - @part sectioning command.
  62   - Allow subitems and `see' and `see also' in indices.
  63   - @exercise/@answer command for, e.g., gawk.
  64   - Allow @hsep/@vsep at @item, instead of just in template.
  65   - Support automatic line numbering of examples.
  66   - Better macro syntax.
  67   - Allow : in node names for info files, for names like
  68     `class::method'.  Likewise index entries.  A quoting mechanism such
  69     as surrounding node names with SPACE BACKSPACE is probably the best
  70     solution, although this is an incompatible change to Info format, sigh.
  71   - Change bars.  This is difficult or impossible in TeX,
  72     unfortunately.  To do it right requires device driver support.
  73     wdiff or ediff may be all we can do.
  74
  75 * Doc:
  76   - Include a complete functional summary, as in a reference card, in
  77     the manual.
  78   - Improve the manuals, especially for makeinfo, standalone info, etc.
  79   - new section on doing dedication pages. See gawk.texi
  80     for an example of doing it in both the tex and info versions.
  81
  82 * Info:
  83   - Regular expression search.
  84   - Full-text search across all info files installed on the system.
  85   - Support character sets other than ISO Latin 1.
  86   - Perhaps comply with LANGUAGE setting on a per-node basis, to allow
  87     incremental translation of Texinfo files.
  88   - Search all nodes of dir file at startup, then can have
  89     INFO-DIR-SEPARATE-GROUPS and other such.
  90   - Better dir file merging.
  91   - Steal interface ideas from Lynx: number links, use color, etc.
  92     Perhaps code from the pinfo viewer can be reused:
  93     http://zeus.polsl.gliwice.pl/~pborys/.
  94   - More sample .infokey files, so people can choose without writing their own.
  95   - q within help should quit help like C-x 0.
  96   - Incorporate an X-based viewer, perhaps tkinfo
  97       http://www.math.ucsb.edu/~boldt/tkinfo/
  98     or saxinfo.
  99
 100 * PDF:
 101   - make each letter of the index (A, B, ...) a section in the TOC.
 102     From Carsten Dominik <dominik@astro.uva.nl>.
 103
 104
 105 * install-info:
 106   - be able to copy the info file to compile-time $(infodir), to
 107     simplify by-hand installation.
 108
 109
 110 Ideas that will not be implemented:
 111 - Process Texinfo files directly instead of converting to Info:
 112   ftp://ftp.cs.berkeley.edu/ucb/people/phelps/tcltk/tkman.tar.Z, which
 113   uses Tcl/Tk 8.0 from ftp.smli.com in the /pub/tcl directory.
 114   From: phelps@ecstasy.CS.Berkeley.EDU (Tom Phelps)
 115   [This has the disadvantage of needing to be updated when the
 116   Texinfo language changes, so don't.]
 117
 118 - Split HTML output by chapter.
 119   [Then cross-references in HTML cannot be generated consistently.]