NEWS.1-17 96.6 KB
Newer Older
Dave Love's avatar
Dave Love committed
GNU Emacs NEWS -- history of user-visible changes.  26-Mar-1986

Paul Eggert's avatar
Paul Eggert committed
Copyright (C) 1985-1986, 2006-2019 Free Software Foundation, Inc.
4 5
See the end of the file for license conditions.

Dave Love's avatar
Dave Love committed

This file is about changes in Emacs versions 1 through 17.
8 9

Dave Love's avatar
Dave Love committed
* Changes in Emacs 17
Dave Love's avatar
Dave Love committed

** Frustrated?
Dave Love's avatar
Dave Love committed
14 15 16

Try M-x doctor.

** Bored?
Dave Love's avatar
Dave Love committed
18 19 20

Try M-x hanoi.

** Brain-damaged?
Dave Love's avatar
Dave Love committed
22 23 24

Try M-x yow.

** Sun3, Tahoe, Apollo, HP9000s300, Celerity, NCR Tower 32,
Dave Love's avatar
Dave Love committed
26 27 28 29 30 31 32
  Sequent, Stride, Encore, Plexus and AT&T 7300 machines supported.

The Tahoe, Sun3, Sequent and Celerity use 4.2.  In regard to the
Apollo, see the file APOLLO in this directory.  NCR Tower32,
HP9000s300, Stride and Nu run forms of System V.  System V rel 2 also
works on Vaxes now.  See etc/MACHINES.

** System V Unix supported, including subprocesses.
Dave Love's avatar
Dave Love committed
34 35 36 37 38 39

It should be possible now to bring up Emacs on a machine running
mere unameliorated system V Unix with no major work; just possible bug
fixes.  But you can expect to find a handful of those on any machine
that Emacs has not been run on before.

** Berkeley 4.1 Unix supported.
Dave Love's avatar
Dave Love committed
41 42 43


** Portable `alloca' provided.
Dave Love's avatar
Dave Love committed
45 46 47 48 49

Emacs can now run on machines that do not and cannot support the library
subroutine `alloca' in the canonical fashion, using an `alloca' emulation
written in C.

** On-line manual.
Dave Love's avatar
Dave Love committed
51 52 53 54 55 56 57 58 59

Info now contains an Emacs manual, with essentially the same text
as in the printed manual.

The manual can now be printed with a standard TeX.

Nicely typeset and printed copies of the manual are available
from the Free Software Foundation.

** Backup file version numbers.
Dave Love's avatar
Dave Love committed
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110

Emacs now supports version numbers in backup files.

The first time you save a particular file in one editing session,
the old file is copied or renamed to serve as a backup file.
In the past, the name for the backup file was made by appending `~'
to the end of the original file name.

Now the backup file name can instead be made by appending ".~NN~" to
the original file name, where NN stands for a numeric version.  Each
time this is done, the new version number is one higher than the
highest previously used.

Thus, the active, current file does not have a version number.
Only the backups have them.

This feature is controlled by the variable `version-control'.  If it
is `nil', as normally, then numbered backups are made only for files
that already have numbered backups.  Backup names with just `~' are
used for files that have no numbered backups.

If `version-control' is `never', then the backup file's name is
made with just `~' in any case.

If `version-control' is not `nil' or `never', numbered backups are
made unconditionally.

To prevent unlimited consumption of disk space, Emacs can delete
old backup versions automatically.  Generally Emacs keeps the first
few backups and the latest few backups, deleting any in between.
This happens every time a new backup is made.  The two variables that
control the deletion are `kept-old-versions' and `kept-new-versions'.
Their values are, respectively, the number of oldest backups to keep
and the number of newest ones to keep, each time a new backup is made.
The value of `kept-new-versions' includes the backup just created.
By default, both values are 2.

If `trim-versions-without-asking' is non-`nil', the excess middle versions
are deleted without a murmur.  If it is `nil', the default, then you
are asked whether the excess middle versions should really be deleted.

Dired has a new command `.' which marks for deletion all but the latest
and oldest few of every numeric series of backups.  `kept-old-versions'
controls the number of oldest versions to keep, and `dired-kept-versions'
controls the number of latest versions to keep.  A numeric argument to
the `.' command, if positive, specifies the number of latest versions
to keep, overriding `dired-kept-versions'.  A negative argument specifies
the number of oldest versions to keep, using minus the argument to override

** Immediate conflict detection.
Dave Love's avatar
Dave Love committed
112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132

Emacs now locks the files it is modifying, so that if
you start to modify within Emacs a file that is being
modified in another Emacs, you get an immediate warning.

The warning gives you three choices:
1. Give up, and do not make any changes.
2. Make changes anyway at your own risk.
3. Make changes anyway, and record yourself as
 the person locking the file (instead of whoever
 was previously recorded.)

Just visiting a file does not lock it.  It is locked
when you try to change the buffer that is visiting the file.
Saving the file unlocks it until you make another change.

Locking is done by writing a lock file in a special designated
directory.  If such a directory is not provided and told to
Emacs as part of configuring it for your machine, the lock feature
is turned off.

** M-x recover-file.
Dave Love's avatar
Dave Love committed
134 135 136 137 138 139

This command is used to get a file back from an auto-save
(after a system crash, for example).  It takes a file name
as argument and visits that file, but gets the data from the
file's last auto save rather than from the file itself.

** M-x normal-mode.
Dave Love's avatar
Dave Love committed
141 142 143 144 145 146

This command resets the current buffer's major mode and local
variables to be as specified by the visit filename, the -*- line
and/or the Local Variables: block at the end of the buffer.
It is the same thing normally done when a file is first visited.

** Echo area messages disappear shortly if minibuffer is in use.
Dave Love's avatar
Dave Love committed
148 149 150 151 152

Any message in the echo area disappears after 2 seconds
if the minibuffer is active.  This allows the minibuffer
to become visible again.

** C-z on System V runs a subshell.
Dave Love's avatar
Dave Love committed
154 155 156 157 158 159 160

On systems which do not allow programs to be suspended, the C-z command
forks a subshell that talks directly to the terminal, and then waits
for the subshell to exit.  This gets almost the effect of suspending
in that you can run other programs and then return to Emacs.  However,
you cannot log out from the subshell.

** C-c is always a prefix character.
Dave Love's avatar
Dave Love committed
162 163 164 165 166

Also, subcommands of C-c which are letters are always
reserved for the user.  No standard Emacs major mode
defines any of them.

** Picture mode C-c commands changed.
Dave Love's avatar
Dave Love committed
168 169 170 171

The old C-c k command is now C-c C-w.
The old C-c y command is now C-c C-x.

** Shell mode commands changed.
Dave Love's avatar
Dave Love committed
173 174 175 176 177 178 179 180 181 182 183 184

All the special commands of Shell mode are now moved onto
the C-c prefix.  Most are not changed aside from that.
Thus, the old Shell mode C-c command (kill current job)
is now C-c C-c; the old C-z (suspend current job) is now C-c C-z,

The old C-x commands are now C-c commands.  C-x C-k (kill output)
is now C-c C-o, and C-x C-v (show output) is now C-c C-r.

The old M-= (copy previous input) command is now C-c C-y.

** Shell mode recognizes aliases for `pushd', `popd' and `cd'.
Dave Love's avatar
Dave Love committed
186 187 188 189 190 191 192 193 194 195 196

Shell mode now uses the variable `shell-pushd-regexp' as a
regular expression to recognize any command name that is
equivalent to a `pushd' command.  By default it is set up
to recognize just `pushd' itself.  If you use aliases for
`pushd', change the regexp to recognize them as well.

There are also `shell-popd-regexp' to recognize commands
with the effect of a `popd', and `shell-cd-regexp' to recognize
commands with the effect of a `cd'.

** "Exit" command in certain modes now C-c C-c.
Dave Love's avatar
Dave Love committed
198 199 200 201 202

These include electric buffer menu mode, electric command history
mode, Info node edit mode, and Rmail edit mode.  In all these
modes, the command to exit used to be just C-c.

** Outline mode changes.
Dave Love's avatar
Dave Love committed
204 205 206 207 208 209 210 211 212 213 214

Lines that are not heading lines are now called "body" lines.
The command `hide-text' is renamed to `hide-body'.
The key M-H is renamed to C-c C-h.
The key M-S is renamed to C-c C-s.
The key M-s is renamed to C-c C-i.

Changes of line visibility are no longer undoable.  As a result,
they no longer use up undo memory and no longer interfere with
undoing earlier commands.

** Rmail changes.
Dave Love's avatar
Dave Love committed
216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231

The s and q commands now both expunge deleted messages before saving;
use C-x C-s to save without expunging.

The u command now undeletes the current message if it is deleted;
otherwise, it backs up as far as necessary to reach a deleted message,
and undeletes that one.  The u command in the summary behaves likewise,
but considers only messages listed in the summary.  The M-u command
has been eliminated.

The o and C-o keys' meanings are interchanged.
o now outputs to an Rmail file, and C-o to a Unix mail file.

The F command (rmail-find) is renamed to M-s (rmail-search).
Various new commands and features exist; see the Emacs manual.

** Local bindings described first in describe-bindings.
Dave Love's avatar
Dave Love committed

** [...], {...} now balance in Fundamental mode.
Dave Love's avatar
Dave Love committed

** Nroff mode and TeX mode.
Dave Love's avatar
Dave Love committed

Juanma Barranquero's avatar
Juanma Barranquero committed
There are two new major modes for editing nroff input and TeX input.
Dave Love's avatar
Dave Love committed
239 240
See the Emacs manual for full information.

** New C indentation style variable `c-brace-imaginary-offset'.
Dave Love's avatar
Dave Love committed
242 243 244 245 246 247

The value of `c-brace-imaginary-offset', normally zero, controls the
indentation of a statement inside a brace-group where the open-brace
is not the first thing on a line.  The value says where the open-brace
is imagined to be, relative to the first nonblank character on the line.

** Dired improvements.
Dave Love's avatar
Dave Love committed
249 250 251 252 253 254 255 256 257 258 259 260 261

Dired now normally keeps the cursor at the beginning of the file name,
not at the beginning of the line.  The most used motion commands are
redefined in Dired to position the cursor this way.

`n' and `p' are now equivalent in dired to `C-n' and `C-p'.

If any files to be deleted cannot be deleted, their names are
printed in an error message.

If the `v' command is invoked on a file which is a directory,
dired is run on that directory.

** `visit-tag-table' renamed `visit-tags-table'.
Dave Love's avatar
Dave Love committed
263 264 265 266

This is so apropos of `tags' finds everything you need to
know about in connection with Tags.

** `mh-e' library uses C-c as prefix.
Dave Love's avatar
Dave Love committed
268 269 270 271 272

All the special commands of `mh-rmail' now are placed on a
C-c prefix rather than on the C-x prefix.  This is for
consistency with other special modes with their own commands.

** M-$ or `spell-word' checks word before point.
Dave Love's avatar
Dave Love committed
274 275 276

It used to check the word after point.

** Quitting during autoloading no longer causes trouble.
Dave Love's avatar
Dave Love committed
278 279 280 281 282 283 284 285 286

Now, when a file is autoloaded, all function redefinitions
and `provide' calls are recorded and are undone if you quit
before the file is finished loading.

As a result, it no longer happens that some of the entry points
which are normally autoloading have been defined already, but the
entire file is not really present to support them.

** `else' can now be indented correctly in C mode.
Dave Love's avatar
Dave Love committed
288 289 290 291 292 293

TAB in C mode now knows which `if' statement an `else' matches
up with, and can indent the `else' correctly under the `if',
even if the `if' contained such things as another `if' statement,
or a `while' or `for' statement, with no braces around it.

** `batch-byte-compile'
Dave Love's avatar
Dave Love committed
295 296 297 298 299 300 301 302

Runs byte-compile-file on the files specified on the command line.
All the rest of the command line arguments are taken as files to
compile (or, if directories, to do byte-recompile-directory on).
Must be used only with -batch, and kills emacs on completion.
Each file will be processed even if an error occurred previously.
For example, invoke `emacs -batch -f batch-byte-compile *.el'.

** `-batch' changes.
Dave Love's avatar
Dave Love committed
304 305 306 307 308 309 310 311 312 313 314 315

`-batch' now implies `-q': no init file is loaded by Emacs when
`-batch' is used.  Also, no `term/TERMTYPE.el' file is loaded.  Auto
saving is not done except in buffers in which it is explicitly
requested.  Also, many echo-area printouts describing what is going on
are inhibited in batch mode, so that the only output you get is the
output you program specifically.

One echo-area message that is not suppressed is the one that says
that a file is being loaded.  That is because you can prevent this
message by passing `t' as the third argument to `load'.

** Display of search string in incremental search.
Dave Love's avatar
Dave Love committed
317 318 319 320 321 322 323

Now, when you type C-s or C-r to reuse the previous search
string, that search string is displayed immediately in the echo area.

Three dots are displayed after the search string while search
is actually going on.

** View commands.
Dave Love's avatar
Dave Love committed
325 326 327 328 329

The commands C-x ], C-x [, C-x /, C-x j and C-x o are now
available inside `view-buffer' and `view-file', with their
normal meanings.

** Full-width windows preferred.
Dave Love's avatar
Dave Love committed
331 332 333 334

The ``other-window'' commands prefer other full width windows,
and will split only full width windows.

** M-x rename-file can copy if necessary.
Dave Love's avatar
Dave Love committed
336 337 338 339

When used between different file systems, since actual renaming does
not work, the old file will be copied and deleted.

** Within C-x ESC, you can pick the command to repeat.
Dave Love's avatar
Dave Love committed
341 342 343 344 345 346 347 348 349 350 351 352 353 354 355

While editing a previous command to be repeated, inside C-x ESC,
you can now use the commands M-p and M-n to pick an earlier or
later command to repeat.  M-n picks the next earlier command
and M-p picks the next later one.  The new command appears in
the minibuffer, and you can go ahead and edit it, and repeat it
when you exit the minibuffer.

Using M-n or M-p within C-x ESC is like having used a different
numeric argument when you ran C-x ESC in the first place.

The command you finally execute using C-x ESC is added to the
front of the command history, unless it is identical with the
first thing in the command history.

** Use C-c C-c to exit from editing within Info.
Dave Love's avatar
Dave Love committed
357 358 359 360 361

It used to be C-z for this.  Somehow this use of C-z was
left out when all the others were moved.  The intention is that
C-z should always suspend Emacs.

** Default arg to C-x < and C-x > now window width minus 2.
Dave Love's avatar
Dave Love committed
363 364 365 366 367

These commands, which scroll the current window horizontally
by a specified number of columns, now scroll a considerable
distance rather than a single column if used with no argument.

** Auto Save Files Deleted.
Dave Love's avatar
Dave Love committed
369 370 371 372

The default value of `delete-auto-save-files' is now `t', so that
when you save a file for real, its auto save file is deleted.

** Rnews changes.
Dave Love's avatar
Dave Love committed
374 375 376 377 378 379 380 381 382 383 384

The N, P and J keys in Rnews are renamed to M-n, M-p and M-j.
These keys move among newsgroups.

The n and p keys for moving sequentially between news articles now
accept repeat count arguments, and the + and - keys, made redundant by
this change, are eliminated.

The s command for outputting the current article to a file
is renamed as o, to be compatible with Rmail.

** Sendmail changes.
Dave Love's avatar
Dave Love committed
386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409

If you have a ~/.mailrc file, Emacs searches it for mailing address
aliases, and these aliases are expanded when you send mail in Emacs.

Fcc fields can now be used in the headers in the *mail* buffer
to specify files in which copies of the message should be put.
The message is written into those files in Unix mail file format.
The message as sent does not contain any Fcc fields in its header.
You can use any number of Fcc fields, but only one file name in each one.
The variable `mail-archive-file-name', if non-`nil', can be a string
which is a file name; an Fcc to that file will be inserted in every
message when you begin to compose it.

A new command C-c q now exists in Mail mode.  It fills the
paragraphs of an old message that had been inserted with C-c y.

When the *mail* buffer is put in Mail mode, text-mode-hook
is now run in addition to mail-mode-hook.  text-mode-hook
is run first.

The new variable `mail-header-separator' now specifies the string
to use on the line that goes between the headers and the message text.
By default it is still "--text follows this line--".

** Command history truncated automatically.
Dave Love's avatar
Dave Love committed
411 412 413

Just before each garbage collection, all but the last 30 elements
of the command history are discarded.

Dave Love's avatar
Dave Love committed
* Incompatible Lisp Programming Changes in Emacs 17
Dave Love's avatar
Dave Love committed

** `&quote' no longer supported.
Dave Love's avatar
Dave Love committed
419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436

This feature, which allowed Lisp functions to take arguments
that were not evaluated, has been eliminated, because it is
inescapably hard to make the compiler work properly with such

You should use macros instead.  A simple way to change any
code that uses `&quote' is to replace

   (defun foo (&quote x y z) ...


   (defmacro foo (x y z)
     (list 'foo-1 (list 'quote x) (list 'quote y) (list 'quote z)))

   (defun foo-1 (x y z) ...

** Functions `region-to-string' and `region-around-match' removed.
Dave Love's avatar
Dave Love committed
438 439 440 441 442 443 444 445 446 447 448 449 450 451 452

These functions were made for compatibility with Gosling Emacs, but it
turns out to be undesirable to use them in GNU Emacs because they use
the mark.  They have been eliminated from Emacs proper, but are
present in mlsupport.el for the sake of converted mocklisp programs.

If you were using `region-to-string', you should instead use
`buffer-substring'; then you can pass the bounds as arguments and
can avoid setting the mark.

If you were using `region-around-match', you can use instead
the two functions `match-beginning' and `match-end'.  These give
you one bound at a time, as a numeric value, without changing
point or the mark.

** Function `function-type' removed.
Dave Love's avatar
Dave Love committed
454 455 456 457 458 459

This just appeared not to be very useful.  It can easily be written in
Lisp if you happen to want it.  Just use `symbol-function' to get the
function definition of a symbol, and look at its data type or its car
if it is a list.

** Variable `buffer-number' removed.
Dave Love's avatar
Dave Love committed
461 462 463 464

You can still use the function `buffer-number' to find out
a buffer's unique number (assigned in order of creation).

** Variable `executing-macro' renamed `executing-kbd-macro'.
Dave Love's avatar
Dave Love committed
466 467 468 469

This variable is the currently executing keyboard macro, as
a string, or `nil' when no keyboard macro is being executed.

** Loading term/$TERM.
Dave Love's avatar
Dave Love committed
471 472 473 474 475 476 477 478 479 480

The library term/$TERM (where $TERM get replaced by your terminal
type), which is done by Emacs automatically when it starts up, now
happens after the user's .emacs file is loaded.

In previous versions of Emacs, these files had names of the form
term-$TERM; thus, for example, term-vt100.el, but now they live
in a special subdirectory named term, and have names like

** `command-history' format changed.
Dave Love's avatar
Dave Love committed
482 483 484 485

The elements of this list are now Lisp expressions which can
be evaluated directly to repeat a command.

** Unused editing commands removed.
Dave Love's avatar
Dave Love committed
487 488 489

The functions `forward-to-word', `backward-to-word',
`upcase-char', `mark-beginning-of-buffer' and `mark-end-of-buffer'
have been removed.  Their definitions can be found in file
Dave Love's avatar
Dave Love committed
lisp/unused.el if you need them.

Dave Love's avatar
Dave Love committed
* Upward Compatible Lisp Programming Changes in Emacs 17
Dave Love's avatar
Dave Love committed

** You can now continue after errors and quits.
Dave Love's avatar
Dave Love committed
497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515

When the debugger is entered because of a C-g, due to
a non-`nil' value of `debug-on-quit', the `c' command in the debugger
resumes execution of the code that was running when the quit happened.
Use the `q' command to go ahead and quit.

The same applies to some kinds of errors, but not all.  Errors
signaled with the Lisp function `signal' can be continued; the `c'
command causes `signal' to return.  The `r' command causes `signal' to
return the value you specify.  The `c' command is equivalent to `r'
with the value `nil'.

For a `wrong-type-argument' error, the value returned with the `r'
command is used in place of the invalid argument.  If this new value
is not valid, another error occurs.

Errors signaled with the function `error' cannot be continued.
If you try to continue, the error just happens again.

** `dot' renamed `point'.
Dave Love's avatar
Dave Love committed
517 518 519 520 521 522 523 524 525 526 527 528

The word `dot' has been replaced with `point' in all
function and variable names, including:

  point, point-min, point-max,
  point-marker, point-min-marker, point-max-marker,
  window-point, set-window-point,
  point-to-register, register-to-point,

The old names are still supported, for now.

** `string-match' records position of end of match.
Dave Love's avatar
Dave Love committed
530 531 532 533 534 535 536

After a successful call to `string-match', `(match-end 0)' will
return the index in the string of the first character after the match.
Also, `match-begin' and `match-end' with nonzero arguments can be
used to find the indices of beginnings and ends of substrings matched
by subpatterns surrounded by parentheses.

** New function `insert-before-markers'.
Dave Love's avatar
Dave Love committed
538 539 540 541 542 543 544

This function is just like `insert' except in the handling of any
relocatable markers that are located at the point of insertion.
With `insert', such markers end up pointing before the inserted text.
With `insert-before-markers', they end up pointing after the inserted

** New function `copy-alist'.
Dave Love's avatar
Dave Love committed
546 547 548 549 550 551 552 553 554

This function takes one argument, a list, and makes a disjoint copy
of the alist structure.  The list itself is copied, and each element
that is a cons cell is copied, but the cars and cdrs of elements
remain shared with the original argument.

This is what it takes to get two alists disjoint enough that changes
in one do not change the result of `assq' on the other.

** New function `copy-keymap'.
Dave Love's avatar
Dave Love committed
556 557 558 559 560

This function takes a keymap as argument and returns a new keymap
containing initially the same bindings.  Rebindings in either one of
them will not alter the bindings in the other.

** New function `copy-syntax-table'.
Dave Love's avatar
Dave Love committed
562 563 564 565 566

This function takes a syntax table as argument and returns a new
syntax table containing initially the same syntax settings.  Changes
in either one of them will not alter the other.

** Randomizing the random numbers.
Dave Love's avatar
Dave Love committed
568 569 570 571

`(random t)' causes the random number generator's seed to be set
based on the current time and Emacs's process id.

** Third argument to `modify-syntax-entry'.
Dave Love's avatar
Dave Love committed
573 574 575 576 577

The optional third argument to `modify-syntax-entry', if specified
should be a syntax table.  The modification is made in that syntax table
rather than in the current syntax table.

** New function `run-hooks'.
Dave Love's avatar
Dave Love committed
579 580 581 582 583 584 585 586

This function takes any number of symbols as arguments.
It processes the symbols in order.  For each symbol which
has a value (as a variable) that is non-nil, the value is
called as a function, with no arguments.

This is useful in major mode commands.

** Second arg to `switch-to-buffer'.
Dave Love's avatar
Dave Love committed
588 589 590 591 592 593 594

If this function is given a non-`nil' second argument, then the
selection being done is not recorded on the selection history.
The buffer's position in the history remains unchanged.  This
feature is used by the view commands, so that the selection history
after exiting from viewing is the same as it was before.

** Second arg to `display-buffer' and `pop-to-buffer'.
Dave Love's avatar
Dave Love committed
596 597 598 599 600 601 602 603 604

These two functions both accept an optional second argument which
defaults to `nil'.  If the argument is not `nil', it means that
another window (not the selected one) must be found or created to
display the specified buffer in, even if it is already shown in
the selected window.

This feature is used by `switch-to-buffer-other-window'.

** New variable `completion-ignore-case'.
Dave Love's avatar
Dave Love committed
606 607 608 609 610 611 612 613 614 615 616

If this variable is non-`nil', completion allows strings
in different cases to be considered matching.  The global value
is `nil'

This variable exists for the sake of commands that are completing
an argument in which case is not significant.  It is possible
to change the value globally, but you might not like the consequences
in the many situations (buffer names, command names, file names)
where case makes a difference.

** Major modes related to Text mode call text-mode-hook, then their own hooks.
Dave Love's avatar
Dave Love committed
618 619 620 621 622

For example, turning on Outline mode first calls the value of
`text-mode-hook' as a function, if it exists and is non-`nil',
and then does likewise for the variable `outline-mode-hook'.

** Defining new command line switches.
Dave Love's avatar
Dave Love committed
624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640

You can define a new command line switch in your .emacs file
by putting elements on the value of `command-switch-alist'.
Each element of this list should look like
where SWITCHSTRING is a string containing the switch to be
defined, such as "-foo", and FUNCTION is a function to be called
if such an argument is found in the command line.  FUNCTION
receives the command line argument, a string, as its argument.

To implement a switch that uses up one or more following arguments,
use the fact that the remaining command line arguments are kept
as a list in the variable `command-line-args'.  FUNCTION can
examine this variable, and do
    (setq command-line-args (cdr command-line-args)
to "use up" an argument.

** New variable `load-in-progress'.
Dave Love's avatar
Dave Love committed
642 643 644 645

This variable is non-`nil' when a file of Lisp code is being read
and executed by `load'.

** New variable `print-length'.
Dave Love's avatar
Dave Love committed
647 648 649 650 651 652

The value of this variable is normally `nil'.  It may instead be
a number; in that case, when a list is printed by `prin1' or
`princ' only that many initial elements are printed; the rest are
replaced by `...'.

** New variable `find-file-not-found-hook'.
Dave Love's avatar
Dave Love committed
654 655 656 657 658 659

If `find-file' or any of its variants is used on a nonexistent file,
the value of `find-file-not-found-hook' is called (if it is not `nil')
with no arguments, after creating an empty buffer.  The file's name
can be found as the value of `buffer-file-name'.

** Processes without buffers.
Dave Love's avatar
Dave Love committed
661 662 663 664 665 666 667 668 669 670 671 672 673 674

In the function `start-process', you can now specify `nil' as
the process's buffer.  You can also set a process's buffer to `nil'
using `set-process-buffer'.

The reason you might want to do this is to prevent the process
from being killed because any particular buffer is killed.
When a process has a buffer, killing that buffer kills the
process too.

When a process has no buffer, its output is lost unless it has a
filter, and no indication of its being stopped or killed is given
unless it has a sentinel.

** New function `user-variable-p'.  `v' arg prompting changed.
Dave Love's avatar
Dave Love committed
676 677 678 679 680 681 682 683 684 685 686 687 688

This function takes a symbol as argument and returns `t' if
the symbol is defined as a user option variable.  This means
that it has a `variable-documentation' property whose value is
a string starting with `*'.

Code `v' in an interactive arg reading string now accepts
user variables only, and completion is limited to the space of
user variables.

The function `read-variable' also now accepts and completes
over user variables only.

** CBREAK mode input is the default in Unix 4.3 bsd.
Dave Love's avatar
Dave Love committed
690 691 692 693 694 695 696 697

In Berkeley 4.3 Unix, there are sufficient features for Emacs to
work fully correctly using CBREAK mode and not using SIGIO.
Therefore, this mode is the default when running under 4.3.
This mode corresponds to `nil' as the first argument to
`set-input-mode'.  You can still select either mode by calling
that function.

** Information on memory usage.
Dave Love's avatar
Dave Love committed
699 700 701 702 703 704 705 706

The new variable `data-bytes-used' contains the number
of bytes of impure space allocated in Emacs.
`data-bytes-free' contains the number of additional bytes
Emacs could allocate.  Note that space formerly allocated
and freed again still counts as `used', since it is still
in Emacs's address space.

** No limit on size of output from `format'.
Dave Love's avatar
Dave Love committed
708 709 710 711

The string output from `format' used to be truncated to
100 characters in length.  Now it can have any length.

** New errors `void-variable' and `void-function' replace `void-symbol'.
Dave Love's avatar
Dave Love committed
713 714 715 716 717

This change makes it possible to have error messages that
clearly distinguish undefined variables from undefined functions.
It also allows `condition-case' to handle one case without the other.

** `replace-match' handling of `\'.
Dave Love's avatar
Dave Love committed
719 720 721 722 723 724 725 726 727 728 729 730

In `replace-match', when the replacement is not literal,
`\' in the replacement string is always treated as an
escape marker.  The only two special `\' constructs
are `\&' and `\DIGIT', so `\' followed by anything other than
`&' or a digit has no effect.  `\\' is necessary to include
a `\' in the replacement text.

This level of escaping is comparable with what goes on in
a regular expression.  It is over and above the level of `\'
escaping that goes on when strings are read in Lisp syntax.

** New error `invalid-regexp'.
Dave Love's avatar
Dave Love committed
732 733 734 735

A regexp search signals this type of error if the argument does
not meet the rules for regexp syntax.

** `kill-emacs' with argument.
Dave Love's avatar
Dave Love committed
737 738 739 740 741 742

If the argument is a number, it is returned as the exit status code
of the Emacs process.  If the argument is a string, its contents
are stuffed as pending terminal input, to be read by another program
after Emacs is dead.

** New fifth argument to `subst-char-in-region'.
Dave Love's avatar
Dave Love committed
744 745 746 747 748 749 750 751

This argument is optional and defaults to `nil'.  If it is not `nil',
then the substitutions made by this function are not recorded
in the Undo mechanism.

This feature should be used with great care.  It is now used
by Outline mode to make lines visible or invisible.

** ` *Backtrace*' buffer renamed to `*Backtrace*'.
Dave Love's avatar
Dave Love committed
753 754 755 756 757 758 759

As a result, you can now reselect this buffer easily if you switch to
another while in the debugger.

Exiting from the debugger kills the `*Backtrace*' buffer, so you will
not try to give commands in it when no longer really in the debugger.

** New function `switch-to-buffer-other-window'.
Dave Love's avatar
Dave Love committed
761 762

This is the new primitive to select a specified buffer (the
argument) in another window.  It is not quite the same as
Dave Love's avatar
Dave Love committed
764 765 766 767 768 769 770
`pop-to-buffer', because it is guaranteed to create another
window (assuming there is room on the screen) so that it can
leave the current window's old buffer displayed as well.

All functions to select a buffer in another window should
do so by calling this new function.

** New variable `minibuffer-help-form'.
Dave Love's avatar
Dave Love committed
772 773 774 775 776 777

At entry to the minibuffer, the variable `help-form' is bound
to the value of `minibuffer-help-form'.

`help-form' is expected at all times to contain either `nil'
or an expression to be executed when C-h is typed (overriding
Paul Eggert's avatar
Paul Eggert committed
the definition of C-h as a command).  `minibuffer-help-form'
Dave Love's avatar
Dave Love committed
779 780 781
can be used to provide a different default way of handling
C-h while in the minibuffer.

** New \{...} documentation construct.
Dave Love's avatar
Dave Love committed
783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801

It is now possible to set up the documentation string for
a major mode in such a way that it always describes the contents
of the major mode's keymap, as it has been customized.
To do this, include in the documentation string the characters `\{'
followed by the name of the variable containing the keymap,
terminated with `}'.  (The `\' at the beginning probably needs to
be quoted with a second `\', to include it in the doc string.)
This construct is normally used on a line by itself, with no blank
lines before or after.

For example, the documentation string for the function `c-mode' contains
    Paragraphs are separated by blank lines only.
    Delete converts tabs to spaces as it moves back.
    Variables controlling indentation style:

** New character syntax class "punctuation".
Dave Love's avatar
Dave Love committed
803 804 805 806 807 808

Punctuation characters behave like whitespace in word and
list parsing, but can be distinguished in regexps and in the
function `char-syntax'.  Punctuation syntax is represented by
a period in `modify-syntax-entry'.

** `auto-mode-alist' no longer needs entries for backup-file names,
Dave Love's avatar
Dave Love committed
810 811 812

Backup suffixes of all kinds are now stripped from a file's name
before searching `auto-mode-alist'.
813 814

Dave Love's avatar
Dave Love committed
* Changes in Emacs 16
Dave Love's avatar
Dave Love committed

** No special code for Ambassadors, VT-100's and Concept-100's.
Dave Love's avatar
Dave Love committed
819 820 821 822 823 824 825 826 827 828 829

Emacs now controls these terminals based on the termcap entry, like
all other terminals.  Formerly it did not refer to the termcap entries
for those terminal types, and often the termcap entries for those
terminals are wrong or inadequate.  If you experience worse behavior
on these terminals than in version 15, you can probably correct it by
fixing up the termcap entry.  See ./TERMS for more info.

See ./TERMS in any case if you find that some terminal does not work
right with Emacs now.

** Minibuffer default completion character is TAB (and not ESC).
Dave Love's avatar
Dave Love committed
831 832 833

So that ESC can be used in minibuffer for more useful prefix commands.

** C-z suspends Emacs in all modes.
Dave Love's avatar
Dave Love committed
835 836 837 838 839

Formerly, C-z was redefined for other purposes by certain modes,
such as Buffer Menu mode.  Now other keys are used for those purposes,
to keep the meaning of C-z uniform.

** C-x ESC (repeat-complex-command) allows editing the command it repeats.
Dave Love's avatar
Dave Love committed
841 842 843 844 845 846

Instead of asking for confirmation to re-execute a command from the
command history, the command is placed, in its Lisp form, into the
minibuffer for editing.  You can confirm by typing RETURN, change some
arguments and then confirm, or abort with C-g.

** Incremental search does less redisplay on slow terminals.
Dave Love's avatar
Dave Love committed
848 849 850 851 852 853 854 855 856 857 858 859

If the terminal baud rate is <= the value of `isearch-slow-speed',
incremental searching outside the text on the screen creates
a single-line window and uses that to display the line on which
a match has been found.  Exiting or quitting the search restores
the previous window configuration and redisplays the window you
were searching in.

The initial value of `isearch-slow-speed' is 1200.

This feature is courtesy of crl@purdue.

** Recursive minibuffers not allowed.
Dave Love's avatar
Dave Love committed
861 862 863 864 865 866 867 868 869 870 871 872 873 874 875

If the minibuffer window is selected, most commands that would
use the minibuffer gets an error instead.  (Specific commands
may override this feature and therefore still be allowed.)

Strictly speaking, recursive entry to the minibuffer is still
possible, because you can switch to another window after
entering the minibuffer, and then minibuffer-using commands
are allowed.  This is still allowed by a deliberate decision:
if you know enough to switch windows while in the minibuffer,
you can probably understand recursive minibuffers.

This may be overridden by binding the variable
`enable-recursive-minibuffers' to t.

** New major mode Emacs-Lisp mode, for editing Lisp code to run in Emacs.
Dave Love's avatar
Dave Love committed
877 878 879 880 881 882 883 884 885 886

The mode in which emacs lisp files is edited is now called emacs-lisp-mode
and is distinct from lisp-mode.  The latter is intended for use with
lisps external to emacs.

The hook which is funcalled (if non-nil) on entry to elisp-mode is now
called emacs-lisp-mode-hook.  A consequence of this changes is that
.emacs init files which set the value of lisp-mode-hook may need to be
changed to use the new names.

** Correct matching of parentheses is checked on insertion.
Dave Love's avatar
Dave Love committed
888 889 890 891 892

When you insert a close-paren, the matching open-paren
is checked for validity.  The close paren must be the kind
of close-paren that the open-paren says it should match.
Otherwise, a warning message is printed.  close-paren immediately
preceded by quoting backslash syntax character is not matched.
Dave Love's avatar
Dave Love committed
894 895 896

This feature was originally written by shane@mit-ajax.

897 898 899
** M-x list-command-history
** M-x command-history-mode
** M-x electric-command-history
Dave Love's avatar
Dave Love committed
900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915

`list-command-history' displays forms from the command history subject
to user controlled filtering and limit on number of forms.  It leaves
the buffer in `command-history-mode'.  M-x command-history-mode
recomputes the command history each time it is invoked via
`list-command-history'.  It is like Emacs-Lisp mode except that characters
don't insert themselves and provision is made for re-evaluating an
expression from the list.  `electric-command-history' pops up a type
out window with the command history displayed.  If the very next
character is Space, the window goes away and the previous window
configuration is restored.  Otherwise you can move around in the
history and select an expression for evaluation *inside* the buffer
which invoked `electric-command-history'.  The original window
configuration is restored on exit unless the command selected changes

** M-x edit-picture
Dave Love's avatar
Dave Love committed
917 918 919 920 921 922 923 924 925 926 927 928

Enters a temporary major mode (the previous major mode is remembered
and can is restored on exit) designed for editing pictures and tables.
Printing characters replace rather than insert themselves with motion
afterwards that is user controlled (you can specify any of the 8
compass directions).  Special commands for movement are provided.
Special commands for hacking tabs and tab stops are provided.  Special
commands for killing rectangles and overlaying them are provided.  See
the documentation of function  edit-picture  for more details.

Calls value of `edit-picture-hook' on entry if non-nil.

** Stupid C-s/C-q `flow control' supported.
Dave Love's avatar
Dave Love committed
930 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 956 957

Do (set-input-mode nil t) to tell Emacs to use CBREAK mode and interpret
C-s and C-q as flow control commands.  (set-input-mode t nil) switches
back to interrupt-driven input.  (set-input-mode nil nil) uses CBREAK
mode but no `flow control'; this may make it easier to run Emacs under
certain debuggers that have trouble dealing with inferiors that use SIGIO.

CBREAK mode has certain inherent disadvantages, which are why it is
not the default:

     Meta-keys are ignored; CBREAK mode discards the 8th bit of
     input characters.

     Control-G as keyboard input discards buffered output,
     and therefore can cause incorrect screen updating.

The use of `flow control' has its own additional disadvantage: the
characters C-s and C-q are not available as editing commands.  You can
partially compensate for this by setting up a keyboard-translate-table
(see file ONEWS) that maps two other characters (such as C-^ and C-\) into
C-s and C-q.  Of course, C-^ and C-\ are commonly used as escape
characters in remote-terminal programs.  You really can't win except
by getting rid of this sort of `flow control.'

The configuration switch CBREAK_INPUT is now eliminated.
INTERRUPT_INPUT exists only to specify the default mode of operation;
#define it to make interrupt-driven input the default.

** Completion of directory names provides a slash.
Dave Love's avatar
Dave Love committed
959 960 961 962

If file name completion yields the name of a directory,
a slash is appended to it.

** Undo can clear modified-flag.
Dave Love's avatar
Dave Love committed
964 965

If you undo changes in a buffer back to a state in which the
Paul Eggert's avatar
Paul Eggert committed
buffer was not considered "modified", then it is labeled as
Dave Love's avatar
Dave Love committed
967 968
once again "unmodified".

** M-x run-lisp.
Dave Love's avatar
Dave Love committed
970 971 972 973

This command creates an inferior Lisp process whose input and output
appear in the Emacs buffer named `*lisp*'.  That buffer uses a major mode
called inferior-lisp-mode, which has many of the commands of lisp-mode
and those of shell-mode.  Calls the value of shell-mode-hook and
Dave Love's avatar
Dave Love committed
975 976 977 978 979
lisp-mode-hook, in that order, if non-nil.

Meanwhile, in lisp-mode, the command C-M-x is defined to
send the current defun as input to the `*lisp*' subprocess.

** Mode line says `Narrow' when buffer is clipped.
Dave Love's avatar
Dave Love committed
981 982 983 984 985

If a buffer has a clipping restriction (made by `narrow-to-region')
then its mode line contains the word `Narrow' after the major and
minor modes.

** Mode line says `Abbrev' when abbrev mode is on.
Dave Love's avatar
Dave Love committed

** add-change-log-entry takes prefix argument
Dave Love's avatar
Dave Love committed
989 990 991 992 993

Giving a prefix argument makes it prompt for login name, full name,
and site name, with defaults.  Otherwise the defaults are used
with no confirmation.

** M-x view-buffer and M-x view-file
Dave Love's avatar
Dave Love committed
995 996 997 998

view-buffer selects the named buffer, view-file finds the named file; the
resulting buffer is placed into view-mode (a recursive edit).  The normal
emacs commands are not available.  Instead a set of special commands is
Paul Eggert's avatar
Paul Eggert committed
provided which facilitate moving around in the buffer, searching and
Dave Love's avatar
Dave Love committed
1000 1001 1002 1003 1004 1005 1006
scrolling by screenfuls.  Exiting view-mode returns to the buffer in which
the view-file or view-buffer command was given.
Type ? or h when viewing for a complete list of view commands.
Each calls value of `view-hook' if non-nil on entry.

written by shane@mit-ajax.

** New key commands in dired.
Dave Love's avatar
Dave Love committed
1008 1009 1010 1011 1012 1013 1014 1015 1016

`v' views (like more) the file on the current line.
`#' marks auto-save files for deletion.
`~' marks backup files for deletion.
`r' renames a file and updates the directory listing if the
file is renamed to same directory.
`c' copies a file and updates the directory listing if the file is
copied to the same directory.

** New function `electric-buffer-list'.
Dave Love's avatar
Dave Love committed
1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028

This pops up a buffer describing the set of emacs buffers.
Immediately typing space makes the buffer list go away and returns
to the buffer and window which were previously selected.

Otherwise one may use the c-p and c-n commands to move around in the
buffer-list buffer and type Space or C-z to select the buffer on the
cursor's line.  There are a number of other commands which are the same
as those of buffer-menu-mode.

This is a useful thing to bind to c-x c-b in your `.emacs' file if the
Glenn Morris's avatar
Glenn Morris committed
rather non-standard `electric' behavior of the buffer list suits your taste.
Dave Love's avatar
Dave Love committed
1030 1031 1032 1033 1034
Type C-h after invoking electric-buffer-list for more information.

Calls value of `electric-buffer-menu-mode-hook' if non-nil on entry.
Calls value of `after-electric-buffer-menu' on exit (select) if non-nil.
** Changes in version 16 for mail reading and sending
Dave Love's avatar
Dave Love committed

*** sendmail prefix character is C-c (and not C-z).  New command C-c w.
Dave Love's avatar
Dave Love committed
1038 1039 1040 1041 1042

For instance C-c C-c (or C-c C-s) sends mail now rather than C-z C-z.
C-c w inserts your `signature' (contents of ~/.signature) at the end
of mail.

*** New feature in C-c y command in sending mail.
Dave Love's avatar
Dave Love committed
1044 1045 1046 1047 1048 1049 1050 1051 1052

C-c y is the command to insert the message being replied to.
Normally it deletes most header fields and indents everything
by three spaces.

Now, C-c y does not delete header fields or indent.
C-c y with any other numeric argument does delete most header
fields, but indents by the amount specified in the argument.

*** C-r command in Rmail edits current message.
Dave Love's avatar
Dave Love committed
1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065

It does this by switching to a different major mode
which is nearly the same as Text mode.  The only difference
between it and text mode are the two command C-c and C-].
C-c is defined to switch back to Rmail mode, and C-]
is defined to restore the original contents of the message
and then switch back to Rmail mode.

C-c and C-] are the only ways "back into Rmail", but you
can switch to other buffers and edit them as usual.
C-r in Rmail changes only the handling of the Rmail buffer.

*** Rmail command `t' toggles header display.
Dave Love's avatar
Dave Love committed
1067 1068 1069 1070 1071 1072

Normally Rmail reformats messages to hide most header fields.
`t' switches to display of all the header fields of the
current message, as long as it remains current.
Another `t' switches back to the usual display.

*** Rmail command '>' goes to the last message.
Dave Love's avatar
Dave Love committed

*** Rmail commands `a' and `k' set message attributes.
Dave Love's avatar
Dave Love committed
`a' adds an attribute and `k' removes one.  You specify
Paul Eggert's avatar
Paul Eggert committed
the attribute by name.  You can specify either a built-in
Dave Love's avatar
Dave Love committed
1078 1079 1080
flag such as "deleted" or "filed", or a user-defined keyword
(anything not recognized as built-in).

*** Rmail commands `l' and `L' summarize by attributes.
Dave Love's avatar
Dave Love committed
1082 1083 1084 1085 1086 1087

These commands create a summary with one line per message,
like `h', but they list only some of the messages.  You
specify which attribute (for `l') or attributes (for `L')
the messages should have.

*** Rmail can parse mmdf mail files.
Dave Love's avatar
Dave Love committed

*** Interface to MH mail system.
Dave Love's avatar
Dave Love committed
1091 1092

mh-e is a front end for GNU emacs and the MH mail system.  It
Paul Eggert's avatar
Paul Eggert committed
provides a friendly and convenient interface to the MH commands.
Dave Love's avatar
Dave Love committed
1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105

To read mail, invoke mh-rmail.  This will inc new mail and display the
scan listing on the screen.  To see a summary of the mh-e commands,
type ?.  Help is available through the usual facilities.

To send mail, invoke mh-smail.

mh-e requires a copy of MH.5 that has been compiled with the MHE
compiler switch.

From larus@berkeley.
** New hooks and parameters in version 16
Dave Love's avatar
Dave Love committed

*** New variable `blink-matching-paren-distance'.
Dave Love's avatar
Dave Love committed
1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120

This is the maximum number of characters to search for
an open-paren to match an inserted close-paren.
The matching open-paren is shown and checked if it is found
within this distance.

`nil' means search all the way to the beginning of the buffer.
In this case, a warning message is printed if no matching
open-paren is found.

This feature was originally written by shane@mit-ajax.

*** New variable `find-file-run-dired'
Dave Love's avatar
Dave Love committed
1122 1123 1124 1125 1126

If nil, find-file will report an error if an attempt to visit a
directory is detected; otherwise, it runs dired on that directory.
The default is t.

*** Variable `dired-listing-switches' holds switches given to `ls' by dired.
Dave Love's avatar
Dave Love committed
1128 1129 1130 1131 1132 1133 1134

The value should be a string containing `-' followed by letters.
The letter `l' had better be included and letter 'F' had better be excluded!
The default is "-al".

This feature was originally written by shane@mit-ajax.

*** New variable `display-time-day-and-date'.
Dave Love's avatar
Dave Love committed
1136 1137 1138 1139

If this variable is set non-`nil', the function M-x display-time
displays the day and date, as well as the time.

*** New parameter `c-continued-statement-indent'.
Dave Love's avatar
Dave Love committed
1141 1142 1143 1144 1145 1146 1147 1148 1149

This controls the extra indentation given to a line
that continues a C statement started on the previous line.
By default it is 2, which is why you would see

	if (foo)
	  bar ();

*** Changed meaning of `c-indent-level'.
Dave Love's avatar
Dave Love committed
1151 1152 1153 1154 1155 1156 1157 1158 1159

The value of `c-brace-offset' used to be
subtracted from the value of `c-indent-level' whenever
that value was used.  Now it is not.

As a result, `c-indent-level' is now the offset of
statements within a block, relative to the line containing
the open-brace that starts the block.

*** turn-on-auto-fill is useful value for text-mode-hook.
Dave Love's avatar
Dave Love committed
1161 1162 1163 1164 1165

(setq text-mode-hook 'turn-on-auto-fill)
is all you have to do to make sure Auto Fill mode is turned
on whenever you enter Text mode.

*** Parameter explicit-shell-file-name for M-x shell.
Dave Love's avatar
Dave Love committed
1167 1168 1169 1170 1171 1172

This variable, if non-nil, specifies the file name to use
for the shell to run if you do M-x shell.
Changes in version 16 affecting Lisp programming:

*** Documentation strings adapt to customization.
Dave Love's avatar
Dave Love committed
1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200

Often the documentation string for a command wants to mention
another command.  Simply stating the other command as a
character sequence has a disadvantage: if the user customizes
Emacs by moving that function to a different command, the
cross reference in the documentation becomes wrong.

A new feature allows you to write the documentation string
using a function name, and the command to run that function
is looked up when the documentation is printed.

If a documentation string contains `\[' (two characters) then
the following text, up to the next `]', is taken as a function name.
Instead of printing that function name, the command that runs it is printed.
(M-x is used to construct a command if no shorter one exists.)

For example, instead of putting `C-n' in a documentation string
to refer to the C-n command, put in `\[next-line]'.  (In practice
you will need to quote the backslash with another backslash,
due to the syntax for strings in Lisp and C.)

To include the literal characters `\[' in a documentation string,
precede them with `\='.  To include the characters `\=', precede
them with `\='.  For example, "\\=\\= is the way to quote \\=\\["
will come out as `\= is the way to quote \['.

The new function `substitute-command-keys' takes a string possibly
Paul Eggert's avatar
Paul Eggert committed
containing \[...] constructs and replaces those constructs with
Dave Love's avatar
Dave Love committed
1202 1203
the key sequences they currently stand for.

*** Primitives `find-line-comment' and `find-line-comment-body' flushed.
Dave Love's avatar
Dave Love committed
1205 1206 1207 1208

Search for the value of `comment-start-skip' if you want to find
whether and where a line has a comment.

*** New function `auto-save-file-name-p'
Dave Love's avatar
Dave Love committed

Glenn Morris's avatar
Glenn Morris committed
Should return non-`nil' if given a string which is the name of an
Dave Love's avatar
Dave Love committed
1212 1213 1214 1215 1216
auto-save file (sans directory name).  If you redefine
`make-auto-save-file-name', you should redefine this accordingly.  By
default, this function returns `t' for filenames beginning with
character `#'.

*** The value of `exec-directory' now ends in a slash.
Dave Love's avatar
Dave Love committed
1218 1219 1220

This is to be compatible with most directory names in GNU Emacs.

*** Dribble files and termscript files.
Dave Love's avatar
Dave Love committed
1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233

(open-dribble-file FILE) opens a dribble file named FILE.  When a
dribble file is open, every character Emacs reads from the terminal is
written to the dribble file.

(open-termscript FILE) opens a termscript file named FILE.  When a
termscript file is open, all characters sent to the terminal by Emacs
are also written in the termscript file.

The two of these together are very useful for debugging Emacs problems
in redisplay.

*** Upper case command characters by default are same as lower case.
Dave Love's avatar
Dave Love committed
1235 1236 1237 1238 1239 1240

If a character in a command is an upper case letter, and is not defined,
Emacs uses the definition of the corresponding lower case letter.
For example, if C-x U is not directly undefined, it is treated as
a synonym for C-x u (undo).

*** Undefined function errors versus undefined variable errors.
Dave Love's avatar
Dave Love committed
1242 1243 1244 1245

Void-symbol errors now say "boundp" if the symbol's value was void
or "fboundp" if the function definition was void.

*** New function `bury-buffer'.
Dave Love's avatar
Dave Love committed
1247 1248 1249 1250 1251 1252

The new function `bury-buffer' takes one argument, a buffer object,
and puts that buffer at the end of the internal list of buffers.
So it is the least preferred candidate for use as the default value
of C-x b, or for other-buffer to return.

*** Already-displayed buffers have low priority for display.
Dave Love's avatar
Dave Love committed
1254 1255 1256 1257 1258

When a buffer is chosen automatically for display, or to be the
default in C-x b, buffers already displayed in windows have lower
priority than buffers not currently visible.

*** `set-window-start' accepts a third argument NOFORCE.
Dave Love's avatar
Dave Love committed
1260 1261 1262 1263 1264 1265

This argument, if non-nil, prevents the window's force_start flag
from being set.  Setting the force_start flag causes the next
redisplay to insist on starting display at the specified starting
point, even if dot must be moved to get it onto the screen.

*** New function `send-string-to-terminal'.
Dave Love's avatar
Dave Love committed
1267 1268 1269 1270 1271

This function takes one argument, a string, and outputs its contents
to the terminal exactly as specified: control characters, escape
sequences, and all.

*** Keypad put in command mode.
Dave Love's avatar
Dave Love committed
1273 1274 1275 1276 1277

The terminal's keypad is now put into command mode, as opposed to
numeric mode, while Emacs is running.  This is done by means of the
termcap `ks' and `ke' strings.

*** New function `generate-new-buffer'
Dave Love's avatar
Dave Love committed
1279 1280 1281 1282 1283 1284 1285

This function takes a string as an argument NAME and looks for a
creates and returns a buffer called NAME if one did not already exist.
Otherwise, it successively tries appending suffixes of the form "<1>",
"<2>" etc to NAME until it creates a string which does not name an
existing buffer.  A new buffer with that name is the created and returned.

*** New function `prin1-to-string'
Dave Love's avatar
Dave Love committed
1287 1288 1289 1290
This function takes one argument, a lisp object, and returns a string
containing that object's printed representation, such as `prin1'
would output.

*** New function `read-from-minibuffer'
Dave Love's avatar
Dave Love committed
1292 1293 1294 1295 1296
Lets you supply a prompt, initial-contents, a keymap, and specify
whether the result should be interpreted as a string or a lisp object.

Old functions `read-minibuffer', `eval-minibuffer', `read-string' all
take second optional string argument which is initial contents of
Dave Love's avatar
Dave Love committed

*** minibuffer variable names changed (names of keymaps)
Dave Love's avatar
Dave Love committed
1300 1301 1302 1303 1304 1305

minibuf-local-map -> minibuffer-local-map
minibuf-local-ns-map -> minibuffer-local-ns-map
minibuf-local-completion-map -> minibuffer-local-completion-map
minibuf-local-must-match-map -> minibuffer-local-must-match-map
** Changes in version 16 affecting configuring and building Emacs
Dave Love's avatar
Dave Love committed

*** Configuration switch VT100_INVERSE eliminated.
Dave Love's avatar
Dave Love committed
1309 1310 1311 1312 1313 1314

You can control the use of inverse video on any terminal by setting
the variable `inverse-video', or by changing the termcap entry.  If
you like, set `inverse-video' in your `.emacs' file based on
examination of (getenv "TERM").

*** New switch `-batch' makes Emacs run noninteractively.
Dave Love's avatar
Dave Love committed
1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332

If the switch `-batch' is used, Emacs treats its standard output
and input like ordinary files (even if they are a terminal).
It does not display buffers or windows; the only output to standard output
is what would appear as messages in the echo area, and each
message is followed by a newline.

The terminal modes are not changed, so that C-z and C-c retain
their normal Unix meanings.  Emacs does still read commands from
the terminal, but the idea of `-batch' is that you use it with
other command line arguments that tell Emacs a complete task to perform,
including killing itself.  `-kill' used as the last argument is a good
way to accomplish this.

The Lisp variable `noninteractive' is now defined, to be `nil'
except when `-batch' has been specified.

*** Emacs can be built with output redirected to a file.
Dave Love's avatar
Dave Love committed
1334 1335

This is because -batch (see above) is now used in building Emacs.
1336 1337 1338

* Changes in Emacs 15

** Emacs now runs on Sun and Megatest 68000 systems;
1342 1343
 also on at least one 16000 system running 4.2.

** Emacs now alters the output-start and output-stop characters
1345 1346 1347
 to prevent C-s and C-q from being considered as flow control
 by cretinous rlogin software in 4.2.

** It is now possible convert Mocklisp code (for Gosling Emacs) to Lisp code
1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367
 that can run in GNU Emacs.  M-x convert-mocklisp-buffer
 converts the contents of the current buffer from Mocklisp to
 GNU Emacs Lisp.  You should then save the converted buffer with C-x C-w
 under a name ending in ".el"

 There are probably some Mocklisp constructs that are not handled.
 If you encounter one, feel free to report the failure as a bug.
 The construct will be handled in a future Emacs release, if that is not
 not too hard to do.

 Note that lisp code converted from Mocklisp code will not necessarily
 run as fast as code specifically written for GNU Emacs, nor will it use
 the many features of GNU Emacs which are not present in Gosling's emacs.
 (In particular, the byte-compiler (m-x byte-compile-file) knows little
 about compilation of code directly converted from mocklisp.)
 It is envisaged that old mocklisp code will be incrementally converted
 to GNU lisp code, with M-x convert-mocklisp-buffer being the first
 step in this process.

** Control-x n (narrow-to-region) is now by default a disabled command.
1369 1370 1371 1372 1373 1374 1375

 This means that, if you issue this command, it will ask whether
 you really mean it.  You have the opportunity to enable the
 command permanently at that time, so you will not be asked again.
 This will place the form "(put 'narrow-to-region 'disabled nil)" in your
 .emacs file.

** Tags now prompts for the tag table file name to use.
1377 1378 1379 1380 1381 1382 1383 1384

 All the tags commands ask for the tag table file name
 if you have not yet specified one.

 Also, the command M-x visit-tag-table can now be used to
 specify the tag table file name initially, or to switch
 to a new tag table.

** If truncate-partial-width-windows is non-nil (as it initially is),
1386 1387 1388 1389
 all windows less than the full screen width (that is,
 made by side-by-side splitting) truncate lines rather than continuing

** Emacs now checks for Lisp stack overflow to avoid fatal errors.
1391 1392 1393 1394 1395 1396 1397
 The depth in eval, apply and funcall may not exceed max-lisp-eval-depth.
 The depth in variable bindings and unwind-protects may not exceed
 max-specpdl-size.  If either limit is exceeded, an error occurs.
 You can set the limits to larger values if you wish, but if you make them
 too large, you are vulnerable to a fatal error if you invoke
 Lisp code that does infinite recursion.

** New hooks  find-file-hook  and  write-file-hook.
1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411
 Both of these variables if non-nil should be functions of no arguments.
 At the time they are called (current-buffer) will be the buffer being
 read or written respectively.

 find-file-hook  is called whenever a file is read into its own buffer,
 such as by calling  find-file,  revert-buffer, etc.  It is not called by
 functions such as  insert-file  which do not read the file into a buffer of
 its own.
 find-file-hook  is called after the file has been read in and its
 local variables (if any) have been processed.

 write-file-hook  is called just before writing out a file from a buffer.

** The initial value of shell-prompt-pattern is now  "^[^#$%>]*[#$%>] *"

** If the .emacs file sets inhibit-startup-message to non-nil,
1415 1416 1417
 the messages normally printed by Emacs at startup time
 are inhibited.

** Facility for run-time conditionalization on the basis of emacs features.
1419 1420 1421 1422 1423

 The new variable  features  is a list of symbols which represent "features"
 of the executing emacs, for use in run-time conditionalization.

 The function  featurep  of one argument may be used to test for the
 presence of a feature.  It is just the same as
1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440
 (not (null (memq FEATURE features))) where FEATURE is its argument.
 For example, (if (featurep 'magic-window-hack)
		  (transmogrify-window 'vertical)

 The function  provide  of one argument "announces" that FEATURE is present.
 It is much the same as (if (not (featurep FEATURE))
			    (setq features (cons FEATURE features)))

 The function  require  with arguments FEATURE and FILE-NAME loads FILE-NAME
 (which should contain the form (provide FEATURE)) unless FEATURE is present.
 It is much the same as (if (not (featurep FEATURE))
			    (progn (load FILE-NAME)
				   (if (not featurep FEATURE) (error ...))))
 FILE-NAME is optional and defaults to FEATURE.

** New function load-average.
1442 1443 1444 1445 1446 1447

 This returns a list of three integers, which are
 the current 1 minute, 5 minute and 15 minute load averages,
 each multiplied by a hundred (since normally they are floating
 point numbers).

** Per-terminal libraries loaded automatically.
1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459

 Emacs when starting up on terminal type T automatically loads
 a library named term-T.  T is the value of the TERM environment variable.
 Thus, on terminal type vt100, Emacs would do (load "term-vt100" t t).
 Such libraries are good places to set the character translation table.

 It is a bad idea to redefine lots of commands in a per-terminal library,
 since this affects all users.  Instead, define a command to do the
 redefinitions and let the user's init file, which is loaded later,
 call that command or not, as the user prefers.

** Programmer's note: detecting killed buffers.
1461 1462 1463 1464 1465 1466 1467 1468

 Buffers are eliminated by explicitly killing them, using
 the function kill-buffer.  This does not eliminate or affect
 the pointers to the buffer which may exist in list structure.
 If you have a pointer to a buffer and wish to tell whether
 the buffer has been killed, use the function buffer-name.
 It returns nil on a killed buffer, and a string on a live buffer.

** New ways to access the last command input character.
1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481

 The function last-key-struck, which used to return the last
 input character that was read by command input, is eliminated.
 Instead, you can find this information as the value of the
 variable last-command-char.  (This variable used to be called

 Another new variable, last-input-char, holds the last character
 read from the command input stream regardless of what it was
 read for.  last-input-char and last-command-char are different
 only inside a command that has called read-char to read input.

** The new switch -kill causes Emacs to exit after processing the
1483 1484 1485 1486 1487
 preceding command line arguments.  Thus,
    emacs -l lib data -e do-it -kill
 means to load lib, find file data, call do-it on no arguments,
 and then exit.

** The config.h file has been modularized.
1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501

 Options that depend on the machine you are running on are defined
 in a file whose name starts with "m-", such as m-vax.h.
 Options that depend on the operating system software version you are
 running on are defined in a file whose name starts with "s-",
 such as s-bsd4.2.h.

 config.h includes one m- file and one s- file.  It also defines a
 few other options whose values do not follow from the machine type
 and system type being used.  Installers normally will have to
 select the correct m- and s- files but will never have to change their

** Termcap AL and DL strings are understood.
1503 1504 1505 1506 1507 1508

 If the termcap entry defines AL and DL strings, for insertion
 and deletion of multiple lines in one blow, Emacs now uses them.
 This matters most on certain bit map display terminals for which
 scrolling is comparatively slow.

** Bias against scrolling screen far on fast terminals.
1510 1511 1512 1513

 Emacs now prefers to redraw a few lines rather than
 shift them a long distance on the screen, when the terminal is fast.

** New major mode, mim-mode.
1515 1516 1517 1518 1519

 This major mode is for editing MDL code.  Perhaps a MDL
 user can explain why it is not called mdl-mode.
 You must load the library mim-mode explicitly to use this.

** GNU documentation formatter `texinfo'.
1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534

 The `texinfo' library defines a format for documentation
 files which can be passed through Tex to make a printed manual
 or passed through texinfo to make an Info file.  Texinfo is
 documented fully by its own Info file; compare this file
 with its source, texinfo.texinfo, for additional guidance.

 All documentation files for GNU utilities should be written
 in texinfo input format.

 Tex processing of texinfo files requires the Botex macro package.
 This is not ready for distribution yet, but will appear at
 a later time.

** New function read-from-string (emacs 15.29)
1536 1537 1538 1539 1540 1541 1542 1543

 read-from-string takes three arguments: a string to read from,
 and optionally start and end indices which delimit a substring
 from which to read.  (They default to 0 and the length of the string,

 This function returns a cons cell whose car is the object produced
 by reading from the string and whose cdr is a number giving the
 index in the string of the first character not read.  That index may
1545 1546 1547 1548 1549
 be passed as the second argument to a later call to  read-from-string
 to read the next form represented by the string.

 In addition, the function  read  now accepts a string as its argument.
 In this case, it calls  read-from-string  on the whole string, and
 returns the car of the result (ie the actual object read.)
1551 1552 1553

* Changes in Emacs 14

** Completion now prints various messages such as [Sole Completion]
1557 1558 1559 1560
 or [Next Character Not Unique] to describe the results obtained.
 These messages appear after the text in the minibuffer, and remain
 on the screen until a few seconds go by or you type a key.

** The buffer-read-only flag is implemented.
1562 1563 1564 1565 1566 1567 1568 1569 1570
 Setting or binding this per-buffer variable to a non-nil value
 makes illegal any operation which would modify the textual content of
 the buffer.  (Such operations signal a  buffer-read-only  error)
 The read-only state of a buffer may be altered using toggle-read-only
 (C-x C-q)
 The buffers used by Rmail, Dired, Rnews, and Info are now read-only
 by default to prevent accidental damage to the information in those

** Functions car-safe and cdr-safe.
1572 1573 1574 1575
 These functions are like car and cdr when the argument is a cons.
 Given an argument not a cons, car-safe always returns nil, with
 no error; the same for cdr-safe.

** The new function user-real-login-name returns the name corresponding
1577 1578 1579 1580 1581 1582 1583
 to the real uid of the Emacs process.  This is usually the same
 as what user-login-name returns; however, when Emacs is invoked
 from su, user-real-login-name returns "root" but user-login-name
 returns the name of the user who invoked su.

* Changes in Emacs 13

** There is a new version numbering scheme.
1587 1588 1589 1590 1591 1592 1593 1594 1595 1596

 What used to be the first version number, which was 1,
 has been discarded since it does not seem that I need three
 levels of version number.

 However, a new third version number has been added to represent
 changes by user sites.  This number will always be zero in
 Emacs when I distribute it; it will be incremented each time
 Emacs is built at another site.

** There is now a reader syntax for Meta characters:
1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610
 \M-CHAR means CHAR or'ed with the Meta bit.  For example:

    ?\M-x   is   (+ ?x 128)
    ?\M-\n  is   (+ ?\n 128)
    ?\M-\^f is   (+ ?\^f 128)

 This syntax can be used in strings too.  Note, however, that
 Meta characters are not meaningful in key sequences being passed
 to define-key or lookup-key; you must use ESC characters (\e)
 in them instead.

 ?\C- can be used likewise for control characters.  (13.9)

** Installation change
1612 1613 1614
 The string "../lisp" now adds to the front of the load-path
 used for searching for Lisp files during Emacs initialization.
 It used to replace the path specified in paths.h entirely.
Paul Eggert's avatar
Paul Eggert committed
 Now the directory ../lisp is searched first and the directories
1616 1617 1618 1619
 specified in paths.h are searched afterward.

* Changes in Emacs 1.12

** There is a new installation procedure.
1623 1624 1625
 See the file INSTALL that comes in the top level
 directory in the tar file or tape.

** The Meta key is now supported on terminals that have it.
1627 1628 1629 1630 1631 1632
 This is a shift key which causes the high bit to be turned on
 in all input characters typed while it is held down.

 read-char now returns a value in the range 128-255 if
 a Meta character is typed.  When interpreted as command
 input, a Meta character is equivalent to a two character
Paul Eggert's avatar
Paul Eggert committed
 sequence, the meta prefix character followed by the unmetized
1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645
 character (Meta-G unmetized is G).

 The meta prefix character
 is specified by the value of the variable meta-prefix-char.
 If this character (normally Escape) has been redefined locally
 with a non-prefix definition (such as happens in completing
 minibuffers) then the local redefinition is suppressed when
 the character is not the last one in a key sequence.
 So the local redefinition is effective if you type the character
 explicitly, but not effective if the character comes from
 the use of the Meta key.

** `-' is no longer a completion command in the minibuffer.
1647 1648
 It is an ordinary self-inserting character.

** The list load-path of directories load to search for Lisp files
1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660
 is now controlled by the EMACSLOADPATH environment variable
[[ Note this was originally EMACS-LOAD-PATH and has been changed
 again; sh does not deal properly with hyphens in env variable names]]
 rather than the EPATH environment variable.  This is to avoid
 conflicts with other Emacses.

 While Emacs is being built initially, the load-path
 is now just ("../lisp"), ignoring paths.h.  It does not
 ignore EMACSLOADPATH, however; you should avoid having
 this variable set while building Emacs.

** You can now specify a translation table for keyboard
1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672
 input characters, as a way of exchanging or substituting
 keys on the keyboard.

 If the value of keyboard-translate-table is a string,
 every character received from the keyboard is used as an
 index in that string, and the character at that index in
 the string is used as input instead of what was actually
 typed.  If the actual input character is >= the length of
 the string, it is used unchanged.

 One way this feature can be used is to fix bad keyboard
Paul Eggert's avatar
Paul Eggert committed
 designs.  For example, on some terminals, Delete is
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