summaryrefslogtreecommitdiff
path: root/elpa/auctex-13.1.3/doc/todo.texi
diff options
context:
space:
mode:
Diffstat (limited to 'elpa/auctex-13.1.3/doc/todo.texi')
-rw-r--r--elpa/auctex-13.1.3/doc/todo.texi311
1 files changed, 311 insertions, 0 deletions
diff --git a/elpa/auctex-13.1.3/doc/todo.texi b/elpa/auctex-13.1.3/doc/todo.texi
new file mode 100644
index 0000000..218231d
--- /dev/null
+++ b/elpa/auctex-13.1.3/doc/todo.texi
@@ -0,0 +1,311 @@
+@c This is part of the AUCTeX Manual.
+@c Copyright (C) 2004-2006, 2008, 2009, 2013-2015,
+@c 2020-2022 Free Software Foundation, Inc.
+@c See the file auctex.texi for copying conditions.
+@ifset rawfile
+@include macros.texi
+@node Development,,(dir),(dir)
+@top Future Development of @AUCTeX{}
+@end ifset
+
+The following sections describe future development of @AUCTeX{}.
+Besides mid-term goals, bug reports and requests we cannot fix or honor
+right away are being gathered here. If you have some time for Emacs
+Lisp hacking, you are encouraged to try to provide a solution to one of
+the following problems. If you don't know Lisp, you may help us to
+improve the documentation. It might be a good idea to discuss proposed
+changes on the mailing list of @AUCTeX{} first.
+
+@menu
+* Mid-term Goals::
+* Wishlist::
+* Bugs::
+@end menu
+
+@ifset rawfile
+@node Mid-term Goals
+@chapter Mid-term Goals
+@raisesections
+@end ifset
+
+@ifclear rawfile
+@node Mid-term Goals
+@section Mid-term Goals
+@end ifclear
+
+@itemize @bullet
+@item Integration of @previewlatex{} into @AUCTeX{}
+
+As of @AUCTeX{} 11.81 @previewlatex{} is a part of @AUCTeX{} in the
+sense that the installation routines were merged and @previewlatex{} is
+being packaged with @AUCTeX{}.
+
+Further integration will happen at the backend. This involves folding
+of error parsing and task management of both packages which will ease
+development efforts and avoid redundant work.
+
+@item Error help catalogs
+
+Currently, the help for errors is more or less hardwired into
+@file{latex.el}. For supporting error help in other languages, it would
+be sensible to instead arrange error messages in language-specific
+files, make a common info file from all such catalogs in a given
+language and look the error texts up in an appropriate index. The user
+would then specify a preference list of languages, and the errors would
+be looked up in the catalogs in sequence until they were identified.
+
+@item Combining @samp{docTeX} with Ref@TeX{}
+
+Macro cross references should also be usable for document navigation
+using Ref@TeX{}.
+
+@item Fix remove-style feature
+
+Currently @code{TeX-remove-style} implementation isn't good. It is common
+practice that major mode functions directly add macros and environments
+via @code{TeX-add-symbols} and @code{LaTeX-add-environments}, but those
+macros and environments are lost once @code{TeX-remove-style} runs. It is
+necessary to run major mode function, by e.g.@: @code{normal-mode}, again
+to recover them, but that makes no point in running
+@code{TeX-remove-style} itself because major mode function kills all
+buffer-local variables.
+
+As of @AUCTeX{} 12.3, @code{TeX-remove-style} is no longer used by any
+other codes.
+
+@item
+Document @code{LaTeX-insert-into-commments},
+@code{TeX-translate-location-hook}, and usage of @ConTeXt{} mode.
+@end itemize
+
+@node Wishlist
+@section Wishlist
+
+@itemize @bullet
+@item
+Simplify tool bar implementation. The library @file{toolbar-x.el} was
+developed as an abstraction layer to absorb difference between XEmacs
+and @acronym{GNU} Emacs. Now that XEmacs is no longer supported, the
+library, together with @file{tex-bar.el} as a whole, can be much
+simplified (or even unified).
+
+@item Documentation lookup for macros
+
+A parser could gather information about which macros are defined in
+which @LaTeX{} packages and store the information in a hashtable which
+can be used in a backend for @code{TeX-doc} in order to open the
+matching documentation for a given macro. The information could also be
+used to insert an appropriate @samp{\usepackage} statement if the user
+tries to insert a macro for which the respective package has not been
+requested yet.
+
+@item Improvements to error reporting
+
+Fringe indicators for errors in the main text would be nice.
+
+@item A math entry grid
+
+A separate frame with a table of math character graphics to click on in
+order to insert the respective sequence into the buffer (cf. the
+``grid'' of @samp{x-symbol}).
+
+@item Crossreferencing support
+
+It would be nice if you could index process your favorite collection of
+@file{.dtx} files (such as the @LaTeX{} source), just call a command on
+arbitrary control sequence, and get either the @acronym{DVI} viewer opened right
+at the definition of that macro (using Source Specials), or the source
+code of the @file{.dtx} file.
+
+@item Better plain @TeX{} support
+
+For starters, @code{LaTeX-math-mode} is not very @LaTeX{}-specific in
+the first place, and similar holds for indentation and formatting.
+
+@item
+Page count when compiling should (optionally) go to modeline of the
+window where the compilation command was invoked, instead of the output
+window. Suggested by Karsten Tinnefeld
+@email{tinnefeld@@irb.informatik.uni-dortmund.de}.
+
+@item
+Command to insert a macrodefinition in the preamble, without moving
+point from the current location. Suggested by
+"Jeffrey C. Ely" @email{ely@@nwu.edu}.
+
+@item
+A database of all commands defined in all stylefiles. When a command or
+environment gets entered that is provided in one of the styles, insert
+the appropriate @code{\usepackage} in the preamble.
+
+@item
+A way to add and overwrite math mode entries in style files, and to
+decide where they should be. Suggested by Remo Badii @email{Remo.Badii@@psi.ch}.
+
+@item
+Create template for (first) line of tabular environment.
+
+@item
+@c FIXME: Already fixed?
+I think prompting for the master is the intended behaviour. It
+corresponds to a `shared' value for @code{TeX-master}.
+
+There should probably be a `none' value which wouldn't query for the
+master, but instead disable all features that relies on @code{TeX-master}.
+
+This default value for @code{TeX-master} could then be controled with mapping
+based on the extension.
+
+@item
+Use index files (when available) to speed up @kbd{C-c C-m include
+@key{RET}}.
+
+@item
+Option not to calculate very slow completions like for
+@kbd{C-c C-m include @key{RET}}.
+
+@item
+Font menu should be created from @code{TeX-font-list}.
+
+@item
+Installation procedure written purely in emacs lisp.
+
+@item
+Included PostScript files should also be counted as part of the
+document.
+
+@item
+A nice hierarchical by-topic organization of all officially documented
+@LaTeX{} macros, available from the menu bar.
+
+@item
+@code{TeX-command-default} should be set from the master file, if not
+set locally. Suggested by Peter Whaite @email{peta@@cim.mcgill.ca}.
+
+@item
+Make @AUCTeX{} work with @samp{crypt++}. Suggested by Chris Moore
+@email{Chris.Moore@@src.bae.co.uk}.
+
+@item
+Make @AUCTeX{} work with @samp{longlines}. This would also apply to
+@previewlatex{}, though it might make sense to unify error processing
+before attempting this.
+
+@item
+@c FIXME: Already achieved?
+The @samp{Spell} command should apply to all files in a document. Maybe
+it could try to restrict to files that have been modified since last
+spell check? Suggested by Ravinder Bhumbla @email{rbhumbla@@ucsd.edu}.
+
+@item
+Make @key{.} check for abbreviations and sentences ending with capital
+letters.
+
+@item
+Use Emacs 19 minibuffer history to choose between previewers, and other
+stuff. Suggested by John Interrante
+@email{interran@@uluru.Stanford.EDU}.
+
+@item
+Documentation of variables that can be set in a style hook.
+
+We need a list of what can safely be done in an ordinary style hook.
+You can not set a variable that @AUCTeX{} depends on, unless @AUCTeX{}
+knows that it has to run the style hooks first.
+
+Here is the start of such a list.
+@table @code
+
+@item LaTeX-add-environments
+
+@item TeX-add-symbols
+
+@item LaTeX-add-labels
+
+@item LaTeX-add-bibliographies
+
+@item LaTeX-largest-level
+
+@end table
+
+@item
+Outline should be (better) supported in @TeX{} mode.
+
+At least, support headers, trailers, as well as @code{TeX-outline-extra}.
+
+@item
+@code{TeX-header-start} and @code{TeX-trailer-end}.
+
+We might want these, just for fun (and outlines)
+
+@item
+Plain @TeX{} and @LaTeX{} specific header and trailer expressions.
+
+We should have a way to globally specify the default value of the header
+and trailer regexps.
+
+@item
+Get closer to original @code{TeX-mode} keybindings.
+
+A third initialization file (@file{tex-mode.el}) containing an emulator
+of the standard @code{TeX-mode} would help convince some people to
+change to @AUCTeX{}.
+
+@item
+Use markers in @code{TeX-error-list} to remember buffer positions in
+order to be more robust with regard to line numbers and changed files.
+
+@item
+Finish the Texinfo mode. For one thing, many Texinfo mode commands do
+not accept braces around their arguments.
+
+@item
+Hook up the letter environment with @file{bbdb.el}.
+
+@end itemize
+
+@node Bugs
+@section Bugs
+
+@c FIXME: Are those bugs still present?
+
+@itemize @bullet
+@item
+The style hooks automatically generated by parsing files for
+@file{example.dtx}, @file{example.sty}, @file{example.drv} and
+@file{example.bib} all clash. Bad. Clash with hand-written style hooks
+should be removed by dialect discrimination --- to be checked.
+
+@item
+@kbd{C-c `} should always stay in the current window, also when it finds
+a new file.
+
+@item
+Do not overwrite emacs warnings about existing auto-save files when
+loading a new file.
+
+@item
+Maybe the regexp for matching a @TeX{} symbol during parsing should be
+@samp{"\\\\\\([a-zA-Z]+\\|.\\)"} ---
+@email{thiemann@@informatik.uni-tuebingen.de} Peter Thiemann.
+
+@item
+@AUCTeX{} should not parse verbatim environments.
+
+@item
+Make @samp{`} check for math context in @code{LaTeX-math-mode}. and
+simply self insert if not in a math context.
+
+@item
+Make @code{TeX-insert-dollar} more robust. Currently it can be fooled
+by @samp{\mbox}'es and escaped double dollar for example.
+
+@item
+@c FIXME: Is support for table environment really necessary?
+Correct indentation for tabbing, table, and math environments.
+@end itemize
+
+@c Local Variables:
+@c mode: texinfo
+@c TeX-master: "auctex"
+@c End: