NEWS 319 KB
Newer Older
Dave Love's avatar
Dave Love committed
1 2
GNU Emacs NEWS -- history of user-visible changes.  5 Jan 2000
Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
Dave Love's avatar
#  
Dave Love committed
3 4 5 6 7
See the end for copying conditions.

Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
For older news, see the file ONEWS.

Dave Love's avatar
Dave Love committed
8 9 10

* Installation Changes in Emacs 21.1

Gerd Moellmann's avatar
Gerd Moellmann committed
11 12 13 14 15 16 17 18
** `movemail' defaults to supporting POP.  You can turn this off using
the --without-pop configure option, should that be necessary.

** There are new configure options associated with the support for
images and toolkit scrollbars.  Use the --help option to list them.

* Changes in Emacs 21.1

Dave Love's avatar
Dave Love committed
19 20 21 22 23 24 25 26 27 28 29 30
** Variable `default-korean-keyboard' is initialized properly from the
environment variable `HANGUL_KEYBOARD_TYPE'.

** C-u C-x = provides detailed information about the character at
point in a pop-up window.

** New command M-x list-charset-chars reads a character set name and
displays all characters in that character set.

** M-x set-terminal-coding-system (C-x RET t) now allows CCL-based
coding systems such as cpXXX and cyrillic-koi8.

31 32 33
** M-; now calls comment-dwim which tries to do something clever based
on the context.

Gerd Moellmann's avatar
Gerd Moellmann committed
34 35
** The function `getenv' is now callable interactively.

Dave Love's avatar
Dave Love committed
36 37 38
** The many obsolete language `setup-...-environment' commands have
been removed -- use `set-language-environment'.

Dave Love's avatar
Dave Love committed
39 40 41 42 43
** New user options `display-time-mail-face' and
`display-time-use-mail-icon' control the appearance of mode-line mail
indicator used by the display-time package.  On a suitable display the
indicator can be an icon and is mouse-sensitive.

Gerd Moellmann's avatar
Gerd Moellmann committed
44 45
** Emacs' auto-save list files are now by default stored in a
sub-directory `.emacs.d/auto-save-list/' of the user's home directory.
46
(On MS-DOS, this subdirectory's name is `_emacs.d/auto-save.list/'.)
Gerd Moellmann's avatar
Gerd Moellmann committed
47 48
You can customize `auto-save-list-prefix' to change this location.

Gerd Moellmann's avatar
Gerd Moellmann committed
49 50 51 52 53 54 55 56 57 58
** On window-systems, additional space can be put between text lines
on the display using several methods

- By setting frame parameter `line-spacing' to PIXELS.  PIXELS must be
a positive integer, and specifies that PIXELS number of pixels should
be put below text lines on the affected frame or frames.

- By setting X resource `lineSpacing', class `LineSpacing'.  This is
equivalent ot specifying the frame parameter.

Gerd Moellmann's avatar
Gerd Moellmann committed
59
- By specifying `--line-spacing=N' or `-lsp N' on the command line.
Gerd Moellmann's avatar
Gerd Moellmann committed
60 61 62 63

- By setting buffer-local variable `line-spacing'.  The meaning is
the same, but applies to the a particular buffer only.

Gerd Moellmann's avatar
Gerd Moellmann committed
64
** The new command `clone-buffer-indirectly' can be used to create
Gerd Moellmann's avatar
Gerd Moellmann committed
65 66 67
an indirect buffer that is a twin copy of the current buffer.  The
command `clone-buffer-indirectly-other-window', bound to C-x 4 c,
does the same but displays the indirect buffer in another window.
Gerd Moellmann's avatar
Gerd Moellmann committed
68

69
** New user options `backup-directory-alist' and
Dave Love's avatar
Dave Love committed
70 71
`make-backup-file-name-function' control the placement of backups,
typically in a single directory or in an invisible sub-directory.
72

Dave Love's avatar
Dave Love committed
73 74 75
** New commands iso-iso2sgml and iso-sgml2iso convert between Latin-1
characters and the corresponding SGML (HTML) entities.

Gerd Moellmann's avatar
Gerd Moellmann committed
76 77 78 79 80 81 82 83 84
** Emacs now refuses to load compiled Lisp files which weren't
compiled with Emacs.  Set `load-dangerous-libraries' to t to change
this behavior.

The reason for this change is an incompatible change in XEmacs' byte
compiler.  Files compiled with XEmacs can contain byte codes that let
Emacs dump core.

** New X resources recognized
Gerd Moellmann's avatar
Gerd Moellmann committed
85

Gerd Moellmann's avatar
Gerd Moellmann committed
86 87 88 89 90 91
*** The X resource `synchronous', class `Synchronous', specifies
whether Emacs should run in synchronous mode.  Synchronous mode
is useful for debugging X problems.

Example:

Gerd Moellmann's avatar
Gerd Moellmann committed
92
  emacs.synchronous: true
Gerd Moellmann's avatar
Gerd Moellmann committed
93

Gerd Moellmann's avatar
Gerd Moellmann committed
94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
*** The X resource `visualClass, class `VisualClass', specifies the
visual Emacs should use.  The resource's value should be a string of
the form `CLASS-DEPTH', where CLASS is the name of the visual class,
and DEPTH is the requested color depth as a decimal number.  Valid
visual class names are

  TrueColor
  PseudoColor
  DirectColor
  StaticColor
  GrayScale
  StaticGray

Visual class names specified as X resource are case-insensitive, i.e.
`pseudocolor', `Pseudocolor' and `PseudoColor' all have the same
meaning.

The program `xdpyinfo' can be used to list the visual classes
supported on your display, and which depths they have.  If
`visualClass' is not specified, Emacs uses the display's default
visual.

Example:

Gerd Moellmann's avatar
Gerd Moellmann committed
118
  emacs.visualClass: TrueColor-8
Gerd Moellmann's avatar
Gerd Moellmann committed
119 120 121 122 123 124 125 126

*** The X resource `privateColormap', class `PrivateColormap',
specifies that Emacs should use a private colormap if it is using the
default visual, and that visual is of class PseudoColor.  Recognized
resource values are `true' or `on'.

Example:

Gerd Moellmann's avatar
Gerd Moellmann committed
127
  emacs.privateColormap: true
Gerd Moellmann's avatar
Gerd Moellmann committed
128

129 130 131 132
** The menu bar configuration has changed.  The new configuration is
more CUA-compliant.  The most significant change is that Options is
now a separate menu-bar item, with Mule and Customize as its submenus.

Gerd Moellmann's avatar
Gerd Moellmann committed
133
** User-option `show-cursor-in-non-selected-windows' controls how to
Gerd Moellmann's avatar
Gerd Moellmann committed
134
display the cursor in non-selected windows.  If nil, no cursor is
Gerd Moellmann's avatar
Gerd Moellmann committed
135 136
shown, if non-nil a hollow box cursor is shown.  This option can
be customized.
Gerd Moellmann's avatar
Gerd Moellmann committed
137

Dave Love's avatar
Dave Love committed
138 139
** The variable `echo-keystrokes' may now have a floating point value.

Gerd Moellmann's avatar
Gerd Moellmann committed
140 141 142
** C-x 5 1 runs the new command delete-other-frames which deletes
all frames except the selected one.

Dave Love's avatar
Dave Love committed
143 144 145
** If your init file is compiled (.emacs.elc), `user-init-file' is set
to the source name (.emacs.el), if that exists, after loading it.

Gerd Moellmann's avatar
Gerd Moellmann committed
146 147 148 149
** The help string specified for a menu-item whose definition contains
the property `:help HELP' is now displayed under X either in the echo
area or with tooltips.

150 151 152
** New user option `read-mail-command' specifies a command to use to
read mail from the menu etc.

Gerd Moellmann's avatar
Gerd Moellmann committed
153 154 155
** Hexl contains a new command `hexl-insert-hex-string' which inserts
a string of hexadecimal numbers read from the mini-buffer.

Gerd Moellmann's avatar
Gerd Moellmann committed
156 157 158 159 160 161 162 163 164 165 166 167 168
** Changes in Texinfo mode.

** A couple of new key bindings have been added for inserting Texinfo
macros

  Key binding	Macro
  -------------------------
  C-c C-c C-s	@strong
  C-c C-c C-e	@emph
  C-c C-c u	@url
  C-c C-c q     @quotation
  C-c C-c m	@email

169 170 171 172 173 174
** Changes in Outline mode.

There is now support for Imenu to index headings.  A new command
`outline-headers-as-kill' copies the visible headings in the region to
the kill ring, e.g. to produce a table of contents.

Dave Love's avatar
Dave Love committed
175 176 177
** New command M-x check-parens can be used to find unbalanced paren
groups and strings in buffers in Lisp mode (or other modes).

Stefan Monnier's avatar
Stefan Monnier committed
178 179 180 181
** You can now easily create new *Info* buffers using either M-x clone-buffer
or C-u m <entry> RET.  M-x clone-buffer can also be used on *Help* and
several other special buffers.

William M. Perry's avatar
William M. Perry committed
182 183 184 185 186 187 188
** Emacs can now support 'wheeled' mice (such as the MS IntelliMouse)
under XFree86.  To enable this, simply put (mwheel-install) in your
.emacs file.

The variables `mwheel-follow-mouse' and `mwheel-scroll-amount'
determine where and by how much buffers are scrolled.

Gerd Moellmann's avatar
Gerd Moellmann committed
189 190 191 192
** Listing buffers with M-x list-buffers (C-x C-b) now shows
abbreviated file names.  Abbreviations can be customized by changing
`directory-abbrev-alist'.

193 194 195 196 197 198 199 200
** Reading from the mini-buffer now reads from standard input if Emacs
is running in batch mode.  For example,

  (message "%s" (read t))

will read a Lisp expression from standard input and print the result
to standard output.

Dave Love's avatar
#  
Dave Love committed
201 202 203 204 205 206 207 208 209 210 211 212
** Faces and frame parameters.

There are four new faces `scroll-bar', `border', `cursor' and `mouse'.
Setting the frame parameters `scroll-bar-foreground' and
`scroll-bar-background' sets foreground and background color of face
`scroll-bar' and vice versa.  Setting frame parameter `border-color'
sets the background color of face `border' and vice versa.  Likewise
for frame parameters `cursor-color' and face `cursor', and frame
parameter `mouse-color' and face `mouse'.

Changing frame parameter `font' sets font-related attributes of the
`default' face and vice versa.  Setting frame parameters
Francesco Potortì's avatar
etags:  
Francesco Potortì committed
213
`foreground-color' or `background-color' sets the colors of the
Dave Love's avatar
#  
Dave Love committed
214 215
`default' face and vice versa.

Gerd Moellmann's avatar
Gerd Moellmann committed
216 217 218 219 220 221
** New face `menu'.

The face `menu' can be used to change colors and font of Emacs' menus.
Setting the font of LessTif/Motif menus is currently not supported;
attempts to set the font are ignored in this case.

Dave Love's avatar
#  
Dave Love committed
222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353
** New frame parameter `screen-gamma' for gamma correction.

The new frame parameter `screen-gamma' specifies gamma-correction for
colors.  Its value may be nil, the default, in which case no gamma
correction occurs, or a number > 0, usually a float, that specifies
the screen gamma of a frame's display.

PC monitors usually have a screen gamma of 2.2.  smaller values result
in darker colors.  You might want to try a screen gamma of 1.5 for LCD
color displays.  The viewing gamma Emacs uses is 0.4545. (1/2.2).

The X resource name of this parameter is `screenGamma', class
`ScreenGamma'.

** Emacs has a new redisplay engine.

The new redisplay handles characters of variable width and height.
Italic text can be used without redisplay problems.  Fonts containing
oversized characters, i.e. characters larger than the logical height
of a font can be used.  Images of various formats can be displayed in
the text.

** Emacs has a new face implementation.

The new faces no longer fundamentally use X font names to specify the
font.  Instead, each face has several independent attributes--family,
height, width, weight and slant--that it may or may not specify.
These attributes can be merged from various faces, and then together
specify a font.

Faces are supported on terminals that can display color or fonts.
These terminal capabilities are auto-detected.  Details can be found
under Lisp changes, below.

** New default font is Courier 12pt.

** When using a windowing terminal, Emacs window now has a cursor of
its own.  When the window is selected, the cursor is solid; otherwise,
it is hollow.

** Bitmap areas to the left and right of windows are used to display
truncation marks, continuation marks, overlay arrows and alike.  The
foreground, background, and stipple of these areas can be changed by
customizing face `fringe'.

** The mode line under X is now drawn with shadows by default.  You
can change its appearance by modifying the face `modeline'.

** LessTif support.

Emacs now runs with LessTif (see <http://www.lesstif.org>).  You will
need a version 0.88.1 or later.

** Toolkit scroll bars.

Emacs now uses toolkit scrollbars if available.  When configured for
LessTif/Motif, it will use that toolkit's scrollbar.  Otherwise, when
configured for Lucid and Athena widgets, it will use the Xaw3d scroll
bar if Xaw3d is available.  You can turn off the use of toolkit scroll
bars by specifying `--with-toolkit-scroll-bars=no' when configuring
Emacs.

When you encounter problems with the Xaw3d scroll bar, watch out how
Xaw3d is compiled on your system.  If the Makefile generated from
Xaw3d's Imakefile contains a `-DNARROWPROTO' compiler option, and your
Emacs system configuration file `s/your-system.h' does not contain a
define for NARROWPROTO, you might consider adding it.  Take
`s/freebsd.h' as an example.

Alternatively, if you don't have access to the Xaw3d source code, take
a look at your system's imake configuration file, for example in the
directory `/usr/X11R6/lib/X11/config' (paths are different on
different systems).  You will find files `*.cf' there.  If your
system's cf-file contains a line like `#define NeedWidePrototypes NO',
add a `#define NARROWPROTO' to your Emacs system configuration file.

The reason for this is that one Xaw3d function uses `double' or
`float' function parameters depending on the setting of NARROWPROTO.
This is not a problem when Imakefiles are used because each system's
image configuration file contains the necessary information.  Since
Emacs doesn't use imake, this has do be done manually.

** Toggle buttons and radio buttons in menus.

When compiled with LessTif (or Motif) support, Emacs uses toolkit
widgets for radio and toggle buttons in menus.  When configured for
Lucid, Emacs draws radio buttons and toggle buttons similar to Motif.

** Highlighting of trailing whitespace.

When `show-trailing-whitespace' is non-nil, Emacs displays trailing
whitespace in the face `trailing-whitespace'.  Trailing whitespace is
defined as spaces or tabs at the end of a line.  To avoid busy
highlighting when entering new text, trailing whitespace is not
displayed if point is at the end of the line containing the
whitespace.

** Busy-cursor.

Emacs can optionally display a busy-cursor under X.  You can turn the
display on or off by customizing group `cursor'.

** Blinking cursor

M-x blink-cursor-mode toggles a blinking cursor under X and on
terminals having terminal capabilities `vi', `vs', and `ve'.  Blinking
and related parameters like frequency and delay can be customized in
the group `cursor'.

** New font-lock support mode `jit-lock-mode'.

This support mode is roughly equivalent to `lazy-lock' but is
generally faster.  It supports stealth and deferred fontification.
See the documentation of the function `jit-lock-mode' for more
details.

Font-lock uses jit-lock-mode as default support mode, so you don't
have to do anything to activate it.

** Tabs and variable-width text.

Tabs are now displayed with stretch properties; the width of a tab is
defined as a multiple of the normal character width of a frame, and is
independent of the fonts used in the text where the tab appears.
Thus, tabs can be used to line up text in different fonts.

** Enhancements of the Lucid menu bar

*** The Lucid menu bar now supports the resource "margin".

	emacs.pane.menubar.margin: 5

354 355
The default margin is 4 which makes the menu bar appear like the
LessTif/Motif one.
Dave Love's avatar
#  
Dave Love committed
356

357 358
*** Arrows that indicate sub-menus are now drawn with shadows, as in
LessTif and Motif.
Dave Love's avatar
#  
Dave Love committed
359 360 361

** Hscrolling in C code.

Gerd Moellmann's avatar
Gerd Moellmann committed
362 363 364
Horizontal scrolling now happens automatically if
`automatic-hscrolling' is set (the default).  This setting can be
customized.
Dave Love's avatar
#  
Dave Love committed
365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388

** Tool bar support.

Emacs supports a tool bar at the top of a frame under X.  For details
how to define a tool bar, see the page describing Lisp-level changes.

** Mouse-sensitive mode line.

Different parts of the mode line under X have been made
mouse-sensitive.  Moving the mouse to a mouse-sensitive part in the mode
line changes the appearance of the mouse pointer to an arrow, and help
about available mouse actions is displayed either in the echo area, or
in the tooltip window if you have enabled one.

Currently, the following actions have been defined:

- Mouse-1 on the buffer name in the mode line switches between two
buffers.

- Mouse-2 on the buffer-name switches to the next buffer, and
M-mouse-2 switches to the previous buffer in the buffer list.

- Mouse-3 on the buffer-name displays a buffer menu.

389
- Mouse-2 on the read-only status in the mode line (`%' or `*')
Dave Love's avatar
#  
Dave Love committed
390 391 392 393 394 395 396
toggles the read-only status.

- Mouse-3 on the mode name display a minor-mode menu.

** LessTif/Motif file selection dialog.

When Emacs is configured to use LessTif or Motif, reading a file name
Dave Love's avatar
Dave Love committed
397
from a menu will pop up a file selection dialog if `use-dialog-box' is
Dave Love's avatar
#  
Dave Love committed
398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456
non-nil.

** Emacs can display faces on TTY frames.

Emacs automatically detects terminals that are able to display colors.
Faces with a weight greater than normal are displayed extra-bright, if
the terminal supports it.  Faces with a weight less than normal and
italic faces are displayed dimmed, if the terminal supports it.
Underlined faces are displayed underlined if possible.  Other face
attributes like overlines, strike-throught, box are ignored.

** Sound support

Emacs supports playing sound files on GNU/Linux and the free BSDs
(Voxware driver and native BSD driver, aka as Luigi's driver).
Currently supported file formats are RIFF-WAVE (*.wav) and Sun Audio
(*.au).  You must configure Emacs with the option `--with-sound=yes'
to enable sound support.

** A new variable, backup-by-copying-when-privileged-mismatch, gives
the highest file uid for which backup-by-copying-when-mismatch will be
forced on.  The assumption is that uids less than or equal to this
value are special uids (root, bin, daemon, etc.--not real system
users) and that files owned by these users should not change ownership,
even if your system policy allows users other than root to edit them.

The default is 200; set the variable to nil to disable the feature.

** A block cursor can be drawn as wide as the glyph under it under X.

As an example: if a block cursor is over a tab character, it will be
drawn as wide as that tab on the display.  To do this, set
`x-stretch-cursor' to a non-nil value.

** Empty display lines at the end of a buffer may be marked with a
bitmap (this is similar to the tilde displayed by vi).

This behavior is activated by setting the buffer-local variable
`indicate-empty-lines' to a non-nil value.  The default value of this
variable is found in `default-indicate-empty-lines'.

** There is a new "aggressive" scrolling method.

When scrolling up because point is above the window start, if the
value of the buffer-local variable `scroll-up-aggessively' is a
number, Emacs chooses a new window start so that point ends up that
fraction of the window's height from the bottom of the window.

When scrolling down because point is below the window end, if the
value of the buffer-local variable `scroll-down-aggessively' is a
number, Emacs chooses a new window start so that point ends up that
fraction of the window's height from the top of the window.

** The rectangle commands now avoid inserting undesirable spaces,
notably at the end of lines.

All these functions have been rewritten to avoid inserting unwanted
spaces, and an optional prefix now allows them to behave the old way.

Dave Love's avatar
Dave Love committed
457 458
There is a new command M-x replace-rectangle.

Dave Love's avatar
#  
Dave Love committed
459 460 461 462
** The new command M-x query-replace-regexp-eval acts like
query-replace-regexp, but takes a Lisp expression which is evaluated
after each match to get the replacement text.

Dave Love's avatar
Dave Love committed
463
** M-x query-replace recognizes a new command `E' that lets you
Gerd Moellmann's avatar
Gerd Moellmann committed
464 465 466 467 468 469
edit the replacement string.

** The new command mail-abbrev-complete-alias, bound to `M-TAB', let's
you complete mail aliases in the text, analogous to
lisp-complete-symbol.

Dave Love's avatar
#  
Dave Love committed
470 471 472 473 474 475 476 477 478 479 480 481 482 483 484
** Emacs now resizes mini-windows if appropriate.

If a message is longer than one line, or mini-buffer contents are
longer than one line, Emacs now resizes the mini-window unless it is
on a frame of its own.  You can control the maximum mini-window size
by setting the following variable:

- User option: max-mini-window-height

Maximum height for resizing mini-windows.  If a float, it specifies a
fraction of the mini-window frame's height.  If an integer, it
specifies a number of lines.  If nil, don't resize.

Default is 0.25.

Gerd Moellmann's avatar
Gerd Moellmann committed
485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518
** Changes to hideshow.el

Hideshow is now at version 5.x.  It uses a new algorithms for block
selection and traversal and includes more isearch support.

*** Generalized block selection and traversal

A block is now recognized by three things: its start and end regexps
(both strings), and a match-data selector (an integer) specifying
which sub-expression in the start regexp serves as the place where a
`forward-sexp'-like function can operate.  Hideshow always adjusts
point to this sub-expression before calling `hs-forward-sexp-func'
(which for most modes evaluates to `forward-sexp').

If the match-data selector is not specified, it defaults to zero,
i.e., the entire start regexp is valid, w/ no prefix.  This is
backwards compatible with previous versions of hideshow.  Please see
the docstring for variable `hs-special-modes-alist' for details.

*** Isearch support for updating mode line

During incremental search, if Hideshow minor mode is active, hidden
blocks are temporarily shown.  The variable `hs-headline' records the
line at the beginning of the opened block (preceding the hidden
portion of the buffer), and the mode line is refreshed.  When a block
is re-hidden, the variable is set to nil.

To show `hs-headline' in the mode line, you may wish to include
something like this in your .emacs.

	(add-hook 'hs-minor-mode-hook
	  (lambda ()
	    (add-to-list 'mode-line-format 'hs-headline)))

519 520 521 522 523 524 525 526
** Changes to Change Log mode and Add-Log functions

If you invoke `add-change-log-entry' from a backup file, it makes an
entry appropriate for the file's parent.  This is useful for making
log entries by comparing a version with deleted functions.

New command M-x change-log-merge merges another log into the current
buffer, fixing old-style date formats if necessary.
Gerd Moellmann's avatar
Gerd Moellmann committed
527 528 529 530 531 532 533 534 535

Change Log mode now adds a file's version number to change log entries
if user-option `change-log-version-info-enabled' is non-nil.

The search for a file's version number is performed based on regular
expressions from `change-log-version-number-regexp-list' which can be
cutomized.  Version numbers are only found in the first 10 percent of
a file.

536 537 538 539 540 541
** Changes in Font Lock

*** The new function `font-lock-remove-keywords' can be used to remove
font-lock keywords from the current buffer or from a specific major
mode.

Gerd Moellmann's avatar
Gerd Moellmann committed
542 543 544 545 546 547 548 549 550 551 552 553 554
** Comint (subshell) changes

Comint now includes new features to send commands to running processes
and redirect the output to a designated buffer or buffers.

The command M-x comint-redirect-send-command reads a command and
buffer name from the mini-buffer.  The command is sent to the current
buffer's process, and its output is inserted into the specified buffer.

The command M-x comint-redirect-send-command-to-process acts like
M-x comint-redirect-send-command but additionally reads the name of
the buffer whose process should be used from the mini-buffer.

Gerd Moellmann's avatar
Gerd Moellmann committed
555 556
** Changes to Rmail mode

Gerd Moellmann's avatar
Gerd Moellmann committed
557 558 559 560 561 562 563 564 565
*** The new user-option rmail-rmail-user-mail-address-regexp can be
set to fine tune the identification of of the correspondent when
receiving new mail.  If it matches the address of the sender, the
recipient is taken as correspondent of a mail.  If nil, the default,
`user-login-name' and `user-mail-address' are used to exclude yourself
as correspondent.

Usually you don't have to set this variable, except if you collect
mails sent by you under different user names.  Then it should be a
Dave Love's avatar
Dave Love committed
566
regexp matching your mail addresses.
Gerd Moellmann's avatar
Gerd Moellmann committed
567

Gerd Moellmann's avatar
Gerd Moellmann committed
568 569 570 571 572 573
*** The new user-option rmail-confirm-expunge controls whether and how
to ask for confirmation before expunging deleted messages from an
Rmail file.  You can choose between no confirmation, confirmation
with y-or-n-p, or confirmation with yes-or-no-p.  Default is to ask
for confirmation with yes-or-no-p.

Gerd Moellmann's avatar
Gerd Moellmann committed
574 575 576
*** RET is now bound in the Rmail summary to rmail-summary-goto-msg,
like `j'.

577 578
*** There is a new user option `rmail-digest-end-regexps' that
specifies the regular expressions to detect the line that ends a
579
digest message.
Gerd Moellmann's avatar
Gerd Moellmann committed
580

Dave Love's avatar
Dave Love committed
581 582 583
*** The new user option `rmail-automatic-folder-directives' specifies
in which folder to put messages automatically.

Gerd Moellmann's avatar
Gerd Moellmann committed
584 585 586 587 588
** Changes to TeX mode

The default mode has been changed from `plain-tex-mode' to
`latex-mode'.

Dave Love's avatar
#  
Dave Love committed
589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609
** Changes to RefTeX mode

*** RefTeX has new support for index generation.  Index entries can be
    created with `C-c <', with completion available on index keys.
    Pressing `C-c /' indexes the word at the cursor with a default
    macro.  `C-c >' compiles all index entries into an alphabetically
    sorted *Index* buffer which looks like the final index.  Entries
    can be edited from that buffer.

*** Label and citation key selection now allow to select several
    items and reference them together (use `m' to mark items, `a' or
    `A' to use all marked entries).

*** reftex.el has been split into a number of smaller files to reduce
    memory use when only a part of RefTeX is being used.

*** a new command `reftex-view-crossref-from-bibtex' (bound to `C-c &'
    in BibTeX-mode) can be called in a BibTeX database buffer in order
    to show locations in LaTeX documents where a particular entry has
    been cited.

610 611 612 613 614
** Emacs Lisp mode now allows multiple levels of outline headings.
The level of a heading is determined from the number of leading
semicolons in a heading line.  Toplevel forms starting with a `('
in column 1 are always made leaves.

Dave Love's avatar
#  
Dave Love committed
615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643
** The M-x time-stamp command (most commonly used on write-file-hooks)
has the following new features:

*** The patterns for finding the time stamp and for updating a pattern
may match text spanning multiple lines.  For example, some people like
to have the filename and date on separate lines.  The new variable
time-stamp-inserts-lines controls the matching for multi-line patterns.

*** More than one time stamp can be updated in the same file.  This
feature is useful if you need separate time stamps in a program source
file to both include in formatted documentation and insert in the
compiled binary.  The same time-stamp will be written at each matching
pattern.  The variable time-stamp-count enables this new feature; it
defaults to 1.

** Tooltips.

Tooltips are small X windows displaying a help string at the current
mouse position.  To use them, use the Lisp package `tooltip' which you
can access via the user option `tooltip-mode'.

Tooltips also provides support for GUD debugging.  If activated,
variable values can be displayed in tooltips by pointing at them with
the mouse in source buffers.  You can customize various aspects of the
tooltip display in the group `tooltip'.

** Customize changes

*** Customize now supports comments about customized items.  Use the
Dave Love's avatar
Dave Love committed
644 645
`State' menu to add comments.  Note that customization comments will
cause the customizations to fail in earlier versions of Emacs.
Dave Love's avatar
#  
Dave Love committed
646 647 648 649 650

*** The new option `custom-buffer-done-function' says whether to kill
Custom buffers when you've done with them or just bury them (the
default).

651 652 653 654 655 656 657 658 659 660 661 662 663 664 665
*** The keyword :set-after in defcustom allows to specify dependencies
between custom options.  Example:

  (defcustom default-input-method nil
    "*Default input method for multilingual text (a string).
  This is the input method activated automatically by the command
  `toggle-input-method' (\\[toggle-input-method])."
    :group 'mule
    :type '(choice (const nil) string)
    :set-after '(current-language-environment))

This specifies that default-input-method should be set after
current-language-environment even if default-input-method appears
first in a custom-set-variables statement.

Dave Love's avatar
#  
Dave Love committed
666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683
** New features in evaluation commands

The commands to evaluate Lisp expressions, such as C-M-x in Lisp
modes, C-j in Lisp Interaction mode, and M-:, now bind the variables
print-level, print-length, and debug-on-error based on the
customizable variables eval-expression-print-level,
eval-expression-print-length, and eval-expression-debug-on-error.

** Dired changes

*** New variable `dired-recursive-deletes' determines if the delete
command will delete non-empty directories recursively.  The default
is, delete only empty directories.

*** New variable `dired-recursive-copies' determines if the copy
command will copy directories recursively.  The default is, do not
copy directories recursively.

684 685 686 687
*** In command `dired-do-shell-command' (usually bound to `!') a `?'
in the shell command has a special meaning similar to `*', but with
the difference that the command will be run on each file individually.

Dave Love's avatar
#  
Dave Love committed
688 689 690
** The variable mail-specify-envelope-from controls whether to
use the -f option when sending mail.

Gerd Moellmann's avatar
Gerd Moellmann committed
691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832
** CC mode changes.

Note: This release contains changes that might not be compatible with
current user setups (although it's believed that these
incompatibilities will only show in very uncommon circumstances).
However, since the impact is uncertain, these changes may be rolled
back depending on user feedback.  Therefore there's no forward
compatibility guarantee wrt the new features introduced in this
release.

*** New initialization procedure for the style system.
When the initial style for a buffer is determined by CC Mode (from the
variable c-default-style), the global values of style variables now
take precedence over the values specified by the chosen style.  This
is different than the old behavior: previously, the style-specific
settings would override the global settings.  This change makes it
possible to do simple configuration in the intuitive way with
Customize or with setq lines in one's .emacs file.

By default, the global value of every style variable is the new
special symbol set-from-style, which causes the value to be taken from
the style system.  This means that in effect, only an explicit setting
of a style variable will cause the "overriding" behavior described
above.

Also note that global settings override style-specific settings *only*
when the initial style of a buffer is chosen by a CC Mode major mode
function.  When a style is chosen in other ways --- for example, by a
call like (c-set-style "gnu") in a hook, or via M-x c-set-style ---
then the style-specific values take precedence over any global style
values.  In Lisp terms, global values override style-specific values
only when the new second argument to c-set-style is non-nil; see the
function documentation for more info.

The purpose of these changes is to make it easier for users,
especially novice users, to do simple customizations with Customize or
with setq in their .emacs files.  On the other hand, the new system is
intended to be compatible with advanced users' customizations as well,
such as those that choose styles in hooks or whatnot.  This new system
is believed to be almost entirely compatible with current
configurations, in spite of the changed precedence between style and
global variable settings when a buffer's default style is set.

(Thanks to Eric Eide for clarifying this explanation a bit.)

**** c-offsets-alist is now a customizable variable.
This became possible as a result of the new initialization behavior.

This variable is treated slightly differently from the other style
variables; instead of using the symbol set-from-style, it will be
completed with the syntactic symbols it doesn't already contain when
the style is first initialized.  This means it now defaults to the
empty list to make all syntactic elements get their values from the
style system.

**** Compatibility variable to restore the old behavior.
In case your configuration doesn't work with this change, you can set
c-old-style-variable-behavior to non-nil to get the old behavior back
as far as possible.

*** Improvements to line breaking and text filling.
CC Mode now handles this more intelligently and seamlessly wrt the
surrounding code, especially inside comments.  For details see the new
chapter about this in the manual.

**** New variable to recognize comment line prefix decorations.
The variable c-comment-prefix-regexp has been added to properly
recognize the line prefix in both block and line comments.  It's
primarily used to initialize the various paragraph recognition and
adaptive filling variables that the text handling functions uses.

**** New variable c-block-comment-prefix.
This is a generalization of the now obsolete variable
c-comment-continuation-stars to handle arbitrary strings.

**** CC Mode now uses adaptive fill mode.
This to make it adapt better to the paragraph style inside comments.

It's also possible to use other adaptive filling packages inside CC
Mode, notably Kyle E. Jones' Filladapt mode (http://wonderworks.com/).
A new convenience function c-setup-filladapt sets up Filladapt for use
inside CC Mode.

Note though that the 2.12 version of Filladapt lacks a feature that
causes it to work suboptimally when c-comment-prefix-regexp can match
the empty string (which it commonly does).  A patch for that is
available from the CC Mode web site (http://www.python.org/emacs/
cc-mode/).

**** It's now possible to selectively turn off auto filling.
The variable c-ignore-auto-fill is used to ignore auto fill mode in
specific contexts, e.g. in preprocessor directives and in string
literals.

**** New context sensitive line break function c-context-line-break.
It works like newline-and-indent in normal code, and adapts the line
prefix according to the comment style when used inside comments.  If
you're normally using newline-and-indent, you might want to switch to
this function.

*** Fixes to IDL mode.
It now does a better job in recognizing only the constructs relevant
to IDL.  E.g. it no longer matches "class" as the beginning of a
struct block, but it does match the CORBA 2.3 "valuetype" keyword.
Thanks to Eric Eide.

*** Improvements to the Whitesmith style.
It now keeps the style consistently on all levels and both when
opening braces hangs and when they don't.

**** New lineup function c-lineup-whitesmith-in-block.

*** New lineup functions c-lineup-template-args and c-indent-multi-line-block.
See their docstrings for details.  c-lineup-template-args does a
better job of tracking the brackets used as parens in C++ templates,
and is used by default to line up continued template arguments.

*** c-lineup-comment now preserves alignment with a comment on the
previous line.  It used to instead preserve comments that started in
the column specified by comment-column.

*** c-lineup-C-comments handles "free form" text comments.
In comments with a long delimiter line at the start, the indentation
is kept unchanged for lines that start with an empty comment line
prefix.  This is intended for the type of large block comments that
contain documentation with its own formatting.  In these you normally
don't want CC Mode to change the indentation.

*** The `c' syntactic symbol is now relative to the comment start
instead of the previous line, to make integers usable as lineup
arguments.

*** All lineup functions have gotten docstrings.

*** More preprocessor directive movement functions.
c-down-conditional does the reverse of c-up-conditional.
c-up-conditional-with-else and c-down-conditional-with-else are
variants of these that also stops at "#else" lines (suggested by Don
Provan).

*** Minor improvements to many movement functions in tricky situations.

Gerd Moellmann's avatar
Gerd Moellmann committed
833 834 835 836 837 838 839
** Makefile mode changes

*** The mode now uses the abbrev table `makefile-mode-abbrev-table'.

*** Conditionals and include statements are now highlighted when 
Fontlock mode is active.

Gerd Moellmann's avatar
Gerd Moellmann committed
840 841
** Isearch changes

Gerd Moellmann's avatar
Gerd Moellmann committed
842 843 844 845
** In Isearch mode, M-C-s and M-C-r are now bound like C-s and C-r,
respectively, i.e. you can repeat a regexp isearch with the same keys
that started the search.

Gerd Moellmann's avatar
Gerd Moellmann committed
846
*** In Isearch mode, mouse-2 in the echo area now yanks the current
Dave Love's avatar
#  
Dave Love committed
847 848
selection into the search string rather than giving an error.

Gerd Moellmann's avatar
Gerd Moellmann committed
849 850
*** There is a new lazy highlighting feature in incremental search.

Gerd Moellmann's avatar
Gerd Moellmann committed
851
Lazy highlighting is switched on/off by customizing variable
Gerd Moellmann's avatar
Gerd Moellmann committed
852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868
`isearch-lazy-highlight'.  When active, all matches for the current
search string are highlighted.  The current match is highlighted as
before using face `isearch' or `region'.  All other matches are
highlighted using face `isearch-lazy-highlight-face' which defaults to
`secondary-selection'.  

The extra highlighting makes it easier to anticipate where the cursor
will end up each time you press C-s or C-r to repeat a pending search.
Highlighting of these additional matches happens in a deferred fashion
using "idle timers," so the cycles needed do not rob isearch of its
usual snappy response.

If `isearch-lazy-highlight-cleanup' is set to t, highlights for
matches are automatically cleared when you end the search.  If it is
set to nil, you can remove the highlights manually with `M-x
isearch-lazy-highlight-cleanup'.

869 870 871
** Changes in sort.el

The function sort-numeric-fields interprets numbers starting with `0'
872
as octal and numbers starting with `0x' or `0X' as hexadecimal.  The
873 874
new user-option sort-numberic-base can be used to specify a default
numeric base.
Gerd Moellmann's avatar
Gerd Moellmann committed
875

Gerd Moellmann's avatar
Gerd Moellmann committed
876 877 878
** Changes to Ange-ftp

*** Ange-ftp allows you to specify of a port number in remote file
Dave Love's avatar
Dave Love committed
879 880 881
names cleanly.  It is appended to the host name, separated by a hash
sign, e.g. `/foo@bar.org#666:mumble'.  (This syntax comes from EFS.)

Gerd Moellmann's avatar
Gerd Moellmann committed
882 883 884
*** If the new user-option `ange-ftp-try-passive-mode' is set, passive
ftp mode will be used if the ftp client supports that.

Gerd Moellmann's avatar
Gerd Moellmann committed
885 886 887 888 889 890
** Shell script mode changes.

Shell script mode (sh-script) can now indent scripts for shells
derived from sh and rc.  The indentation style is customizeable, and
sh-script can attempt to "learn" the current buffer's style.

Francesco Potortì's avatar
etags:  
Francesco Potortì committed
891 892 893 894
** Etags changes.

*** In DOS, etags looks for file.cgz if it cannot find file.c.

895
*** New option --ignore-case-regex is an alternative to --regex.  It is now
896 897 898 899
possible to bind a regexp to a language, by prepending the regexp with
{lang}, where lang is one of the languages that `etags --help' prints out.
This feature is useful especially for regex files, where each line contains
a regular expression.  The manual contains details.
900

Francesco Potortì's avatar
etags:  
Francesco Potortì committed
901 902 903 904
*** In C and derived languages, etags creates tags for function
declarations when given the --declarations option.

*** In C++, tags are created for "operator".  The tags have the form
905
"operator+", without spaces between the keyword and the operator.
Francesco Potortì's avatar
etags:  
Francesco Potortì committed
906 907 908 909

*** New language Ada: tags are functions, procedures, packages, tasks, and
types.

Dave Love's avatar
Dave Love committed
910
*** In Fortran, `procedure' is not tagged.
Francesco Potortì's avatar
etags:  
Francesco Potortì committed
911 912 913 914 915 916 917 918 919 920 921

*** In Java, tags are created for "interface".

*** In Lisp, "(defstruct (foo", "(defun (operator" and similar constructs
are now tagged.

*** In Perl, the --globals option tags global variables.  my and local
variables are tagged.

*** New language Python: def and class at the beginning of a line are tags.

922 923
*** .ss files are Scheme files, .pdb is Postscript with C syntax, .psw is
for PSWrap.
Francesco Potortì's avatar
etags:  
Francesco Potortì committed
924

925 926
** Changes in etags.el

Gerd Moellmann's avatar
Gerd Moellmann committed
927 928 929 930
*** The new user-option tags-case-fold-search can be used to make
tags operations case-sensitive or case-insensitive.  The default
is to use the same setting as case-fold-search.

931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955
*** You can display additional output with M-x tags-apropos by setting
the new variable tags-apropos-additional-actions.

If non-nil, the variable's value should be a list of triples (TITLE
FUNCTION TO-SEARCH).  For each triple, M-x tags-apropos processes
TO-SEARCH and lists tags from it.  TO-SEARCH should be an alist,
obarray, or symbol.  If it is a symbol, the symbol's value is used.

TITLE is a string to use to label the list of tags from TO-SEARCH.

FUNCTION is a function to call when an entry is selected in the Tags
List buffer.  It is called with one argument, the selected symbol.

A useful example value for this variable might be something like:

  '(("Emacs Lisp" Info-goto-emacs-command-node obarray)
    ("Common Lisp" common-lisp-hyperspec common-lisp-hyperspec-obarray)
    ("SCWM" scwm-documentation scwm-obarray))

*** The face tags-tag-face can be used to customize the appearance
of tags in the output of M-x tags-apropos.

*** Setting tags-apropos-verbose to a non-nil value displays the
names of tags files in the *Tags List* buffer.

956 957 958 959
** Emacs now attempts to determine the initial language environment
and preferred and locale coding systems systematically from the
LC_ALL, LC_CTYPE, and LANG environment variables during startup.

Dave Love's avatar
Dave Love committed
960 961 962 963
** New language environments `Polish', `Latin-8' and `Latin-9'.
Latin-8 and Latin-9 correspond respectively to the ISO character sets
8859-14 (Celtic) and 8859-15 (updated Latin-1, with the Euro sign).
There is currently no specific input method support for them.
Dave Love's avatar
Dave Love committed
964

Dave Love's avatar
Dave Love committed
965 966 967 968 969 970
** Fortran mode has a new command `fortran-strip-sqeuence-nos' to
remove text past column 72.  The syntax class of `\' in Fortran is now
appropriate for C-style escape sequences in strings.

** SGML mode's default `sgml-validate-command' is now `nsgmls'.

Dave Love's avatar
Dave Love committed
971 972
** A new command `view-emacs-problems' (C-h P) displays the PROBLEMS file.

Gerd Moellmann's avatar
Gerd Moellmann committed
973 974 975 976
** The Dabbrev package has a new user-option `dabbrev-ignore-regexps'
containing a list of regular expressions.  Buffers matching a regular
expression from that list, are not checked.

Dave Love's avatar
#  
Dave Love committed
977 978
** New modes and packages

979 980 981 982
*** The comment operations are now provided by the newcomment.el
package which allows different styles of comment-region and should
be more robust while offering the same functionality.

Gerd Moellmann's avatar
Gerd Moellmann committed
983 984 985 986
*** The Ebrowse package implements a C++ class browser and tags
facilities tailored for use with C++.  It is documented in a
separate Texinfo file.

Stefan Monnier's avatar
Stefan Monnier committed
987 988 989 990 991 992
*** The PCL-CVS package available by either running M-x cvs-examine
or by visiting a CVS administrative directory (with a prefix argument)
provides an alternative interface to VC-dired for CVS.
It comes with log-view-mode to view RCS and SCCS logs and log-edit-mode
used to enter checkin log messages.

Eli Zaretskii's avatar
Eli Zaretskii committed
993 994 995 996 997 998 999
*** The new package called `woman' allows to browse Unix man pages
without invoking external programs.

The command `M-x woman' formats manual pages entirely in Emacs Lisp
and then displays them, like `M-x manual-entry' does.  Unlike
`manual-entry', `woman' does not invoke any external programs, so it
is useful on systems such as MS-DOS/MS-Windows where the `man' and
1000
Groff or `troff' commands are not readily available.
Eli Zaretskii's avatar
Eli Zaretskii committed
1001 1002 1003 1004

The command `M-x woman-find-file' asks for the file name of a man
page, then formats and displays it like `M-x woman' does.

Gerd Moellmann's avatar
Gerd Moellmann committed
1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019
*** The new command M-x re-builder offers a convenient interface for
authoring regular expressions with immediate visual feedback.

The buffer from which the command was called becomes the target for
the regexp editor popping up in a separate window.  Matching text in
the target buffer is immediately color marked during the editing.
Each sub-expression of the regexp will show up in a different face so
even complex regexps can be edited and verified on target data in a
single step.

On displays not supporting faces the matches instead blink like
matching parens to make them stand out.  On such a setup you will
probably also want to use the sub-expression mode when the regexp
contains such to get feedback about their respective limits.

Gerd Moellmann's avatar
Gerd Moellmann committed
1020 1021 1022 1023
*** glasses-mode is a minor mode that makes
unreadableIdentifiersLikeThis readable.  It works as glasses, without
actually modifying content of a buffer.

Gerd Moellmann's avatar
Gerd Moellmann committed
1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055
*** The package ebnf2ps translates an EBNF to a syntactic chart in
PostScript.

Currently accepts ad-hoc EBNF, ISO EBNF and Bison/Yacc.

The ad-hoc default EBNF syntax has the following elements:

    ;		comment (until end of line)
    A		non-terminal
    "C"		terminal
    ?C?		special
    $A		default non-terminal
    $"C"	default terminal
    $?C?	default special
    A = B.	production (A is the header and B the body)
    C D		sequence (C occurs before D)
    C | D	alternative (C or D occurs)
    A - B	exception (A excluding B, B without any non-terminal)
    n * A	repetition (A repeats n (integer) times)
    (C)		group (expression C is grouped together)
    [C]		optional (C may or not occurs)
    C+		one or more occurrences of C
    {C}+	one or more occurrences of C
    {C}*	zero or more occurrences of C
    {C}		zero or more occurrences of C
    C / D	equivalent to: C {D C}*
    {C || D}+	equivalent to: C {D C}*
    {C || D}*	equivalent to: [C {D C}*]
    {C || D}	equivalent to: [C {D C}*]

Please, see ebnf2ps documentation for EBNF syntax and how to use it.

Gerd Moellmann's avatar
Gerd Moellmann committed
1056 1057 1058 1059 1060 1061
*** The package align.el will align columns within a region, using M-x
align.  Its mode-specific rules, based on regular expressions,
determine where the columns should be split.  In C and C++, for
example, it will align variable names in declaration lists, or the
equal signs of assignments.

1062 1063 1064
*** `paragraph-indent-minor-mode' is a new minor mode supporting
paragraphs in the same style as `paragraph-indent-text-mode'.

Gerd Moellmann's avatar
Gerd Moellmann committed
1065 1066 1067 1068 1069
*** bs.el is a new package for buffer selection similar to
list-buffers or electric-buffer-list.  Use M-x bs-show to display a
buffer menu with this package.  You can use M-x bs-customize to
customize the package.

Gerd Moellmann's avatar
Gerd Moellmann committed
1070 1071 1072 1073 1074 1075 1076
*** calculator.el is a small calculator package that is intended to
replace desktop calculators such as xcalc and calc.exe.  Actually, it
is not too small - it has more features than most desktop calculators,
and can be customized easily to get many more functions.  It should
not be confused with "calc" which is a much bigger mathematical tool
which answers different needs.

1077 1078 1079 1080 1081 1082 1083
*** The minor modes cwarn-mode and global-cwarn-mode highlights
suspicious C and C++ constructions.  Currently, assignments inside
expressions, semicolon following `if', `for' and `while' (except, of
course, after a `do .. while' statement), and C++ functions with
reference parameters are recognized.  The modes require font-lock mode
to be enabled.

Stefan Monnier's avatar
Stefan Monnier committed
1084 1085 1086
*** smerge-mode.el provides `smerge-mode', a simple minor-mode for files
containing diff3-style conflict markers, such as generated by RCS.

Dave Love's avatar
#  
Dave Love committed
1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100
*** 5x5.el is a simple puzzle game.

*** hl-line.el provides a minor mode to highlight the current line.

*** ansi-color.el translates ANSI terminal escapes into text-properties.

*** delphi.el provides a major mode for editing the Delphi (Object
Pascal) language.

*** quickurl.el provides a simple method of inserting a URL based on
the text at point.

*** sql.el provides an interface to SQL data bases.

Dave Love's avatar
Dave Love committed
1101 1102
*** fortune.el uses the fortune program to create mail/news signatures.

Dave Love's avatar
#  
Dave Love committed
1103 1104
*** whitespace.el ???

Gerd Moellmann's avatar
Gerd Moellmann committed
1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157
*** PostScript mode (ps-mode) is a new major mode for editing PostScript
files. It offers: interaction with a PostScript interpreter, including
(very basic) error handling; fontification, easily customizable for
interpreter messages; auto-indentation; insertion of EPSF templates and
often used code snippets; viewing of BoundingBox; commenting out /
uncommenting regions; conversion of 8bit characters to PostScript octal
codes. All functionality is accessible through a menu.

*** delim-col helps to prettify columns in a text region or rectangle.

Here is an example of columns:

horse	apple	bus
dog	pineapple	car	EXTRA
porcupine	strawberry	airplane

Doing the following settings:

   (setq delimit-columns-str-before "[ ")
   (setq delimit-columns-str-after " ]")
   (setq delimit-columns-str-separator ", ")
   (setq delimit-columns-separator "\t")


Selecting the lines above and typing:

   M-x delimit-columns-region

It results:

[ horse    , apple     , bus     ,       ]
[ dog      , pineapple , car     , EXTRA ]
[ porcupine, strawberry, airplane,       ]

delim-col has the following options:

   delimit-columns-str-before		Specify a string to be inserted
					before all columns.

   delimit-columns-str-separator	Specify a string to be inserted
					between each column.

   delimit-columns-str-after		Specify a string to be inserted
					after all columns.

   delimit-columns-separator		Specify a regexp which separates
					each column.

delim-col has the following commands:

   delimit-columns-region	Prettify all columns in a text region.
   delimit-columns-rectangle	Prettify all columns in a text rectangle.

Gerd Moellmann's avatar
Gerd Moellmann committed
1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171
*** The package recentf.el maintains a menu for visiting files that
were operated on recently.  When enabled, a new "Open Recent" submenu
is displayed in the "Files" menu.

The recent files list is automatically saved across Emacs sessions.

To enable/disable recentf use M-x recentf-mode.

To enable recentf at Emacs startup use
M-x customize-variable RET recentf-mode RET.

To change the number of recent files displayed and others options use
M-x customize-group RET recentf RET.

Dave Love's avatar
Dave Love committed
1172 1173 1174
*** elide-head.el provides a mechanism for eliding boilerplate header
text.

Dave Love's avatar
Dave Love committed
1175
*** footnote.el provides `footnote-mode', a minor mode supporting use
Dave Love's avatar
Dave Love committed
1176 1177 1178
of footnotes.  It is intended for use with Message mode, but isn't
specific to Message mode.

Dave Love's avatar
Dave Love committed
1179 1180 1181 1182
*** diff-mode.el provides `diff-mode', a major mode for
viewing/editing context diffs (patches).  It is selected for files
with extension `.diff', `.diffs', `.patch' and `.rej'.

1183 1184 1185 1186
*** EUDC, the Emacs Unified Directory Client, provides a common user
interface to access directory servers using different directory
protocols.  It has a separate manual.

Dave Love's avatar
Dave Love committed
1187 1188 1189
*** autoconf.el provides a major mode for editing configure.in files
for Autoconf, selected automatically.

Gerd Moellmann's avatar
Gerd Moellmann committed
1190 1191 1192 1193
*** windmove.el provides moving between windows.

*** crm.el provides a facility to read multiple strings from the 
minibuffer with completion.
1194

Dave Love's avatar
Dave Love committed
1195 1196 1197
*** todo-mode.el provides management of TODO lists and integration
with the diary features.

Dave Love's avatar
Dave Love committed
1198 1199 1200
*** autoarg.el provides a feature reported from Twenex Emacs whereby
numeric keys supply prefix args rather than self inserting.

Dave Love's avatar
#  
Dave Love committed
1201 1202 1203 1204
** Withdrawn packages

*** mldrag.el has been removed.  mouse.el provides the same
functionality with aliases for the mldrag functions.
Dave Love's avatar
Dave Love committed
1205

Dave Love's avatar
Dave Love committed
1206 1207 1208
*** eval-reg.el has been obsoleted by changes to edebug.el and removed.

*** ph.el has been obsoleted by EUDC and removed.
Gerd Moellmann's avatar
Gerd Moellmann committed
1209 1210 1211 1212 1213


* Lisp changes made after edition 2.6 of the Emacs Lisp Manual,
(Display-related features are described in a page of their own below.)

Dave Love's avatar
Dave Love committed
1214
** The function `subr-arity' provides information on the argument list
Dave Love's avatar
Dave Love committed
1215 1216
of a primitive.

Dave Love's avatar
Dave Love committed
1217 1218 1219 1220 1221
** The text property `keymap' specifies a key map which overrides the
buffer's local map and the map specified by the `local-map' property.
This is probably what most current uses of `local-map' want, rather
than replacing the local map.

1222 1223
** The obsolete variables before-change-function and
after-change-function are no longer acted upon and have been removed.
Gerd Moellmann's avatar
Gerd Moellmann committed
1224 1225 1226

** The function `apropos-mode' runs the hook `apropos-mode-hook'.

Dave Love's avatar
#  
Dave Love committed
1227 1228 1229 1230 1231 1232 1233 1234

* Lisp changes in Emacs 21.1 (see following page for display-related features)

Note that +++ before an item means the Lisp manual has been updated.
--- means that I have decided it does not need to be in the Lisp manual.
When you add a new item, please add it without either +++ or ---
so I will know I still need to look at it -- rms.

Dave Love's avatar
Dave Love committed
1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326
*** The functions `find-charset-region' and `find-charset-string' include
`eight-bit-control' and/or `eight-bit-graphic' in the returned list
when it finds 8-bit characters.  Previously, it included `ascii' in a
multibyte buffer and `unknown' in a unibyte buffer.

*** The functions `set-buffer-modified', `string-as-multibyte' and
`string-as-unibyte' change the byte sequence of a buffer if it
contains a character from the `eight-bit-control' character set.

*** The handling of multibyte sequences in a multibyte buffer is
changed.  Previously, a byte sequence matching the pattern
[\200-\237][\240-\377]+ was interpreted as a single character
regardless of the length of the trailing bytes [\240-\377]+.  Thus, if
the sequence was longer than what the leading byte indicated, the
extra trailing bytes were ignored by Lisp functions.  Now such extra
bytes are independent 8-bit characters belonging to the charset
eight-bit-graphic.

** Fontsets are now implemented using char-tables.

A fontset can now be specified for for each independent character, for
a group of characters or for a character set rather than just for a
character set as previously.

*** The arguments of the function `set-fontset-font' are changed.
They are NAME, CHARACTER, FONTNAME, and optional FRAME.  The function
modifies fontset NAME to use FONTNAME for CHARACTER.

CHARACTER may be a cons (FROM . TO), where FROM and TO are non-generic
characters.  In that case FONTNAME is used for all characters in the
range FROM and TO (inclusive).  CHARACTER may be a charset.  In that
case FONTNAME is used for all character in the charset.

FONTNAME may be a cons (FAMILY . REGISTRY), where FAMILY is the family
name of a font and REGSITRY is a registry name of a font.

*** Variable x-charset-registry has been deleted.  The default charset
registries of character sets are set in the default fontset
"fontset-default".

*** The function `create-fontset-from-fontset-spec' ignores the second
argument STYLE-VARIANT.  It never creates style-variant fontsets.

** The method of composing characters is changed.  Now character
composition is done by a special text property `composition' in
buffers and strings.

*** Charset composition is deleted.  Emacs never creates a `composite
character' which is an independent character with a unique character
code.  Thus the following functions handling `composite characters'
have been deleted: composite-char-component,
composite-char-component-count, composite-char-composition-rule,
composite-char-composition-rule and decompose-composite-char delete.
The variables leading-code-composition and min-composite-char have
also been deleted.

*** Three more glyph reference points are added.  They can be used to
specify a composition rule.  See the documentation of the variable
`reference-point-alist' for more detail.

*** The function `compose-region' takes new arguments COMPONENTS and
MODIFICATION-FUNC.  With COMPONENTS, you can specify not only a
composition rule but also characters to be composed.  Such characters
may differ between buffer and string text.

*** The function `compose-string' takes new arguments START, END,
COMPONENTS, and MODIFICATION-FUNC.

*** The function `compose-string' puts text property `composition'
directly on the argument STRING instead of returning a new string.
Likewise, the function `decompose-string' just removes text property
`composition' from STRING.

*** The new function `find-composition' returns information about
a composition at a specified position in a buffer or a string.

*** The function `decompose-composite-char' is now labeled as
obsolete.

** The new character set `mule-unicode-0100-24ff' is introduced for
Unicode characters of the range U+0100..U+24FF.  Currently, this
character set is not used.

** The new character sets `japanese-jisx0213-1' and
`japanese-jisx0213-2' are introduced for the new Japanese standard JIS
X 0213 Plane 1 and Plane 2.

+++
** The new character sets `eight-bit-control' and `eight-bit-graphic'
are introduced for 8-bit characters in the ranges 0x80..0x9F and
0xA0..0xFF repectively.

Dave Love's avatar
Dave Love committed
1327
+++
Dave Love's avatar
Dave Love committed
1328 1329 1330
** If the APPEND argument of `write-region' is an integer, it seeks to
that offset in the file before writing.

Dave Love's avatar
Dave Love committed
1331 1332 1333
** `concat' no longer accepts individual integer arguments, as
promised long ago.

Gerd Moellmann's avatar
Gerd Moellmann committed
1334 1335 1336
** The function `add-minor-mode' simplifies the definition of minor
modes.

Gerd Moellmann's avatar
Gerd Moellmann committed
1337
- Function: add-minor-mode TOGGLE NAME &optional KEYMAP AFTER TOGGLE-FUN
Gerd Moellmann's avatar
Gerd Moellmann committed
1338

Gerd Moellmann's avatar
Gerd Moellmann committed
1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355
Register a new minor mode.

TOGGLE is a symbol which is the name of a buffer-local variable that
is toggled on or off to say whether the minor mode is active or not.

NAME specifies what will appear in the mode line when the minor mode
is active.  NAME should be either a string starting with a space, or a
symbol whose value is such a string.

Optional KEYMAP is the keymap for the minor mode that will be added
to `minor-mode-map-alist'.

Optional AFTER specifies that TOGGLE should be added after AFTER
in `minor-mode-alist'.

Optional TOGGLE-FUN is there for compatiblity with other Emacssen.
It is currently not used.
Gerd Moellmann's avatar
Gerd Moellmann committed
1356

Gerd Moellmann's avatar
Gerd Moellmann committed
1357 1358 1359 1360 1361 1362 1363 1364 1365 1366
** The function `shell-command' now sets the default directory of the
`*Shell Command Output*' buffer to the default directory of the buffer
from which the command was issued.

** The functions `query-replace', `query-replace-regexp',
`query-replace-regexp-eval' `map-query-replace-regexp',
`replace-string', `replace-regexp', and `perform-replace' take two
additional optional arguments START and END that specify the region to
operate on.

Gerd Moellmann's avatar
Gerd Moellmann committed
1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390
** The new function `count-screen-lines' is a more flexible alternative
to `window-buffer-height'.

- Function: count-screen-lines &optional BEG END COUNT-FINAL-NEWLINE WINDOW

Return the number of screen lines in the region between BEG and END.
The number of screen lines may be different from the number of actual
lines, due to line breaking, display table, etc.

Optional arguments BEG and END default to `point-min' and `point-max'
respectively.

If region ends with a newline, ignore it unless optinal third argument
COUNT-FINAL-NEWLINE is non-nil.

The optional fourth argument WINDOW specifies the window used for
obtaining parameters such as width, horizontal scrolling, and so
on. The default is to use the selected window's parameters.

Like `vertical-motion', `count-screen-lines' always uses the current
buffer, regardless of which buffer is displayed in WINDOW. This makes
possible to use `count-screen-lines' in any buffer, whether or not it
is currently displayed in some window.

Dave Love's avatar
mapc  
Dave Love committed
1391 1392 1393
** The new function `mapc' is like `mapcar' but doesn't collect the
argument function's results.

Gerd Moellmann's avatar
Gerd Moellmann committed
1394 1395 1396
** The functions base64-decode-region and base64-decode-string now
signal an error instead of returning nil if decoding fails.

Gerd Moellmann's avatar
Gerd Moellmann committed
1397 1398 1399 1400 1401 1402 1403
** The function sendmail-user-agent-compose now recognizes a `body'
header is the list of headers passed to it.

** The new function member-ignore-case works like `member', but
ignores differences in case and text representation.

** The buffer-local variable cursor-type can be used to specify the
Gerd Moellmann's avatar
Gerd Moellmann committed
1404 1405 1406 1407 1408 1409 1410 1411 1412
cursor to use in windows displaying a buffer.  Values are interpreted
as follows:

  t 		use the cursor specified for the frame (default)
  nil		don't display a cursor
  `bar'		display a bar cursor with default width
  (bar . WIDTH)	display a bar cursor with width WIDTH
  others	display a box cursor.

Gerd Moellmann's avatar
Gerd Moellmann committed
1413 1414 1415 1416 1417
** The variable open-paren-in-column-0-is-defun-start controls whether
an open parenthesis in column 0 is considered to be the start of a
defun.  If set, the default, it is considered a defun start.  If not
set, an open parenthesis in column 0 has no special meaning.

Gerd Moellmann's avatar
Gerd Moellmann committed
1418
** The new function `string-to-syntax' can be used to translate syntax
Stefan Monnier's avatar
Stefan Monnier committed
1419
specifications in string form as accepted by `modify-syntax-entry' to
Gerd Moellmann's avatar
Gerd Moellmann committed
1420 1421 1422 1423 1424 1425 1426 1427
the cons-cell form that is used for the values of the `syntax-table'
text property, and in `font-lock-syntactic-keywords'.

Example:

  (string-to-syntax "()")
    => (4 . 41)

Gerd Moellmann's avatar
Gerd Moellmann committed
1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455
** Emacs' reader supports CL read syntax for integers in bases
other than 10.

*** `#BINTEGER' or `#bINTEGER' reads INTEGER in binary (radix 2).
INTEGER optionally contains a sign.

  #b1111 
    => 15
  #b-1111 
    => -15

*** `#OINTEGER' or `#oINTEGER' reads INTEGER in octal (radix 8).

  #o666 
    => 438

*** `#XINTEGER' or `#xINTEGER' reads INTEGER in hexadecimal (radix 16).

  #xbeef 
    => 48815

*** `#RADIXrINTEGER' reads INTEGER in radix RADIX, 2 <= RADIX <= 36.

  #2R-111 
    => -7
  #25rah 
    => 267

Gerd Moellmann's avatar
Gerd Moellmann committed
1456
** The function `documentation-property' now evaluates the value of
Gerd Moellmann's avatar
Gerd Moellmann committed
1457 1458 1459
the given property to obtain a a string if it doesn't refer to etc/DOC
and isn't a string.

Gerd Moellmann's avatar
Gerd Moellmann committed
1460 1461 1462 1463 1464
** If called for a symbol, the function `documentation' now looks for
a `function-documentation' property of that symbol.  If it has a non-nil
value, the documentation is taken from that value.  If the value is
not a string, it is evaluated to obtain a string.

1465 1466 1467
+++
** The last argument of `define-key-after' defaults to t for convenience.

Dave Love's avatar
Dave Love committed
1468
** The new function `replace-regexp-in-string' replaces all matches
1469 1470 1471 1472 1473
for a regexp in a string.

** `mouse-position' now runs the abnormal hook
`mouse-position-function'.

Gerd Moellmann's avatar
Gerd Moellmann committed
1474 1475 1476
** The function string-to-number now returns a float for numbers
that don't fit into a Lisp integer.

Gerd Moellmann's avatar
Gerd Moellmann committed
1477 1478 1479
** The variable keyword-symbols-constants-flag has been removed.
Keywords are now always considered constants.

Dave Love's avatar
Dave Love committed
1480 1481 1482 1483
+++
** The new function `delete-and-extract-region' deletes text and
returns it.

Gerd Moellmann's avatar
Gerd Moellmann committed
1484 1485 1486
** The function `clear-this-command-keys' now also clears the vector
returned by function `recent-keys'.

1487 1488 1489 1490 1491 1492
+++
** Variables `beginning-of-defun-function' and `end-of-defun-function'
can be used to define handlers for the functions that find defuns.
Major modes can define these locally instead of rebinding M-C-a
etc. if the normal conventions for defuns are not appropriate for the
mode.
Dave Love's avatar
Dave Love committed
1493

1494
+++
Stefan Monnier's avatar
Stefan Monnier committed
1495 1496 1497
** easy-mmode-define-minor-mode now takes an additional BODY argument
and is renamed `define-minor-mode'.

1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508
+++
** If an abbrev has a hook function which is a symbol, and that symbol
has a non-nil `no-self-insert' property, the return value of the hook
function specifies whether an expansion has been done or not.  If it
returns nil, abbrev-expand also returns nil, meaning "no expansion has
been performed."

When abbrev expansion is done by typing a self-inserting character,
and the abbrev has a hook with the `no-self-insert' property, and the
hook function returns non-nil meaning expansion has been done,
then the self-inserting character is not inserted.
1509

1510
+++
Gerd Moellmann's avatar
Gerd Moellmann committed
1511 1512 1513 1514
** The function `intern-soft' now accepts a symbol as first argument.
In this case, that exact symbol is looked up in the specified obarray,
and the function's value is nil if it is not found.

1515
+++
Gerd Moellmann's avatar
Gerd Moellmann committed
1516 1517 1518 1519 1520 1521 1522
** The new macro `with-syntax-table' can be used to evaluate forms
with the syntax table of the current buffer temporarily set to a
specified table.

  (with-syntax-table TABLE &rest BODY)

Evaluate BODY with syntax table of current buffer set to a copy of
Gerd Moellmann's avatar
Gerd Moellmann committed
1523 1524 1525
TABLE.  The current syntax table is saved, BODY is evaluated, and the
saved table is restored, even in case of an abnormal exit.  Value is
what BODY returns.
Gerd Moellmann's avatar
Gerd Moellmann committed
1526

1527
+++
Stefan Monnier's avatar
Stefan Monnier committed
1528
** Regular expressions now support intervals \{n,m\} as well as
Stefan Monnier's avatar
Stefan Monnier committed
1529
Perl's shy-groups \(?:...\) and non-greedy *? +? and ?? operators.
Stefan Monnier's avatar
Stefan Monnier committed
1530

1531
+++
1532 1533 1534
** The optional argument BUFFER of function file-local-copy has been
removed since it wasn't used by anything.

1535
+++
1536 1537 1538
** The file name argument of function `file-locked-p' is now required
instead of being optional.

1539
+++
1540 1541 1542
** The new built-in error `text-read-only' is signaled when trying to
modify read-only text.

1543
+++
1544 1545 1546 1547
** New functions and variables for locales.

The new variable `locale-coding-system' specifies how to encode and
decode strings passed to low-level message functions like strerror and
1548 1549 1550
time functions like strftime.  The new variables
`system-messages-locale' and `system-time-locale' give the system
locales to be used when invoking these two types of functions.
1551 1552 1553 1554

The new function `set-locale-environment' sets the language
environment, preferred coding system, and locale coding system from
the system locale as specified by the LC_ALL, LC_CTYPE, and LANG
1555 1556 1557 1558
environment variables.  Normally, it is invoked during startup and need
not be invoked thereafter.  It uses the new variables
`locale-language-names', `locale-charset-language-names', and
`locale-preferred-coding-systems' to make its decisions.
1559

1560
+++
Stefan Monnier's avatar
Stefan Monnier committed
1561 1562 1563 1564 1565
** syntax tables now understand nested comments.
To declare a comment syntax as allowing nesting, just add an `n'
modifier to either of the characters of the comment end and the comment
start sequences.

1566
+++
1567 1568 1569
** The function `pixmap-spec-p' has been renamed `bitmap-spec-p'
because `bitmap' is more in line with the usual X terminology.

1570
+++
Dave Love's avatar
#  
Dave Love committed
1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587
** New function `propertize'

The new function `propertize' can be used to conveniently construct
strings with text properties.

- Function: propertize STRING &rest PROPERTIES

Value is a copy of STRING with text properties assigned as specified
by PROPERTIES.  PROPERTIES is a sequence of pairs PROPERTY VALUE, with
PROPERTY being the name of a text property and VALUE being the
specified value of that property.  Example:

  (propertize "foo" 'face 'bold 'read-only t)

+++
** push and pop macros.

1588 1589
Simple versions of the push and pop macros of Common Lisp
are now defined in Emacs Lisp.  These macros allow only symbols
Dave Love's avatar
#  
Dave Love committed
1590 1591 1592 1593 1594 1595
as the place that holds the list to be changed.

(push NEWELT LISTNAME)  add NEWELT to the front of LISTNAME's value.
(pop LISTNAME)          return first elt of LISTNAME, and remove it
			(thus altering the value of LISTNAME).

1596 1597
** New dolist and dotimes macros.

1598 1599
Simple versions of the dolist and dotimes macros of Common Lisp
are now defined in Emacs Lisp.
1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610

(dolist (VAR LIST [RESULT]) BODY...)
      Execute body once for each element of LIST,
      using the variable VAR to hold the current element.
      Then return the value of RESULT, or nil if RESULT is omitted.

(dotimes (VAR COUNT [RESULT]) BODY...)
      Execute BODY with VAR bound to successive integers running from 0,
      inclusive, to COUNT, exclusive.
      Then return the value of RESULT, or nil if RESULT is omitted.

Dave Love's avatar
#  
Dave Love committed
1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726
+++
** Regular expressions now support Posix character classes such
as [:alpha:], [:space:] and so on.

[:digit:]  matches 0 through 9
[:cntrl:]  matches ASCII control characters
[:xdigit:]  matches 0 through 9, a through f and A through F.
[:blank:]  matches space and tab only
[:graph:]  matches graphic characters--everything except ASCII control chars,
	   space, and DEL.
[:print:]  matches printing characters--everything except ASCII control chars
	   and DEL.
[:alnum:]  matches letters and digits.
	   (But at present, for multibyte characters,
	    it matches anything that has word syntax.)
[:alpha:]  matches letters.
	   (But at present, for multibyte characters,
	    it matches anything that has word syntax.)
[:ascii:]  matches ASCII (unibyte) characters.
[:nonascii:]  matches non-ASCII (multibyte) characters.
[:lower:]  matches anything lower-case.
[:punct:]  matches punctuation.
	   (But at present, for multibyte characters,
	    it matches anything that has non-word syntax.)
[:space:]  matches anything that has whitespace syntax.
[:upper:]  matches anything upper-case.
[:word:]   matches anything that has word syntax.

+++
** Emacs now has built-in hash tables.

The following functions are defined for hash tables:

- Function: make-hash-table ARGS

The argument list ARGS consists of keyword/argument pairs.  All arguments
are optional.  The following arguments are defined:

:test TEST

TEST must be a symbol specifying how to compare keys.  Default is `eql'.
Predefined are `eq', `eql' and `equal'.  If TEST is not predefined,
it must have been defined with `define-hash-table-test'.

:size SIZE

SIZE must be an integer > 0 giving a hint to the implementation how
many elements will be put in the hash table.  Default size is 65.

:rehash-size REHASH-SIZE

REHASH-SIZE specifies by how much to grow a hash table once it becomes
full.  If REHASH-SIZE is an integer, add that to the hash table's old
size to get the new size.  Otherwise, REHASH-SIZE must be a float >
1.0, and the new size is computed by multiplying REHASH-SIZE with the
old size.  Default rehash size is 1.5.

:rehash-threshold THRESHOLD

THRESHOLD must be a float > 0 and <= 1.0 specifying when to resize the
hash table.  It is resized when the ratio of (number of entries) /
(size of hash table) is >= THRESHOLD.  Default threshold is 0.8.

:weakness WEAK

WEAK must be either nil, one of the symbols `key, `value', or t.
Entries are removed from weak tables during garbage collection if
their key and/or value are not referenced elsewhere outside of the
hash table.  Default are non-weak hash tables.

- Function: makehash &optional TEST

Similar to make-hash-table, but only TEST can be specified.

- Function: hash-table-p TABLE

Returns non-nil if TABLE is a hash table object.

- Function: copy-hash-table TABLE

Returns a copy of TABLE.  Only the table itself is copied, keys and
values are shared.

- Function: hash-table-count TABLE

Returns the number of entries in TABLE.

- Function: hash-table-rehash-size TABLE

Returns the rehash size of TABLE.

- Function: hash-table-rehash-threshold TABLE

Returns the rehash threshold of TABLE.

- Function: hash-table-rehash-size TABLE

Returns the size of TABLE.

- Function: hash-table-rehash-test TABLE

Returns the test TABLE uses to compare keys.

- Function: hash-table-weakness TABLE

Returns the weakness specified for TABLE.

- Function: clrhash TABLE

Clear TABLE.

- Function: gethash KEY TABLE &optional DEFAULT

Look up KEY in TABLE and return its associated VALUE or DEFAULT if
not found.

Francesco Potortì's avatar
etags:  
Francesco Potortì committed
1727
- Function: puthash KEY VALUE TABLE
Dave Love's avatar
#  
Dave Love committed
1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748

Associate KEY with VALUE in TABLE.  If KEY is already associated with
another value, replace the old value with VALUE.

- Function: remhash KEY TABLE

Remove KEY from TABLE if it is there.

- Function: maphash FUNCTION TABLE

Call FUNCTION for all elements in TABLE.  FUNCTION must take two
arguments KEY and VALUE.

- Function: sxhash OBJ

Return a hash code for Lisp object OBJ.

- Function: define-hash-table-test NAME TEST-FN HASH-FN

Define a new hash table test named NAME.  If NAME is specified as
a test in `make-hash-table', the table created will use TEST-FN for
Francesco Potortì's avatar
etags:  
Francesco Potortì committed
1749
comparing keys, and HASH-FN to compute hash codes for keys.  Test
Dave Love's avatar
#  
Dave Love committed
1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767
and hash function are stored as symbol property `hash-table-test'
of NAME with a value of (TEST-FN HASH-FN).

TEST-FN must take two arguments and return non-nil if they are the same.

HASH-FN must take one argument and return an integer that is the hash
code of the argument.  The function should use the whole range of
integer values for hash code computation, including negative integers.

Example: The following creates a hash table whose keys are supposed to
be strings that are compared case-insensitively.

  (defun case-fold-string= (a b)
    (compare-strings a nil nil b nil nil t))

  (defun case-fold-string-hash (a)
    (sxhash (upcase a)))

Francesco Potortì's avatar
etags:  
Francesco Potortì committed
1768
  (define-hash-table-test 'case-fold 'case-fold-string=
Dave Love's avatar
#  
Dave Love committed
1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865
                          'case-fold-string-hash))

  (make-hash-table :test 'case-fold)

+++
** The Lisp reader handles circular structure.

It now works to use the #N= and #N# constructs to represent
circular structures.  For example, #1=(a . #1#) represents
a cons cell which is its own cdr.

+++
** The Lisp printer handles circular structure.

If you bind print-circle to a non-nil value, the Lisp printer outputs
#N= and #N# constructs to represent circular and shared structure.

+++
** If the second argument to `move-to-column' is anything but nil or
t, that means replace a tab with spaces if necessary to reach the
specified column, but do not add spaces at the end of the line if it
is too short to reach that column.

+++
** perform-replace has a new feature:  the REPLACEMENTS argument may
now be a cons cell (FUNCTION . DATA).  This means to call FUNCTION
after each match to get the replacement text.  FUNCTION is called with
two arguments: DATA, and the number of replacements already made.

If the FROM-STRING contains any upper-case letters,
perform-replace also turns off `case-fold-search' temporarily
and inserts the replacement text without altering case in it.

+++
** The function buffer-size now accepts an optional argument
to specify which buffer to return the size of.

+++
** The calendar motion commands now run the normal hook
calendar-move-hook after moving point.

+++
** The new variable small-temporary-file-directory specifies a
directory to use for creating temporary files that are likely to be
small.  (Certain Emacs features use this directory.)  If
small-temporary-file-directory is nil, they use
temporary-file-directory instead.

+++
** The variable `inhibit-modification-hooks', if non-nil, inhibits all
the hooks that track changes in the buffer.  This affects
`before-change-functions' and `after-change-functions', as well as
hooks attached to text properties and overlay properties.

+++
** assoc-delete-all is a new function that deletes all the
elements of an alist which have a particular value as the car.

+++
** make-temp-file provides a more reliable way to create a temporary file.

make-temp-file is used like make-temp-name, except that it actually
creates the file before it returns.  This prevents a timing error,
ensuring that no other job can use the same name for a temporary file.

+++
** New exclusive-open feature in `write-region'

The optional seventh arg is now called MUSTBENEW.  If non-nil, it insists
on a check for an existing file with the same name.  If MUSTBENEW
is `excl', that means to get an error if the file already exists;
never overwrite. If MUSTBENEW is neither nil nor `excl', that means
ask for confirmation before overwriting, but do go ahead and
overwrite the file if the user gives confirmation.

If the MUSTBENEW argument in `write-region' is `excl',
that means to use a special feature in the `open' system call
to get an error if the file exists at that time.
The error reported is `file-already-exists'.

+++
** Function `format' now handles text properties.

Text properties of the format string are applied to the result string.
If the result string is longer than the format string, text properties
ending at the end of the format string are extended to the end of the
result string.

Text properties from string arguments are applied to the result
string where arguments appear in the result string.

Example:

  (let ((s1 "hello, %s")
        (s2 "world"))
     (put-text-property 0 (length s1) 'face 'bold s1)
     (put-text-property 0 (length s2) 'face 'italic s2)
Gerd Moellmann's avatar
Gerd Moellmann committed
1866
     (format s1 s2))
Dave Love's avatar
#  
Dave Love committed
1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905

results in a bold-face string with an italic `world' at the end.

+++
** Messages can now be displayed with text properties.

Text properties are handled as described above for function `format'.
The following example displays a bold-face message with an italic
argument in it.

  (let ((msg "hello, %s!")
        (arg "world"))
     (put-text-property 0 (length msg) 'face 'bold msg)
     (put-text-property 0 (length arg) 'face 'italic arg)
     (message msg arg))

+++
** Sound support

Emacs supports playing sound files on GNU/Linux and the free BSDs
(Voxware driver and native BSD driver, aka as Luigi's driver).

Currently supported file formats are RIFF-WAVE (*.wav) and Sun Audio
(*.au).  You must configure Emacs with the option `--with-sound=yes'
to enable sound support.

Sound files can be played by calling (play-sound SOUND).  SOUND is a
list of the form `(sound PROPERTY...)'.  The function is only defined
when sound support is present for the system on which Emacs runs.  The
functions runs `play-sound-functions' with one argument which is the
sound to play, before playing the sound.

The following sound properties are supported:

- `:file FILE'

FILE is a file name.  If FILE isn't an absolute name, it will be
searched relative to `data-directory'.

Gerd Moellmann's avatar
Gerd Moellmann committed
1906 1907 1908 1909 1910
- `:data DATA'

DATA is a string containing sound data.  Either :file or :data
may be present, but not both.

Dave Love's avatar
#  
Dave Love committed
1911 1912 1913 1914 1915 1916 1917 1918
- `:volume VOLUME'

VOLUME must be an integer in the range 0..100 or a float in the range
0..1.  This property is optional.

Other properties are ignored.

** `multimedia' is a new Finder keyword and Custom group.
Dave Love's avatar
Dave Love committed
1919 1920 1921

** keywordp is a new predicate to test efficiently for an object being
a keyword s