diff options
Diffstat (limited to 'TODO')
-rw-r--r-- | TODO | 212 |
1 files changed, 212 insertions, 0 deletions
@@ -0,0 +1,212 @@ +$Id: TODO,v 1.45 2008/07/26 17:13:26 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, 2005, 2006, 2007, 2008 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: + - 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. + - Or even multibyte languages like Japanese, see msg: + http://lists.gnu.org/archive/html/bug-texinfo/2005-03/msg00000.html + - 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 + - Extend and improve the tests. + - 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. + +* 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, including a separate @inlinemacro (or + something) to distinguish macros that swallow their final newline + and those that don't. + - 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. + - Really support UTF-8 instead of just passing through the bytes. + - lang.c setup doesn't support @v{S} (S with caron) -- no named entity. + - Automatically do -I of 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. + Even different splits for different chapters. + 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? + - Support the MediaWiki output format. + - 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. + - Support input in any encoding and language, via ec or Latin Modern fonts. + Including Unicode, e.g., UTF-8. (Some work has been done.) + - 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. + - Use marks to define a real @thissection. + - Table of contents is misaligned if there are 10 or more [sub]sections. + - Use url.sty (or something) to allow linebreak of url's. + - Make accent commands implicitly use @dotless{i/j}. + - 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. + - PDF: use the PageLabels dictionary to allow jumping to logical + pages, presumably after xpdf/gv support it. Section 8.3.1 of the + PDF reference. From Werner Lemberg, texinfo-pretest mail of + 27 Feb 2006 22:55:13 +0100. + +* 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: + - (By far the most important bug to fix.) + Support multibyte character sets, principally UTF-8; most + critically, do not break multibyte characters across lines, but lots + of other problems are present. This implies major changes to Info, + since it currently assumes byte/character equivalence (having been + written long before multibyte character sets were common). + + Here's a careful bug report on the subject (the sender can help test): + http://lists.gnu.org/archive/html/bug-texinfo/2007-11/msg00033.html + + Here's an initial bug report and "patch" that simply disables translation. + http://lists.gnu.org/archive/html/bug-texinfo/2006-08/msg00001.html + http://wiki.linuxfromscratch.org/patches/browser/trunk/texinfo/texinfo-4.8-multibyte-1.patch + + - The help message does not report Down/Up for next/prev-line. + - When scrolling through the help text, it should stop at the end, not + report "No more nodes" and go back to the beginning. + - It would be nice for h in the help window to quit help. + - It would be nice to be able to specify a preferred key to report in + the help message, instead of using the last one set; cf. q vs. C-x C-c. + - Full-text search across all info files installed on the system. + - Perhaps comply with LANGUAGE setting on a per-node basis, to allow + incremental translation of Texinfo files. + - Display images when running under X, as Emacs 22+ can. + - Search all nodes of dir file at startup, then can have + INFO-DIR-SEPARATE-GROUPS and other such. I.e., we could have + programs (what is now "Individual utilities") in one node, library + functions, in another, etc. And how about supporting other languages? + - 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. + - Incorporate an X-based viewer, perhaps the old GNU xinfo widget + (http://www.gnu.org/software/xinfo) or 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. + +* 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: Tom Phelps @ berkeley + [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. texdiff (http://www.robmar.net/TexDiff) does + something reasonable for LaTeX, maybe it can be adapted. |