diff options
Diffstat (limited to 'Build/source/utils/texinfo/TODO')
-rw-r--r-- | Build/source/utils/texinfo/TODO | 181 |
1 files changed, 181 insertions, 0 deletions
diff --git a/Build/source/utils/texinfo/TODO b/Build/source/utils/texinfo/TODO new file mode 100644 index 00000000000..0fcaa5c5991 --- /dev/null +++ b/Build/source/utils/texinfo/TODO @@ -0,0 +1,181 @@ +$Id: TODO,v 1.26 2004/11/22 23:57:32 karl Exp $ +This is the todo list for GNU Texinfo. +If you are interested in working on any of these, email bug-texinfo@gnu.org. + + Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2003, + 2001, 2002, 2003, 2004 Free Software Foundation. + + Copying and distribution of this file, with or without modification, + are permitted in any medium without royalty provided the copyright + notice and this notice are preserved. + +* General: + - @euro{}. + - Support installation of manuals in different languages, along these lines: + . support a LINGUAS file or variable saying which subdirs LL in the + source to descend into (under doc/). + . within each subdir LL, install the info files into $infodir/LL, + and run install-info on $infodir/LL/dir. + . info (both emacs and standalone) should read $infodir/$LANG/dir + as the first dir file, and likewise read info files first from + $infodir/$LANG, before falling back to $infodir. + . consider ways to avoid installing images in both places. + In fact, images probably need to be installed in a subdir + $infodir/MANUAL/ in the first place, to avoid conflicts of having + the same image name in different manuals. + For a test case, see texinfo cvs, with its one translated manual + (info-fr.texi). + From Wojciech Polak. + - Monitor and improve the dir categories in existing manuals, + following the Free Software Directory categories. Much mail to + developers has already been sent, what's needed now is to check new + releases and make sure they are using the right categories. + See the util/dir-example in the Texinfo distribution for our current + recommended categories. + For background, see the thread (which discusses a lot of other + issues too) at + http://mail.gnu.org/pipermail/emacs-devel/2002-10/msg00011.html, + especially + http://mail.gnu.org/archive/html/emacs-devel/2002-10/msg00090.html + http://mail.gnu.org/archive/html/emacs-devel/2002-10/msg00137.html + - Get Info declared as a MIME Content-Type. + - Likewise the `info:' URI scheme; a library consortium has proposed a + completely different purpose for the URI scheme, but I don't know + how to send comments, despite it being a "request for comments". Sigh. + There is mail about this in the bug-texinfo archives: + http://mail.gnu.org/archive/html/bug-texinfo/2003-09/msg00086.html + - Support compressed image files. + - Support reference card creation, perhaps by only paying attention to + sectioning and @def... commands. + - Allow @end (and other?) commands to be indented in the source. + - Test for memory leaks, e.g., with valgrind: + http://developer.kde.org/~sewardj/ + - Extend and improve the tests. + +* Language: + - @else for the @if... conditionals. + - @xindexterm [def] primary [,secondary [,tertiary]] or some such? + - Allow subitems and `see' and `see also' in indices. + - multicolumn * width to take up `the rest'. + - another table command to take N succeeding items and split them + into M columns (see eplain). + - support bibliographies with BibTeX (see web2c/doc for kludge prototype). + - @flushboth to combine @flushleft and @flushright, for RFC's. + - @part sectioning command. + - @exercise/@answer command for, e.g., gawk. + - Allow @hsep/@vsep at @item, instead of just in template. + - Support automatic line numbering of examples. + - Better macro syntax. + - Better def... command syntax. + - Allow : in node names for info files, for names like + `class::method'. Likewise index entries. A quoting mechanism such + as surrounding node names with SPACE BACKSPACE is probably the best + solution, although this is an incompatible change to Info format, sigh. + - Glossary/general definition support (dumas msg 28 Nov 2003 17:09:57 +0100). + - Add support for other Latin 9 (and Latin 2 and Latin 1) characters. + +* Makeinfo: + - Translation of "Appendix" etc. should depend on @doclang not $LANG. + - Try directory of main source file. + - Make makeinfo -E just do macro expansion, avoiding all error checks. + That way, texi2dvi could run makeinfo --iftex -E. + - A detexinfo program, like detex or delatex. This command would + strip all the texinfo commands out, and would be used as a filter on + the way to a speller. An option would be to NOT strip comments out. + makeinfo --no-headers comes close. + - If node name contains an @ command, complain explicitly. + - Use @documentlanguage instead of LANG for many translations. + - HTML: split output by chapter to improve context, per Akim. + Generate dummy files for all nodes for the sake of cross-references. + - HTML: support thumbnails. + - HTML: make images of math, maybe. + - HTML: allow settable background color, table colors and spacing, + <head> meta tags, etc. A la http://texi2html.cvshome.org. In fact: + - HTML: have a library of different CSS styles. + http://mail.gnu.org/archive/html/bug-texinfo/2004-01/msg00025.html + - XML: cannot be loaded directly in a browser; why not? + - Docbook: € and other entities do not work; does anything work? + - Rewrite completely to simplify generation of different formats. + +* TeX: + - Use @ as the escape character, and Texinfo syntax generally, in the + table of contents and index files. Eliminate all the crazy + multiple redefinitions of every Texinfo command in different contexts. + - Support input in any encoding and language, via ec or Latin Modern fonts. + - Reasonable way to change fonts from the default (some work has been + done), to allow for PostScript fonts, for example. + - @multitable: handle @hsep and @vsep. + - @multitable: repeat table headings if multiple pages long. + - @multitable: support a heading line concept (<thead> in HTML). + - Introduce new command to change \bindingoffset. + - How about using latex2html to produce HTML? + - Table of contents gets misaligned if there are 10 or more [sub]sections. + - Use url.sty (or something) to allow linebreak of url's. + - Include hyperlink \special's in the DVI output for xdvi, etc. + - PDF: make each letter of the index (A, B, ...) a section in the TOC. + From Carsten Dominik <dominik@astro.uva.nl>. + +* Doc: + - Include a complete functional summary, as in a reference card, in + the manual. + - Improve the manuals, especially for makeinfo, standalone info, etc. + - new section on doing dedication pages. See gawk.texi + for an example of doing it in both the tex and info versions. + +* Info: + - Regular expression search. + - Full-text search across all info files installed on the system. + - Support character sets other than ISO Latin 1. + - Perhaps comply with LANGUAGE setting on a per-node basis, to allow + incremental translation of Texinfo files. + - Search all nodes of dir file at startup, then can have + INFO-DIR-SEPARATE-GROUPS and other such. + - Better dir file merging. + - Global dir file (as in /etc/conf/dir) and texinfo config file + specifying which info directories to search. From Dale Mellor. + http://mail.gnu.org/mailman/private/gnu-prog-discuss/2003q4/000439.html + - Steal interface ideas from Lynx: number links, use color, etc. + Perhaps code from the pinfo viewer can be reused: + http://zeus.polsl.gliwice.pl/~pborys/. + - More sample .infokey files, so people can choose without writing their own. + - q within help should quit help like C-x 0. + - Incorporate an X-based viewer, perhaps saxinfo or tkinfo + http://www.math.ucsb.edu/~boldt/tkinfo/ + - Make "info foo bar" search for bar in foo's index(es) if no menu match. + - Handle M-n, C-u m, and C-u g like Emacs Info (opening new windows). + - Write technical definition of Info format. + +* install-info: + - be able to copy the info file to compile-time $infodir, to + simplify by-hand installation. + - also support installing HTML files, etc., along with subsidiary + @image (or other) files. In subdirs. Or something. + - support info dir entries for other than the current info file name; + see comments in menu_item_equal. + - merge features with Debian install-info, so we can have one program. + +* texindex: + - read source file (specified by new option) for @documentlanguage + and/or @documentencoding, and change the sorting appropriately. + From: Wojciech Polak, 26 Apr 2003 11:30:59 +0200. + +* Distribution: + - generate txi-??.tex from .po's to make translators' jobs easier. + From Akim and Karl E. + +Ideas that will not be implemented: +- Process Texinfo files directly instead of converting to Info: + ftp://ftp.cs.berkeley.edu/ucb/people/phelps/tcltk/tkman.tar.Z, which + uses Tcl/Tk 8.0 from ftp.smli.com in the /pub/tcl directory. + From: phelps@ecstasy.CS.Berkeley.EDU (Tom Phelps) + [This has the disadvantage of needing to be updated when the + Texinfo language changes, so don't.] + +- Call Ghostscript to get ASCII/jpg output for the @image command. + [makeinfo should not try to be make, or assume it knows how the user + wants to generate images. Too many different methods are possible.] + +- Change bars. This is difficult or impossible in TeX, + unfortunately. To do it right requires device driver support. + wdiff or ediff may be all we can do. Merely specifying what should be + changed is not obvious. |