diff options
Diffstat (limited to 'contrib/texinfo/TODO')
| -rw-r--r-- | contrib/texinfo/TODO | 135 |
1 files changed, 92 insertions, 43 deletions
diff --git a/contrib/texinfo/TODO b/contrib/texinfo/TODO index e350c1b..0fcaa5c 100644 --- a/contrib/texinfo/TODO +++ b/contrib/texinfo/TODO @@ -1,84 +1,119 @@ -$Id: TODO,v 1.8 2003/04/27 13:12:24 karl Exp $ +$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, - 2001, 2002, 2003 Free Software Foundation. + 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: - - Test for memory leaks, e.g., with valgrind: - http://developer.kde.org/~sewardj/ - - Rationalize and improve the dir categories in existing manuals. - See http://mail.gnu.org/pipermail/emacs-devel/2002-October/013094.html - (and the containing thread). - - Extend and improve the tests. + - @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. - - Handle reference card creation, perhaps by only paying attention to + - 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: - - @figure, something like: -@figure [xref-label] -@figureinclude <filename>, [<height>], [<width>] -@figurehsize <dimen> -@figurevsize <dimen> -@caption ... @end caption -<arbitrary Texinfo commands> -@end figure - @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. - - Allow subitems and `see' and `see also' in indices. - @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. - - 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. - - @LaTeX{} command to produce the LaTeX logo. + - 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. - - Support @`{@dotless{i}} et al. in HTML. + - 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. - - Call Ghostscript to get ASCII/jpg output for the @image command. - - Better HTML output: allow settable background color, table colors - and spacing, <head> meta tags, back link from footnote marker, etc. + - 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, aux, and index files. Eliminate all the crazy + table of contents and index files. Eliminate all the crazy multiple redefinitions of every Texinfo command in different contexts. - - Handle @hsep and @vsep in @multitables. - - Introduce new command to change \bindingoffset. + - 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? - - Support 8-bit input characters, perhaps via the ec fonts. - - Repeat table headings if a @multitable is multiple pages long. - 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 @@ -96,29 +131,37 @@ If you are interested in working on any of these, email bug-texinfo@gnu.org. - 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 tkinfo + - Incorporate an X-based viewer, perhaps saxinfo or tkinfo http://www.math.ucsb.edu/~boldt/tkinfo/ - or saxinfo. + - 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. -* PDF: - - make each letter of the index (A, B, ...) a section in the TOC. - From Carsten Dominik <dominik@astro.uva.nl>. - * install-info: - - be able to copy the info file to compile-time $(infodir), to + - 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 <polak@gnu.org>, 26 Apr 2003 11:30:59 +0200. + 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: @@ -128,5 +171,11 @@ Ideas that will not be implemented: [This has the disadvantage of needing to be updated when the Texinfo language changes, so don't.] -- Split HTML output by chapter. - [Then cross-references in HTML cannot be generated consistently.] +- 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. |
