"Fossies" - the Fresh Open Source Software Archive

Member "texinfo-6.5/TODO" (30 Sep 2015, 9953 Bytes) of package /linux/misc/texinfo-6.5.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 $Id: TODO 6661 2015-09-30 13:17:11Z gavin $
    2 This is the todo list for GNU Texinfo.
    3 If you are interested in working on any of these, email bug-texinfo@gnu.org.
    4 
    5   Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2003, 
    6   2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2011, 2012,
    7   2013, 2014, 2015
    8   Free Software Foundation.
    9 
   10   Copying and distribution of this file, with or without modification,
   11   are permitted in any medium without royalty provided the copyright
   12   notice and this notice are preserved.
   13 
   14 * Language:
   15   - Remove the need for @if[not]tex at the beginning of the document.
   16   - Allow : in node names for info files, for names such as
   17     `class::method'.  Likewise index entries.  A quoting mechanism such
   18     as surrounding node names with SPACE BACKSPACE is probably the best
   19     solution, although this is an incompatible change to Info format.
   20     This would also allow references without any *note and :: in text,
   21     (pace goptical, Alexandre Becoulet, 18 Jan 2011 00:31:42).
   22   - consider doing some @inline version of @set, @ifset, like 
   23     @inlineset{flag, ...}, @inlineifset{flag, if set} or @inlineifset{flag,
   24     if set, if not set} in analogy with @inlinefmt.
   25   - @xindexterm [def] primary [,secondary [,tertiary]]  or some such?
   26   - Allow subitems and `see' and `see also' in indices.
   27   - generalize @vtable/@htable to any defined index.
   28   - generalize @deffn/etc. with variants that don't make index entries.
   29   - @mergeindex to do @syn*index without changing fonts.
   30   - multicolumn * width to take up `the rest'.
   31   - Allow @hsep/@vsep at @item, instead of just in template.
   32   - another table command to take N succeeding items and split them
   33     into M columns (see eplain).
   34   - support bibliographies with BibTeX (see web2c/doc for kludge prototype).
   35   - @flushboth to combine @flushleft and @flushright, for RFC's.
   36   - @exercise/@answer command for, e.g., gawk.
   37   - Support automatic line numbering of examples.
   38   - Better def... command syntax, explicitly marking variables, etc.
   39   - Glossary/general definition support (dumas msg 28 Nov 2003 17:09:57 +0100).
   40   - Add support for other Latin 9 (and Latin 2 and Latin 1) characters.
   41 
   42 * Makeinfo:
   43   - Improve the HTML customization API.
   44   - HTML: support thumbnails.
   45   - HTML: have a library of different CSS styles.
   46     http://mail.gnu.org/archive/html/bug-texinfo/2004-01/msg00025.html
   47   - XML: cannot be loaded directly in a browser; browsers are supposed to
   48     be able to look up the DTD and do something.
   49   - add --output-encoding, to set OUTPUT_ENCODING_NAME.
   50   - Support output formats retaining the tree structure of Texinfo documents
   51     as parsed by the Parser.  A lisp-like format for GUILE? Maybe JSON?
   52   - Support LaTeX as a backend.
   53   - Support the epub output format, http://en.wikipedia.org/wiki/OEBPS.
   54     Suggested by Sean Young, 30 Nov 2008 20:13:11.
   55   - Support the MediaWiki output format.
   56 
   57 * TeX:
   58   - Index above @item allows page break.
   59   - Table of contents is misaligned if there are 10 or more [sub]sections.
   60   - @float captions should be typeset in a smaller font?
   61   - Reset the scriptfonts and scriptscriptfonts when font size changes.
   62   - Reasonable way to change fonts from the default (some work has been
   63     done), to allow for PostScript fonts, for example.
   64   - @multitable: handle @hsep and @vsep.
   65   - @multitable: repeat table headings if multiple pages long.
   66   - @multitable: support a heading line concept (<thead> in HTML).
   67   - Introduce new command to change \bindingoffset.
   68   - Use marks to define a real @thissection.
   69   - Include synctex support.
   70   - Include hyperlink \special's in the DVI output for xdvi, etc.
   71   - PDF: make each letter of the index (A, B, ...) a section in the TOC.
   72     From Carsten Dominik.
   73   - PDF: use the PageLabels dictionary to allow jumping to logical
   74     pages, presumably after xpdf/gv support it.  Section 8.3.1 of the
   75     PDF reference.  From Werner Lemberg, texinfo-pretest mail of
   76     27 Feb 2006 22:55:13 +0100.
   77   - Use @ as the escape character in index files by default,
   78     after new texindex is deployed (2020?).
   79 
   80 * Doc:
   81   - New section on doing dedication pages. See gawk.texi
   82     for an example of doing it in both the tex and info versions.
   83   - Use/distribute pod2texi generated documentation of the perl modules in 
   84     tp generated in doc/tp_api -- when api is stable.
   85   - Documentation of the HTML customization is missing.
   86 
   87 * Info:
   88   - Perhaps comply with LANGUAGE setting on a per-node basis, to allow
   89     incremental translation of Texinfo files.
   90   - Display images when running under X, as Emacs 22+ can.
   91   - Search all nodes of dir file at startup, then can have
   92     INFO-DIR-SEPARATE-GROUPS and other such.  I.e., we could have
   93     programs (what is now "Individual utilities") in one node, library
   94     functions, in another, etc.  And how about supporting other languages?
   95   - Better dir file merging.
   96   - Global dir file (as in /etc/conf/dir) and texinfo config file
   97     specifying which info directories to search.  From Dale Mellor.
   98     http://mail.gnu.org/mailman/private/gnu-prog-discuss/2003q4/000439.html
   99   - More sample .infokey files, so people can choose without writing their own.
  100   - Incorporate an X-based viewer, perhaps the old GNU xinfo widget
  101      (http://www.gnu.org/software/xinfo) or saxinfo
  102      or tkinfo (http://www.math.ucsb.edu/~boldt/tkinfo/).
  103   - Handle M-n, C-u m, and C-u g like Emacs Info (opening new windows).
  104   - A running view mode, to display the next node after the end of the
  105     last one, and be able to toggle display of a node's subnodes.  
  106     (Could be hard to implement though, because of how much code assumes 
  107     that only one node is in a window at once.)
  108 
  109 
  110 * install-info:
  111   - install-info --dir-file=dir2 --entry=info foo.info installs garbage
  112     from the misformatted --entry (and no entries from foo.info).
  113   - be able to copy the info file to compile-time $infodir, to
  114     simplify by-hand installation.
  115   - also support installing HTML files, etc., along with subsidiary
  116     @image (or other) files.  In subdirs.  Or something.
  117   - support info dir entries for other than the current info file name;
  118     see comments in menu_item_equal.
  119   - Monitor and improve the dir categories in existing manuals,
  120     following the Free Software Directory categories.  Much mail to
  121     developers has already been sent, what's needed now is to check new
  122     releases and make sure they are using the right categories.
  123     See the util/dir-example in the Texinfo distribution for our current
  124     recommended categories.
  125     For background, see the thread (which discusses a lot of other
  126     issues too) at
  127     http://lists.gnu.org/archive/html/emacs-devel/2002-10/msg00011.html
  128     especially 
  129       http://lists.gnu.org/archive/html/emacs-devel/2002-10/msg00090.html
  130       http://lists.gnu.org/archive/html/emacs-devel/2002-10/msg00137.html
  131 
  132 * texindex:
  133   - read source file (specified by new option) for @documentlanguage
  134     and/or @documentencoding, and change the sorting appropriately.
  135   From: Wojciech Polak, 26 Apr 2003 11:30:59 +0200.
  136 
  137 * Distribution:
  138   - generate txi-??.tex from .po's to make translators' jobs easier.
  139     From Akim and Karl E.
  140 
  141 ***********************************************************************
  142 
  143 * Ideas that will not be implemented:
  144 
  145 - Support general reference card creation.
  146   [Reference cards are too different from normal Texinfo.]
  147 
  148 - Support installation of manuals in different languages, along these lines:
  149   . support a LINGUAS file or variable saying which subdirs LL in the
  150     source to descend into (under doc/).
  151   . within each subdir LL, install the info files into $infodir/LL,
  152     and run install-info on $infodir/LL/dir.
  153   . info (both emacs and standalone) should read $infodir/$LANG/dir
  154     as the first dir file, and likewise read info files first from
  155     $infodir/$LANG, before falling back to $infodir.
  156   . consider ways to avoid installing images in both places.
  157     In fact, images probably need to be installed in a subdir
  158     $infodir/MANUAL/ in the first place, to avoid conflicts of having
  159     the same image name in different manuals.
  160   For a test case, see texinfo cvs, with its one translated manual
  161   (info-fr.texi).
  162   From Wojciech Polak.
  163   ... Except, in practice, people just name their manuals with a
  164   suffix for the language, and that seems to work well enough.  There
  165   aren't that many manuals even in English, let alone other languages,
  166   and there are almost no manuals in multiple languages.
  167 
  168 - Process Texinfo files directly instead of converting to Info:
  169   ftp://ftp.cs.berkeley.edu/ucb/people/phelps/tcltk/tkman.tar.Z, which
  170   uses Tcl/Tk 8.0 from ftp.smli.com in the /pub/tcl directory.
  171   From: Tom Phelps @ berkeley
  172   [This has the disadvantage of needing to be updated when the
  173   Texinfo language changes, so don't.]
  174 
  175 - Call Ghostscript to get ASCII/jpg output for the @image command.
  176   [makeinfo should not try to be make, or assume it knows how the user
  177    wants to generate images.  Too many different methods are possible.]
  178 
  179 - Get Info declared as a MIME Content-Type, and
  180   an `info:' URI scheme; a library consortium has proposed a
  181   completely different purpose for the URI scheme, but I don't know
  182   how to send comments, despite it being a "request for comments".  Sigh.
  183   There is mail about this in the bug-texinfo archives:
  184     http://mail.gnu.org/archive/html/bug-texinfo/2003-09/msg00086.html
  185   [I suppose it is too late, and it doesn't seem to matter in practice.]
  186 
  187 - Change bars.  This is difficult or impossible in TeX,
  188   unfortunately.  To do it right requires device driver support.
  189   wdiff or ediff may be all we can do.  Merely specifying what should be
  190   changed is not obvious.  texdiff (http://www.robmar.net/TexDiff) does
  191   something reasonable for LaTeX, maybe it can be adapted.
  192 
  193 - @else for the @if... conditionals.  Using (for example) an @iftex block
  194   followed by an @ifnottex block is good enough.