comparison etc/NEWS @ 62354:a3caa4bbb562

Many cleanups.

62353:0db5e423dce7

** The TCL package tcl-mode.el was replaced by tcl.el.
This was actually done in Emacs-21.1, and was not documented.

* Changes in Specialized Modes and Packages in Emacs 22.1:

** Makefile mode has now been split up into specialized modes for automake,
gmake, makepp and BSD make.  The former two couldn't be differentiated before,
and the latter two are new.  Font-locking is robust now and offers new
customizable faces.

+++
** In Outline mode, hide-body no longer hides lines at the top
of the file that precede the first header line.

+++
** Telnet now prompts you for a port number with C-u M-x telnet.

---
** The terminal emulation code in term.el has been improved, it can
run most curses applications now.

+++
** M-x diff uses diff-mode instead of compilation-mode.

+++
** You can now customize fill-nobreak-predicate to control where
filling can break lines.  The value is now normally a list of
functions, but it can also be a single function, for compatibility.

We provide two sample predicates, fill-single-word-nobreak-p and
fill-french-nobreak-p, for use in the value of fill-nobreak-predicate.

---
** M-x view-file and commands that use it now avoid interfering
with special modes such as Tar mode.

---
** Commands winner-redo and winner-undo, from winner.el, are now bound to
C-c <left> and C-c <right>, respectively.  This is an incompatible change.

---
** global-whitespace-mode is a new alias for whitespace-global-mode.

+++
** M-x compare-windows now can automatically skip non-matching text to
resync points in both windows.

+++
** New user option `add-log-always-start-new-record'.
When this option is enabled, M-x add-change-log-entry always
starts a new record regardless of when the last record is.

---
** PO translation files are decoded according to their MIME headers

** Info mode changes:

+++
*** A numeric prefix argument of `info' selects an Info buffer
with the number appended to the *info* buffer name (e.g. "*info*<2>").

---
*** isearch in Info uses Info-search and searches through multiple nodes.
Before leaving the initial Info node isearch fails once with the error
message [initial node], and with subsequent C-s/C-r continues through
other nodes.  When isearch fails for the rest of the manual, it wraps
aroung the whole manual to the top/final node.  The user option
`Info-isearch-search' controls whether to use Info-search for isearch,

*** http and ftp links in Info are now operational: they look like cross
references and following them calls `browse-url'.

+++
*** Info now hides node names in menus and cross references by default.
If you prefer the old behavior, you can set the new user option
`Info-hide-note-references' to nil.

---
*** Images in Info pages are supported.
Info pages show embedded images, in Emacs frames with image support.
Info documentation that includes images, processed with makeinfo
version 4.7 or newer, compiles to Info pages with embedded images.

+++
*** The default value for `Info-scroll-prefer-subnodes' is now nil.

---
*** Info-index offers completion.

** Lisp mode changes:

---
*** Lisp mode now uses font-lock-doc-face for the docstrings.

+++
*** A prefix argument of C-M-q in Emacs Lisp mode pretty-printifies the
list starting after point.

*** New features in evaluation commands

+++
*** The function `eval-defun' (C-M-x) called on defface reinitializes
the face to the value specified in the defface expression.

+++
*** Typing C-x C-e twice prints the value of the integer result
in additional formats (octal, hexadecimal, character) specified
by the new function `eval-expression-print-format'.  The same
function also defines the result format for `eval-expression' (M-:),
`eval-print-last-sexp' (C-j) and some edebug evaluation functions.

now handled like "namespace" in C++: They are given syntactic symbols
module-open, module-close, inmodule, composition-open,
composition-close, and incomposition.

*** New functions to do hungry delete without enabling hungry delete mode.
The functions c-hungry-backspace and c-hungry-delete-forward can be
bound to keys to get this feature without toggling a mode.
Contributed by Kevin Ryde.

*** Better control over require-final-newline.  The variable that
controls how to handle a final newline when the buffer is saved,
require-final-newline, is now customizable on a per-mode basis through
c-require-final-newline.  That is a list of modes, and only those
modes set require-final-newline.  By default that's C, C++ and
Objective-C.

The specified modes set require-final-newline based on
mode-require-final-newline, as usual.

*** Format change for syntactic context elements.
The elements in the syntactic context returned by c-guess-basic-syntax
and stored in c-syntactic-context has been changed somewhat to allow
attaching more information.  They are now lists instead of single cons
cells.  E.g. a line that previously had the syntactic analysis

((inclass . 11) (topmost-intro . 13))

((inclass 11) (topmost-intro 13))

In some cases there are more than one position given for a syntactic
symbol.

This change might affect code that call c-guess-basic-syntax directly,
and custom lineup functions if they use c-syntactic-context.  However,
the argument given to lineup functions is still a single cons cell
with nil or an integer in the cdr.

*** API changes for derived modes.
There have been extensive changes "under the hood" which can affect
derived mode writers.  Some of these changes are likely to cause
incompatibilities with existing derived modes, but on the other hand
care has now been taken to make it possible to extend and modify CC
Mode with less risk of such problems in the future.

**** New language variable system.
See the comment blurb near the top of cc-langs.el.

**** New initialization functions.
The initialization procedure has been split up into more functions to
give better control: c-basic-common-init, c-font-lock-init, and
c-init-language-vars.

*** Changes in analysis of nested syntactic constructs.
The syntactic analysis engine has better handling of cases where
several syntactic constructs appear nested on the same line.  They are
now handled as if each construct started on a line of its own.

*** Better handling of multiline macros.

**** Syntactic indentation inside macros.
The contents of multiline #define's are now analyzed and indented
syntactically just like other code.  This can be disabled by the new
variable c-syntactic-indentation-in-macros.  A new syntactic symbol
cpp-define-intro has been added to control the initial indentation
inside #define's.

**** New lineup function c-lineup-cpp-define.
Now used by default to line up macro continuation lines.  The behavior
of this function closely mimics the indentation one gets if the macro
is indented while the line continuation backslashes are temporarily
removed.  If syntactic indentation in macros is turned off, it works
much line c-lineup-dont-change, which was used earlier, but handles
empty lines within the macro better.

**** Automatically inserted newlines continues the macro if used within one.
This applies to the newlines inserted by the auto-newline mode, and to
c-context-line-break and c-context-open-line.

**** Better alignment of line continuation backslashes.
c-backslash-region tries to adapt to surrounding backslashes.  New
variable c-backslash-max-column which put a limit on how far out
backslashes can be moved.

**** Automatic alignment of line continuation backslashes.
This is controlled by the new variable c-auto-align-backslashes.  It
affects c-context-line-break, c-context-open-line and newlines
inserted in auto-newline mode.

**** Line indentation works better inside macros.
Regardless whether syntactic indentation and syntactic indentation
inside macros are enabled or not, line indentation now ignores the
line continuation backslashes.  This is most noticeable when syntactic
indentation is turned off and there are empty lines (save for the
backslash) in the macro.

*** indent-for-comment is more customizable.
The behavior of M-; (indent-for-comment) is now configurable through
the variable c-indent-comment-alist.  The indentation behavior based
on the preceding code on the line, e.g. to get two spaces after #else
and #endif but indentation to comment-column in most other cases
(something which was hardcoded earlier).

*** New function c-context-open-line.
It's the open-line equivalent of c-context-line-break.

*** New lineup functions

**** c-lineup-string-cont
This lineup function lines up a continued string under the one it
continues.  E.g:

result = prefix + "A message "
                  "string.";      <- c-lineup-string-cont

**** c-lineup-cascaded-calls
Lines up series of calls separated by "->" or ".".

**** c-lineup-knr-region-comment
Gives (what most people think is) better indentation of comments in
the "K&R region" between the function header and its body.

**** c-lineup-gcc-asm-reg
Provides better indentation inside asm blocks.  Contributed by Kevin
Ryde.

**** c-lineup-argcont
Lines up continued function arguments after the preceding comma.
Contributed by Kevin Ryde.

*** Better caching of the syntactic context.
CC Mode caches the positions of the opening parentheses (of any kind)
of the lists surrounding the point.  Those positions are used in many
places as anchor points for various searches.  The cache is now

*** Statements are recognized in a more robust way.
Statements are recognized most of the time even when they occur in an
"invalid" context, e.g. in a function argument.  In practice that can
happen when macros are involved.

*** Improved the way c-indent-exp chooses the block to indent.
It now indents the block for the closest sexp following the point
whose closing paren ends on a different line.  This means that the
point doesn't have to be immediately before the block to indent.
Also, only the block and the closing line is indented; the current
line is left untouched.

*** Added toggle for syntactic indentation.
The function c-toggle-syntactic-indentation can be used to toggle
syntactic indentation.

---
** Perl mode has a new variable `perl-indent-continued-arguments'.

`f90-end-of-block', `f90-beginning-of-block', `f90-next-block',
`f90-previous-block', `fortran-end-of-block',
`fortran-beginning-of-block'.

---
*** F90 mode and Fortran mode have support for hs-minor-mode (hideshow).
It cannot deal with every code format, but ought to handle a sizeable
majority.

---
*** The new function `f90-backslash-not-special' can be used to change

---
*** verbatim environments are now highlighted in courier by font-lock
and super/sub-scripts are made into super/sub-scripts.

+++
*** New major mode doctex-mode for *.dtx files.

** BibTeX mode:
*** The new command bibtex-url browses a URL for the BibTeX entry at
point (bound to C-c C-l and mouse-2, RET on clickable fields).

*** The new command bibtex-entry-update (bound to C-c C-u) updates
an existing BibTeX entry.

*** New `bibtex-entry-format' option `required-fields', enabled by default.

*** bibtex-maintain-sorted-entries can take values `plain',
`crossref', and `entry-class' which control the sorting scheme used
for BibTeX entries.  `bibtex-sort-entry-class' controls the sorting
scheme `entry-class'.  TAB completion for reference keys and
automatic detection of duplicates does not require anymore that
bibtex-maintain-sorted-entries is non-nil.

*** If the new variable bibtex-parse-keys-fast is non-nil,
use fast but simplified algorithm for parsing BibTeX keys.

*** If the new variable bibtex-autoadd-commas is non-nil,
automatically add missing commas at end of BibTeX fields.

*** The new variable bibtex-autofill-types contains a list of entry
types for which fields are filled automatically (if possible).

*** The new command bibtex-complete completes word fragment before
point according to context (bound to M-tab).

*** The new commands bibtex-find-entry and bibtex-find-crossref
locate entries and crossref'd entries (bound to C-c C-s and C-c C-x).
Crossref fields are clickable (bound to mouse-2, RET).

*** In BibTeX mode the command fill-paragraph (bound to M-q) fills
individual fields of a BibTeX entry.

*** The new variables bibtex-files and bibtex-file-path define a set
of BibTeX files that are searched for entry keys.

*** The new command bibtex-validate-globally checks for duplicate keys
in multiple BibTeX files.

*** The new command bibtex-copy-summary-as-kill pushes summary
of BibTeX entry to kill ring (bound to C-c C-t).

+++
** In Enriched mode, `set-left-margin' and `set-right-margin' are now
by default bound to `C-c [' and `C-c ]' instead of the former `C-c C-l'

Emacs 21 such as the display margin for breakpoints, and the toolbar.

Use M-x gdba to start GDB-UI.

*** GUD tooltips can be toggled independently of normal tooltips
with the minor mode, gud-tooltip-mode.

+++
*** In graphical mode, with a C program, GUD Tooltips have been extended to
display the #define directive associated with an identifier when program is
not executing.

*** Supports new jdb (Java 1.2 and later) in addition to oldjdb
    (Java 1.1 jdb).

*** The previous method of searching for source files has been
    preserved in case someone still wants/needs to use it.
    Set gud-jdb-use-classpath to nil.

  Added Customization Variables

*** gud-jdb-command-name.  What command line to use to invoke jdb.

*** gud-jdb-use-classpath. Allows selection of java source file searching
    method: set to t for new method, nil to scan gud-jdb-directories for
    java sources (previous method).

*** gud-jdb-directories. List of directories to scan and search for java
    classes using the original gud-jdb method (if gud-jdb-use-classpath
    is nil).

  Minor Improvements

*** The STARTTLS wrapper (starttls.el) can now use GNUTLS
instead of the OpenSSL based "starttls" tool.  For backwards
compatibility, it prefers "starttls", but you can toggle
`starttls-use-gnutls' to switch to GNUTLS (or simply remove the
"starttls" tool).

*** Do not allow debugger output history variable to grow without bounds.

** Auto-Revert changes:

+++
*** You can now use Auto Revert mode to `tail' a file.
If point is at the end of a file buffer before reverting, Auto Revert
mode keeps it at the end after reverting.  Similarly if point is
displayed at the end of a file buffer in any window, it stays at
the end of the buffer in that window.  This allows to tail a file:
just put point at the end of the buffer and it stays there.  This

+++
** Desktop package

+++
*** Desktop saving is now a minor mode, desktop-save-mode. Variable
desktop-enable is obsolete. Customize desktop-save-mode to enable desktop
saving.

---
*** Buffers are saved in the desktop file in the same order as that in the
buffer list.

+++
*** The desktop package can be customized to restore only some buffers immediately,
remaining buffers are restored lazily (when Emacs is idle).

+++
*** New commands:
  - desktop-revert reverts to the last loaded desktop.
  - desktop-change-dir kills current desktop and loads a new.

62354:a3caa4bbb562

** The TCL package tcl-mode.el was replaced by tcl.el.
This was actually done in Emacs-21.1, and was not documented.

* Changes in Specialized Modes and Packages in Emacs 22.1:

** Makefile mode has submodes for automake, gmake, makepp and BSD make.

The former two couldn't be differentiated before, and the latter two
are new.  Font-locking is robust now and offers new customizable
faces.

+++
** In Outline mode, `hide-body' no longer hides lines at the top
of the file that precede the first header line.

+++
** Telnet now prompts you for a port number with C-u M-x telnet.

---
** The terminal emulation code in term.el has been improved; it can
run most curses applications now.

+++
** M-x diff uses Diff mode instead of Compilation mode.

+++
** You can now customize `fill-nobreak-predicate' to control where
filling can break lines.  The value is now normally a list of
functions, but it can also be a single function, for compatibility.

Emacs provide two predicates, `fill-single-word-nobreak-p' and
`fill-french-nobreak-p', for use as the value of
`fill-nobreak-predicate'.

---
** M-x view-file and commands that use it now avoid interfering
with special modes such as Tar mode.

---
** Commands `winner-redo' and `winner-undo', from winner.el, are now
bound to C-c <left> and C-c <right>, respectively.  This is an
incompatible change.

---
** `global-whitespace-mode' is a new alias for `whitespace-global-mode'.

+++
** M-x compare-windows now can automatically skip non-matching text to
resync points in both windows.

+++
** New user option `add-log-always-start-new-record'.

When this option is enabled, M-x add-change-log-entry always
starts a new record regardless of when the last record is.

---
** PO translation files are decoded according to their MIME headers

** Info mode changes:

+++
*** A numeric prefix argument of `info' selects an Info buffer
with the number appended to the `*info*' buffer name (e.g. "*info*<2>").

---
*** isearch in Info uses Info-search and searches through multiple nodes.

Before leaving the initial Info node isearch fails once with the error
message [initial node], and with subsequent C-s/C-r continues through
other nodes.  When isearch fails for the rest of the manual, it wraps
aroung the whole manual to the top/final node.  The user option
`Info-isearch-search' controls whether to use Info-search for isearch,

*** http and ftp links in Info are now operational: they look like cross
references and following them calls `browse-url'.

+++
*** Info now hides node names in menus and cross references by default.

If you prefer the old behavior, you can set the new user option
`Info-hide-note-references' to nil.

---
*** Images in Info pages are supported.

Info pages show embedded images, in Emacs frames with image support.
Info documentation that includes images, processed with makeinfo
version 4.7 or newer, compiles to Info pages with embedded images.

+++
*** The default value for `Info-scroll-prefer-subnodes' is now nil.

---
*** `Info-index' offers completion.

** Lisp mode changes:

---
*** Lisp mode now uses `font-lock-doc-face' for doc strings.

+++
*** C-u C-M-q in Emacs Lisp mode pretty-prints the list after point.

*** New features in evaluation commands

+++
**** The function `eval-defun' (C-M-x) called on defface reinitializes
the face to the value specified in the defface expression.

+++
**** Typing C-x C-e twice prints the value of the integer result
in additional formats (octal, hexadecimal, character) specified
by the new function `eval-expression-print-format'.  The same
function also defines the result format for `eval-expression' (M-:),
`eval-print-last-sexp' (C-j) and some edebug evaluation functions.

now handled like "namespace" in C++: They are given syntactic symbols
module-open, module-close, inmodule, composition-open,
composition-close, and incomposition.

*** New functions to do hungry delete without enabling hungry delete mode.
The functions `c-hungry-backspace' and `c-hungry-delete-forward' can be
bound to keys to get this feature without toggling a mode.

*** Better control over `require-final-newline'.

The variable `c-require-final-newline' specifies which of the modes
implemented by CC mode should insert final newlines.  Its value is a
list of modes, and only those modes should do it.  By default the list
includes C, C++ and Objective-C modes.

Whichever modes are in this list will set `require-final-newline'
based on `mode-require-final-newline'.

*** Format change for syntactic context elements.

The elements in the syntactic context returned by `c-guess-basic-syntax'
and stored in `c-syntactic-context' has been changed somewhat to allow
attaching more information.  They are now lists instead of single cons
cells.  E.g. a line that previously had the syntactic analysis

((inclass . 11) (topmost-intro . 13))

((inclass 11) (topmost-intro 13))

In some cases there are more than one position given for a syntactic
symbol.

This change might affect code that call `c-guess-basic-syntax' directly,
and custom lineup functions if they use `c-syntactic-context'.  However,
the argument given to lineup functions is still a single cons cell
with nil or an integer in the cdr.

*** API changes for derived modes.

There have been extensive changes "under the hood" which can affect
derived mode writers.  Some of these changes are likely to cause
incompatibilities with existing derived modes, but on the other hand
care has now been taken to make it possible to extend and modify CC
Mode with less risk of such problems in the future.

**** New language variable system.
See the comment blurb near the top of cc-langs.el.

**** New initialization functions.
The initialization procedure has been split up into more functions to
give better control: `c-basic-common-init', `c-font-lock-init', and
`c-init-language-vars'.

*** Changes in analysis of nested syntactic constructs.
The syntactic analysis engine has better handling of cases where
several syntactic constructs appear nested on the same line.  They are
now handled as if each construct started on a line of its own.

*** Better handling of multiline macros.

**** Syntactic indentation inside macros.
The contents of multiline #define's are now analyzed and indented
syntactically just like other code.  This can be disabled by the new
variable `c-syntactic-indentation-in-macros'.  A new syntactic symbol
`cpp-define-intro' has been added to control the initial indentation
inside `#define's.

**** New lineup function `c-lineup-cpp-define'.

Now used by default to line up macro continuation lines.  The behavior
of this function closely mimics the indentation one gets if the macro
is indented while the line continuation backslashes are temporarily
removed.  If syntactic indentation in macros is turned off, it works
much line `c-lineup-dont-change', which was used earlier, but handles
empty lines within the macro better.

**** Automatically inserted newlines continues the macro if used within one.
This applies to the newlines inserted by the auto-newline mode, and to
`c-context-line-break' and `c-context-open-line'.

**** Better alignment of line continuation backslashes.
`c-backslash-region' tries to adapt to surrounding backslashes.  New
variable `c-backslash-max-column' which put a limit on how far out
backslashes can be moved.

**** Automatic alignment of line continuation backslashes.
This is controlled by the new variable `c-auto-align-backslashes'.  It
affects `c-context-line-break', `c-context-open-line' and newlines
inserted in Auto-Newline mode.
**** Line indentation works better inside macros.

Regardless whether syntactic indentation and syntactic indentation
inside macros are enabled or not, line indentation now ignores the
line continuation backslashes.  This is most noticeable when syntactic
indentation is turned off and there are empty lines (save for the
backslash) in the macro.

*** indent-for-comment is more customizable.
The behavior of M-; (indent-for-comment) is now configurable through
the variable `c-indent-comment-alist'.  The indentation behavior based
on the preceding code on the line, e.g. to get two spaces after #else
and #endif but indentation to `comment-column' in most other cases
(something which was hardcoded earlier).

*** New function `c-context-open-line'.
It's the open-line equivalent of `c-context-line-break'.

*** New lineup functions

**** `c-lineup-string-cont'
This lineup function lines up a continued string under the one it
continues.  E.g:

result = prefix + "A message "
                  "string.";      <- c-lineup-string-cont

**** `c-lineup-cascaded-calls'
Lines up series of calls separated by "->" or ".".

**** `c-lineup-knr-region-comment'
Gives (what most people think is) better indentation of comments in
the "K&R region" between the function header and its body.

**** `c-lineup-gcc-asm-reg'
Provides better indentation inside asm blocks.

**** `c-lineup-argcont'
Lines up continued function arguments after the preceding comma.

*** Better caching of the syntactic context.
CC Mode caches the positions of the opening parentheses (of any kind)
of the lists surrounding the point.  Those positions are used in many
places as anchor points for various searches.  The cache is now

*** Statements are recognized in a more robust way.
Statements are recognized most of the time even when they occur in an
"invalid" context, e.g. in a function argument.  In practice that can
happen when macros are involved.

*** Improved the way `c-indent-exp' chooses the block to indent.
It now indents the block for the closest sexp following the point
whose closing paren ends on a different line.  This means that the
point doesn't have to be immediately before the block to indent.
Also, only the block and the closing line is indented; the current
line is left untouched.

*** Added toggle for syntactic indentation.
The function `c-toggle-syntactic-indentation' can be used to toggle
syntactic indentation.

---
** Perl mode has a new variable `perl-indent-continued-arguments'.

`f90-end-of-block', `f90-beginning-of-block', `f90-next-block',
`f90-previous-block', `fortran-end-of-block',
`fortran-beginning-of-block'.

---
*** F90 mode and Fortran mode have support for `hs-minor-mode' (hideshow).
It cannot deal with every code format, but ought to handle a sizeable
majority.

---
*** The new function `f90-backslash-not-special' can be used to change

---
*** verbatim environments are now highlighted in courier by font-lock
and super/sub-scripts are made into super/sub-scripts.

+++
*** New major mode Doctex mode, for *.dtx files.

** BibTeX mode:

*** The new command `bibtex-url' browses a URL for the BibTeX entry at
point (bound to C-c C-l and mouse-2, RET on clickable fields).

*** The new command `bibtex-entry-update' (bound to C-c C-u) updates
an existing BibTeX entry.

*** New `bibtex-entry-format' option `required-fields', enabled by default.

*** `bibtex-maintain-sorted-entries' can take values `plain',
`crossref', and `entry-class' which control the sorting scheme used
for BibTeX entries.  `bibtex-sort-entry-class' controls the sorting
scheme `entry-class'.  TAB completion for reference keys and
automatic detection of duplicates does not require anymore that
`bibtex-maintain-sorted-entries' is non-nil.

*** If the new variable `bibtex-parse-keys-fast' is non-nil,
use fast but simplified algorithm for parsing BibTeX keys.

*** If the new variable `bibtex-autoadd-commas' is non-nil,
automatically add missing commas at end of BibTeX fields.

*** The new variable `bibtex-autofill-types' contains a list of entry
types for which fields are filled automatically (if possible).

*** The new command `bibtex-complete' completes word fragment before
point according to context (bound to M-tab).

*** The new commands `bibtex-find-entry' and `bibtex-find-crossref'
locate entries and crossref'd entries (bound to C-c C-s and C-c C-x).
Crossref fields are clickable (bound to mouse-2, RET).

*** In BibTeX mode the command `fill-paragraph' (M-q) fills
individual fields of a BibTeX entry.

*** The new variables `bibtex-files' and `bibtex-file-path' define a set
of BibTeX files that are searched for entry keys.

*** The new command `bibtex-validate-globally' checks for duplicate keys
in multiple BibTeX files.

*** The new command `bibtex-copy-summary-as-kill' pushes summary
of BibTeX entry to kill ring (bound to C-c C-t).

+++
** In Enriched mode, `set-left-margin' and `set-right-margin' are now
by default bound to `C-c [' and `C-c ]' instead of the former `C-c C-l'

Emacs 21 such as the display margin for breakpoints, and the toolbar.

Use M-x gdba to start GDB-UI.

*** GUD tooltips can be toggled independently of normal tooltips
with the minor mode `gud-tooltip-mode'.

+++
*** In graphical mode, with a C program, GUD Tooltips have been extended to
display the #define directive associated with an identifier when program is
not executing.

*** Supports new jdb (Java 1.2 and later) in addition to oldjdb
    (Java 1.1 jdb).

*** The previous method of searching for source files has been
    preserved in case someone still wants/needs to use it.
    Set `gud-jdb-use-classpath' to nil.

  Added Customization Variables

*** `gud-jdb-command-name'.  What command line to use to invoke jdb.

*** `gud-jdb-use-classpath'. Allows selection of java source file searching
    method: set to t for new method, nil to scan `gud-jdb-directories' for
    java sources (previous method).

*** `gud-jdb-directories'. List of directories to scan and search for java
    classes using the original gud-jdb method (if `gud-jdb-use-classpath'
    is nil).

  Minor Improvements

*** The STARTTLS wrapper (starttls.el) can now use GNUTLS
instead of the OpenSSL based `starttls' tool.  For backwards
compatibility, it prefers `starttls', but you can toggle
`starttls-use-gnutls' to switch to GNUTLS (or simply remove the
`starttls' tool).

*** Do not allow debugger output history variable to grow without bounds.

** Auto-Revert changes:

+++
*** You can now use Auto Revert mode to `tail' a file.

If point is at the end of a file buffer before reverting, Auto Revert
mode keeps it at the end after reverting.  Similarly if point is
displayed at the end of a file buffer in any window, it stays at
the end of the buffer in that window.  This allows to tail a file:
just put point at the end of the buffer and it stays there.  This

+++
** Desktop package

+++
*** Desktop saving is now a minor mode, `desktop-save-mode'.

*** The variable `desktop-enable' is obsolete.

Customize `desktop-save-mode' to enable desktop saving.

---
*** Buffers are saved in the desktop file in the same order as that in the
buffer list.

+++
*** The desktop package can be customized to restore only some buffers
immediately, remaining buffers are restored lazily (when Emacs is
idle).

+++
*** New commands:
  - desktop-revert reverts to the last loaded desktop.
  - desktop-change-dir kills current desktop and loads a new.