(large-file-warning-threshold): Add type, groups.
[emacs.git] / etc / ONEWS.4
blob1fcb3d1859a202368ade3aa25c462506bbc66722
1 GNU Emacs NEWS -- history of user-visible changes.  1992.
2 Copyright (C) 1992 Free Software Foundation, Inc.
3 See the end for copying conditions.
5 For older news, see the file ONEWS.3.
6 \f
7 Changes in version 18.58.
9 * RMAIL reply now properly parses nested comments in addesses.
11 * The "visual bell" feature when used with X windows
12 now flashes only 1/4 of the window's total area.  This is because
13 flashing the whole window is too slow on some systems.
15 * `call-process' and `call-process-region' now return an indication
16 of the exit status of the subprocess: either a numeric exit code
17 or a string describing the signal which caused termination.
19 * It is possible for regular expression matching to overflow the stack
20 of failure points.  In the past, such overflow was treated as simple
21 failure to match.  Now it causes an error.
23 * You can use C-u to end a numeric argument.  Thus, type C-u 1 0 0 C-u 1
24 to insert 100 1's.
26 * Emacs now knows how to get resource values from the X server.
28 * Job control commands in shell mode work properly on more systems
29 because they now work by "typing" signal characters such as C-c.
31 * copy-keymap no longer recursively copies keymaps reached through
32 symbols' function definitions (i.e., those that have names).  It does
33 copy nested keymaps that appear directly in the other copied keymaps.
35 Changes in version 18.56.
37 * C-g should now work to interrupt a running program
38 on all kinds of systems even when using X windows.
40 * Quitting is inhibited while a filter or sentinel is running.
41 Those functions can run asynchronously while Emacs is waiting
42 for keyboard input, and if they allow quitting, they
43 make the behavior of C-g unpredictable.
45 * Storing text into the X windows cut buffer
46 now clears out any selection.
48 * The undo facility is completely rewritten, and now
49 uses Lisp data structures.  It can record much more
50 information.  You can use the variables undo-threshold
51 and undo-high-threshold to control how much.
53 * There is no longer a maximum screen height or width.
55 Changes in version 18.52.
57 * X windows version 10 is supported under system V.
59 * Pop-up menus are now supported with the same Lisp interface in
60 both version 10 and 11 of X windows.
62 * C-x 4 a is a new command to edit a change-log entry in another window.
64 * The emacs client program now allows an option +NNN to specify the
65 line number to go to in the file whose name follows.  Thus,
66     emacsclient foo.c +45 bar.c
67 will find the files `foo.c' and `bar.c', going to line 45 in `bar.c'.
69 * Dired allows empty directories to be deleted like files.
71 * When the terminal type is used to find a terminal-specific file to
72 run, Emacs now tries the entire terminal type first.  If that doesn't
73 yield a file that exists, the last hyphen and what follows it is
74 stripped.  If that doesn't yield a file that exists, the previous
75 hyphen is stripped, and so on until all hyphens are gone.  For
76 example, if the terminal type is `aaa-48-foo', Emacs will try first
77 `term/aaa-48-foo.el', then `term/aaa-48.el' and finally `term/aaa.el'.
79 Underscores now receive the same treatment as hyphens.
81 * Texinfo features: @defun, etc.  texinfo-show-structure.
82 New template commands.  texinfo-format-region.
84 * The special "local variable" `eval' is now ignored if you are running
85 as root.
87 * New command `c-macro-expand' shows the result of C macro expansion
88 in the region.  It works using the C preprocessor, so its results
89 are completely accurate.
91 * Errors in trying to auto save now flash error messages for a few seconds.
93 * Killing a buffer now sends SIGHUP to the buffer's process.
95 * New hooks.
97 ** `spell-region' now allows you to filter the text before spelling-checking.
98 If the value of `spell-filter' is non-nil, it is called, with no arguments,
99 looking at a temporary buffer containing a copy of the text to be checked.
100 It can alter the text freely before the spell program sees it.
102 ** The variable `lpr-command' now specifies the command to be used when
103 you use the commands to print text (such as M-x print-buffer).
105 ** Posting netnews now calls the value of `news-inews-hook' (if not nil)
106 as a function of no arguments before the actual posting.
108 ** Rmail now calls the value of `rmail-show-message-hook' (if not nil)
109 as a function of no arguments, each time a new message is selected.
111 ** `kill-emacs' calls the value of `kill-emacs-hook' as a function of no args
112 unless Emacs is running in batch mode.
114 * New libraries.
115 See the source code of each library for more information.
117 ** icon.el: a major mode for editing programs written in Icon.
119 ** life.el: a simulator for the cellular automaton "life".  Load the
120 library and run M-x life.
122 ** doctex.el: a library for converting the Emacs `etc/DOC' file of
123 documentation strings into TeX input.
125 ** saveconf.el: a library which records the arrangement of windows and
126 buffers when you exit Emacs, and automatically recreates the same
127 setup the next time you start Emacs.
129 ** uncompress.el: a library that automatically uncompresses files
130 when you visit them.
132 ** c-fill.el: a mode for editing filled comments in C.
134 ** kermit.el: an extended version of shell-mode designed for running kermit.
136 ** spook.el: a library for adding some "distract the NSA" keywords to every
137 message you send.
139 ** hideif.el: a library for hiding parts of a C program based on preprocessor
140 conditionals.
142 ** autoinsert.el: a library to put in some initial text when you visit
143 a nonexistent file.  The text used depends on the major mode, and
144 comes from a directory of files created by you.
146 * New programming features.
148 ** The variable `window-system-version' now contains the version number
149 of the window system you are using (if appropriate).  When using X windows,
150 its value is either 10 or 11.
152 ** (interactive "N") uses the prefix argument if any; otherwise, it reads
153 a number using the minibuffer.
155 ** VMS: there are two new functions `vms-system-info' and `shrink-to-icon'.
156 The former allows you to get many kinds of system status information.
157 See its self-documentation for full details.
158 The second is used with the window system: it iconifies the Emacs window.
160 ** VMS: the new function `define-logical-name' allows you to create
161 job-wide logical names.  The old function `define-dcl-symbol' has been
162 removed.
164 Changes in version 18.50.
166 * X windows version 11 is supported.
168 Define X11 in config.h if you want X version 11 instead of version 10.
170 * The command M-x gdb runs the GDB debugger as an inferior.
171 It asks for the filename of the executable you want to debug.
173 GDB runs as an inferior with I/O through an Emacs buffer.  All the
174 facilities of Shell mode are available.  In addition, each time your
175 program stops, and each time you select a new stack frame, the source
176 code is displayed in another window with an arrow added to the line
177 where the program is executing.
179 Special GDB-mode commands include M-s, M-n, M-i, M-u, M-d, and C-c C-f
180 which send the GDB commands `step', `next', `stepi', `up', `down'
181 and `finish'.
183 In any source file, the commands C-x SPC tells GDB to set a breakpoint
184 on the current line.
186 * M-x calendar displays a three-month calendar.
188 * C-u 0 C-x C-s never makes a backup file.
190 This is a way you can explicitly request not to make a backup.
192 * `term-setup-hook' is for users only.
194 Emacs never uses this variable for internal purposes, so you can freely
195 set it in your `.emacs' file to make Emacs do something special after
196 loading any terminal-specific setup file from `lisp/term'.
198 * `copy-keymap' now copies recursive submaps.
200 * New overlay-arrow feature.
202 If you set the variable `overlay-arrow-string' to a string
203 and `overlay-arrow-position' to a marker, that string is displayed on
204 the screen at the position of that marker, hiding whatever text would
205 have appeared there.  If that position isn't on the screen, or if
206 the buffer the marker points into isn't displayed, there is no effect.
208 * -batch mode can read from the terminal.
210 It now works to use `read-char' to do terminal input in a noninteractive
211 Emacs run.  End of file causes Emacs to exit.
213 * Variables `data-bytes-used' and `data-bytes-free' removed.
215 These variables cannot really work because the 24-bit range of an
216 integer in (most ports of) GNU Emacs is not large enough to hold their
217 values on many systems.
219 Changes in version 18.45, since version 18.41.
221 * C indentation parameter `c-continued-brace-offset'.
223 This parameter's value is added to the indentation of any
224 line that is in a continuation context and starts with an open-brace.
225 For example, it applies to the open brace shown here:
227      if (x)
228        {
230 The default value is zero.
232 * Dabbrev expansion (Meta-/) preserves case.
234 When you use Meta-/ to search the buffer for an expansion of an
235 abbreviation, if the expansion found is all lower case except perhaps
236 for its first letter, then the case pattern of the abbreviation
237 is carried over to the expansion that replaces it.
239 * TeX-mode syntax.
241 \ is no longer given "escape character" syntax in TeX mode.  It now
242 has the syntax of an ordinary punctuation character.  As a result,
243 \[...\] and such like are considered to balance each other.
245 * Mail-mode automatic Reply-to field.
247 If the variable `mail-default-reply-to' is non-`nil', then each time
248 you start to compose a message, a Reply-to field is inserted with
249 its contents taken from the value of `mail-default-reply-to'.
251 * Where is your .emacs file?
253 If you run Emacs under `su', so your real and effective uids are
254 different, Emacs uses the home directory associated with the real uid
255 (the name you actually logged in under) to find the .emacs file.
257 Otherwise, Emacs uses the environment variable HOME to find the .emacs
258 file.
260 The .emacs file is not loaded at all if -batch is specified.
262 * Prolog mode is the default for ".pl" files.
264 * File names are not case-sensitive on VMS.
266 On VMS systems, all file names that you specify are converted to upper
267 case.  You can use either upper or lower case indiscriminately.
269 * VMS-only function 'define-dcl-symbol'.
271 This is a new name for the function formerly called
272 `define-logical-name'.
274 Editing Changes in Emacs 18
276 * Additional systems and machines are supported.
278 GNU Emacs now runs on Vax VMS.  However, many facilities that are normally
279 implemented by running subprocesses do not work yet.  This includes listing
280 a directory and sending mail.  There are features for running subprocesses
281 but they are incompatible with those on Unix.  I hope that some of
282 the VMS users can reimplement these features for VMS (compatibly for
283 the user, if possible).
285 VMS wizards are also asked to work on making the subprocess facilities
286 more upward compatible with those on Unix, and also to rewrite their
287 internals to use the same Lisp objects that are used on Unix to
288 represent processes.
290 In addition, the TI Nu machine running Unix system V, the AT&T 3b, and
291 the Wicat, Masscomp, Integrated Solutions, Alliant, Amdahl uts, Mips,
292 Altos 3068 and Gould Unix systems are now supported.  The IBM PC-RT is
293 supported under 4.2, but not yet under system V.  The GEC 93 is close
294 to working.  The port for the Elxsi is partly merged.  See the file
295 MACHINES for full status information and machine-specific installation
296 advice.
298 * Searching is faster.
300 Forward search for a text string, or for a regexp that is equivalent
301 to a text string, is now several times faster.  Motion by lines and
302 counting lines is also faster.
304 * Memory usage improvements.
306 It is no longer possible to run out of memory during garbage
307 collection.  As a result, running out of memory is never fatal.  This
308 is due to a new garbage collection algorithm which compactifies
309 strings in place rather than copying them.  Another consequence of the
310 change is a reduction in total memory usage and a slight increase in
311 garbage collection speed.
313 * Display changes.
315 ** Editing above top of screen.
317 When you delete or kill or alter text that reaches to the top of the
318 screen or above it, so that display would start in the middle of a
319 line, Emacs will usually attempt to scroll the text so that display
320 starts at the beginning of a line again.
322 ** Yanking in the minibuffer.
324 The message "Mark Set" is no longer printed when the minibuffer is
325 active.  This is convenient with many commands, including C-y, that
326 normally print such a message.
328 ** Cursor appears in last line during y-or-n questions.
330 Questions that want a `y' or `n' answer now move the cursor
331 to the last line, following the question.
333 * Library loading changes.
335 `load' now considers all possible suffixes (`.elc', `.el' and none)
336 for each directory in `load-path' before going on to the next directory.
337 It now accepts an optional fourth argument which, if non-nil, says to
338 use no suffixes; then the file name must be given in full.  The search
339 of the directories in `load-path' goes on as usual in this case, but
340 it too can be prevented by passing an absolute file name.
342 The value of `load-path' no longer by default includes nil (meaning to
343 look in the current default directory).  The idea is that `load' should
344 be used to search the path only for libraries to be found in the standard
345 places.  If you want to override system libraries with your own, place
346 your own libraries in one special directory and add that directory to the
347 front of `load-path'.
349 The function `load' is no longer a command; that is to say, `M-x load'
350 is no longer allowed.  Instead, there are two commands for loading files.
351 `M-x load-library' is equivalent to the old meaning of `M-x load'.
352 `M-x load-file' reads a file name with completion and defaulting
353 and then loads exactly that file, with no searching and no suffixes.
355 * Emulation of other editors.
357 ** `edt-emulation-on' starts emulating DEC's EDT editor.
359 Do `edt-emulation-off' to return Emacs to normal.
361 ** `vi-mode' and `vip-mode' starts emulating vi.
363 These are two different vi emulations provided by GNU Emacs users.
364 We are interested in feedback as to which emulation is preferable.
366 See the documentation and source code for these functions
367 for more information.
369 ** `set-gosmacs-bindings' emulates Gosling Emacs.
371 This command changes many global bindings to resemble those of
372 Gosling Emacs.  The previous bindings are saved and can be restored using
373 `set-gnu-bindings'.
375 * Emulation of a display terminal.
377 Within Emacs it is now possible to run programs (such as emacs or
378 supdup) which expect to do output to a visual display terminal.
380 See the function `terminal-emulator' for more information.
382 * New support for keypads and function keys.
384 There is now a first attempt at terminal-independent support for
385 keypad and function keys.
387 Emacs now defines a standard set of key-names for function and keypad
388 keys, and provides standard hooks for defining them.  Most of the
389 standard key-names have default definitions built into Emacs; you can
390 override these in a terminal-independent manner.  The default definitions
391 and the conventions for redefining them are in the file `lisp/keypad.el'.
393 These keys on the terminal normally work by sending sequences of
394 characters starting with ESC.  The exact sequences used vary from
395 terminal to terminal.  Emacs interprets them in two stages:
396 in the first stage, terminal-dependent sequences are mapped into
397 the standard key-names; then second stage maps the standard key-names
398 into their definitions in a terminal-independent fashion.
400 The terminal-specific file `term/$TERM.el' now is responsible only for
401 establishing the mapping from the terminal's escape sequences into
402 standard key-names.  It no longer knows what Emacs commands are
403 assigned to the standard key-names.
405 One other change in terminal-specific files: if the value of the TERM
406 variable contains a hyphen, only the part before the first hyphen is
407 used in forming the name of the terminal-specific file.  Thus, for
408 terminal type `aaa-48', the file loaded is now `term/aaa.el' rather
409 than `term/aaa-48.el'.
411 * New startup command line options.
413 `-i FILE' or `-insert FILE' in the command line to Emacs tells Emacs to
414 insert the contents of FILE into the current buffer at that point in
415 command line processing.  This is like using the command M-x insert-file.
417 `-funcall', `-load', `-user' and `-no-init-file' are new synonyms for
418 `-f', `-l', `-u' and `-q'.
420 `-nw' means don't use a window system.  If you are using a terminal
421 emulator on the X window system and you want to run Emacs to work through
422 the terminal emulator instead of working directly with the window system,
423 use this switch.
425 * Buffer-sorting commands.
427 Various M-x commands whose names start with `sort-' sort parts of
428 the region:
430 sort-lines      divides the region into lines and sorts them alphabetically.
431 sort-pages      divides into pages and sorts them alphabetically.
432 sort-paragraphs divides into paragraphs and sorts them alphabetically.
433 sort-fields     divides into lines and sorts them alphabetically
434                 according to one field in the line.
435                 The numeric argument specifies which field (counting
436                 from field 1 at the beginning of the line).  Fields in a line
437                 are separated by whitespace.
438 sort-numeric-fields
439                 is similar but converts the specified fields to numbers
440                 and sorts them numerically.
441 sort-columns    divides into lines and sorts them according to the contents
442                 of a specified range of columns.
444 Refer to the self-documentation of these commands for full usage information.
446 * Changes in various commands.
448 ** `occur' output now serves as a menu.  `occur-menu' command deleted.
450 `M-x occur' now allows you to move quickly to any of the occurrences
451 listed.  Select the `*Occur*' buffer that contains the output of `occur',
452 move point to the occurrence you want, and type C-c C-c.
453 This will move point to the same occurrence in the buffer that the
454 occurrences were found in.
456 The command `occur-menu' is thus obsolete, and has been deleted.
458 One way to get a list of matching lines without line numbers is to
459 copy the text to another buffer and use the command `keep-lines'.
461 ** Incremental search changes.
463 Ordinary and regexp incremental searches now have distinct default
464 search strings.  Thus, regexp searches recall only previous regexp
465 searches.
467 If you exit an incremental search when the search string is empty,
468 the old default search string is kept.  The default does not become
469 empty.
471 Reversing the direction of an incremental search with C-s or C-r
472 when the search string is empty now does not get the default search
473 string.  It leaves the search string empty.  A second C-s or C-r
474 will get the default search string.  As a result, you can do a reverse
475 incremental regexp search with C-M-s C-r.
477 If you add a `*', `?' or `\|' to an incremental search regexp,
478 point will back up if that is appropriate.  For example, if
479 you have searched for `ab' and add a `*', point moves to the
480 first match for `ab*', which may be before the match for `ab'
481 that was previously found.
483 If an incremental search is failing and you ask to repeat it,
484 it will start again from the beginning of the buffer (or the end,
485 if it is a backward search).
487 The search-controlling parameters `isearch-slow-speed' and
488 `isearch-slow-window-lines' have now been renamed to start with
489 `search' instead of `isearch'.  Now all the parameters' names start
490 with `search'.
492 If `search-slow-window-lines' is negative, the slow search window
493 is put at the top of the screen, and the absolute value or the
494 negative number specifies the height of it.
496 ** Undo changes
498 The undo command now will mark the buffer as unmodified only when it is
499 identical to the contents of the visited file.
501 ** C-M-v in minibuffer.
503 If while in the minibuffer you request help in a way that uses a
504 window to display something, then until you exit the minibuffer C-M-v
505 in the minibuffer window scrolls the window of help.
507 For example, if you request a list of possible completions, C-M-v can
508 be used reliably to scroll the completion list.
510 ** M-TAB command.
512 Meta-TAB performs completion on the Emacs Lisp symbol names.  The sexp
513 in the buffer before point is compared against all existing nontrivial
514 Lisp symbols and completed as far as is uniquely determined by them.
515 Nontrivial symbols are those with either function definitions, values
516 or properties.
518 If there are multiple possibilities for the very next character, a
519 list of possible completions is displayed.
521 ** Dynamic abbreviation package.
523 The new command Meta-/ expands an abbreviation in the buffer before point
524 by searching the buffer for words that start with the abbreviation.
526 ** Changes in saving kbd macros.
528 The commands `write-kbd-macro' and `append-kbd-macro' have been
529 deleted.  The way to save a keyboard macro is to use the new command
530 `insert-kbd-macro', which inserts Lisp code to define the macro as
531 it is currently defined into the buffer before point.  Visit a Lisp
532 file such as your Emacs init file `~/.emacs', insert the macro
533 definition (perhaps deleting an old definition for the same macro)
534 and then save the file.
536 ** C-x ' command.
538 The new command C-x ' (expand-abbrev) expands the word before point as
539 an abbrev, even if abbrev-mode is not turned on.
541 ** Sending to inferior Lisp.
543 The command C-M-x in Lisp mode, which sends the current defun to
544 an inferior Lisp process, now works by writing the text into a temporary
545 file and actually sending only a `load'-form to load the file.
546 As a result, it avoids the Unix bugs that used to strike when the
547 text was above a certain length.
549 With a prefix argument, this command now makes the inferior Lisp buffer
550 appear on the screen and scrolls it so that the bottom is showing.
552 Two variables `inferior-lisp-load-command' and `inferior-lisp-prompt',
553 exist to customize these feature for different Lisp implementations.
555 ** C-x n p now disabled.
557 The command C-x n p, a nonrecomended command which narrows to the current
558 page, is now initially disabled like C-x n n.
560 * Dealing with files.
562 ** C-x C-v generalized
564 This command is now allowed even if the current buffer is not visiting
565 a file.  As usual, it kills the current buffer and replaces it with a
566 newly found file.
568 ** M-x recover-file improved; auto save file names changed.
570 M-x recover-file now checks whether the last auto-save file is more
571 recent than the real visited file before offering to read in the
572 auto-save file.  If the auto-save file is newer, a directory listing
573 containing the two files is displayed while you are asked whether you
574 want the auto save file.
576 Visiting a file also makes this check.  If the auto-save file is more recent,
577 a message is printed suggesting that you consider using M-x recover file.
579 Auto save file names now by default have a `#' at the end as well
580 as at the beginning.  This is so that `*.c' in a shell command
581 will never match auto save files.
583 On VMS, auto save file names are made by appending `_$' at the front
584 and `$' at the end.
586 When you change the visited file name of a buffer, the auto save file
587 is now renamed to belong to the new visited file name.
589 You can customize the way auto save file names are made by redefining
590 the two functions `make-auto-save-file-name' and `auto-save-file-name-p',
591 both of which are defined in `files.el'.
593 ** Modifying a buffer whose file is changed on disk is detected instantly.
595 On systems where clash detection (locking of files being edited) is
596 implemented, Emacs also checks the first time you modify a buffer
597 whether the file has changed on disk since it was last visited or saved.
598 If it has, you are asked to confirm that you want to change the buffer.
600 ** Exiting Emacs offers to save `*mail*'.
602 Emacs can now know about buffers that it should offer to save on exit
603 even though they are not visiting files.  This is done for any buffer
604 which has a non-nil local value of `buffer-offer-save'.  By default,
605 Mail mode provides such a local value.
607 ** Backup file changes.
609 If a backup file cannot be written in the directory of the visited file
610 due to fascist file protection, a backup file is now written in your home
611 directory as `~/%backup%~'.  Only one such file is made, ever, so only
612 the most recently made such backup is available.
614 When backup files are made by copying, the last-modification time of the
615 original file is now preserved in the backup copy.
617 ** Visiting remote files.
619 On an internet host, you can now visit and save files on any other
620 internet host directly from Emacs with the commands M-x ftp-find-file
621 and M-x ftp-write-file.  Specify an argument of the form HOST:FILENAME.
622 Since standard internet FTP is used, the other host may be any kind
623 of machine and is not required to have any special facilities.
625 The first time any one remote host is accessed, you will be asked to
626 give the user name and password for use on that host.  FTP is reinvoked
627 each time you ask to use it, but previously specified user names and
628 passwords are remembered automatically.
630 ** Dired `g' command.
632 `g' in Dired mode is equivalent to M-x revert-buffer; it causes the
633 current contents of the same directory to be read in.
635 * Changes in major modes.
637 ** C mode indentation change.
639 The binding of Linefeed is no longer changed by C mode.  It once again
640 has its normal meaning, which is to insert a newline and then indent
641 afterward.
643 The old definition did one additional thing: it reindented the line
644 before the new newline.  This has been removed because it made the
645 command twice as slow.  The only time it was really useful was after the
646 insertion of an `else', since the fact of starting with `else' may change
647 the way that line is indented.  Now you will have to type TAB again
648 yourself to reindent the `else' properly.
650 If the variable `c-tab-always-indent' is set to `nil', the TAB command
651 in C mode, with no argument, will just insert a tab character if there
652 is non-whitespace preceding point on the current line.  Giving it a
653 prefix argument will force reindentation of the line (as well as
654 of the compound statement that begins after point, if any).
656 ** Fortran mode now exists.
658 This mode provides commands for motion and indentation of Fortran code,
659 plus built-in abbrevs for Fortran keywords.  For details, see the manual
660 or the on-line documentation of the command `fortran-mode'.
662 ** Scribe mode now exists.
664 This mode does something useful for editing files of Scribe input.
665 It is used automatically for files with names ending in ".mss".
667 ** Modula2 and Prolog modes now exist.
669 These modes are for editing programs in the languages of the same names.
670 They can be selected with M-x modula-2-mode and M-x prolog-mode.
672 ** Telnet mode changes.
674 The telnet mode special commands have now been assigned to C-c keys.
675 Most of them are the same as in Shell mode.
677 ** Picture mode changes.
679 The special picture-mode commands to specify the direction of cursor
680 motion after insertion have been moved to C-c keys.  The commands to
681 specify diagonal motion were already C-c keys; they are unchanged.
682 The keys to specify horizontal or vertical motion are now
683 C-c < (left), C-c > (right), C-c ^ (up) and C-c . (down).
685 ** Nroff mode comments.
687 Comments are now supported in Nroff mode.  The standard comment commands
688 such as M-; and C-x ; know how to insert, align and delete comments
689 that start with backslash-doublequote.
691 ** LaTeX mode.
693 LaTeX mode now exists.  Use M-x latex-mode to select this mode, and
694 M-x plain-tex-mode to select the previously existing mode for Plain
695 TeX.  M-x tex-mode attempts to examine the contents of the buffer and
696 choose between latex-mode and plain-tex-mode accordingly; if the
697 buffer is empty or it cannot tell, the variable `TeX-default-mode'
698 controls the choice.  Its value should be the symbol for the mode to
699 be used.
701 The facilities for running TeX on all or part of the buffer
702 work with LaTeX as well.
704 Some new commands available in both modes:
706 C-c C-l         recenter the window showing the TeX output buffer
707                  so most recent line of output can be seen.
708 C-c C-k         kill the TeX subprocess.
709 C-c C-q         show the printer queue.
710 C-c C-f         close a block (appropriate for LaTeX only).
711                  If the current line contains a \begin{...},
712                  this inserts an \end{...} on the following line
713                  and puts point on a blank line between them.
715 ** Outline mode changes.
717 Invisible lines in outline mode are now indicated by `...' at the
718 end of the previous visible line.
720 The special outline heading motion commands are now all on C-c keys.
721 A few new ones have been added.  Here is a full list:
723 C-c C-n   Move to next visible heading (formerly M-})
724 C-c C-p   Move to previous visible heading (formerly M-{)
725 C-c C-f   Move to next visible heading at the same level.
726            Thus, if point is on a level-2 heading line,
727            this command moves to the next visible level-2 heading.
728 C-c C-b   Move to previous visible heading at the same level.
729 C-c C-u   Move up to previous visible heading at a higher level.
731 The variable `outline-regexp' now controls recognition of heading lines.
732 Any line whose beginning matches this regexp is a heading line.
733 The depth in outline structure is determined by the length of
734 the string that matches.
736 A line starting with a ^L (formfeed) is now by default considered
737 a header line.
739 * Mail reading and sending.
741 ** MH-E changes.
743 MH-E has been extensively modified and improved since the v17 release.
744 It contains many new features, including commands to: extracted failed
745 messages, kill a draft message, undo changes to a mail folder, monitor
746 delivery of a letter, print multiple messages, page digests backwards,
747 insert signatures, and burst digests.  Also, many commands have been
748 made to able to deal with named sequences of messages, instead of
749 single messages.  MH-E also has had numerous bugs fixed and commands
750 made to run faster.  Furthermore, its keybindings have been changed to
751 be compatible with Rmail and the rest of GNU Emacs.
753 ** Mail mode changes.
755 The C-c commands of mail mode have been rearranged:
757 C-c s, C-c c, C-c t and C-c b (move point to various header fields)
758 have been reassigned as C-c C-f C-s, C-c C-f C-c, C-c C-f C-t and C-c
759 C-f C-b.  C-c C-f is for "field".
761 C-c y, C-c w and C-c q have been changed to C-c C-y, C-c C-w and C-c C-q.
763 Thus, C-c LETTER is always unassigned.
765 ** Rmail C-r command changed to w.
767 The Rmail command to edit the current message is now `w'.  This change
768 has been made because people frequently type C-r while in Rmail hoping
769 to do a reverse incremental search.  That now works.
771 * Rnews changes.
773 ** Caesar rotation added.
775 The function news-caesar-buffer-body performs the rot13 code on the
776 body of a news message.  You can also specify the number to rotate by,
777 as a prefix argument.  The function is bound to C-c C-r in both
778 News mode and News Reply mode.
780 ** rmail-output command added.
782 The C-o command has been bound to rmail-output in news-mode.
783 This allows one to append an article to a file which is in either Unix
784 mail or RMAIL format.
786 ** news-reply-mode changes.
788 The C-c commands of news reply mode have been rearranged and changed,
789 so that C-c LETTER is always unassigned:
791 C-c y, C-c w and C-c q have been changed to C-c C-y, C-c C-w and C-c C-q.
793 C-c c, C-c t, and C-c b (move to various mail header fields) have been
794 deleted (they make no sense for posting and replying to USENET).
796 C-c s (move to Subject: header field) has been reassigned as C-c C-f
797 C-s.  C-c C-f is for "field".  Several additional move to news header
798 field commands have been added.
800 The local news-reply-mode bindings now look like this:
802 C-c C-s  news-inews (post the message)    C-c C-c  news-inews
803 C-c C-f  move to a header field (and create it if there isn't):
804          C-c C-f C-n  move to Newsgroups:       C-c C-f C-s  move to Subj:
805          C-c C-f C-f  move to Followup-To:      C-c C-f C-k  move to Keywords:
806          C-c C-f C-d  move to Distribution:     C-c C-f C-a  move to Summary:
807 C-c C-y  news-reply-yank-original (insert current message, in NEWS).
808 C-c C-q  mail-fill-yanked-message (fill what was yanked).
809 C-c C-r  caesar rotate all letters by 13 places in the article's body (rot13).
811 * Changes in tags handling.
813 ** M-. (`find-tag') and similar commands now look first for an exact
814 match in the tags table, and try substring matches only afterward.
816 ** The new command `find-tag-regexp' visits successively the tags that
817 match a specified regular expression.
819 ** You can now use more than one tags table.  Using `visit-tags-table'
820 to load a new tags table does not discard the other tables previously
821 loaded.  The other tags commands use all the tags tables that are loaded;
822 the first tags table used is the one that mentions the current visited file.
824 ** Tags tables can now be told to "include" other tags tables.  This means
825 the tags table gives the file names of other tags tables.  Tags command
826 then search included tags tables after the including table (but before any
827 other tags tables you have loaded).  Included tags tables can make it much
828 easier and more efficient to maintain a tags table for a large package with
829 many subdirectories--there is one tags table for each subdirectory, and a
830 master tags table that includes each subdirectory table.  You use `-i'
831 options to `etags' when creating the tags table to give the file names of
832 the included tables.
834 ** You can now use the tags table for completion of names during
835 ordinary editing.  The command M-TAB (except in Emacs Lisp mode)
836 completes the identifier in the buffer before point, using the set of
837 all tags as the list of possible completions.
839 ** `tags-query-replace' and `tags-search' changes.
841 These functions no longer permanently create buffers for files that
842 are searched but that do not contain any matches for the search
843 pattern.
845 * Existing Emacs usable as a server.
847 Programs such as mailers that invoke "the editor" as an inferior
848 to edit some text can now be told to use an existing Emacs process
849 instead of creating a new editor.
851 To do this, you must have an Emacs process running and capable of
852 doing terminal I/O at the time you want to invoke it.  This means that
853 either you are using a window system and give Emacs a separate window
854 or you run the other programs as inferiors of Emacs (such as, using
855 M-x shell).
857 First prepare the existing Emacs process by loading the `server'
858 library and executing M-x server-start.  (Your .emacs can do this
859 automatically.)
861 Now tell the other programs to use, as "the editor", the Emacs client
862 program (etc/emacsclient, located in the same directory as this file).
863 This can be done by setting the environment variable EDITOR.
865 When another program invokes the emacsclient as "the editor", the
866 client actually transfers the file names to be edited to the existing
867 Emacs, which automatically visits the files.
869 When you are done editing a buffer for a client, do C-x # (server-edit).
870 This marks that buffer as done, and selects the next buffer that the client
871 asked for.  When all the buffers requested by a client are marked in this
872 way, Emacs tells the client program to exit, so that the program that
873 invoked "the editor" will resume execution.
875 You can only have one server Emacs at a time, but multiple client programs
876 can put in requests at the same time.
878 The client/server work only on Berkeley Unix, since they use the Berkeley
879 sockets mechanism for their communication.
881 Changes in Lisp programming in Emacs version 18.
883 * Init file changes.
885 ** Suffixes no longer accepted on `.emacs'.
887 Emacs will no longer load a file named `.emacs.el' or `emacs.elc'
888 in place of `.emacs'.  This is so that it will take less time to
889 find `.emacs'.  If you want to compile your init file, give it another
890 name and make `.emacs' a link to the `.elc' file, or make it contain
891 a call to `load' to load the `.elc' file.
893 ** `default-profile' renamed to `default', and loaded after `.emacs'.
895 It used to be the case that the file `default-profile' was loaded if
896 and only if `.emacs' was not found.
898 Now the name `default-profile' is not used at all.  Instead, a library
899 named `default' is loaded after the `.emacs' file.  `default' is loaded
900 whether the `.emacs' file exists or not.  However, loading of `default'
901 can be prevented if the `.emacs' file sets `inhibit-default-init' to non-nil.
903 In fact, you would call the default file `default.el' and probably would
904 byte-compile it to speed execution.
906 Note that for most purposes you are better off using a `site-init' library
907 since that will be loaded before the runnable Emacs is dumped.  By using
908 a `site-init' library, you avoid taking up time each time Emacs is started.
910 ** inhibit-command-line has been eliminated.
912 This variable used to exist for .emacs files to set.  It has been
913 eliminated because you can get the same effect by setting
914 command-line-args to nil and setting inhibit-startup-message to t.
916 * `apply' is more general.
918 `apply' now accepts any number of arguments.  The first one is a function;
919 the rest are individual arguments to pass to that function, except for the
920 last, which is a list of arguments to pass.
922 Previously, `apply' required exactly two arguments.  Its old behavior
923 follows as a special case of the new definition.
925 * New code-letter for `interactive'.
927 (interactive "NFoo: ") is like (interactive "nFoo: ") in reading
928 a number using the minibuffer to serve as the argument; however,
929 if a prefix argument was specified, it uses the prefix argument
930 value as the argument, and does not use the minibuffer at all.
932 This is used by the `goto-line' and `goto-char' commands.
934 * Semantics of variables.
936 ** Built-in per-buffer variables improved.
938 Several built-in variables which in the past had a different value in
939 each buffer now behave exactly as if `make-variable-buffer-local' had
940 been done to them.
942 These variables are `tab-width', `ctl-arrow', `truncate-lines',
943 `fill-column', `left-margin', `mode-line-format', `abbrev-mode',
944 `overwrite-mode', `case-fold-search', `auto-fill-hook',
945 `selective-display', `selective-display-ellipses'.
947 To be precise, each variable has a default value which shows through
948 in most buffers and can be accessed with `default-value' and set with
949 `set-default'.  Setting the variable with `setq' makes the variable
950 local to the current buffer.  Changing the default value has retroactive
951 effect on all buffers in which the variable is not local.
953 The variables `default-case-fold-search', etc., are now obsolete.
954 They now refer to the default value of the variable, which is not
955 quite the same behavior as before, but it should enable old init files
956 to continue to work.
958 ** New per-buffer variables.
960 The variables `fill-prefix', `comment-column' and `indent-tabs-mode'
961 are now per-buffer.  They work just like `fill-column', etc.
963 ** New function `setq-default'.
965 `setq-default' sets the default value of a variable, and uses the
966 same syntax that `setq' accepts: the variable name is not evaluated
967 and need not be quoted.
969 `(setq-default case-fold-search nil)' would make searches case-sensitive
970 in all buffers that do not have local values for `case-fold-search'.
972 You can set multiple variables sequentially, each with its own value,
973 in `setq-default' just as in `setq'.
975 ** Functions `global-set' and `global-value' deleted.
977 These functions were never used except by mistake by users expecting
978 the functionality of `set-default' and `default-value'.
980 * Changes in defaulting of major modes.
982 When `default-major-mode' is `nil', new buffers are supposed to
983 get their major mode from the buffer that is current.  However,
984 certain major modes (such as Dired mode, Rmail mode, Rmail Summary mode,
985 and others) are not reasonable to use in this way.
987 Now such modes' names have been given non-`nil' `mode-class' properties.
988 If the current buffer's mode has such a property, Fundamental mode is
989 used as the default for newly created buffers.
991 * `where-is-internal' requires additional arguments.
993 This function now accepts three arguments, two of them required:
994 DEFINITION, the definition to search for; LOCAL-KEYMAP, the keymap
995 to use as the local map when doing the searching, and FIRST-ONLY,
996 which is nonzero to return only the first key found.
998 This function returns a list of keys (strings) whose definitions
999 (in the LOCAL-KEYMAP or the current global map) are DEFINITION.
1001 If FIRST-ONLY is non-nil, it returns a single key (string).
1003 This function has changed incompatibly in that now two arguments
1004 are required when previously only one argument was allowed.  To get
1005 the old behavior of this function, write `(current-local-map)' as
1006 the expression for the second argument.
1008 The incompatibility is sad, but `nil' is a legitimate value for the
1009 second argument (it means there is no local keymap), so it cannot also
1010 serve as a default meaning to use the current local keymap.
1012 * Abbrevs with hooks.
1014 When an abbrev defined with a hook is expanded, it now performs the
1015 usual replacement of the abbrev with the expansion before running the
1016 hook.  Previously the abbrev itself was deleted but the expansion was
1017 not inserted.
1019 * Function `scan-buffer' deleted.
1021 Use `search-forward' or `search-backward' in place of `scan-buffer'.
1022 You will have to rearrange the arguments.
1024 * X window interface improvements.
1026 ** Detect release of mouse buttons.
1028 Button-up events can now be detected.  See the file `lisp/x-mouse.el'
1029 for details.
1031 ** New pop-up menu facility.
1033 The new function `x-popup-menu' pops up a menu (in a X window)
1034 and returns an indication of which selection the user made.
1035 For more information, see its self-documentation.
1037 * M-x disassemble.
1039 This command prints the disassembly of a byte-compiled Emacs Lisp function.
1041 Would anyone like to interface this to the debugger?
1043 * `insert-buffer-substring' can insert part of the current buffer.
1045 The old restriction that the text being inserted had to come from
1046 a different buffer is now lifted.
1048 When inserting text from the current buffer, the text to be inserted
1049 is determined from the specified bounds before any copying takes place.
1051 * New function `substitute-key-definition'.
1053 This is a new way to replace one command with another command as the
1054 binding of whatever keys may happen to refer to it.
1056 (substitute-key-definition OLDDEF NEWDEF KEYMAP) looks through KEYMAP
1057 for keys defined to run OLDDEF, and rebinds those keys to run NEWDEF
1058 instead.
1060 * New function `insert-char'.
1062 Insert a specified character, a specified number of times.
1064 * `mark-marker' changed.
1066 When there is no mark, this now returns a marker that points
1067 nowhere, rather than `nil'.
1069 * `ding' accepts argument.
1071 When given an argument, the function `ding' does not terminate
1072 execution of a keyboard macro.  Normally, `ding' does terminate
1073 all macros that are currently executing.
1075 * New function `minibuffer-depth'.
1077 This function returns the current depth in minibuffer activations.
1078 The value is zero when the minibuffer is not in use.
1079 Values greater than one are possible if the user has entered the
1080 minibuffer recursively.
1082 * New function `documentation-property'.
1084 (documentation-property SYMBOL PROPNAME) is like (get SYMBOL PROPNAME),
1085 except that if the property value is a number `documentation-property'
1086 will take that number (or its absolute value) as a character position
1087 in the DOC file and return the string found there.
1089 (documentation-property VAR 'variable-documentation) is the proper
1090 way for a Lisp program to get the documentation of variable VAR.
1092 * New documentation-string expansion feature.
1094 If a documentation string (for a variable or function) contains text
1095 of the form `\<FOO>', it means that all command names specified in
1096 `\[COMMAND]' construct from that point on should be turned into keys
1097 using the value of the variable FOO as the local keymap.  Thus, for example,
1099   `\<emacs-lisp-mode-map>\[eval-defun] evaluates the defun containing point.'
1101 will expand into
1103   "ESC C-x evaluates the defun containing point."
1105 regardless of the current major mode, because ESC C-x is defined to
1106 run `eval-defun' in the keymap `emacs-lisp-mode-map'.  The effect is
1107 to show the key for `eval-defun' in Emacs Lisp mode regardless of the
1108 current major mode.
1110 The `\<...>' construct applies to all `\[...]' constructs that follow it,
1111 up to the end of the documentation string or the next `\<...>'.
1113 Without `\<...>', the keys for commands specified in `\[...]' are found
1114 in the current buffer's local map.
1116 The current global keymap is always searched second, whether `\<...>'
1117 has been used or not.
1119 * Multiple hooks allowed in certain contexts.
1121 The old hook variables `find-file-hook', `find-file-not-found-hook' and
1122 `write-file-hook' have been replaced.
1124 The replacements are `find-file-hooks', `find-file-not-found-hooks'
1125 and `write-file-hooks'.  Each holds a list of functions to be called;
1126 by default, `nil', for no functions.  The functions are called in
1127 order of appearance in the list.
1129 In the case of `find-file-hooks', all the functions are executed.
1131 In the case of `find-file-not-found-hooks', if any of the functions
1132 returns non-`nil', the rest of the functions are not called.
1134 In the case of `write-file-hooks', if any of the functions returns
1135 non-`nil', the rest of the functions are not called, and the file is
1136 considered to have been written already; so actual writing in the
1137 usual way is not done.  If `write-file-hooks' is local to a buffer,
1138 it is set to its global value if `set-visited-file-name' is called
1139 (and thus by C-x C-w as well).
1141 `find-file-not-found-hooks' and `write-file-hooks' can be used
1142 together to implement editing of files that are not stored as Unix
1143 files: stored in archives, or inside version control systems, or on
1144 other machines running other operating systems and accessible via ftp.
1146 * New hooks for suspending Emacs.
1148 Suspending Emacs runs the hook `suspend-hook' before suspending
1149 and the hook `suspend-resume-hook' if the suspended Emacs is resumed.
1150 Running a hook is done by applying the variable's value to no arguments
1151 if the variable has a non-`nil' value.  If `suspend-hook' returns
1152 non-`nil', then suspending is inhibited and so is running the
1153 `suspend-resume-hook'.  The non-`nil' value means that the `suspend-hook'
1154 has done whatever suspending is required.
1156 * Disabling commands can print a special message.
1158 A command is disabled by giving it a non-`nil' `disabled' property.
1159 Now, if this property is a string, it is included in the message
1160 printed when the user tries to run the command.
1162 * Emacs can open TCP connections.
1164 The function `open-network-stream' opens a TCP connection to
1165 a specified host and service.  Its value is a Lisp object that represents
1166 the connection.  The object is a kind of "subprocess", and I/O are
1167 done like I/O to subprocesses.
1169 * Display-related changes.
1171 ** New mode-line control features.
1173 The display of the mode line used to be controlled by a format-string
1174 that was the value of the variable `mode-line-format'.
1176 This variable still exists, but it now allows more general values,
1177 not just strings.  Lists, cons cells and symbols are also meaningful.
1179 The mode line contents are created by outputting various mode elements
1180 one after the other.  Here are the kinds of objects that can be
1181 used as mode elements, and what they do in the display:
1183   string        the contents of the string are output to the mode line,
1184                 and %-constructs are replaced by other text.
1186   t or nil      ignored; no output results.
1188   symbol        the symbol's value is used.  If the value is a string,
1189                 the string is output verbatim to the mode line
1190                 (so %-constructs are not interpreted).  Otherwise,
1191                 the symbol's value is processed as a mode element.
1193   list (whose first element is a string or list or cons cell)
1194                 the elements of the list are treated as as mode elements,
1195                 so that the output they generate is concatenated,
1197   list (whose car is a symbol)
1198                 if the symbol's value is non-nil, the second element of the
1199                 list is treated as a mode element.  Otherwise, the third
1200                 element (if any) of the list is treated as a mode element.
1202   cons (whose car is a positive integer)
1203                 the cdr of the cons is used as a mode element, but
1204                 the text it produces is padded, if necessary, to have
1205                 at least the width specified by the integer.
1207   cons (whose car is a negative integer)
1208                 the cdr of the cons is used as a mode element, but
1209                 the text it produces is truncated, if necessary, to have
1210                 at most the width specified by the integer.
1212 There is always one mode element to start with, that being the value of
1213 `mode-line-format', but if this value is a list then it leads to several
1214 more mode elements, which can lead to more, and so on.
1216 There is one new %-construct for mode elements that are strings:
1217 `%n' displays ` Narrow' for a buffer that is narrowed.
1219 The default value of `mode-line-format' refers to several other variables.
1220 These variables are `mode-name', `mode-line-buffer-identification',
1221 `mode-line-process', `mode-line-modified', `global-mode-string' and
1222 `minor-mode-alist'.  The first four are local in every buffer in which they
1223 are changed from the default.
1225 mode-name       Name of buffer's major mode.  Local in every buffer.
1227 mode-line-buffer-identification
1228                 Normally the list ("Emacs: %17b"), it is responsible
1229                 for displaying text to indicate what buffer is being shown
1230                 and what kind of editing it is doing.  `Emacs' means
1231                 that a file of characters is being edited.  Major modes
1232                 such as Info and Dired which edit or view other kinds
1233                 of data often change this value.  This variables becomes
1234                 local to the current buffer if it is setq'd.
1236 mode-line-process
1237                 Normally nil, this variable is responsible for displaying
1238                 information about the process running in the current buffer.
1239                 M-x shell-mode and M-x compile alter this variable.
1241 mode-line-modified
1242                 This variable is responsible for displaying the indication
1243                 of whether the current buffer is modified or read-only.
1244                 By default its value is `("--%*%*-")'.
1246 minor-mode-alist
1247                 This variable is responsible for displaying text for those
1248                 minor modes that are currently enabled.  Its value
1249                 is a list of elements of the form (VARIABLE STRING),
1250                 where STRING is to be displayed if VARIABLE's value
1251                 (in the buffer whose mode line is being displayed)
1252                 is non-nil.  This variable is not made local to particular
1253                 buffers, but loading some libraries may add elements to it.
1255 global-mode-string
1256                 This variable is used to display the time, if you ask
1257                 for that.
1259 The idea of these variables is to eliminate the need for major modes
1260 to alter mode-line-format itself.
1262 ** `window-point' valid for selected window.
1264 The value returned by `window-point' used to be incorrect when its
1265 argument was the selected window.  Now the value is correct.
1267 ** Window configurations may be saved as Lisp objects.
1269 The function `current-window-configuration' returns a special type of
1270 Lisp object that represents the current layout of windows: the
1271 sizes and positions of windows, which buffers appear in them, and
1272 which parts of the buffers appear on the screen.
1274 The function `set-window-configuration' takes one argument, which must
1275 be a window configuration object, and restores that configuration.
1277 ** New hook `temp-output-buffer-show-hook'.
1279 This hook allows you to control how help buffers are displayed.
1280 Whenever `with-output-to-temp-buffer' has executed its body and wants
1281 to display the temp buffer, if this variable is bound and non-`nil'
1282 then its value is called with one argument, the temp buffer.
1283 The hook function is solely responsible for displaying the buffer.
1284 The standard manner of display--making the buffer appear in a window--is
1285 used only if there is no hook function.
1287 ** New function `minibuffer-window'.
1289 This function returns the window used (sometimes) for displaying
1290 the minibuffer.  It can be used even when the minibuffer is not active.
1292 ** New feature to `next-window'.
1294 If the optional second argument is neither `nil' nor `t', the minibuffer
1295 window is omitted from consideration even when active; if the starting
1296 window was the last non-minibuffer window, the value will be the first
1297 non-minibuffer window.
1299 ** New variable `minibuffer-scroll-window'.
1301 When this variable is non-`nil', the command `scroll-other-window'
1302 uses it as the window to be scrolled.  Displays of completion-lists
1303 set this variable to the window containing the display.
1305 ** New argument to `sit-for'.
1307 A non-nil second argument to `sit-for' means do not redisplay;
1308 just wait for the specified time or until input is available.
1310 ** Deleted function `set-minor-mode'; minor modes must be changed.
1312 The function `set-minor-mode' has been eliminated.  The display
1313 of minor mode names in the mode line is now controlled by the
1314 variable `minor-mode-alist'.  To specify display of a new minor
1315 mode, it is sufficient to add an element to this list.  Once that
1316 is done, you can turn the mode on and off just by setting a variable,
1317 and the display will show its status automatically.
1319 ** New variable `cursor-in-echo-area'.
1321 If this variable is non-nil, the screen cursor appears on the
1322 last line of the screen, at the end of the text displayed there.
1324 Binding this variable to t is useful at times when reading single
1325 characters of input with `read-char'.
1327 ** New per-buffer variable `selective-display-ellipses'.
1329 If this variable is non-nil, an ellipsis (`...') appears on the screen
1330 at the end of each text line that is followed by invisible text.
1332 If this variable is nil, no ellipses appear.  Then there is no sign
1333 on the screen that invisible text is present.
1335 Text is made invisible under the control of the variable
1336 `selective-display'; this is how Outline mode and C-x $ work.
1338 ** New variable `no-redraw-on-reenter'.
1340 If you set this variable non-nil, Emacs will not clear the screen when
1341 you resume it after suspending it.  This is for the sake of terminals
1342 with multiple screens of memory, where the termcap entry has been set
1343 up to switch between screens when Emacs is suspended and resumed.
1345 ** New argument to `set-screen-height' or `set-screen-width'.
1347 These functions now take an optional second argument which says
1348 what significance the newly specified height or width has.
1350 If the argument is nil, or absent, it means that Emacs should
1351 believe that the terminal height or width really is as just specified.
1353 If the argument is t, it means Emacs should not believe that the
1354 terminal really is this high or wide, but it should use the
1355 specific height or width as the number of lines or columns to display.
1356 Thus, you could display only 24 lines on a screen known to have 48 lines.
1358 What practical difference is there between using only 24 lines for display
1359 and really believing that the terminal has 24 lines?
1361 1. The "real" height of the terminal says what the terminal command
1362 to move the cursor to the last line will do.
1364 2. The "real" height of the terminal determines how much padding is
1365 needed.
1367 * File-related changes.
1369 ** New parameter `backup-by-copying-when-mismatch'.
1371 If this variable is non-`nil', then when Emacs is about to save a
1372 file, it will create the backup file by copying if that would avoid
1373 changing the file's uid or gid.
1375 The default value of this variable is `nil', because usually it is
1376 useful to have the uid of a file change according to who edited it
1377 last.  I recommend thet this variable be left normally `nil' and
1378 changed with a local variables list in those particular files where
1379 the uid needs to be preserved.
1381 ** New parameter `file-precious-flag'.
1383 If this variable is non-`nil', saving the buffer tries to avoid
1384 leaving an incomplete file due to disk full or other I/O errors.
1385 It renames the old file before saving.  If saving is successful,
1386 the renamed file is deleted; if saving gets an error, the renamed
1387 file is renamed back to the name you visited.
1389 Backups are always made by copying for such files.
1391 ** New variable `buffer-offer-save'.
1393 If the value of this variable is non-`nil' in a buffer then exiting
1394 Emacs will offer to save the buffer (if it is modified and nonempty)
1395 even if the buffer is not visiting a file.  This variable is
1396 automatically made local to the current buffer whenever it is set.
1398 ** `rename-file', `copy-file', `add-name-to-file' and `make-symbolic-link'.
1400 The third argument to these functions used to be `t' or `nil'; `t'
1401 meaning go ahead even if the specified new file name already has a file,
1402 and `nil' meaning to get an error.
1404 Now if the third argument is a number it means to ask the user for
1405 confirmation in this case.
1407 ** New optional argument to `copy-file'.
1409 If `copy-file' receives a non-nil fourth argument, it attempts
1410 to give the new copy the same time-of-last-modification that the
1411 original file has.
1413 ** New function `file-newer-than-file-p'.
1415 (file-newer-than-file-p FILE1 FILE2) returns non-nil if FILE1 has been
1416 modified more recently than FILE2.  If FILE1 does not exist, the value
1417 is always nil; otherwise, if FILE2 does not exist, the value is t.
1418 This is meant for use when FILE2 depends on FILE1, to see if changes
1419 in FILE1 make it necessary to recompute FILE2 from it.
1421 ** Changed function `file-exists-p'.
1423 This function is no longer the same as `file-readable-p'.
1424 `file-exists-p' can now return t for a file that exists but which
1425 the fascists won't allow you to read.
1427 ** New function `file-locked-p'.
1429 This function receives a file name as argument and returns `nil'
1430 if the file is not locked, `t' if locked by this Emacs, or a
1431 string giving the name of the user who has locked it.
1433 ** New function `file-name-sans-versions'.
1435 (file-name-sans-versions NAME) returns a substring of NAME, with any
1436 version numbers or other backup suffixes deleted from the end.
1438 ** New functions for directory names.
1440 Although a directory is really a kind of file, specifying a directory
1441 uses a somewhat different syntax from specifying a file.
1442 In Emacs, a directory name is used as part of a file name.
1444 On Unix, the difference is small: a directory name ends in a slash,
1445 while a file name does not: thus, `/usr/rms/' to name a directory,
1446 while `/usr/rms' names the file which holds that directory.
1448 On VMS, the difference is considerable: `du:[rms.foo]' specifies a
1449 directory, but the name of the file that holds that directory is
1450 `du:[rms]foo.dir'.
1452 There are two new functions for converting between directory names
1453 and file names.  `directory-file-name' takes a directory name and
1454 returns the name of the file in which that directory's data is stored.
1455 `file-name-as-directory' takes the name of a file and returns
1456 the corresponding directory name.  These always understand Unix file name
1457 syntax; on VMS, they understand VMS syntax as well.
1459 For example, (file-name-as-directory "/usr/rms") returns "/usr/rms/"
1460 and (directory-file-name "/usr/rms/") returns "/usr/rms".
1461 On VMS, (file-name-as-directory "du:[rms]foo.dir") returns "du:[rms.foo]"
1462 and (directory-file-name "du:[rms.foo]") returns "du:[rms]foo.dir".
1464 ** Value of `file-attributes' changed.
1466 The function file-attributes returns a list containing many kinds of
1467 information about a file.  Now the list has eleven elements.
1469 The tenth element is `t' if deleting the file and creating another
1470 file of the same name would result in a change in the file's group;
1471 `nil' if there would be no change.  You can also think of this as
1472 comparing the file's group with the default group for files created in
1473 the same directory by you.
1475 The eleventh element is the inode number of the file.
1477 ** VMS-only function `file-name-all-versions'.
1479 This function returns a list of all the completions, including version
1480 number, of a specified version-number-less file name.  This is like
1481 `file-name-all-completions', except that the latter returns values
1482 that do not include version numbers.
1484 ** VMS-only variable `vms-stmlf-recfm'.
1486 On a VMS system, if this variable is non-nil, Emacs will give newly
1487 created files the record format `stmlf'.  This is necessary for files
1488 that must contain lines of arbitrary length, such as compiled Emacs
1489 Lisp.
1491 When writing a new version of an existing file, Emacs always keeps
1492 the same record format as the previous version; so this variable has
1493 no effect.
1495 This variable has no effect on Unix systems.
1497 ** `insert-file-contents' on an empty file.
1499 This no longer sets the buffer's "modified" flag.
1501 ** New function (VMS only) `define-logical-name':
1503 (define-logical-name LOGICAL TRANSLATION) defines a VMS logical name
1504 LOGICAL whose translation is TRANSLATION.  The new name applies to
1505 the current process only.
1507 ** Deleted variable `ask-about-buffer-names'.
1509 If you want buffer names for files to be generated in a special way,
1510 you must redefine `create-file-buffer'.
1512 * Subprocess-related changes.
1514 ** New function `process-list'.
1516 This function takes no arguments and returns a list of all
1517 of Emacs's asynchronous subprocesses.
1519 ** New function `process-exit-status'.
1521 This function, given a process, process name or buffer as argument,
1522 returns the exit status code or signal number of the process.
1523 If the process has not yet exited or died, this function returns 0.
1525 ** Process output ignores `buffer-read-only'.
1527 Output from a process will go into the process's buffer even if the
1528 buffer is read only.
1530 ** Switching buffers in filter functions and sentinels.
1532 Emacs no longer saves and restore the current buffer around calling
1533 the filter and sentinel functions, so these functions can now
1534 permanently alter the selected buffer in a straightforward manner.
1536 ** Specifying environment variables for subprocesses.
1538 When a subprocess is started with `start-process' or `call-process',
1539 the value of the variable `process-environment' is taken to
1540 specify the environment variables to give the subprocess.  The
1541 value should be a list of strings, each of the form "VAR=VALUE".
1543 `process-environment' is initialized when Emacs starts up
1544 based on Emacs's environment.
1546 ** New variable `process-connection-type'.
1548 If this variable is `nil', when a subprocess is created, Emacs uses
1549 a pipe rather than a pty to communicate with it.  Normally this
1550 variable is `t', telling Emacs to use a pty if ptys are supported
1551 and one is available.
1553 ** New function `waiting-for-user-input-p'.
1555 This function, given a subprocess as argument, returns `t' if that
1556 subprocess appears to be waiting for input sent from Emacs,
1557 or `nil' otherwise.
1559 ** New hook `shell-set-directory-error-hook'.
1561 The value of this variable is called, with no arguments, whenever
1562 Shell mode gets an error trying to keep track of directory-setting
1563 commands (such as `cd' and `pushd') used in the shell buffer.
1565 * New functions `user-uid' and `user-real-uid'.
1567 These functions take no arguments and return, respectively,
1568 the effective uid and the real uid of the Emacs process.
1569 The value in each case is an integer.
1571 * New variable `print-escape-newlines' controls string printing.
1573 If this variable is non-`nil', then when a Lisp string is printed
1574 by the Lisp printing function `prin1' or `print', newline characters
1575 are printed as `\n' rather than as a literal newline.
1577 * New function `sysnetunam' on HPUX.
1579 This function takes two arguments, a network address PATH and a
1580 login string LOGIN, and executes the system call `netunam'.
1581 It returns `t' if the call succeeds, otherwise `nil'.
1583 News regarding installation:
1585 * Many `s-...' file names changed.
1587 Many `s-...' files have been renamed.  All periods in such names,
1588 except the ones just before the final `h', have been changed to
1589 hyphens.  Thus, `s-bsd4.2.h' has been renamed to `s-bsd4-2.h'.
1591 This is so a Unix distribution can be moved mechanically to VMS.
1593 * `DOCSTR...' file now called `DOC-...'.
1595 The file of on-line documentation strings, that used to be
1596 `DOCSTR.mm.nn.oo' in this directory, is now called `DOC-mm.nn.oo'.
1597 This is so that it can port to VMS using the standard conventions
1598 for translating filenames for VMS.
1600 This file also now contains the doc strings for variables as
1601 well as functions.
1603 * Emacs no longer uses floating point arithmetic.
1605 This may make it easier to port to some machines.
1607 * Macros `XPNTR' and `XSETPNTR'; flag `DATA_SEG_BITS'.
1609 These macros exclusively are used to unpack a pointer from a Lisp_Object
1610 and to insert a pointer into a Lisp_Object.  Redefining them may help
1611 port Emacs to machines in which all pointers to data objects have
1612 certain high bits set.
1614 If `DATA_SEG_BITS' is defined, it should be a number which contains
1615 the high bits to be inclusive or'ed with pointers that are unpacked.
1617 * New flag `HAVE_X_MENU'.
1619 Define this flag in `config.h' in addition to `HAVE_X_WINDOWS'
1620 to enable use of the Emacs interface to X Menus.  On some operating
1621 systems, the rest of the X interface works properly but X Menus
1622 do not work; hence this separate flag.  See the file `src/xmenu.c'
1623 for more information.
1625 * Macros `ARRAY_MARK_FLAG' and `DONT_COPY_FLAG'.
1627 * `HAVE_ALLOCA' prevents assembly of `alloca.s'.
1629 * `SYSTEM_MALLOC' prevents use of GNU `malloc.c'.
1631 SYSTEM_MALLOC, if defined, means use the system's own `malloc' routines
1632 rather than those that come with Emacs.
1634 Use this only if absolutely necessary, because if it is used you do
1635 not get warnings when space is getting low.
1637 * New flags to control unexec.
1639 See the file `unexec.c' for a long comment on the compilation
1640 switches that suffice to make it work on many machines.
1642 * `PNTR_COMPARISON_TYPE'
1644 Pointers that need to be compared for ordering are converted to this type
1645 first.  Normally this is `unsigned int'.
1647 * `HAVE_VFORK', `HAVE_DUP2' and `HAVE_GETTIMEOFDAY'.
1649 These flags just say whether certain system calls are available.
1651 * New macros control compiler switches, linker switches and libraries.
1653 The m- and s- files can now control in a modular fashion the precise
1654 arguments passed to `cc' and `ld'.
1656 LIBS_STANDARD defines the standard C libraries.  Default is `-lc'.
1657 LIBS_DEBUG defines the extra libraries to use when debugging.  Default `-lg'.
1658 LIBS_SYSTEM can be defined by the s- file to specify extra libraries.
1659 LIBS_MACHINE can be defined by the m- file to specify extra libraries.
1660 LIBS_TERMCAP defines the libraries for Termcap or Terminfo.
1661   It is defined by default in a complicated fashion but the m- or s- file
1662   can override it.
1664 LD_SWITCH_SYSTEM can be defined by the s- file to specify extra `ld' switches.
1665   The default is `-X' on BSD systems except those few that use COFF object files.
1666 LD_SWITCH_MACHINE can be defined by the m- file to specify extra `ld' switches.
1668 C_DEBUG_SWITCH defines the switches to give `cc' when debugging.  Default `-g'.
1669 C_OPTIMIZE_SWITCH defines the switches to give `cc' to optimize.  Default `-O'.
1670 C_SWITCH_MACHINE can be defined by the m- file to specify extra `cc' switches.
1672 For older news, see the file ONEWS.3.
1674 ----------------------------------------------------------------------
1675 Copyright information:
1677 Copyright (C) 1992 Free Software Foundation, Inc.
1679    Permission is granted to anyone to make or distribute verbatim copies
1680    of this document as received, in any medium, provided that the
1681    copyright notice and this permission notice are preserved,
1682    thus giving the recipient permission to redistribute in turn.
1684    Permission is granted to distribute modified versions
1685    of this document, or of portions of it,
1686    under the above conditions, provided also that they
1687    carry prominent notices stating who last changed them.
1689 Local variables:
1690 mode: text
1691 end: