aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGerd Moellmann2000-08-17 15:38:59 +0000
committerGerd Moellmann2000-08-17 15:38:59 +0000
commit3787e12e9d324207d442b035b066ccec5e10936c (patch)
treea87a49954be68523f5cf60ebcf8466b88d803ed2
parentaff3bff87b8f7c4a6a25378084269f4318ef240c (diff)
downloademacs-3787e12e9d324207d442b035b066ccec5e10936c.tar.gz
emacs-3787e12e9d324207d442b035b066ccec5e10936c.zip
*** empty log message ***
-rw-r--r--etc/ChangeLog6
-rw-r--r--etc/NEWS4984
-rw-r--r--etc/NEWS.16051
-rw-r--r--etc/NEWS.2 (renamed from etc/OOOONEWS)4
-rw-r--r--etc/NEWS.3 (renamed from etc/OOONEWS)4
-rw-r--r--etc/NEWS.4 (renamed from etc/OONEWS)4
-rw-r--r--etc/ONEWS6
-rw-r--r--etc/OOOOONEWS1165
-rw-r--r--lisp/ChangeLog8
9 files changed, 6110 insertions, 6122 deletions
diff --git a/etc/ChangeLog b/etc/ChangeLog
index 93efc8dc5ee..8faaf8a888d 100644
--- a/etc/ChangeLog
+++ b/etc/ChangeLog
@@ -1,3 +1,9 @@
12000-08-17 Gerd Moellmann <gerd@gnu.org>
2
3 * NEWS.1: Reintegrated into NEWS.
4
5 * OOOOONEWS...OONEWS: Renamed to NEWS.1...NEWS.4.
6
12000-08-16 Gerd Moellmann <gerd@gnu.org> 72000-08-16 Gerd Moellmann <gerd@gnu.org>
2 8
3 * dired-ref.tex, dired-ref.ps: New files. 9 * dired-ref.tex, dired-ref.ps: New files.
diff --git a/etc/NEWS b/etc/NEWS
index b8eacecc9bf..b2983a30b2b 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -3,7 +3,7 @@ Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
3See the end for copying conditions. 3See the end for copying conditions.
4 4
5Please send Emacs bug reports to bug-gnu-emacs@gnu.org. 5Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
6For older news, see the file NEWS.1. 6For older news, see the file ONEWS
7 7
8 8
9* Installation Changes in Emacs 21.1 9* Installation Changes in Emacs 21.1
@@ -3456,8 +3456,4988 @@ overrides this as it does on Unix, except that the bar cursor is
3456horizontal rather than vertical (since the MS-DOS display doesn't 3456horizontal rather than vertical (since the MS-DOS display doesn't
3457support a vertical-bar cursor). 3457support a vertical-bar cursor).
3458 3458
3459
3460^L
3461* Emacs 20.7 is a bug-fix release with few user-visible changes
3462
3463** It is now possible to use CCL-based coding systems for keyboard
3464input.
3465
3466** ange-ftp now handles FTP security extensions, like Kerberos.
3467
3468** Rmail has been extended to recognize more forms of digest messages.
3469
3470** Now, most coding systems set in keyboard coding system work not
3471only for character input, but also in incremental search. The
3472exceptions are such coding systems that handle 2-byte character sets
3473(e.g euc-kr, euc-jp) and that use ISO's escape sequence
3474(e.g. iso-2022-jp). They are ignored in incremental search.
3475
3476** Support for Macintosh PowerPC-based machines running GNU/Linux has
3477been added.
3478
3479^L
3480* Emacs 20.6 is a bug-fix release with one user-visible change
3481
3482** Support for ARM-based non-RISCiX machines has been added.
3483
3484^L
3485* Emacs 20.5 is a bug-fix release with no user-visible changes.
3486
3487** Not new, but not mentioned before:
3488M-w when Transient Mark mode is enabled disables the mark.
3489
3490* Changes in Emacs 20.4
3491
3492** Init file may be called .emacs.el.
3493
3494You can now call the Emacs init file `.emacs.el'.
3495Formerly the name had to be `.emacs'. If you use the name
3496`.emacs.el', you can byte-compile the file in the usual way.
3497
3498If both `.emacs' and `.emacs.el' exist, the latter file
3499is the one that is used.
3500
3501** shell-command, and shell-command-on-region, now return
3502the exit code of the command (unless it is asynchronous).
3503Also, you can specify a place to put the error output,
3504separate from the command's regular output.
3505Interactively, the variable shell-command-default-error-buffer
3506says where to put error output; set it to a buffer name.
3507In calls from Lisp, an optional argument ERROR-BUFFER specifies
3508the buffer name.
3509
3510When you specify a non-nil error buffer (or buffer name), any error
3511output is inserted before point in that buffer, with \f\n to separate
3512it from the previous batch of error output. The error buffer is not
3513cleared, so error output from successive commands accumulates there.
3514
3515** Setting the default value of enable-multibyte-characters to nil in
3516the .emacs file, either explicitly using setq-default, or via Custom,
3517is now essentially equivalent to using --unibyte: all buffers
3518created during startup will be made unibyte after loading .emacs.
3519
3520** C-x C-f now handles the wildcards * and ? in file names. For
3521example, typing C-x C-f c*.c RET visits all the files whose names
3522match c*.c. To visit a file whose name contains * or ?, add the
3523quoting sequence /: to the beginning of the file name.
3524
3525** The M-x commands keep-lines, flush-lines and count-matches
3526now have the same feature as occur and query-replace:
3527if the pattern contains any upper case letters, then
3528they never ignore case.
3529
3530** The end-of-line format conversion feature previously mentioned
3531under `* Emacs 20.1 changes for MS-DOS and MS-Windows' actually
3532applies to all operating systems. Emacs recognizes from the contents
3533of a file what convention it uses to separate lines--newline, CRLF, or
3534just CR--and automatically converts the contents to the normal Emacs
3535convention (using newline to separate lines) for editing. This is a
3536part of the general feature of coding system conversion.
3537
3538If you subsequently save the buffer, Emacs converts the text back to
3539the same format that was used in the file before.
3540
3541You can turn off end-of-line conversion by setting the variable
3542`inhibit-eol-conversion' to non-nil, e.g. with Custom in the MULE group.
3543
3544** The character set property `prefered-coding-system' has been
3545renamed to `preferred-coding-system', for the sake of correct spelling.
3546This is a fairly internal feature, so few programs should be affected.
3547
3548** Mode-line display of end-of-line format is changed.
3549The indication of the end-of-line format of the file visited by a
3550buffer is now more explicit when that format is not the usual one for
3551your operating system. For example, the DOS-style end-of-line format
3552is displayed as "(DOS)" on Unix and GNU/Linux systems. The usual
3553end-of-line format is still displayed as a single character (colon for
3554Unix, backslash for DOS and Windows, and forward slash for the Mac).
3555
3556The values of the variables eol-mnemonic-unix, eol-mnemonic-dos,
3557eol-mnemonic-mac, and eol-mnemonic-undecided, which are strings,
3558control what is displayed in the mode line for each end-of-line
3559format. You can now customize these variables.
3560
3561** In the previous version of Emacs, tar-mode didn't work well if a
3562filename contained non-ASCII characters. Now this is fixed. Such a
3563filename is decoded by file-name-coding-system if the default value of
3564enable-multibyte-characters is non-nil.
3565
3566** The command temp-buffer-resize-mode toggles a minor mode
3567in which temporary buffers (such as help buffers) are given
3568windows just big enough to hold the whole contents.
3569
3570** If you use completion.el, you must now run the function
3571dynamic-completion-mode to enable it. Just loading the file
3572doesn't have any effect.
3573
3574** In Flyspell mode, the default is now to make just one Ispell process,
3575not one per buffer.
3576
3577** If you use iswitchb but do not call (iswitchb-default-keybindings) to
3578use the default keybindings, you will need to add the following line:
3579 (add-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup)
3580
3581** Auto-show mode is no longer enabled just by loading auto-show.el.
3582To control it, set `auto-show-mode' via Custom or use the
3583`auto-show-mode' command.
3584
3585** Handling of X fonts' ascent/descent parameters has been changed to
3586avoid redisplay problems. As a consequence, compared with previous
3587versions the line spacing and frame size now differ with some font
3588choices, typically increasing by a pixel per line. This change
3589occurred in version 20.3 but was not documented then.
3590
3591** If you select the bar cursor style, it uses the frame's
3592cursor-color, rather than the cursor foreground pixel.
3593
3594** In multibyte mode, Rmail decodes incoming MIME messages using the
3595character set specified in the message. If you want to disable this
3596feature, set the variable rmail-decode-mime-charset to nil.
3597
3598** Not new, but not mentioned previously in NEWS: when you use #! at
3599the beginning of a file to make it executable and specify an
3600interpreter program, Emacs looks on the second line for the -*- mode
3601and variable specification, as well as on the first line.
3602
3603** Support for IBM codepage encoding of non-ASCII characters.
3604
3605The new command M-x codepage-setup creates a special coding system
3606that can be used to convert text between a specific IBM codepage and
3607one of the character sets built into Emacs which matches that
3608codepage. For example, codepage 850 corresponds to Latin-1 character
3609set, codepage 855 corresponds to Cyrillic-ISO character set, etc.
3610
3611Windows codepages 1250, 1251 and some others, where Windows deviates
3612from the corresponding ISO character set, are also supported.
3613
3614IBM box-drawing characters and other glyphs which don't have
3615equivalents in the corresponding ISO character set, are converted to
3616a character defined by dos-unsupported-char-glyph on MS-DOS, and to
3617`?' on other systems.
3618
3619IBM codepages are widely used on MS-DOS and MS-Windows, so this
3620feature is most useful on those platforms, but it can also be used on
3621Unix.
3622
3623Emacs compiled for MS-DOS automatically loads the support for the
3624current codepage when it starts.
3625
3626** Mail changes
3627
3628*** When mail is sent using compose-mail (C-x m), and if
3629`mail-send-nonascii' is set to the new default value `mime',
3630appropriate MIME headers are added. The headers are added only if
3631non-ASCII characters are present in the body of the mail, and no other
3632MIME headers are already present. For example, the following three
3633headers are added if the coding system used in the *mail* buffer is
3634latin-1:
3635
3636 MIME-version: 1.0
3637 Content-type: text/plain; charset=iso-8859-1
3638 Content-Transfer-Encoding: 8bit
3639
3640*** The new variable default-sendmail-coding-system specifies the
3641default way to encode outgoing mail. This has higher priority than
3642default-buffer-file-coding-system but has lower priority than
3643sendmail-coding-system and the local value of
3644buffer-file-coding-system.
3645
3646You should not set this variable manually. Instead, set
3647sendmail-coding-system to specify a fixed encoding for all outgoing
3648mail.
3649
3650*** When you try to send a message that contains non-ASCII characters,
3651if the coding system specified by those variables doesn't handle them,
3652Emacs will ask you to select a suitable coding system while showing a
3653list of possible coding systems.
3654
3655** CC Mode changes
3656
3657*** c-default-style can now take an association list that maps major
3658modes to style names. When this variable is an alist, Java mode no
3659longer hardcodes a setting to "java" style. See the variable's
3660docstring for details.
3661
3662*** It's now possible to put a list as the offset on a syntactic
3663symbol. The list is evaluated recursively until a non-nil offset is
3664found. This is useful to combine several lineup functions to act in a
3665prioritized order on a single line. However, none of the supplied
3666lineup functions use this feature currently.
3667
3668*** New syntactic symbol catch-clause, which is used on the "catch" and
3669"finally" lines in try-catch constructs in C++ and Java.
3670
3671*** New cleanup brace-catch-brace on c-cleanup-list, which does for
3672"catch" lines what brace-elseif-brace does for "else if" lines.
3673
3674*** The braces of Java anonymous inner classes are treated separately
3675from the braces of other classes in auto-newline mode. Two new
3676symbols inexpr-class-open and inexpr-class-close may be used on
3677c-hanging-braces-alist to control the automatic newlines used for
3678anonymous classes.
3679
3680*** Support for the Pike language added, along with new Pike specific
3681syntactic symbols: inlambda, lambda-intro-cont
3682
3683*** Support for Java anonymous classes via new syntactic symbol
3684inexpr-class. New syntactic symbol inexpr-statement for Pike
3685support and gcc-style statements inside expressions. New lineup
3686function c-lineup-inexpr-block.
3687
3688*** New syntactic symbol brace-entry-open which is used in brace lists
3689(i.e. static initializers) when a list entry starts with an open
3690brace. These used to be recognized as brace-list-entry's.
3691c-electric-brace also recognizes brace-entry-open braces
3692(brace-list-entry's can no longer be electrified).
3693
3694*** New command c-indent-line-or-region, not bound by default.
3695
3696*** `#' is only electric when typed in the indentation of a line.
3697
3698*** Parentheses are now electric (via the new command c-electric-paren)
3699for auto-reindenting lines when parens are typed.
3700
3701*** In "gnu" style, inline-open offset is now set to zero.
3702
3703*** Uniform handling of the inclass syntactic symbol. The indentation
3704associated with it is now always relative to the class opening brace.
3705This means that the indentation behavior has changed in some
3706circumstances, but only if you've put anything besides 0 on the
3707class-open syntactic symbol (none of the default styles do that).
3708
3709** Gnus changes.
3710
3711*** New functionality for using Gnus as an offline newsreader has been
3712added. A plethora of new commands and modes have been added. See the
3713Gnus manual for the full story.
3714
3715*** The nndraft backend has returned, but works differently than
3716before. All Message buffers are now also articles in the nndraft
3717group, which is created automatically.
3718
3719*** `gnus-alter-header-function' can now be used to alter header
3720values.
3721
3722*** `gnus-summary-goto-article' now accept Message-ID's.
3723
3724*** A new Message command for deleting text in the body of a message
3725outside the region: `C-c C-v'.
3726
3727*** You can now post to component group in nnvirtual groups with
3728`C-u C-c C-c'.
3729
3730*** `nntp-rlogin-program' -- new variable to ease customization.
3731
3732*** `C-u C-c C-c' in `gnus-article-edit-mode' will now inhibit
3733re-highlighting of the article buffer.
3734
3735*** New element in `gnus-boring-article-headers' -- `long-to'.
3736
3737*** `M-i' symbolic prefix command. See the section "Symbolic
3738Prefixes" in the Gnus manual for details.
3739
3740*** `L' and `I' in the summary buffer now take the symbolic prefix
3741`a' to add the score rule to the "all.SCORE" file.
3742
3743*** `gnus-simplify-subject-functions' variable to allow greater
3744control over simplification.
3745
3746*** `A T' -- new command for fetching the current thread.
3747
3748*** `/ T' -- new command for including the current thread in the
3749limit.
3750
3751*** `M-RET' is a new Message command for breaking cited text.
3752
3753*** \\1-expressions are now valid in `nnmail-split-methods'.
3754
3755*** The `custom-face-lookup' function has been removed.
3756If you used this function in your initialization files, you must
3757rewrite them to use `face-spec-set' instead.
3758
3759*** Cancelling now uses the current select method. Symbolic prefix
3760`a' forces normal posting method.
3761
3762*** New command to translate M******** sm*rtq**t*s into proper text
3763-- `W d'.
3764
3765*** For easier debugging of nntp, you can set `nntp-record-commands'
3766to a non-nil value.
3767
3768*** nntp now uses ~/.authinfo, a .netrc-like file, for controlling
3769where and how to send AUTHINFO to NNTP servers.
3770
3771*** A command for editing group parameters from the summary buffer
3772has been added.
3773
3774*** A history of where mails have been split is available.
3775
3776*** A new article date command has been added -- `article-date-iso8601'.
3777
3778*** Subjects can be simplified when threading by setting
3779`gnus-score-thread-simplify'.
3780
3781*** A new function for citing in Message has been added --
3782`message-cite-original-without-signature'.
3783
3784*** `article-strip-all-blank-lines' -- new article command.
3785
3786*** A new Message command to kill to the end of the article has
3787been added.
3788
3789*** A minimum adaptive score can be specified by using the
3790`gnus-adaptive-word-minimum' variable.
3791
3792*** The "lapsed date" article header can be kept continually
3793updated by the `gnus-start-date-timer' command.
3794
3795*** Web listserv archives can be read with the nnlistserv backend.
3796
3797*** Old dejanews archives can now be read by nnweb.
3798
3799*** `gnus-posting-styles' has been re-activated.
3800
3801** Changes to TeX and LaTeX mode
3802
3803*** The new variable `tex-start-options-string' can be used to give
3804options for the TeX run. The default value causes TeX to run in
3805nonstopmode. For an interactive TeX run set it to nil or "".
3806
3807*** The command `tex-feed-input' sends input to the Tex Shell. In a
3808TeX buffer it is bound to the keys C-RET, C-c RET, and C-c C-m (some
3809of these keys may not work on all systems). For instance, if you run
3810TeX interactively and if the TeX run stops because of an error, you
3811can continue it without leaving the TeX buffer by typing C-RET.
3812
3813*** The Tex Shell Buffer is now in `compilation-shell-minor-mode'.
3814All error-parsing commands of the Compilation major mode are available
3815but bound to keys that don't collide with the shell. Thus you can use
3816the Tex Shell for command line executions like a usual shell.
3817
3818*** The commands `tex-validate-region' and `tex-validate-buffer' check
3819the matching of braces and $'s. The errors are listed in a *Occur*
3820buffer and you can use C-c C-c or mouse-2 to go to a particular
3821mismatch.
3822
3823** Changes to RefTeX mode
3824
3825*** The table of contents buffer can now also display labels and
3826file boundaries in addition to sections. Use `l', `i', and `c' keys.
3827
3828*** Labels derived from context (the section heading) are now
3829lowercase by default. To make the label legal in LaTeX, latin-1
3830characters will lose their accent. All Mule characters will be
3831removed from the label.
3832
3833*** The automatic display of cross reference information can also use
3834a window instead of the echo area. See variable `reftex-auto-view-crossref'.
3835
3836*** kpsewhich can be used by RefTeX to find TeX and BibTeX files. See the
3837customization group `reftex-finding-files'.
3838
3839*** The option `reftex-bibfile-ignore-list' has been renamed to
3840`reftex-bibfile-ignore-regexps' and indeed can be fed with regular
3841expressions.
3842
3843*** Multiple Selection buffers are now hidden buffers.
3844
3845** New/deleted modes and packages
3846
3847*** The package snmp-mode.el provides major modes for editing SNMP and
3848SNMPv2 MIBs. It has entries on `auto-mode-alist'.
3849
3850*** The package sql.el provides a major mode, M-x sql-mode, for
3851editing SQL files, and M-x sql-interactive-mode for interacting with
3852SQL interpreters. It has an entry on `auto-mode-alist'.
3853
3854*** M-x highlight-changes-mode provides a minor mode displaying buffer
3855changes with a special face.
3856
3857*** ispell4.el has been deleted. It got in the way of ispell.el and
3858this was hard to fix reliably. It has long been obsolete -- use
3859Ispell 3.1 and ispell.el.
3860
3861* MS-DOS changes in Emacs 20.4
3862
3863** Emacs compiled for MS-DOS now supports MULE features better.
3864This includes support for display of all ISO 8859-N character sets,
3865conversion to and from IBM codepage encoding of non-ASCII characters,
3866and automatic setup of the MULE environment at startup. For details,
3867check out the section `MS-DOS and MULE' in the manual.
3868
3869The MS-DOS installation procedure automatically configures and builds
3870Emacs with input method support if it finds an unpacked Leim
3871distribution when the config.bat script is run.
3872
3873** Formerly, the value of lpr-command did not affect printing on
3874MS-DOS unless print-region-function was set to nil, but now it
3875controls whether an external program is invoked or output is written
3876directly to a printer port. Similarly, in the previous version of
3877Emacs, the value of ps-lpr-command did not affect PostScript printing
3878on MS-DOS unless ps-printer-name was set to something other than a
3879string (eg. t or `pipe'), but now it controls whether an external
3880program is used. (These changes were made so that configuration of
3881printing variables would be almost identical across all platforms.)
3882
3883** In the previous version of Emacs, PostScript and non-PostScript
3884output was piped to external programs, but because most print programs
3885available for MS-DOS and MS-Windows cannot read data from their standard
3886input, on those systems the data to be output is now written to a
3887temporary file whose name is passed as the last argument to the external
3888program.
3889
3890An exception is made for `print', a standard program on Windows NT,
3891and `nprint', a standard program on Novell Netware. For both of these
3892programs, the command line is constructed in the appropriate syntax
3893automatically, using only the value of printer-name or ps-printer-name
3894as appropriate--the value of the relevant `-switches' variable is
3895ignored, as both programs have no useful switches.
3896
3897** The value of the variable dos-printer (cf. dos-ps-printer), if it has
3898a value, overrides the value of printer-name (cf. ps-printer-name), on
3899MS-DOS and MS-Windows only. This has been true since version 20.3, but
3900was not documented clearly before.
3901
3902** All the Emacs games now work on MS-DOS terminals.
3903This includes Tetris and Snake.
3904
3905* Lisp changes in Emacs 20.4
3906
3907** New functions line-beginning-position and line-end-position
3908return the position of the beginning or end of the current line.
3909They both accept an optional argument, which has the same
3910meaning as the argument to beginning-of-line or end-of-line.
3911
3912** find-file and allied functions now have an optional argument
3913WILDCARD. If this is non-nil, they do wildcard processing,
3914and visit all files that match the wildcard pattern.
3915
3916** Changes in the file-attributes function.
3917
3918*** The file size returned by file-attributes may be an integer or a float.
3919It is an integer if the size fits in a Lisp integer, float otherwise.
3920
3921*** The inode number returned by file-attributes may be an integer (if
3922the number fits in a Lisp integer) or a cons cell containing two
3923integers.
3924
3925** The new function directory-files-and-attributes returns a list of
3926files in a directory and their attributes. It accepts the same
3927arguments as directory-files and has similar semantics, except that
3928file names and attributes are returned.
3929
3930** The new function file-attributes-lessp is a helper function for
3931sorting the list generated by directory-files-and-attributes. It
3932accepts two arguments, each a list of a file name and its atttributes.
3933It compares the file names of each according to string-lessp and
3934returns the result.
3935
3936** The new function file-expand-wildcards expands a wildcard-pattern
3937to produce a list of existing files that match the pattern.
3938
3939** New functions for base64 conversion:
3940
3941The function base64-encode-region converts a part of the buffer
3942into the base64 code used in MIME. base64-decode-region
3943performs the opposite conversion. Line-breaking is supported
3944optionally.
3945
3946Functions base64-encode-string and base64-decode-string do a similar
3947job on the text in a string. They return the value as a new string.
3948
3949**
3950The new function process-running-child-p
3951will tell you if a subprocess has given control of its
3952terminal to its own child process.
3953
3954** interrupt-process and such functions have a new feature:
3955when the second argument is `lambda', they send a signal
3956to the running child of the subshell, if any, but if the shell
3957itself owns its terminal, no signal is sent.
3958
3959** There are new widget types `plist' and `alist' which can
3960be used for customizing variables whose values are plists or alists.
3961
3962** easymenu.el Now understands `:key-sequence' and `:style button'.
3963:included is an alias for :visible.
3964
3965easy-menu-add-item now understands the values returned by
3966easy-menu-remove-item and easy-menu-item-present-p. This can be used
3967to move or copy menu entries.
3968
3969** Multibyte editing changes
3970
3971*** The definitions of sref and char-bytes are changed. Now, sref is
3972an alias of aref and char-bytes always returns 1. This change is to
3973make some Emacs Lisp code which works on 20.2 and earlier also
3974work on the latest Emacs. Such code uses a combination of sref and
3975char-bytes in a loop typically as below:
3976 (setq char (sref str idx)
3977 idx (+ idx (char-bytes idx)))
3978The byte-compiler now warns that this is obsolete.
3979
3980If you want to know how many bytes a specific multibyte character
3981(say, CH) occupies in a multibyte buffer, use this code:
3982 (charset-bytes (char-charset ch))
3983
3984*** In multibyte mode, when you narrow a buffer to some region, and the
3985region is preceded or followed by non-ASCII codes, inserting or
3986deleting at the head or the end of the region may signal this error:
3987
3988 Byte combining across boundary of accessible buffer text inhibitted
3989
3990This is to avoid some bytes being combined together into a character
3991across the boundary.
3992
3993*** The functions find-charset-region and find-charset-string include
3994`unknown' in the returned list in the following cases:
3995 o The current buffer or the target string is unibyte and
3996 contains 8-bit characters.
3997 o The current buffer or the target string is multibyte and
3998 contains invalid characters.
3999
4000*** The functions decode-coding-region and encode-coding-region remove
4001text properties of the target region. Ideally, they should correctly
4002preserve text properties, but for the moment, it's hard. Removing
4003text properties is better than preserving them in a less-than-correct
4004way.
4005
4006*** prefer-coding-system sets EOL conversion of default coding systems.
4007If the argument to prefer-coding-system specifies a certain type of
4008end of line conversion, the default coding systems set by
4009prefer-coding-system will specify that conversion type for end of line.
4010
4011*** The new function thai-compose-string can be used to properly
4012compose Thai characters in a string.
4013
4014** The primitive `define-prefix-command' now takes an optional third
4015argument NAME, which should be a string. It supplies the menu name
4016for the created keymap. Keymaps created in order to be displayed as
4017menus should always use the third argument.
4018
4019** The meanings of optional second arguments for read-char,
4020read-event, and read-char-exclusive are flipped. Now the second
4021arguments are INHERIT-INPUT-METHOD. These functions use the current
4022input method (if any) if and only if INHERIT-INPUT-METHOD is non-nil.
4023
4024** The new function clear-this-command-keys empties out the contents
4025of the vector that (this-command-keys) returns. This is useful in
4026programs that read passwords, to prevent the passwords from echoing
4027inadvertently as part of the next command in certain cases.
4028
4029** The new macro `with-temp-message' displays a temporary message in
4030the echo area, while executing some Lisp code. Like `progn', it
4031returns the value of the last form, but it also restores the previous
4032echo area contents.
4033
4034 (with-temp-message MESSAGE &rest BODY)
4035
4036** The function `require' now takes an optional third argument
4037NOERROR. If it is non-nil, then there is no error if the
4038requested feature cannot be loaded.
4039
4040** In the function modify-face, an argument of (nil) for the
4041foreground color, background color or stipple pattern
4042means to clear out that attribute.
4043
4044** The `outer-window-id' frame property of an X frame
4045gives the window number of the outermost X window for the frame.
4046
4047** Temporary buffers made with with-output-to-temp-buffer are now
4048read-only by default, and normally use the major mode Help mode
4049unless you put them in some other non-Fundamental mode before the
4050end of with-output-to-temp-buffer.
4051
4052** The new functions gap-position and gap-size return information on
4053the gap of the current buffer.
4054
4055** The new functions position-bytes and byte-to-position provide a way
4056to convert between character positions and byte positions in the
4057current buffer.
4058
4059** vc.el defines two new macros, `edit-vc-file' and `with-vc-file', to
4060facilitate working with version-controlled files from Lisp programs.
4061These macros check out a given file automatically if needed, and check
4062it back in after any modifications have been made.
4063
4064* Installation Changes in Emacs 20.3
4065
4066** The default value of load-path now includes most subdirectories of
4067the site-specific directories /usr/local/share/emacs/site-lisp and
4068/usr/local/share/emacs/VERSION/site-lisp, in addition to those
4069directories themselves. Both immediate subdirectories and
4070subdirectories multiple levels down are added to load-path.
4071
4072Not all subdirectories are included, though. Subdirectories whose
4073names do not start with a letter or digit are excluded.
4074Subdirectories named RCS or CVS are excluded. Also, a subdirectory
4075which contains a file named `.nosearch' is excluded. You can use
4076these methods to prevent certain subdirectories from being searched.
4077
4078Emacs finds these subdirectories and adds them to load-path when it
4079starts up. While it would be cleaner to find the subdirectories each
4080time Emacs loads a file, that would be much slower.
4081
4082This feature is an incompatible change. If you have stored some Emacs
4083Lisp files in a subdirectory of the site-lisp directory specifically
4084to prevent them from being used, you will need to rename the
4085subdirectory to start with a non-alphanumeric character, or create a
4086`.nosearch' file in it, in order to continue to achieve the desired
4087results.
4088
4089** Emacs no longer includes an old version of the C preprocessor from
4090GCC. This was formerly used to help compile Emacs with C compilers
4091that had limits on the significant length of an identifier, but in
4092fact we stopped supporting such compilers some time ago.
4093
4094* Changes in Emacs 20.3
4095
4096** The new command C-x z (repeat) repeats the previous command
4097including its argument. If you repeat the z afterward,
4098it repeats the command additional times; thus, you can
4099perform many repetitions with one keystroke per repetition.
4100
4101** Emacs now supports "selective undo" which undoes only within a
4102specified region. To do this, set point and mark around the desired
4103region and type C-u C-x u (or C-u C-_). You can then continue undoing
4104further, within the same region, by repeating the ordinary undo
4105command C-x u or C-_. This will keep undoing changes that were made
4106within the region you originally specified, until either all of them
4107are undone, or it encounters a change which crosses the edge of that
4108region.
4109
4110In Transient Mark mode, undoing when a region is active requests
4111selective undo.
4112
4113** If you specify --unibyte when starting Emacs, then all buffers are
4114unibyte, except when a Lisp program specifically creates a multibyte
4115buffer. Setting the environment variable EMACS_UNIBYTE has the same
4116effect. The --no-unibyte option overrides EMACS_UNIBYTE and directs
4117Emacs to run normally in multibyte mode.
4118
4119The option --unibyte does not affect the reading of Emacs Lisp files,
4120though. If you want a Lisp file to be read in unibyte mode, use
4121-*-unibyte: t;-*- on its first line. That will force Emacs to
4122load that file in unibyte mode, regardless of how Emacs was started.
4123
4124** toggle-enable-multibyte-characters no longer has a key binding and
4125no longer appears in the menu bar. We've realized that changing the
4126enable-multibyte-characters variable in an existing buffer is
4127something that most users not do.
4128
4129** You can specify a coding system to use for the next cut or paste
4130operations through the window system with the command C-x RET X.
4131The coding system can make a difference for communication with other
4132applications.
4133
4134C-x RET x specifies a coding system for all subsequent cutting and
4135pasting operations.
4136
4137** You can specify the printer to use for commands that do printing by
4138setting the variable `printer-name'. Just what a printer name looks
4139like depends on your operating system. You can specify a different
4140printer for the Postscript printing commands by setting
4141`ps-printer-name'.
4142
4143** Emacs now supports on-the-fly spell checking by the means of a
4144minor mode. It is called M-x flyspell-mode. You don't have to remember
4145any other special commands to use it, and you will hardly notice it
4146except when you make a spelling error. Flyspell works by highlighting
4147incorrect words as soon as they are completed or as soon as the cursor
4148hits a new word.
4149
4150Flyspell mode works with whichever dictionary you have selected for
4151Ispell in Emacs. In TeX mode, it understands TeX syntax so as not
4152to be confused by TeX commands.
4153
4154You can correct a misspelled word by editing it into something
4155correct. You can also correct it, or accept it as correct, by
4156clicking on the word with Mouse-2; that gives you a pop-up menu
4157of various alternative replacements and actions.
4158
4159Flyspell mode also proposes "automatic" corrections. M-TAB replaces
4160the current misspelled word with a possible correction. If several
4161corrections are made possible, M-TAB cycles through them in
4162alphabetical order, or in order of decreasing likelihood if
4163flyspell-sort-corrections is nil.
4164
4165Flyspell mode also flags an error when a word is repeated, if
4166flyspell-mark-duplications-flag is non-nil.
4167
4168** Changes in input method usage.
4169
4170Now you can use arrow keys (right, left, down, up) for selecting among
4171the alternatives just the same way as you do by C-f, C-b, C-n, and C-p
4172respectively.
4173
4174You can use the ENTER key to accept the current conversion.
4175
4176If you type TAB to display a list of alternatives, you can select one
4177of the alternatives with Mouse-2.
4178
4179The meaning of the variable `input-method-verbose-flag' is changed so
4180that you can set it to t, nil, `default', or `complex-only'.
4181
4182 If the value is nil, extra guidance is never given.
4183
4184 If the value is t, extra guidance is always given.
4185
4186 If the value is `complex-only', extra guidance is always given only
4187 when you are using complex input methods such as chinese-py.
4188
4189 If the value is `default' (this is the default), extra guidance is
4190 given in the following case:
4191 o When you are using a complex input method.
4192 o When you are using a simple input method but not in the minibuffer.
4193
4194If you are using Emacs through a very slow line, setting
4195input-method-verbose-flag to nil or to complex-only is a good choice,
4196and if you are using an input method you are not familiar with,
4197setting it to t is helpful.
4198
4199The old command select-input-method is now called set-input-method.
4200
4201In the language environment "Korean", you can use the following
4202keys:
4203 Shift-SPC toggle-korean-input-method
4204 C-F9 quail-hangul-switch-symbol-ksc
4205 F9 quail-hangul-switch-hanja
4206These key bindings are canceled when you switch to another language
4207environment.
4208
4209** The minibuffer history of file names now records the specified file
4210names, not the entire minibuffer input. For example, if the
4211minibuffer starts out with /usr/foo/, you might type in /etc/passwd to
4212get
4213
4214 /usr/foo//etc/passwd
4215
4216which stands for the file /etc/passwd.
4217
4218Formerly, this used to put /usr/foo//etc/passwd in the history list.
4219Now this puts just /etc/passwd in the history list.
4220
4221** If you are root, Emacs sets backup-by-copying-when-mismatch to t
4222at startup, so that saving a file will be sure to preserve
4223its owner and group.
4224
4225** find-func.el can now also find the place of definition of Emacs
4226Lisp variables in user-loaded libraries.
4227
4228** C-x r t (string-rectangle) now deletes the existing rectangle
4229contents before inserting the specified string on each line.
4230
4231** There is a new command delete-whitespace-rectangle
4232which deletes whitespace starting from a particular column
4233in all the lines on a rectangle. The column is specified
4234by the left edge of the rectangle.
4235
4236** You can now store a number into a register with C-u NUMBER C-x r n REG,
4237increment it by INC with C-u INC C-x r + REG (to increment by one, omit
4238C-u INC), and insert it in the buffer with C-x r g REG. This is useful
4239for writing keyboard macros.
4240
4241** The new command M-x speedbar displays a frame in which directories,
4242files, and tags can be displayed, manipulated, and jumped to. The
4243frame defaults to 20 characters in width, and is the same height as
4244the frame that it was started from. Some major modes define
4245additional commands for the speedbar, including Rmail, GUD/GDB, and
4246info.
4247
4248** query-replace-regexp is now bound to C-M-%.
4249
4250** In Transient Mark mode, when the region is active, M-x
4251query-replace and the other replace commands now operate on the region
4252contents only.
4253
4254** M-x write-region, when used interactively, now asks for
4255confirmation before overwriting an existing file. When you call
4256the function from a Lisp program, a new optional argument CONFIRM
4257says whether to ask for confirmation in this case.
4258
4259** If you use find-file-literally and the file is already visited
4260non-literally, the command asks you whether to revisit the file
4261literally. If you say no, it signals an error.
4262
4263** Major modes defined with the "derived mode" feature
4264now use the proper name for the mode hook: WHATEVER-mode-hook.
4265Formerly they used the name WHATEVER-mode-hooks, but that is
4266inconsistent with Emacs conventions.
4267
4268** shell-command-on-region (and shell-command) reports success or
4269failure if the command produces no output.
4270
4271** Set focus-follows-mouse to nil if your window system or window
4272manager does not transfer focus to another window when you just move
4273the mouse.
4274
4275** mouse-menu-buffer-maxlen has been renamed to
4276mouse-buffer-menu-maxlen to be consistent with the other related
4277function and variable names.
4278
4279** The new variable auto-coding-alist specifies coding systems for
4280reading specific files. This has higher priority than
4281file-coding-system-alist.
4282
4283** If you set the variable unibyte-display-via-language-environment to
4284t, then Emacs displays non-ASCII characters are displayed by
4285converting them to the equivalent multibyte characters according to
4286the current language environment. As a result, they are displayed
4287according to the current fontset.
4288
4289** C-q's handling of codes in the range 0200 through 0377 is changed.
4290
4291The codes in the range 0200 through 0237 are inserted as one byte of
4292that code regardless of the values of nonascii-translation-table and
4293nonascii-insert-offset.
4294
4295For the codes in the range 0240 through 0377, if
4296enable-multibyte-characters is non-nil and nonascii-translation-table
4297nor nonascii-insert-offset can't convert them to valid multibyte
4298characters, they are converted to Latin-1 characters.
4299
4300** If you try to find a file that is not read-accessible, you now get
4301an error, rather than an empty buffer and a warning.
4302
4303** In the minibuffer history commands M-r and M-s, an upper case
4304letter in the regular expression forces case-sensitive search.
4305
4306** In the *Help* buffer, cross-references to commands and variables
4307are inferred and hyperlinked. Use C-h m in Help mode for the relevant
4308command keys.
4309
4310** M-x apropos-command, with a prefix argument, no longer looks for
4311user option variables--instead it looks for noninteractive functions.
4312
4313Meanwhile, the command apropos-variable normally searches for
4314user option variables; with a prefix argument, it looks at
4315all variables that have documentation.
4316
4317** When you type a long line in the minibuffer, and the minibuffer
4318shows just one line, automatically scrolling works in a special way
4319that shows you overlap with the previous line of text. The variable
4320minibuffer-scroll-overlap controls how many characters of overlap
4321it should show; the default is 20.
4322
4323Meanwhile, Resize Minibuffer mode is still available; in that mode,
4324the minibuffer grows taller (up to a point) as needed to show the whole
4325of your input.
4326
4327** The new command M-x customize-changed-options lets you customize
4328all the options whose meanings or default values have changed in
4329recent Emacs versions. You specify a previous Emacs version number as
4330argument, and the command creates a customization buffer showing all
4331the customizable options which were changed since that version.
4332Newly added options are included as well.
4333
4334If you don't specify a particular version number argument,
4335then the customization buffer shows all the customizable options
4336for which Emacs versions of changes are recorded.
4337
4338This function is also bound to the Changed Options entry in the
4339Customize menu.
4340
4341** When you run M-x grep with a prefix argument, it figures out
4342the tag around point and puts that into the default grep command.
4343
4344** The new command M-* (pop-tag-mark) pops back through a history of
4345buffer positions from which M-. or other tag-finding commands were
4346invoked.
4347
4348** The new variable comment-padding specifies the number of spaces
4349that `comment-region' will insert before the actual text of the comment.
4350The default is 1.
4351
4352** In Fortran mode the characters `.', `_' and `$' now have symbol
4353syntax, not word syntax. Fortran mode now supports `imenu' and has
4354new commands fortran-join-line (M-^) and fortran-narrow-to-subprogram
4355(C-x n d). M-q can be used to fill a statement or comment block
4356sensibly.
4357
4358** GUD now supports jdb, the Java debugger, and pdb, the Python debugger.
4359
4360** If you set the variable add-log-keep-changes-together to a non-nil
4361value, the command `C-x 4 a' will automatically notice when you make
4362two entries in one day for one file, and combine them.
4363
4364** You can use the command M-x diary-mail-entries to mail yourself a
4365reminder about upcoming diary entries. See the documentation string
4366for a sample shell script for calling this function automatically
4367every night.
4368
4369** Desktop changes
4370
4371*** All you need to do to enable use of the Desktop package, is to set
4372the variable desktop-enable to t with Custom.
4373
4374*** Minor modes are now restored. Which minor modes are restored
4375and how modes are restored is controlled by `desktop-minor-mode-table'.
4376
4377** There is no need to do anything special, now, to enable Gnus to
4378read and post multi-lingual articles.
4379
4380** Outline mode has now support for showing hidden outlines when
4381doing an isearch. In order for this to happen search-invisible should
4382be set to open (the default). If an isearch match is inside a hidden
4383outline the outline is made visible. If you continue pressing C-s and
4384the match moves outside the formerly invisible outline, the outline is
4385made invisible again.
4386
4387** Mail reading and sending changes
4388
4389*** The Rmail e command now switches to displaying the whole header of
4390the message before it lets you edit the message. This is so that any
4391changes you make in the header will not be lost if you subsequently
4392toggle.
4393
4394*** The w command in Rmail, which writes the message body into a file,
4395now works in the summary buffer as well. (The command to delete the
4396summary buffer is now Q.) The default file name for the w command, if
4397the message has no subject, is stored in the variable
4398rmail-default-body-file.
4399
4400*** Most of the commands and modes that operate on mail and netnews no
4401longer depend on the value of mail-header-separator. Instead, they
4402handle whatever separator the buffer happens to use.
4403
4404*** If you set mail-signature to a value which is not t, nil, or a string,
4405it should be an expression. When you send a message, this expression
4406is evaluated to insert the signature.
4407
4408*** The new Lisp library feedmail.el (version 8) enhances processing of
4409outbound email messages. It works in coordination with other email
4410handling packages (e.g., rmail, VM, gnus) and is responsible for
4411putting final touches on messages and actually submitting them for
4412transmission. Users of the emacs program "fakemail" might be
4413especially interested in trying feedmail.
4414
4415feedmail is not enabled by default. See comments at the top of
4416feedmail.el for set-up instructions. Among the bigger features
4417provided by feedmail are:
4418
4419**** you can park outgoing messages into a disk-based queue and
4420stimulate sending some or all of them later (handy for laptop users);
4421there is also a queue for draft messages
4422
4423**** you can get one last look at the prepped outbound message and
4424be prompted for confirmation
4425
4426**** does smart filling of address headers
4427
4428**** can generate a MESSAGE-ID: line and a DATE: line; the date can be
4429the time the message was written or the time it is being sent; this
4430can make FCC copies more closely resemble copies that recipients get
4431
4432**** you can specify an arbitrary function for actually transmitting
4433the message; included in feedmail are interfaces for /bin/[r]mail,
4434/usr/lib/sendmail, and elisp smtpmail; it's easy to write a new
4435function for something else (10-20 lines of elisp)
4436
4437** Dired changes
4438
4439*** The Dired function dired-do-toggle, which toggles marked and unmarked
4440files, is now bound to "t" instead of "T".
4441
4442*** dired-at-point has been added to ffap.el. It allows one to easily
4443run Dired on the directory name at point.
4444
4445*** Dired has a new command: %g. It searches the contents of
4446files in the directory and marks each file that contains a match
4447for a specified regexp.
4448
4449** VC Changes
4450
4451*** New option vc-ignore-vc-files lets you turn off version control
4452conveniently.
4453
4454*** VC Dired has been completely rewritten. It is now much
4455faster, especially for CVS, and works very similar to ordinary
4456Dired.
4457
4458VC Dired is invoked by typing C-x v d and entering the name of the
4459directory to display. By default, VC Dired gives you a recursive
4460listing of all files at or below the given directory which are
4461currently locked (for CVS, all files not up-to-date are shown).
4462
4463You can change the listing format by setting vc-dired-recurse to nil,
4464then it shows only the given directory, and you may also set
4465vc-dired-terse-display to nil, then it shows all files under version
4466control plus the names of any subdirectories, so that you can type `i'
4467on such lines to insert them manually, as in ordinary Dired.
4468
4469All Dired commands operate normally in VC Dired, except for `v', which
4470is redefined as the version control prefix. That means you may type
4471`v l', `v =' etc. to invoke `vc-print-log', `vc-diff' and the like on
4472the file named in the current Dired buffer line. `v v' invokes
4473`vc-next-action' on this file, or on all files currently marked.
4474
4475The new command `v t' (vc-dired-toggle-terse-mode) allows you to
4476toggle between terse display (only locked files) and full display (all
4477VC files plus subdirectories). There is also a special command,
4478`* l', to mark all files currently locked.
4479
4480Giving a prefix argument to C-x v d now does the same thing as in
4481ordinary Dired: it allows you to supply additional options for the ls
4482command in the minibuffer, to fine-tune VC Dired's output.
4483
4484*** Under CVS, if you merge changes from the repository into a working
4485file, and CVS detects conflicts, VC now offers to start an ediff
4486session to resolve them.
4487
4488Alternatively, you can use the new command `vc-resolve-conflicts' to
4489resolve conflicts in a file at any time. It works in any buffer that
4490contains conflict markers as generated by rcsmerge (which is what CVS
4491uses as well).
4492
4493*** You can now transfer changes between branches, using the new
4494command vc-merge (C-x v m). It is implemented for RCS and CVS. When
4495you invoke it in a buffer under version-control, you can specify
4496either an entire branch or a pair of versions, and the changes on that
4497branch or between the two versions are merged into the working file.
4498If this results in any conflicts, they may be resolved interactively,
4499using ediff.
4500
4501** Changes in Font Lock
4502
4503*** The face and variable previously known as font-lock-reference-face
4504are now called font-lock-constant-face to better reflect their typical
4505use for highlighting constants and labels. (Its face properties are
4506unchanged.) The variable font-lock-reference-face remains for now for
4507compatibility reasons, but its value is font-lock-constant-face.
4508
4509** Frame name display changes
4510
4511*** The command set-frame-name lets you set the name of the current
4512frame. You can use the new command select-frame-by-name to select and
4513raise a frame; this is mostly useful on character-only terminals, or
4514when many frames are invisible or iconified.
4515
4516*** On character-only terminal (not a window system), changing the
4517frame name is now reflected on the mode line and in the Buffers/Frames
4518menu.
4519
4520** Comint (subshell) changes
4521
4522*** In Comint modes, the commands to kill, stop or interrupt a
4523subjob now also kill pending input. This is for compatibility
4524with ordinary shells, where the signal characters do this.
4525
4526*** There are new commands in Comint mode.
4527
4528C-c C-x fetches the "next" line from the input history;
4529that is, the line after the last line you got.
4530You can use this command to fetch successive lines, one by one.
4531
4532C-c SPC accumulates lines of input. More precisely, it arranges to
4533send the current line together with the following line, when you send
4534the following line.
4535
4536C-c C-a if repeated twice consecutively now moves to the process mark,
4537which separates the pending input from the subprocess output and the
4538previously sent input.
4539
4540C-c M-r now runs comint-previous-matching-input-from-input;
4541it searches for a previous command, using the current pending input
4542as the search string.
4543
4544*** New option compilation-scroll-output can be set to scroll
4545automatically in compilation-mode windows.
4546
4547** C mode changes
4548
4549*** Multiline macros are now handled, both as they affect indentation,
4550and as recognized syntax. New syntactic symbol cpp-macro-cont is
4551assigned to second and subsequent lines of a multiline macro
4552definition.
4553
4554*** A new style "user" which captures all non-hook-ified
4555(i.e. top-level) .emacs file variable settings and customizations.
4556Style "cc-mode" is an alias for "user" and is deprecated. "gnu"
4557style is still the default however.
4558
4559*** "java" style now conforms to Sun's JDK coding style.
4560
4561*** There are new commands c-beginning-of-defun, c-end-of-defun which
4562are alternatives which you could bind to C-M-a and C-M-e if you prefer
4563them. They do not have key bindings by default.
4564
4565*** New and improved implementations of M-a (c-beginning-of-statement)
4566and M-e (c-end-of-statement).
4567
4568*** C++ namespace blocks are supported, with new syntactic symbols
4569namespace-open, namespace-close, and innamespace.
4570
4571*** File local variable settings of c-file-style and c-file-offsets
4572makes the style variables local to that buffer only.
4573
4574*** New indentation functions c-lineup-close-paren,
4575c-indent-one-line-block, c-lineup-dont-change.
4576
4577*** Improvements (hopefully!) to the way CC Mode is loaded. You
4578should now be able to do a (require 'cc-mode) to get the entire
4579package loaded properly for customization in your .emacs file. A new
4580variable c-initialize-on-load controls this and is t by default.
4581
4582** Changes to hippie-expand.
4583
4584*** New customization variable `hippie-expand-dabbrev-skip-space'. If
4585non-nil, trailing spaces may be included in the abbreviation to search for,
4586which then gives the same behavior as the original `dabbrev-expand'.
4587
4588*** New customization variable `hippie-expand-dabbrev-as-symbol'. If
4589non-nil, characters of syntax '_' is considered part of the word when
4590expanding dynamically.
4591
4592*** New customization variable `hippie-expand-no-restriction'. If
4593non-nil, narrowed buffers are widened before they are searched.
4594
4595*** New customization variable `hippie-expand-only-buffers'. If
4596non-empty, buffers searched are restricted to the types specified in
4597this list. Useful for example when constructing new special-purpose
4598expansion functions with `make-hippie-expand-function'.
4599
4600*** Text properties of the expansion are no longer copied.
4601
4602** Changes in BibTeX mode.
4603
4604*** Any titleword matching a regexp in the new variable
4605bibtex-autokey-titleword-ignore (case sensitive) is ignored during
4606automatic key generation. This replaces variable
4607bibtex-autokey-titleword-first-ignore, which only checked for matches
4608against the first word in the title.
4609
4610*** Autokey generation now uses all words from the title, not just
4611capitalized words. To avoid conflicts with existing customizations,
4612bibtex-autokey-titleword-ignore is set up such that words starting with
4613lowerkey characters will still be ignored. Thus, if you want to use
4614lowercase words from the title, you will have to overwrite the
4615bibtex-autokey-titleword-ignore standard setting.
4616
4617*** Case conversion of names and title words for automatic key
4618generation is more flexible. Variable bibtex-autokey-preserve-case is
4619replaced by bibtex-autokey-titleword-case-convert and
4620bibtex-autokey-name-case-convert.
4621
4622** Changes in vcursor.el.
4623
4624*** Support for character terminals is available: there is a new keymap
4625and the vcursor will appear as an arrow between buffer text. A
4626variable `vcursor-interpret-input' allows input from the vcursor to be
4627entered exactly as if typed. Numerous functions, including
4628`vcursor-compare-windows', have been rewritten to improve consistency
4629in the selection of windows and corresponding keymaps.
4630
4631*** vcursor options can now be altered with M-x customize under the
4632Editing group once the package is loaded.
4633
4634*** Loading vcursor now does not define keys by default, as this is
4635generally a bad side effect. Use M-x customize to set
4636vcursor-key-bindings to t to restore the old behaviour.
4637
4638*** vcursor-auto-disable can be `copy', which turns off copying from the
4639vcursor, but doesn't disable it, after any non-vcursor command.
4640
4641** Ispell changes.
4642
4643*** You can now spell check comments and strings in the current
4644buffer with M-x ispell-comments-and-strings. Comments and strings
4645are identified by syntax tables in effect.
4646
4647*** Generic region skipping implemented.
4648A single buffer can be broken into a number of regions where text will
4649and will not be checked. The definitions of the regions can be user
4650defined. New applications and improvements made available by this
4651include:
4652
4653 o URLs are automatically skipped
4654 o EMail message checking is vastly improved.
4655
4656*** Ispell can highlight the erroneous word even on non-window terminals.
4657
4658** Changes to RefTeX mode
4659
4660RefTeX has been updated in order to make it more usable with very
4661large projects (like a several volume math book). The parser has been
4662re-written from scratch. To get maximum speed from RefTeX, check the
4663section `Optimizations' in the manual.
4664
4665*** New recursive parser.
4666
4667The old version of RefTeX created a single large buffer containing the
4668entire multifile document in order to parse the document. The new
4669recursive parser scans the individual files.
4670
4671*** Parsing only part of a document.
4672
4673Reparsing of changed document parts can now be made faster by enabling
4674partial scans. To use this feature, read the documentation string of
4675the variable `reftex-enable-partial-scans' and set the variable to t.
4676
4677 (setq reftex-enable-partial-scans t)
4678
4679*** Storing parsing information in a file.
4680
4681This can improve startup times considerably. To turn it on, use
4682
4683 (setq reftex-save-parse-info t)
4684
4685*** Using multiple selection buffers
4686
4687If the creation of label selection buffers is too slow (this happens
4688for large documents), you can reuse these buffers by setting
4689
4690 (setq reftex-use-multiple-selection-buffers t)
4691
4692*** References to external documents.
4693
4694The LaTeX package `xr' allows to cross-reference labels in external
4695documents. RefTeX can provide information about the external
4696documents as well. To use this feature, set up the \externaldocument
4697macros required by the `xr' package and rescan the document with
4698RefTeX. The external labels can then be accessed with the `x' key in
4699the selection buffer provided by `reftex-reference' (bound to `C-c )').
4700The `x' key also works in the table of contents buffer.
4701
4702*** Many more labeled LaTeX environments are recognized by default.
4703
4704The builtin command list now covers all the standard LaTeX commands,
4705and all of the major packages included in the LaTeX distribution.
4706
4707Also, RefTeX now understands the \appendix macro and changes
4708the enumeration of sections in the *toc* buffer accordingly.
4709
4710*** Mouse support for selection and *toc* buffers
4711
4712The mouse can now be used to select items in the selection and *toc*
4713buffers. See also the new option `reftex-highlight-selection'.
4714
4715*** New keymaps for selection and table of contents modes.
4716
4717The selection processes for labels and citation keys, and the table of
4718contents buffer now have their own keymaps: `reftex-select-label-map',
4719`reftex-select-bib-map', `reftex-toc-map'. The selection processes
4720have a number of new keys predefined. In particular, TAB lets you
4721enter a label with completion. Check the on-the-fly help (press `?'
4722at the selection prompt) or read the Info documentation to find out
4723more.
4724
4725*** Support for the varioref package
4726
4727The `v' key in the label selection buffer toggles \ref versus \vref.
4728
4729*** New hooks
4730
4731Three new hooks can be used to redefine the way labels, references,
4732and citations are created. These hooks are
4733`reftex-format-label-function', `reftex-format-ref-function',
4734`reftex-format-cite-function'.
4735
4736*** Citations outside LaTeX
4737
4738The command `reftex-citation' may also be used outside LaTeX (e.g. in
4739a mail buffer). See the Info documentation for details.
4740
4741*** Short context is no longer fontified.
4742
4743The short context in the label menu no longer copies the
4744fontification from the text in the buffer. If you prefer it to be
4745fontified, use
4746
4747 (setq reftex-refontify-context t)
4748
4749** file-cache-minibuffer-complete now accepts a prefix argument.
4750With a prefix argument, it does not try to do completion of
4751the file name within its directory; it only checks for other
4752directories that contain the same file name.
4753
4754Thus, given the file name Makefile, and assuming that a file
4755Makefile.in exists in the same directory, ordinary
4756file-cache-minibuffer-complete will try to complete Makefile to
4757Makefile.in and will therefore never look for other directories that
4758have Makefile. A prefix argument tells it not to look for longer
4759names such as Makefile.in, so that instead it will look for other
4760directories--just as if the name were already complete in its present
4761directory.
4762
4763** New modes and packages
4764
4765*** There is a new alternative major mode for Perl, Cperl mode.
4766It has many more features than Perl mode, and some people prefer
4767it, but some do not.
4768
4769*** There is a new major mode, M-x vhdl-mode, for editing files of VHDL
4770code.
4771
4772*** M-x which-function-mode enables a minor mode that displays the
4773current function name continuously in the mode line, as you move
4774around in a buffer.
4775
4776Which Function mode is effective in major modes which support Imenu.
4777
4778*** Gametree is a major mode for editing game analysis trees. The author
4779uses it for keeping notes about his postal Chess games, but it should
4780be helpful for other two-player games as well, as long as they have an
4781established system of notation similar to Chess.
4782
4783*** The new minor mode checkdoc-minor-mode provides Emacs Lisp
4784documentation string checking for style and spelling. The style
4785guidelines are found in the Emacs Lisp programming manual.
4786
4787*** The net-utils package makes some common networking features
4788available in Emacs. Some of these functions are wrappers around
4789system utilities (ping, nslookup, etc); others are implementations of
4790simple protocols (finger, whois) in Emacs Lisp. There are also
4791functions to make simple connections to TCP/IP ports for debugging and
4792the like.
4793
4794*** highlight-changes-mode is a minor mode that uses colors to
4795identify recently changed parts of the buffer text.
4796
4797*** The new package `midnight' lets you specify things to be done
4798within Emacs at midnight--by default, kill buffers that you have not
4799used in a considerable time. To use this feature, customize
4800the user option `midnight-mode' to t.
4801
4802*** The file generic-x.el defines a number of simple major modes.
4803
4804 apache-generic-mode: For Apache and NCSA httpd configuration files
4805 samba-generic-mode: Samba configuration files
4806 fvwm-generic-mode: For fvwm initialization files
4807 x-resource-generic-mode: For X resource files
4808 hosts-generic-mode: For hosts files (.rhosts, /etc/hosts, etc)
4809 mailagent-rules-generic-mode: For mailagent .rules files
4810 javascript-generic-mode: For JavaScript files
4811 vrml-generic-mode: For VRML files
4812 java-manifest-generic-mode: For Java MANIFEST files
4813 java-properties-generic-mode: For Java property files
4814 mailrc-generic-mode: For .mailrc files
4815
4816 Platform-specific modes:
4817
4818 prototype-generic-mode: For Solaris/Sys V prototype files
4819 pkginfo-generic-mode: For Solaris/Sys V pkginfo files
4820 alias-generic-mode: For C shell alias files
4821 inf-generic-mode: For MS-Windows INF files
4822 ini-generic-mode: For MS-Windows INI files
4823 reg-generic-mode: For MS-Windows Registry files
4824 bat-generic-mode: For MS-Windows BAT scripts
4825 rc-generic-mode: For MS-Windows Resource files
4826 rul-generic-mode: For InstallShield scripts
4827
4828* Lisp changes in Emacs 20.3 since the Emacs Lisp Manual was published
4829
4830** If you want a Lisp file to be read in unibyte mode,
4831use -*-unibyte: t;-*- on its first line.
4832That will force Emacs to read that file in unibyte mode.
4833Otherwise, the file will be loaded and byte-compiled in multibyte mode.
4834
4835Thus, each lisp file is read in a consistent way regardless of whether
4836you started Emacs with --unibyte, so that a Lisp program gives
4837consistent results regardless of how Emacs was started.
4838
4839** The new function assoc-default is useful for searching an alist,
4840and using a default value if the key is not found there. You can
4841specify a comparison predicate, so this function is useful for
4842searching comparing a string against an alist of regular expressions.
4843
4844** The functions unibyte-char-to-multibyte and
4845multibyte-char-to-unibyte convert between unibyte and multibyte
4846character codes, in a way that is appropriate for the current language
4847environment.
4848
4849** The functions read-event, read-char and read-char-exclusive now
4850take two optional arguments. PROMPT, if non-nil, specifies a prompt
4851string. SUPPRESS-INPUT-METHOD, if non-nil, says to disable the
4852current input method for reading this one event.
4853
4854** Two new variables print-escape-nonascii and print-escape-multibyte
4855now control whether to output certain characters as
4856backslash-sequences. print-escape-nonascii applies to single-byte
4857non-ASCII characters; print-escape-multibyte applies to multibyte
4858characters. Both of these variables are used only when printing
4859in readable fashion (prin1 uses them, princ does not).
4860
4861* Lisp changes in Emacs 20.3 before the Emacs Lisp Manual was published
4862
4863** Compiled Emacs Lisp files made with the modified "MBSK" version
4864of Emacs 20.2 do not work in Emacs 20.3.
4865
4866** Buffer positions are now measured in characters, as they were
4867in Emacs 19 and before. This means that (forward-char 1)
4868always increases point by 1.
4869
4870The function chars-in-region now just subtracts its arguments. It is
4871considered obsolete. The function char-boundary-p has been deleted.
4872
4873See below for additional changes relating to multibyte characters.
4874
4875** defcustom, defface and defgroup now accept the keyword `:version'.
4876Use this to specify in which version of Emacs a certain variable's
4877default value changed. For example,
4878
4879 (defcustom foo-max 34 "*Maximum number of foo's allowed."
4880 :type 'integer
4881 :group 'foo
4882 :version "20.3")
4883
4884 (defgroup foo-group nil "The foo group."
4885 :version "20.3")
4886
4887If an entire new group is added or the variables in it have the
4888default values changed, then just add a `:version' to that group. It
4889is recommended that new packages added to the distribution contain a
4890`:version' in the top level group.
4891
4892This information is used to control the customize-changed-options command.
4893
4894** It is now an error to change the value of a symbol whose name
4895starts with a colon--if it is interned in the standard obarray.
4896
4897However, setting such a symbol to its proper value, which is that
4898symbol itself, is not an error. This is for the sake of programs that
4899support previous Emacs versions by explicitly setting these variables
4900to themselves.
4901
4902If you set the variable keyword-symbols-constant-flag to nil,
4903this error is suppressed, and you can set these symbols to any
4904values whatever.
4905
4906** There is a new debugger command, R.
4907It evaluates an expression like e, but saves the result
4908in the buffer *Debugger-record*.
4909
4910** Frame-local variables.
4911
4912You can now make a variable local to various frames. To do this, call
4913the function make-variable-frame-local; this enables frames to have
4914local bindings for that variable.
4915
4916These frame-local bindings are actually frame parameters: you create a
4917frame-local binding in a specific frame by calling
4918modify-frame-parameters and specifying the variable name as the
4919parameter name.
4920
4921Buffer-local bindings take precedence over frame-local bindings.
4922Thus, if the current buffer has a buffer-local binding, that binding is
4923active; otherwise, if the selected frame has a frame-local binding,
4924that binding is active; otherwise, the default binding is active.
4925
4926It would not be hard to implement window-local bindings, but it is not
4927clear that this would be very useful; windows tend to come and go in a
4928very transitory fashion, so that trying to produce any specific effect
4929through a window-local binding would not be very robust.
4930
4931** `sregexq' and `sregex' are two new functions for constructing
4932"symbolic regular expressions." These are Lisp expressions that, when
4933evaluated, yield conventional string-based regexps. The symbolic form
4934makes it easier to construct, read, and maintain complex patterns.
4935See the documentation in sregex.el.
4936
4937** parse-partial-sexp's return value has an additional element which
4938is used to pass information along if you pass it to another call to
4939parse-partial-sexp, starting its scan where the first call ended.
4940The contents of this field are not yet finalized.
4941
4942** eval-region now accepts a fourth optional argument READ-FUNCTION.
4943If it is non-nil, that function is used instead of `read'.
4944
4945** unload-feature by default removes the feature's functions from
4946known hooks to avoid trouble, but a package providing FEATURE can
4947define a hook FEATURE-unload-hook to be run by unload-feature instead.
4948
4949** read-from-minibuffer no longer returns the argument DEFAULT-VALUE
4950when the user enters empty input. It now returns the null string, as
4951it did in Emacs 19. The default value is made available in the
4952history via M-n, but it is not applied here as a default.
4953
4954The other, more specialized minibuffer-reading functions continue to
4955return the default value (not the null string) when the user enters
4956empty input.
4957
4958** The new variable read-buffer-function controls which routine to use
4959for selecting buffers. For example, if you set this variable to
4960`iswitchb-read-buffer', iswitchb will be used to read buffer names.
4961Other functions can also be used if they accept the same arguments as
4962`read-buffer' and return the selected buffer name as a string.
4963
4964** The new function read-passwd reads a password from the terminal,
4965echoing a period for each character typed. It takes three arguments:
4966a prompt string, a flag which says "read it twice to make sure", and a
4967default password to use if the user enters nothing.
4968
4969** The variable fill-nobreak-predicate gives major modes a way to
4970specify not to break a line at certain places. Its value is a
4971function which is called with no arguments, with point located at the
4972place where a break is being considered. If the function returns
4973non-nil, then the line won't be broken there.
4974
4975** window-end now takes an optional second argument, UPDATE.
4976If this is non-nil, then the function always returns an accurate
4977up-to-date value for the buffer position corresponding to the
4978end of the window, even if this requires computation.
4979
4980** other-buffer now takes an optional argument FRAME
4981which specifies which frame's buffer list to use.
4982If it is nil, that means use the selected frame's buffer list.
4983
4984** The new variable buffer-display-time, always local in every buffer,
4985holds the value of (current-time) as of the last time that a window
4986was directed to display this buffer.
4987
4988** It is now meaningful to compare two window-configuration objects
4989with `equal'. Two window-configuration objects are equal if they
4990describe equivalent arrangements of windows, in the same frame--in
4991other words, if they would give the same results if passed to
4992set-window-configuration.
4993
4994** compare-window-configurations is a new function that compares two
4995window configurations loosely. It ignores differences in saved buffer
4996positions and scrolling, and considers only the structure and sizes of
4997windows and the choice of buffers to display.
4998
4999** The variable minor-mode-overriding-map-alist allows major modes to
5000override the key bindings of a minor mode. The elements of this alist
5001look like the elements of minor-mode-map-alist: (VARIABLE . KEYMAP).
5002
5003If the VARIABLE in an element of minor-mode-overriding-map-alist has a
5004non-nil value, the paired KEYMAP is active, and totally overrides the
5005map (if any) specified for the same variable in minor-mode-map-alist.
5006
5007minor-mode-overriding-map-alist is automatically local in all buffers,
5008and it is meant to be set by major modes.
5009
5010** The function match-string-no-properties is like match-string
5011except that it discards all text properties from the result.
5012
5013** The function load-average now accepts an optional argument
5014USE-FLOATS. If it is non-nil, the load average values are returned as
5015floating point numbers, rather than as integers to be divided by 100.
5016
5017** The new variable temporary-file-directory specifies the directory
5018to use for creating temporary files. The default value is determined
5019in a reasonable way for your operating system; on GNU and Unix systems
5020it is based on the TMP and TMPDIR environment variables.
5021
5022** Menu changes
5023
5024*** easymenu.el now uses the new menu item format and supports the
5025keywords :visible and :filter. The existing keyword :keys is now
5026better supported.
5027
5028The variable `easy-menu-precalculate-equivalent-keybindings' controls
5029a new feature which calculates keyboard equivalents for the menu when
5030you define the menu. The default is t. If you rarely use menus, you
5031can set the variable to nil to disable this precalculation feature;
5032then the calculation is done only if you use the menu bar.
5033
5034*** A new format for menu items is supported.
5035
5036In a keymap, a key binding that has the format
5037 (STRING . REAL-BINDING) or (STRING HELP-STRING . REAL-BINDING)
5038defines a menu item. Now a menu item definition may also be a list that
5039starts with the symbol `menu-item'.
5040
5041The format is:
5042 (menu-item ITEM-NAME) or
5043 (menu-item ITEM-NAME REAL-BINDING . ITEM-PROPERTY-LIST)
5044where ITEM-NAME is an expression which evaluates to the menu item
5045string, and ITEM-PROPERTY-LIST has the form of a property list.
5046The supported properties include
5047
5048:enable FORM Evaluate FORM to determine whether the
5049 item is enabled.
5050:visible FORM Evaluate FORM to determine whether the
5051 item should appear in the menu.
5052:filter FILTER-FN
5053 FILTER-FN is a function of one argument,
5054 which will be REAL-BINDING.
5055 It should return a binding to use instead.
5056:keys DESCRIPTION
5057 DESCRIPTION is a string that describes an equivalent keyboard
5058 binding for for REAL-BINDING. DESCRIPTION is expanded with
5059 `substitute-command-keys' before it is used.
5060:key-sequence KEY-SEQUENCE
5061 KEY-SEQUENCE is a key-sequence for an equivalent
5062 keyboard binding.
5063:key-sequence nil
5064 This means that the command normally has no
5065 keyboard equivalent.
5066:help HELP HELP is the extra help string (not currently used).
5067:button (TYPE . SELECTED)
5068 TYPE is :toggle or :radio.
5069 SELECTED is a form, to be evaluated, and its
5070 value says whether this button is currently selected.
5071
5072Buttons are at the moment only simulated by prefixes in the menu.
5073Eventually ordinary X-buttons may be supported.
5074
5075(menu-item ITEM-NAME) defines unselectable item.
5076
5077** New event types
5078
5079*** The new event type `mouse-wheel' is generated by a wheel on a
5080mouse (such as the MS Intellimouse). The event contains a delta that
5081corresponds to the amount and direction that the wheel is rotated,
5082which is typically used to implement a scroll or zoom. The format is:
5083
5084 (mouse-wheel POSITION DELTA)
5085
5086where POSITION is a list describing the position of the event in the
5087same format as a mouse-click event, and DELTA is a signed number
5088indicating the number of increments by which the wheel was rotated. A
5089negative DELTA indicates that the wheel was rotated backwards, towards
5090the user, and a positive DELTA indicates that the wheel was rotated
5091forward, away from the user.
5092
5093As of now, this event type is generated only on MS Windows.
5094
5095*** The new event type `drag-n-drop' is generated when a group of
5096files is selected in an application outside of Emacs, and then dragged
5097and dropped onto an Emacs frame. The event contains a list of
5098filenames that were dragged and dropped, which are then typically
5099loaded into Emacs. The format is:
5100
5101 (drag-n-drop POSITION FILES)
5102
5103where POSITION is a list describing the position of the event in the
5104same format as a mouse-click event, and FILES is the list of filenames
5105that were dragged and dropped.
5106
5107As of now, this event type is generated only on MS Windows.
5108
5109** Changes relating to multibyte characters.
5110
5111*** The variable enable-multibyte-characters is now read-only;
5112any attempt to set it directly signals an error. The only way
5113to change this value in an existing buffer is with set-buffer-multibyte.
5114
5115*** In a string constant, `\ ' now stands for "nothing at all". You
5116can use it to terminate a hex escape which is followed by a character
5117that could otherwise be read as part of the hex escape.
5118
5119*** String indices are now measured in characters, as they were
5120in Emacs 19 and before.
5121
5122The function chars-in-string has been deleted.
5123The function concat-chars has been renamed to `string'.
5124
5125*** The function set-buffer-multibyte sets the flag in the current
5126buffer that says whether the buffer uses multibyte representation or
5127unibyte representation. If the argument is nil, it selects unibyte
5128representation. Otherwise it selects multibyte representation.
5129
5130This function does not change the contents of the buffer, viewed
5131as a sequence of bytes. However, it does change the contents
5132viewed as characters; a sequence of two bytes which is treated as
5133one character when the buffer uses multibyte representation
5134will count as two characters using unibyte representation.
5135
5136This function sets enable-multibyte-characters to record which
5137representation is in use. It also adjusts various data in the buffer
5138(including its markers, overlays and text properties) so that they are
5139consistent with the new representation.
5140
5141*** string-make-multibyte takes a string and converts it to multibyte
5142representation. Most of the time, you don't need to care
5143about the representation, because Emacs converts when necessary;
5144however, it makes a difference when you compare strings.
5145
5146The conversion of non-ASCII characters works by adding the value of
5147nonascii-insert-offset to each character, or by translating them
5148using the table nonascii-translation-table.
5149
5150*** string-make-unibyte takes a string and converts it to unibyte
5151representation. Most of the time, you don't need to care about the
5152representation, but it makes a difference when you compare strings.
5153
5154The conversion from multibyte to unibyte representation
5155loses information; the only time Emacs performs it automatically
5156is when inserting a multibyte string into a unibyte buffer.
5157
5158*** string-as-multibyte takes a string, and returns another string
5159which contains the same bytes, but treats them as multibyte.
5160
5161*** string-as-unibyte takes a string, and returns another string
5162which contains the same bytes, but treats them as unibyte.
5163
5164*** The new function compare-strings lets you compare
5165portions of two strings. Unibyte strings are converted to multibyte,
5166so that a unibyte string can match a multibyte string.
5167You can specify whether to ignore case or not.
5168
5169*** assoc-ignore-case now uses compare-strings so that
5170it can treat unibyte and multibyte strings as equal.
5171
5172*** Regular expression operations and buffer string searches now
5173convert the search pattern to multibyte or unibyte to accord with the
5174buffer or string being searched.
5175
5176One consequence is that you cannot always use \200-\377 inside of
5177[...] to match all non-ASCII characters. This does still work when
5178searching or matching a unibyte buffer or string, but not when
5179searching or matching a multibyte string. Unfortunately, there is no
5180obvious choice of syntax to use within [...] for that job. But, what
5181you want is just to match all non-ASCII characters, the regular
5182expression [^\0-\177] works for it.
5183
5184*** Structure of coding system changed.
5185
5186All coding systems (including aliases and subsidiaries) are named
5187by symbols; the symbol's `coding-system' property is a vector
5188which defines the coding system. Aliases share the same vector
5189as the principal name, so that altering the contents of this
5190vector affects the principal name and its aliases. You can define
5191your own alias name of a coding system by the function
5192define-coding-system-alias.
5193
5194The coding system definition includes a property list of its own. Use
5195the new functions `coding-system-get' and `coding-system-put' to
5196access such coding system properties as post-read-conversion,
5197pre-write-conversion, character-translation-table-for-decode,
5198character-translation-table-for-encode, mime-charset, and
5199safe-charsets. For instance, (coding-system-get 'iso-latin-1
5200'mime-charset) gives the corresponding MIME-charset parameter
5201`iso-8859-1'.
5202
5203Among the coding system properties listed above, safe-charsets is new.
5204The value of this property is a list of character sets which this
5205coding system can correctly encode and decode. For instance:
5206(coding-system-get 'iso-latin-1 'safe-charsets) => (ascii latin-iso8859-1)
5207
5208Here, "correctly encode" means that the encoded character sets can
5209also be handled safely by systems other than Emacs as far as they
5210are capable of that coding system. Though, Emacs itself can encode
5211the other character sets and read it back correctly.
5212
5213*** The new function select-safe-coding-system can be used to find a
5214proper coding system for encoding the specified region or string.
5215This function requires a user interaction.
5216
5217*** The new functions find-coding-systems-region and
5218find-coding-systems-string are helper functions used by
5219select-safe-coding-system. They return a list of all proper coding
5220systems to encode a text in some region or string. If you don't want
5221a user interaction, use one of these functions instead of
5222select-safe-coding-system.
5223
5224*** The explicit encoding and decoding functions, such as
5225decode-coding-region and encode-coding-string, now set
5226last-coding-system-used to reflect the actual way encoding or decoding
5227was done.
5228
5229*** The new function detect-coding-with-language-environment can be
5230used to detect a coding system of text according to priorities of
5231coding systems used by some specific language environment.
5232
5233*** The functions detect-coding-region and detect-coding-string always
5234return a list if the arg HIGHEST is nil. Thus, if only ASCII
5235characters are found, they now return a list of single element
5236`undecided' or its subsidiaries.
5237
5238*** The new functions coding-system-change-eol-conversion and
5239coding-system-change-text-conversion can be used to get a different
5240coding system than what specified only in how end-of-line or text is
5241converted.
5242
5243*** The new function set-selection-coding-system can be used to set a
5244coding system for communicating with other X clients.
5245
5246*** The function `map-char-table' now passes as argument only valid
5247character codes, plus generic characters that stand for entire
5248character sets or entire subrows of a character set. In other words,
5249each time `map-char-table' calls its FUNCTION argument, the key value
5250either will be a valid individual character code, or will stand for a
5251range of characters.
5252
5253*** The new function `char-valid-p' can be used for checking whether a
5254Lisp object is a valid character code or not.
5255
5256*** The new function `charset-after' returns a charset of a character
5257in the current buffer at position POS.
5258
5259*** Input methods are now implemented using the variable
5260input-method-function. If this is non-nil, its value should be a
5261function; then, whenever Emacs reads an input event that is a printing
5262character with no modifier bits, it calls that function, passing the
5263event as an argument. Often this function will read more input, first
5264binding input-method-function to nil.
5265
5266The return value should be a list of the events resulting from input
5267method processing. These events will be processed sequentially as
5268input, before resorting to unread-command-events. Events returned by
5269the input method function are not passed to the input method function,
5270not even if they are printing characters with no modifier bits.
5271
5272The input method function is not called when reading the second and
5273subsequent events of a key sequence.
5274
5275*** You can customize any language environment by using
5276set-language-environment-hook and exit-language-environment-hook.
5277
5278The hook `exit-language-environment-hook' should be used to undo
5279customizations that you made with set-language-environment-hook. For
5280instance, if you set up a special key binding for a specific language
5281environment by set-language-environment-hook, you should set up
5282exit-language-environment-hook to restore the normal key binding.
5283
5284* Changes in Emacs 20.1
5285
5286** Emacs has a new facility for customization of its many user
5287options. It is called M-x customize. With this facility you can look
5288at the many user options in an organized way; they are grouped into a
5289tree structure.
5290
5291M-x customize also knows what sorts of values are legitimate for each
5292user option and ensures that you don't use invalid values.
5293
5294With M-x customize, you can set options either for the present Emacs
5295session or permanently. (Permanent settings are stored automatically
5296in your .emacs file.)
5297
5298** Scroll bars are now on the left side of the window.
5299You can change this with M-x customize-option scroll-bar-mode.
5300
5301** The mode line no longer includes the string `Emacs'.
5302This makes more space in the mode line for other information.
5303
5304** When you select a region with the mouse, it is highlighted
5305immediately afterward. At that time, if you type the DELETE key, it
5306kills the region.
5307
5308The BACKSPACE key, and the ASCII character DEL, do not do this; they
5309delete the character before point, as usual.
5310
5311** In an incremental search the whole current match is highlighted
5312on terminals which support this. (You can disable this feature
5313by setting search-highlight to nil.)
5314
5315** In the minibuffer, in some cases, you can now use M-n to
5316insert the default value into the minibuffer as text. In effect,
5317the default value (if the minibuffer routines know it) is tacked
5318onto the history "in the future". (The more normal use of the
5319history list is to use M-p to insert minibuffer input used in the
5320past.)
5321
5322** In Text mode, now only blank lines separate paragraphs.
5323This makes it possible to get the full benefit of Adaptive Fill mode
5324in Text mode, and other modes derived from it (such as Mail mode).
5325TAB in Text mode now runs the command indent-relative; this
5326makes a practical difference only when you use indented paragraphs.
5327
5328As a result, the old Indented Text mode is now identical to Text mode,
5329and is an alias for it.
5330
5331If you want spaces at the beginning of a line to start a paragraph,
5332use the new mode, Paragraph Indent Text mode.
5333
5334** Scrolling changes
5335
5336*** Scroll commands to scroll a whole screen now preserve the screen
5337position of the cursor, if scroll-preserve-screen-position is non-nil.
5338
5339In this mode, if you scroll several screens back and forth, finishing
5340on the same screen where you started, the cursor goes back to the line
5341where it started.
5342
5343*** If you set scroll-conservatively to a small number, then when you
5344move point a short distance off the screen, Emacs will scroll the
5345screen just far enough to bring point back on screen, provided that
5346does not exceed `scroll-conservatively' lines.
5347
5348*** The new variable scroll-margin says how close point can come to the
5349top or bottom of a window. It is a number of screen lines; if point
5350comes within that many lines of the top or bottom of the window, Emacs
5351recenters the window.
5352
5353** International character set support (MULE)
5354
5355Emacs now supports a wide variety of international character sets,
5356including European variants of the Latin alphabet, as well as Chinese,
5357Devanagari (Hindi and Marathi), Ethiopian, Greek, IPA, Japanese,
5358Korean, Lao, Russian, Thai, Tibetan, and Vietnamese scripts. These
5359features have been merged from the modified version of Emacs known as
5360MULE (for "MULti-lingual Enhancement to GNU Emacs")
5361
5362Users of these scripts have established many more-or-less standard
5363coding systems for storing files. Emacs uses a single multibyte
5364character encoding within Emacs buffers; it can translate from a wide
5365variety of coding systems when reading a file and can translate back
5366into any of these coding systems when saving a file.
5367
5368Keyboards, even in the countries where these character sets are used,
5369generally don't have keys for all the characters in them. So Emacs
5370supports various "input methods", typically one for each script or
5371language, to make it possible to type them.
5372
5373The Emacs internal multibyte encoding represents a non-ASCII
5374character as a sequence of bytes in the range 0200 through 0377.
5375
5376The new prefix key C-x RET is used for commands that pertain
5377to multibyte characters, coding systems, and input methods.
5378
5379You can disable multibyte character support as follows:
5380
5381 (setq-default enable-multibyte-characters nil)
5382
5383Calling the function standard-display-european turns off multibyte
5384characters, unless you specify a non-nil value for the second
5385argument, AUTO. This provides compatibility for people who are
5386already using standard-display-european to continue using unibyte
5387characters for their work until they want to change.
5388
5389*** Input methods
5390
5391An input method is a kind of character conversion which is designed
5392specifically for interactive input. In Emacs, typically each language
5393has its own input method (though sometimes several languages which use
5394the same characters can share one input method). Some languages
5395support several input methods.
5396
5397The simplest kind of input method works by mapping ASCII letters into
5398another alphabet. This is how the Greek and Russian input methods
5399work.
5400
5401A more powerful technique is composition: converting sequences of
5402characters into one letter. Many European input methods use
5403composition to produce a single non-ASCII letter from a sequence which
5404consists of a letter followed by diacritics. For example, a' is one
5405sequence of two characters that might be converted into a single
5406letter.
5407
5408The input methods for syllabic scripts typically use mapping followed
5409by conversion. The input methods for Thai and Korean work this way.
5410First, letters are mapped into symbols for particular sounds or tone
5411marks; then, sequences of these which make up a whole syllable are
5412mapped into one syllable sign--most often a "composite character".
5413
5414None of these methods works very well for Chinese and Japanese, so
5415they are handled specially. First you input a whole word using
5416phonetic spelling; then, after the word is in the buffer, Emacs
5417converts it into one or more characters using a large dictionary.
5418
5419Since there is more than one way to represent a phonetically spelled
5420word using Chinese characters, Emacs can only guess which one to use;
5421typically these input methods give you a way to say "guess again" if
5422the first guess is wrong.
5423
5424*** The command C-x RET m (toggle-enable-multibyte-characters)
5425turns multibyte character support on or off for the current buffer.
5426
5427If multibyte character support is turned off in a buffer, then each
5428byte is a single character, even codes 0200 through 0377--exactly as
5429they did in Emacs 19.34. This includes the features for support for
5430the European characters, ISO Latin-1 and ISO Latin-2.
5431
5432However, there is no need to turn off multibyte character support to
5433use ISO Latin-1 or ISO Latin-2; the Emacs multibyte character set
5434includes all the characters in these character sets, and Emacs can
5435translate automatically to and from either one.
5436
5437*** Visiting a file in unibyte mode.
5438
5439Turning off multibyte character support in the buffer after visiting a
5440file with multibyte code conversion will display the multibyte
5441sequences already in the buffer, byte by byte. This is probably not
5442what you want.
5443
5444If you want to edit a file of unibyte characters (Latin-1, for
5445example), you can do it by specifying `no-conversion' as the coding
5446system when reading the file. This coding system also turns off
5447multibyte characters in that buffer.
5448
5449If you turn off multibyte character support entirely, this turns off
5450character conversion as well.
5451
5452*** Displaying international characters on X Windows.
5453
5454A font for X typically displays just one alphabet or script.
5455Therefore, displaying the entire range of characters Emacs supports
5456requires using many fonts.
5457
5458Therefore, Emacs now supports "fontsets". Each fontset is a
5459collection of fonts, each assigned to a range of character codes.
5460
5461A fontset has a name, like a font. Individual fonts are defined by
5462the X server; fontsets are defined within Emacs itself. But once you
5463have defined a fontset, you can use it in a face or a frame just as
5464you would use a font.
5465
5466If a fontset specifies no font for a certain character, or if it
5467specifies a font that does not exist on your system, then it cannot
5468display that character. It will display an empty box instead.
5469
5470The fontset height and width are determined by the ASCII characters
5471(that is, by the font in the fontset which is used for ASCII
5472characters). If another font in the fontset has a different height,
5473or the wrong width, then characters assigned to that font are clipped,
5474and displayed within a box if highlight-wrong-size-font is non-nil.
5475
5476*** Defining fontsets.
5477
5478Emacs does not use any fontset by default. Its default font is still
5479chosen as in previous versions. You can tell Emacs to use a fontset
5480with the `-fn' option or the `Font' X resource.
5481
5482Emacs creates a standard fontset automatically according to the value
5483of standard-fontset-spec. This fontset's short name is
5484`fontset-standard'. Bold, italic, and bold-italic variants of the
5485standard fontset are created automatically.
5486
5487If you specify a default ASCII font with the `Font' resource or `-fn'
5488argument, a fontset is generated from it. This works by replacing the
5489FOUNDARY, FAMILY, ADD_STYLE, and AVERAGE_WIDTH fields of the font name
5490with `*' then using this to specify a fontset. This fontset's short
5491name is `fontset-startup'.
5492
5493Emacs checks resources of the form Fontset-N where N is 0, 1, 2...
5494The resource value should have this form:
5495 FONTSET-NAME, [CHARSET-NAME:FONT-NAME]...
5496FONTSET-NAME should have the form of a standard X font name, except:
5497 * most fields should be just the wild card "*".
5498 * the CHARSET_REGISTRY field should be "fontset"
5499 * the CHARSET_ENCODING field can be any nickname of the fontset.
5500The construct CHARSET-NAME:FONT-NAME can be repeated any number
5501of times; each time specifies the font for one character set.
5502CHARSET-NAME should be the name name of a character set, and
5503FONT-NAME should specify an actual font to use for that character set.
5504
5505Each of these fontsets has an alias which is made from the
5506last two font name fields, CHARSET_REGISTRY and CHARSET_ENCODING.
5507You can refer to the fontset by that alias or by its full name.
5508
5509For any character sets that you don't mention, Emacs tries to choose a
5510font by substituting into FONTSET-NAME. For instance, with the
5511following resource,
5512 Emacs*Fontset-0: -*-fixed-medium-r-normal-*-24-*-*-*-*-*-fontset-24
5513the font for ASCII is generated as below:
5514 -*-fixed-medium-r-normal-*-24-*-ISO8859-1
5515Here is the substitution rule:
5516 Change CHARSET_REGISTRY and CHARSET_ENCODING to that of the charset
5517 defined in the variable x-charset-registries. For instance, ASCII has
5518 the entry (ascii . "ISO8859-1") in this variable. Then, reduce
5519 sequences of wild cards -*-...-*- with a single wildcard -*-.
5520 (This is to prevent use of auto-scaled fonts.)
5521
5522The function which processes the fontset resource value to create the
5523fontset is called create-fontset-from-fontset-spec. You can also call
5524that function explicitly to create a fontset.
5525
5526With the X resource Emacs.Font, you can specify a fontset name just
5527like an actual font name. But be careful not to specify a fontset
5528name in a wildcard resource like Emacs*Font--that tries to specify the
5529fontset for other purposes including menus, and they cannot handle
5530fontsets.
5531
5532*** The command M-x set-language-environment sets certain global Emacs
5533defaults for a particular choice of language.
5534
5535Selecting a language environment typically specifies a default input
5536method and which coding systems to recognize automatically when
5537visiting files. However, it does not try to reread files you have
5538already visited; the text in those buffers is not affected. The
5539language environment may also specify a default choice of coding
5540system for new files that you create.
5541
5542It makes no difference which buffer is current when you use
5543set-language-environment, because these defaults apply globally to the
5544whole Emacs session.
5545
5546For example, M-x set-language-environment RET Latin-1 RET
5547chooses the Latin-1 character set. In the .emacs file, you can do this
5548with (set-language-environment "Latin-1").
5549
5550*** The command C-x RET f (set-buffer-file-coding-system)
5551specifies the file coding system for the current buffer. This
5552specifies what sort of character code translation to do when saving
5553the file. As an argument, you must specify the name of one of the
5554coding systems that Emacs supports.
5555
5556*** The command C-x RET c (universal-coding-system-argument)
5557lets you specify a coding system when you read or write a file.
5558This command uses the minibuffer to read a coding system name.
5559After you exit the minibuffer, the specified coding system
5560is used for *the immediately following command*.
5561
5562So if the immediately following command is a command to read or
5563write a file, it uses the specified coding system for that file.
5564
5565If the immediately following command does not use the coding system,
5566then C-x RET c ultimately has no effect.
5567
5568For example, C-x RET c iso-8859-1 RET C-x C-f temp RET
5569visits the file `temp' treating it as ISO Latin-1.
5570
5571*** You can specify the coding system for a file using the -*-
5572construct. Include `coding: CODINGSYSTEM;' inside the -*-...-*-
5573to specify use of coding system CODINGSYSTEM. You can also
5574specify the coding system in a local variable list at the end
5575of the file.
5576
5577*** The command C-x RET t (set-terminal-coding-system) specifies
5578the coding system for terminal output. If you specify a character
5579code for terminal output, all characters output to the terminal are
5580translated into that character code.
5581
5582This feature is useful for certain character-only terminals built in
5583various countries to support the languages of those countries.
5584
5585By default, output to the terminal is not translated at all.
5586
5587*** The command C-x RET k (set-keyboard-coding-system) specifies
5588the coding system for keyboard input.
5589
5590Character code translation of keyboard input is useful for terminals
5591with keys that send non-ASCII graphic characters--for example,
5592some terminals designed for ISO Latin-1 or subsets of it.
5593
5594By default, keyboard input is not translated at all.
5595
5596Character code translation of keyboard input is similar to using an
5597input method, in that both define sequences of keyboard input that
5598translate into single characters. However, input methods are designed
5599to be convenient for interactive use, while the code translations are
5600designed to work with terminals.
5601
5602*** The command C-x RET p (set-buffer-process-coding-system)
5603specifies the coding system for input and output to a subprocess.
5604This command applies to the current buffer; normally, each subprocess
5605has its own buffer, and thus you can use this command to specify
5606translation to and from a particular subprocess by giving the command
5607in the corresponding buffer.
5608
5609By default, process input and output are not translated at all.
5610
5611*** The variable file-name-coding-system specifies the coding system
5612to use for encoding file names before operating on them.
5613It is also used for decoding file names obtained from the system.
5614
5615*** The command C-\ (toggle-input-method) activates or deactivates
5616an input method. If no input method has been selected before, the
5617command prompts for you to specify the language and input method you
5618want to use.
5619
5620C-u C-\ (select-input-method) lets you switch to a different input
5621method. C-h C-\ (or C-h I) describes the current input method.
5622
5623*** Some input methods remap the keyboard to emulate various keyboard
5624layouts commonly used for particular scripts. How to do this
5625remapping properly depends on your actual keyboard layout. To specify
5626which layout your keyboard has, use M-x quail-set-keyboard-layout.
5627
5628*** The command C-h C (describe-coding-system) displays
5629the coding systems currently selected for various purposes, plus
5630related information.
5631
5632*** The command C-h h (view-hello-file) displays a file called
5633HELLO, which has examples of text in many languages, using various
5634scripts.
5635
5636*** The command C-h L (describe-language-support) displays
5637information about the support for a particular language.
5638You specify the language as an argument.
5639
5640*** The mode line now contains a letter or character that identifies
5641the coding system used in the visited file. It normally follows the
5642first dash.
5643
5644A dash indicates the default state of affairs: no code conversion
5645(except CRLF => newline if appropriate). `=' means no conversion
5646whatsoever. The ISO 8859 coding systems are represented by digits
56471 through 9. Other coding systems are represented by letters:
5648
5649 A alternativnyj (Russian)
5650 B big5 (Chinese)
5651 C cn-gb-2312 (Chinese)
5652 C iso-2022-cn (Chinese)
5653 D in-is13194-devanagari (Indian languages)
5654 E euc-japan (Japanese)
5655 I iso-2022-cjk or iso-2022-ss2 (Chinese, Japanese, Korean)
5656 J junet (iso-2022-7) or old-jis (iso-2022-jp-1978-irv) (Japanese)
5657 K euc-korea (Korean)
5658 R koi8 (Russian)
5659 Q tibetan
5660 S shift_jis (Japanese)
5661 T lao
5662 T tis620 (Thai)
5663 V viscii or vscii (Vietnamese)
5664 i iso-2022-lock (Chinese, Japanese, Korean)
5665 k iso-2022-kr (Korean)
5666 v viqr (Vietnamese)
5667 z hz (Chinese)
5668
5669When you are using a character-only terminal (not a window system),
5670two additional characters appear in between the dash and the file
5671coding system. These two characters describe the coding system for
5672keyboard input, and the coding system for terminal output.
5673
5674*** The new variable rmail-file-coding-system specifies the code
5675conversion to use for RMAIL files. The default value is nil.
5676
5677When you read mail with Rmail, each message is decoded automatically
5678into Emacs' internal format. This has nothing to do with
5679rmail-file-coding-system. That variable controls reading and writing
5680Rmail files themselves.
5681
5682*** The new variable sendmail-coding-system specifies the code
5683conversion for outgoing mail. The default value is nil.
5684
5685Actually, there are three different ways of specifying the coding system
5686for sending mail:
5687
5688- If you use C-x RET f in the mail buffer, that takes priority.
5689- Otherwise, if you set sendmail-coding-system non-nil, that specifies it.
5690- Otherwise, the default coding system for new files is used,
5691 if that is non-nil. That comes from your language environment.
5692- Otherwise, Latin-1 is used.
5693
5694*** The command C-h t (help-with-tutorial) accepts a prefix argument
5695to specify the language for the tutorial file. Currently, English,
5696Japanese, Korean and Thai are supported. We welcome additional
5697translations.
5698
5699** An easy new way to visit a file with no code or format conversion
5700of any kind: Use M-x find-file-literally. There is also a command
5701insert-file-literally which inserts a file into the current buffer
5702without any conversion.
5703
5704** C-q's handling of octal character codes is changed.
5705You can now specify any number of octal digits.
5706RET terminates the digits and is discarded;
5707any other non-digit terminates the digits and is then used as input.
5708
5709** There are new commands for looking up Info documentation for
5710functions, variables and file names used in your programs.
5711
5712Type M-x info-lookup-symbol to look up a symbol in the buffer at point.
5713Type M-x info-lookup-file to look up a file in the buffer at point.
5714
5715Precisely which Info files are used to look it up depends on the major
5716mode. For example, in C mode, the GNU libc manual is used.
5717
5718** M-TAB in most programming language modes now runs the command
5719complete-symbol. This command performs completion on the symbol name
5720in the buffer before point.
5721
5722With a numeric argument, it performs completion based on the set of
5723symbols documented in the Info files for the programming language that
5724you are using.
5725
5726With no argument, it does completion based on the current tags tables,
5727just like the old binding of M-TAB (complete-tag).
5728
5729** File locking works with NFS now.
5730
5731The lock file for FILENAME is now a symbolic link named .#FILENAME,
5732in the same directory as FILENAME.
5733
5734This means that collision detection between two different machines now
5735works reasonably well; it also means that no file server or directory
5736can become a bottleneck.
5737
5738The new method does have drawbacks. It means that collision detection
5739does not operate when you edit a file in a directory where you cannot
5740create new files. Collision detection also doesn't operate when the
5741file server does not support symbolic links. But these conditions are
5742rare, and the ability to have collision detection while using NFS is
5743so useful that the change is worth while.
5744
5745When Emacs or a system crashes, this may leave behind lock files which
5746are stale. So you may occasionally get warnings about spurious
5747collisions. When you determine that the collision is spurious, just
5748tell Emacs to go ahead anyway.
5749
5750** If you wish to use Show Paren mode to display matching parentheses,
5751it is no longer sufficient to load paren.el. Instead you must call
5752show-paren-mode.
5753
5754** If you wish to use Delete Selection mode to replace a highlighted
5755selection when you insert new text, it is no longer sufficient to load
5756delsel.el. Instead you must call the function delete-selection-mode.
5757
5758** If you wish to use Partial Completion mode to complete partial words
5759within symbols or filenames, it is no longer sufficient to load
5760complete.el. Instead you must call the function partial-completion-mode.
5761
5762** If you wish to use uniquify to rename buffers for you,
5763it is no longer sufficient to load uniquify.el. You must also
5764set uniquify-buffer-name-style to one of the non-nil legitimate values.
5765
5766** Changes in View mode.
5767
5768*** Several new commands are available in View mode.
5769Do H in view mode for a list of commands.
5770
5771*** There are two new commands for entering View mode:
5772view-file-other-frame and view-buffer-other-frame.
5773
5774*** Exiting View mode does a better job of restoring windows to their
5775previous state.
5776
5777*** New customization variable view-scroll-auto-exit. If non-nil,
5778scrolling past end of buffer makes view mode exit.
5779
5780*** New customization variable view-exits-all-viewing-windows. If
5781non-nil, view-mode will at exit restore all windows viewing buffer,
5782not just the selected window.
5783
5784*** New customization variable view-read-only. If non-nil, visiting a
5785read-only file automatically enters View mode, and toggle-read-only
5786turns View mode on or off.
5787
5788*** New customization variable view-remove-frame-by-deleting controls
5789how to remove a not needed frame at view mode exit. If non-nil,
5790delete the frame, if nil make an icon of it.
5791
5792** C-x v l, the command to print a file's version control log,
5793now positions point at the entry for the file's current branch version.
5794
5795** C-x v =, the command to compare a file with the last checked-in version,
5796has a new feature. If the file is currently not locked, so that it is
5797presumably identical to the last checked-in version, the command now asks
5798which version to compare with.
5799
5800** When using hideshow.el, incremental search can temporarily show hidden
5801blocks if a match is inside the block.
5802
5803The block is hidden again if the search is continued and the next match
5804is outside the block. By customizing the variable
5805isearch-hide-immediately you can choose to hide all the temporarily
5806shown blocks only when exiting from incremental search.
5807
5808By customizing the variable hs-isearch-open you can choose what kind
5809of blocks to temporarily show during isearch: comment blocks, code
5810blocks, all of them or none.
5811
5812** The new command C-x 4 0 (kill-buffer-and-window) kills the
5813current buffer and deletes the selected window. It asks for
5814confirmation first.
5815
5816** C-x C-w, which saves the buffer into a specified file name,
5817now changes the major mode according to that file name.
5818However, the mode will not be changed if
5819(1) a local variables list or the `-*-' line specifies a major mode, or
5820(2) the current major mode is a "special" mode,
5821 not suitable for ordinary files, or
5822(3) the new file name does not particularly specify any mode.
5823
5824This applies to M-x set-visited-file-name as well.
5825
5826However, if you set change-major-mode-with-file-name to nil, then
5827these commands do not change the major mode.
5828
5829** M-x occur changes.
5830
5831*** If the argument to M-x occur contains upper case letters,
5832it performs a case-sensitive search.
5833
5834*** In the *Occur* buffer made by M-x occur,
5835if you type g or M-x revert-buffer, this repeats the search
5836using the same regular expression and the same buffer as before.
5837
5838** In Transient Mark mode, the region in any one buffer is highlighted
5839in just one window at a time. At first, it is highlighted in the
5840window where you set the mark. The buffer's highlighting remains in
5841that window unless you select to another window which shows the same
5842buffer--then the highlighting moves to that window.
5843
5844** The feature to suggest key bindings when you use M-x now operates
5845after the command finishes. The message suggesting key bindings
5846appears temporarily in the echo area. The previous echo area contents
5847come back after a few seconds, in case they contain useful information.
5848
5849** Each frame now independently records the order for recently
5850selected buffers, so that the default for C-x b is now based on the
5851buffers recently selected in the selected frame.
5852
5853** Outline mode changes.
5854
5855*** Outline mode now uses overlays (this is the former noutline.el).
5856
5857*** Incremental searches skip over invisible text in Outline mode.
5858
5859** When a minibuffer window is active but not the selected window, if
5860you try to use the minibuffer, you used to get a nested minibuffer.
5861Now, this not only gives an error, it also cancels the minibuffer that
5862was already active.
5863
5864The motive for this change is so that beginning users do not
5865unknowingly move away from minibuffers, leaving them active, and then
5866get confused by it.
5867
5868If you want to be able to have recursive minibuffers, you must
5869set enable-recursive-minibuffers to non-nil.
5870
5871** Changes in dynamic abbrevs.
5872
5873*** Expanding dynamic abbrevs with M-/ is now smarter about case
5874conversion. If the expansion has mixed case not counting the first
5875character, and the abbreviation matches the beginning of the expansion
5876including case, then the expansion is copied verbatim.
5877
5878The expansion is also copied verbatim if the abbreviation itself has
5879mixed case. And using SPC M-/ to copy an additional word always
5880copies it verbatim except when the previous copied word is all caps.
5881
5882*** The values of `dabbrev-case-replace' and `dabbrev-case-fold-search'
5883are no longer Lisp expressions. They have simply three possible
5884values.
5885
5886`dabbrev-case-replace' has these three values: nil (don't preserve
5887case), t (do), or `case-replace' (do like M-x query-replace).
5888`dabbrev-case-fold-search' has these three values: nil (don't ignore
5889case), t (do), or `case-fold-search' (do like search).
5890
5891** Minibuffer history lists are truncated automatically now to a
5892certain length. The variable history-length specifies how long they
5893can be. The default value is 30.
5894
5895** Changes in Mail mode.
5896
5897*** The key C-x m no longer runs the `mail' command directly.
5898Instead, it runs the command `compose-mail', which invokes the mail
5899composition mechanism you have selected with the variable
5900`mail-user-agent'. The default choice of user agent is
5901`sendmail-user-agent', which gives behavior compatible with the old
5902behavior.
5903
5904C-x 4 m now runs compose-mail-other-window, and C-x 5 m runs
5905compose-mail-other-frame.
5906
5907*** While composing a reply to a mail message, from Rmail, you can use
5908the command C-c C-r to cite just the region from the message you are
5909replying to. This copies the text which is the selected region in the
5910buffer that shows the original message.
5911
5912*** The command C-c C-i inserts a file at the end of the message,
5913with separator lines around the contents.
5914
5915*** The command M-x expand-mail-aliases expands all mail aliases
5916in suitable mail headers. Emacs automatically extracts mail alias
5917definitions from your mail alias file (e.g., ~/.mailrc). You do not
5918need to expand mail aliases yourself before sending mail.
5919
5920*** New features in the mail-complete command.
5921
5922**** The mail-complete command now inserts the user's full name,
5923for local users or if that is known. The variable mail-complete-style
5924controls the style to use, and whether to do this at all.
5925Its values are like those of mail-from-style.
5926
5927**** The variable mail-passwd-command lets you specify a shell command
5928to run to fetch a set of password-entries that add to the ones in
5929/etc/passwd.
5930
5931**** The variable mail-passwd-file now specifies a list of files to read
5932to get the list of user ids. By default, one file is used:
5933/etc/passwd.
5934
5935** You can "quote" a file name to inhibit special significance of
5936special syntax, by adding `/:' to the beginning. Thus, if you have a
5937directory named `/foo:', you can prevent it from being treated as a
5938reference to a remote host named `foo' by writing it as `/:/foo:'.
5939
5940Emacs uses this new construct automatically when necessary, such as
5941when you start it with a working directory whose name might otherwise
5942be taken to be magic.
5943
5944** There is a new command M-x grep-find which uses find to select
5945files to search through, and grep to scan them. The output is
5946available in a Compile mode buffer, as with M-x grep.
5947
5948M-x grep now uses the -e option if the grep program supports that.
5949(-e prevents problems if the search pattern starts with a dash.)
5950
5951** In Dired, the & command now flags for deletion the files whose names
5952suggest they are probably not needed in the long run.
5953
5954In Dired, * is now a prefix key for mark-related commands.
5955
5956new key dired.el binding old key
5957------- ---------------- -------
5958 * c dired-change-marks c
5959 * m dired-mark m
5960 * * dired-mark-executables * (binding deleted)
5961 * / dired-mark-directories / (binding deleted)
5962 * @ dired-mark-symlinks @ (binding deleted)
5963 * u dired-unmark u
5964 * DEL dired-unmark-backward DEL
5965 * ? dired-unmark-all-files M-C-?
5966 * ! dired-unmark-all-marks
5967 * % dired-mark-files-regexp % m
5968 * C-n dired-next-marked-file M-}
5969 * C-p dired-prev-marked-file M-{
5970
5971** Rmail changes.
5972
5973*** When Rmail cannot convert your incoming mail into Babyl format, it
5974saves the new mail in the file RMAILOSE.n, where n is an integer
5975chosen to make a unique name. This way, Rmail will not keep crashing
5976each time you run it.
5977
5978*** In Rmail, the variable rmail-summary-line-count-flag now controls
5979whether to include the line count in the summary. Non-nil means yes.
5980
5981*** In Rmail summary buffers, d and C-d (the commands to delete
5982messages) now take repeat counts as arguments. A negative argument
5983means to move in the opposite direction.
5984
5985*** In Rmail, the t command now takes an optional argument which lets
5986you specify whether to show the message headers in full or pruned.
5987
5988*** In Rmail, the new command w (rmail-output-body-to-file) writes
5989just the body of the current message into a file, without the headers.
5990It takes the file name from the message subject, by default, but you
5991can edit that file name in the minibuffer before it is actually used
5992for output.
5993
5994** Gnus changes.
5995
5996*** nntp.el has been totally rewritten in an asynchronous fashion.
5997
5998*** Article prefetching functionality has been moved up into
5999Gnus.
6000
6001*** Scoring can now be performed with logical operators like
6002`and', `or', `not', and parent redirection.
6003
6004*** Article washing status can be displayed in the
6005article mode line.
6006
6007*** gnus.el has been split into many smaller files.
6008
6009*** Suppression of duplicate articles based on Message-ID.
6010
6011(setq gnus-suppress-duplicates t)
6012
6013*** New variables for specifying what score and adapt files
6014are to be considered home score and adapt files. See
6015`gnus-home-score-file' and `gnus-home-adapt-files'.
6016
6017*** Groups can inherit group parameters from parent topics.
6018
6019*** Article editing has been revamped and is now usable.
6020
6021*** Signatures can be recognized in more intelligent fashions.
6022See `gnus-signature-separator' and `gnus-signature-limit'.
6023
6024*** Summary pick mode has been made to look more nn-like.
6025Line numbers are displayed and the `.' command can be
6026used to pick articles.
6027
6028*** Commands for moving the .newsrc.eld from one server to
6029another have been added.
6030
6031 `M-x gnus-change-server'
6032
6033*** A way to specify that "uninteresting" fields be suppressed when
6034generating lines in buffers.
6035
6036*** Several commands in the group buffer can be undone with
6037`M-C-_'.
6038
6039*** Scoring can be done on words using the new score type `w'.
6040
6041*** Adaptive scoring can be done on a Subject word-by-word basis:
6042
6043 (setq gnus-use-adaptive-scoring '(word))
6044
6045*** Scores can be decayed.
6046
6047 (setq gnus-decay-scores t)
6048
6049*** Scoring can be performed using a regexp on the Date header. The
6050Date is normalized to compact ISO 8601 format first.
6051
6052*** A new command has been added to remove all data on articles from
6053the native server.
6054
6055 `M-x gnus-group-clear-data-on-native-groups'
6056
6057*** A new command for reading collections of documents
6058(nndoc with nnvirtual on top) has been added -- `M-C-d'.
6059
6060*** Process mark sets can be pushed and popped.
6061
6062*** A new mail-to-news backend makes it possible to post
6063even when the NNTP server doesn't allow posting.
6064
6065*** A new backend for reading searches from Web search engines
6066(DejaNews, Alta Vista, InReference) has been added.
6067
6068 Use the `G w' command in the group buffer to create such
6069 a group.
6070
6071*** Groups inside topics can now be sorted using the standard
6072sorting functions, and each topic can be sorted independently.
6073
6074 See the commands under the `T S' submap.
6075
6076*** Subsets of the groups can be sorted independently.
6077
6078 See the commands under the `G P' submap.
6079
6080*** Cached articles can be pulled into the groups.
6081
6082 Use the `Y c' command.
6083
6084*** Score files are now applied in a more reliable order.
6085
6086*** Reports on where mail messages end up can be generated.
6087
6088 `M-x nnmail-split-history'
6089
6090*** More hooks and functions have been added to remove junk
6091from incoming mail before saving the mail.
6092
6093 See `nnmail-prepare-incoming-header-hook'.
6094
6095*** The nnml mail backend now understands compressed article files.
6096
6097*** To enable Gnus to read/post multi-lingual articles, you must execute
6098the following code, for instance, in your .emacs.
6099
6100 (add-hook 'gnus-startup-hook 'gnus-mule-initialize)
6101
6102Then, when you start Gnus, it will decode non-ASCII text automatically
6103and show appropriate characters. (Note: if you are using gnus-mime
6104from the SEMI package, formerly known as TM, you should NOT add this
6105hook to gnus-startup-hook; gnus-mime has its own method of handling
6106this issue.)
6107
6108Since it is impossible to distinguish all coding systems
6109automatically, you may need to specify a choice of coding system for a
6110particular news group. This can be done by:
6111
6112 (gnus-mule-add-group NEWSGROUP 'CODING-SYSTEM)
6113
6114Here NEWSGROUP should be a string which names a newsgroup or a tree
6115of newsgroups. If NEWSGROUP is "XXX.YYY", all news groups under
6116"XXX.YYY" (including "XXX.YYY.ZZZ") will use the specified coding
6117system. CODING-SYSTEM specifies which coding system to use (for both
6118for reading and posting).
6119
6120CODING-SYSTEM can also be a cons cell of the form
6121 (READ-CODING-SYSTEM . POST-CODING-SYSTEM)
6122Then READ-CODING-SYSTEM is used when you read messages from the
6123newsgroups, while POST-CODING-SYSTEM is used when you post messages
6124there.
6125
6126Emacs knows the right coding systems for certain newsgroups by
6127default. Here are some of these default settings:
6128
6129 (gnus-mule-add-group "fj" 'iso-2022-7)
6130 (gnus-mule-add-group "alt.chinese.text" 'hz-gb-2312)
6131 (gnus-mule-add-group "alt.hk" 'hz-gb-2312)
6132 (gnus-mule-add-group "alt.chinese.text.big5" 'cn-big5)
6133 (gnus-mule-add-group "soc.culture.vietnamese" '(nil . viqr))
6134
6135When you reply by mail to an article, these settings are ignored;
6136the mail is encoded according to sendmail-coding-system, as usual.
6137
6138** CC mode changes.
6139
6140*** If you edit primarily one style of C (or C++, Objective-C, Java)
6141code, you may want to make the CC Mode style variables have global
6142values so that you can set them directly in your .emacs file. To do
6143this, set c-style-variables-are-local-p to nil in your .emacs file.
6144Note that this only takes effect if you do it *before* cc-mode.el is
6145loaded.
6146
6147If you typically edit more than one style of C (or C++, Objective-C,
6148Java) code in a single Emacs session, you may want to make the CC Mode
6149style variables have buffer local values. By default, all buffers
6150share the same style variable settings; to make them buffer local, set
6151c-style-variables-are-local-p to t in your .emacs file. Note that you
6152must do this *before* CC Mode is loaded.
6153
6154*** The new variable c-indentation-style holds the C style name
6155of the current buffer.
6156
6157*** The variable c-block-comments-indent-p has been deleted, because
6158it is no longer necessary. C mode now handles all the supported styles
6159of block comments, with no need to say which one you will use.
6160
6161*** There is a new indentation style "python", which specifies the C
6162style that the Python developers like.
6163
6164*** There is a new c-cleanup-list option: brace-elseif-brace.
6165This says to put ...} else if (...) {... on one line,
6166just as brace-else-brace says to put ...} else {... on one line.
6167
6168** VC Changes [new]
6169
6170** In vc-retrieve-snapshot (C-x v r), if you don't specify a snapshot
6171name, it retrieves the *latest* versions of all files in the current
6172directory and its subdirectories (aside from files already locked).
6173
6174This feature is useful if your RCS directory is a link to a common
6175master directory, and you want to pick up changes made by other
6176developers.
6177
6178You can do the same thing for an individual file by typing C-u C-x C-q
6179RET in a buffer visiting that file.
6180
6181*** VC can now handle files under CVS that are being "watched" by
6182other developers. Such files are made read-only by CVS. To get a
6183writable copy, type C-x C-q in a buffer visiting such a file. VC then
6184calls "cvs edit", which notifies the other developers of it.
6185
6186*** vc-version-diff (C-u C-x v =) now suggests reasonable defaults for
6187version numbers, based on the current state of the file.
6188
6189** Calendar changes.
6190
6191A new function, list-holidays, allows you list holidays or subclasses
6192of holidays for ranges of years. Related menu items allow you do this
6193for the year of the selected date, or the following/previous years.
6194
6195** ps-print changes
6196
6197There are some new user variables for customizing the page layout.
6198
6199*** Paper size, paper orientation, columns
6200
6201The variable `ps-paper-type' determines the size of paper ps-print
6202formats for; it should contain one of the symbols:
6203`a4' `a3' `letter' `legal' `letter-small' `tabloid'
6204`ledger' `statement' `executive' `a4small' `b4' `b5'
6205It defaults to `letter'.
6206If you need other sizes, see the variable `ps-page-dimensions-database'.
6207
6208The variable `ps-landscape-mode' determines the orientation
6209of the printing on the page. nil, the default, means "portrait" mode,
6210non-nil means "landscape" mode.
6211
6212The variable `ps-number-of-columns' must be a positive integer.
6213It determines the number of columns both in landscape and portrait mode.
6214It defaults to 1.
6215
6216*** Horizontal layout
6217
6218The horizontal layout is determined by the variables
6219`ps-left-margin', `ps-inter-column', and `ps-right-margin'.
6220All are measured in points.
6221
6222*** Vertical layout
6223
6224The vertical layout is determined by the variables
6225`ps-bottom-margin', `ps-top-margin', and `ps-header-offset'.
6226All are measured in points.
6227
6228*** Headers
6229
6230If the variable `ps-print-header' is nil, no header is printed. Then
6231`ps-header-offset' is not relevant and `ps-top-margin' represents the
6232margin above the text.
6233
6234If the variable `ps-print-header-frame' is non-nil, a gaudy
6235framing box is printed around the header.
6236
6237The contents of the header are determined by `ps-header-lines',
6238`ps-show-n-of-n', `ps-left-header' and `ps-right-header'.
6239
6240The height of the header is determined by `ps-header-line-pad',
6241`ps-header-font-family', `ps-header-title-font-size' and
6242`ps-header-font-size'.
6243
6244*** Font managing
6245
6246The variable `ps-font-family' determines which font family is to be
6247used for ordinary text. Its value must be a key symbol in the alist
6248`ps-font-info-database'. You can add other font families by adding
6249elements to this alist.
6250
6251The variable `ps-font-size' determines the size of the font
6252for ordinary text. It defaults to 8.5 points.
6253
6254** hideshow changes.
6255
6256*** now supports hiding of blocks of single line comments (like // for
6257C++, ; for lisp).
6258
6259*** Support for java-mode added.
6260
6261*** When doing `hs-hide-all' it is now possible to also hide the comments
6262in the file if `hs-hide-comments-when-hiding-all' is set.
6263
6264*** The new function `hs-hide-initial-comment' hides the the comments at
6265the beginning of the files. Finally those huge RCS logs don't stay in your
6266way! This is run by default when entering the `hs-minor-mode'.
6267
6268*** Now uses overlays instead of `selective-display', so is more
6269robust and a lot faster.
6270
6271*** A block beginning can span multiple lines.
6272
6273*** The new variable `hs-show-hidden-short-form' if t, directs hideshow
6274to show only the beginning of a block when it is hidden. See the
6275documentation for more details.
6276
6277** Changes in Enriched mode.
6278
6279*** When you visit a file in enriched-mode, Emacs will make sure it is
6280filled to the current fill-column. This behavior is now independent
6281of the size of the window. When you save the file, the fill-column in
6282use is stored as well, so that the whole buffer need not be refilled
6283the next time unless the fill-column is different.
6284
6285*** use-hard-newlines is now a minor mode. When it is enabled, Emacs
6286distinguishes between hard and soft newlines, and treats hard newlines
6287as paragraph boundaries. Otherwise all newlines inserted are marked
6288as soft, and paragraph boundaries are determined solely from the text.
6289
6290** Font Lock mode
6291
6292*** Custom support
6293
6294The variables font-lock-face-attributes, font-lock-display-type and
6295font-lock-background-mode are now obsolete; the recommended way to specify the
6296faces to use for Font Lock mode is with M-x customize-group on the new custom
6297group font-lock-highlighting-faces. If you set font-lock-face-attributes in
6298your ~/.emacs file, Font Lock mode will respect its value. However, you should
6299consider converting from setting that variable to using M-x customize.
6300
6301You can still use X resources to specify Font Lock face appearances.
6302
6303*** Maximum decoration
6304
6305Fontification now uses the maximum level of decoration supported by
6306default. Previously, fontification used a mode-specific default level
6307of decoration, which is typically the minimum level of decoration
6308supported. You can set font-lock-maximum-decoration to nil
6309to get the old behavior.
6310
6311*** New support
6312
6313Support is now provided for Java, Objective-C, AWK and SIMULA modes.
6314
6315Note that Font Lock mode can be turned on without knowing exactly what modes
6316support Font Lock mode, via the command global-font-lock-mode.
6317
6318*** Configurable support
6319
6320Support for C, C++, Objective-C and Java can be more easily configured for
6321additional types and classes via the new variables c-font-lock-extra-types,
6322c++-font-lock-extra-types, objc-font-lock-extra-types and, you guessed it,
6323java-font-lock-extra-types. These value of each of these variables should be a
6324list of regexps matching the extra type names. For example, the default value
6325of c-font-lock-extra-types is ("\\sw+_t") which means fontification follows the
6326convention that C type names end in _t. This results in slower fontification.
6327
6328Of course, you can change the variables that specify fontification in whatever
6329way you wish, typically by adding regexps. However, these new variables make
6330it easier to make specific and common changes for the fontification of types.
6331
6332*** Adding highlighting patterns to existing support
6333
6334You can use the new function font-lock-add-keywords to add your own
6335highlighting patterns, such as for project-local or user-specific constructs,
6336for any mode.
6337
6338For example, to highlight `FIXME:' words in C comments, put:
6339
6340 (font-lock-add-keywords 'c-mode '(("\\<FIXME:" 0 font-lock-warning-face t)))
6341
6342in your ~/.emacs.
6343
6344*** New faces
6345
6346Font Lock now defines two new faces, font-lock-builtin-face and
6347font-lock-warning-face. These are intended to highlight builtin keywords,
6348distinct from a language's normal keywords, and objects that should be brought
6349to user attention, respectively. Various modes now use these new faces.
6350
6351*** Changes to fast-lock support mode
6352
6353The fast-lock package, one of the two Font Lock support modes, can now process
6354cache files silently. You can use the new variable fast-lock-verbose, in the
6355same way as font-lock-verbose, to control this feature.
6356
6357*** Changes to lazy-lock support mode
6358
6359The lazy-lock package, one of the two Font Lock support modes, can now fontify
6360according to the true syntactic context relative to other lines. You can use
6361the new variable lazy-lock-defer-contextually to control this feature. If
6362non-nil, changes to the buffer will cause subsequent lines in the buffer to be
6363refontified after lazy-lock-defer-time seconds of idle time. If nil, then only
6364the modified lines will be refontified; this is the same as the previous Lazy
6365Lock mode behaviour and the behaviour of Font Lock mode.
6366
6367This feature is useful in modes where strings or comments can span lines.
6368For example, if a string or comment terminating character is deleted, then if
6369this feature is enabled subsequent lines in the buffer will be correctly
6370refontified to reflect their new syntactic context. Previously, only the line
6371containing the deleted character would be refontified and you would have to use
6372the command M-g M-g (font-lock-fontify-block) to refontify some lines.
6373
6374As a consequence of this new feature, two other variables have changed:
6375
6376Variable `lazy-lock-defer-driven' is renamed `lazy-lock-defer-on-scrolling'.
6377Variable `lazy-lock-defer-time' can now only be a time, i.e., a number.
6378Buffer modes for which on-the-fly deferral applies can be specified via the
6379new variable `lazy-lock-defer-on-the-fly'.
6380
6381If you set these variables in your ~/.emacs, then you may have to change those
6382settings.
6383
6384** Ada mode changes.
6385
6386*** There is now better support for using find-file.el with Ada mode.
6387If you switch between spec and body, the cursor stays in the same
6388procedure (modulo overloading). If a spec has no body file yet, but
6389you try to switch to its body file, Ada mode now generates procedure
6390stubs.
6391
6392*** There are two new commands:
6393 - `ada-make-local' : invokes gnatmake on the current buffer
6394 - `ada-check-syntax' : check syntax of current buffer.
6395
6396The user options `ada-compiler-make', `ada-make-options',
6397`ada-language-version', `ada-compiler-syntax-check', and
6398`ada-compile-options' are used within these commands.
6399
6400*** Ada mode can now work with Outline minor mode. The outline level
6401is calculated from the indenting, not from syntactic constructs.
6402Outlining does not work if your code is not correctly indented.
6403
6404*** The new function `ada-gnat-style' converts the buffer to the style of
6405formatting used in GNAT. It places two blanks after a comment start,
6406places one blank between a word end and an opening '(', and puts one
6407space between a comma and the beginning of a word.
6408
6409** Scheme mode changes.
6410
6411*** Scheme mode indentation now uses many of the facilities of Lisp
6412mode; therefore, the variables to customize it are the variables used
6413for Lisp mode which have names starting with `lisp-'. The variables
6414with names starting with `scheme-' which used to do this no longer
6415have any effect.
6416
6417If you want to use different indentation for Scheme and Lisp, this is
6418still possible, but now you must do it by adding a hook to
6419scheme-mode-hook, which could work by setting the `lisp-' indentation
6420variables as buffer-local variables.
6421
6422*** DSSSL mode is a variant of Scheme mode, for editing DSSSL scripts.
6423Use M-x dsssl-mode.
6424
6425** Changes to the emacsclient program
6426
6427*** If a socket can't be found, and environment variables LOGNAME or
6428USER are set, emacsclient now looks for a socket based on the UID
6429associated with the name. That is an emacsclient running as root
6430can connect to an Emacs server started by a non-root user.
6431
6432*** The emacsclient program now accepts an option --no-wait which tells
6433it to return immediately without waiting for you to "finish" the
6434buffer in Emacs.
6435
6436*** The new option --alternate-editor allows to specify an editor to
6437use if Emacs is not running. The environment variable
6438ALTERNATE_EDITOR can be used for the same effect; the command line
6439option takes precedence.
6440
6441** M-x eldoc-mode enables a minor mode in which the echo area
6442constantly shows the parameter list for function being called at point
6443(in Emacs Lisp and Lisp Interaction modes only).
6444
6445** C-x n d now runs the new command narrow-to-defun,
6446which narrows the accessible parts of the buffer to just
6447the current defun.
6448
6449** Emacs now handles the `--' argument in the standard way; all
6450following arguments are treated as ordinary file names.
6451
6452** On MSDOS and Windows, the bookmark file is now called _emacs.bmk,
6453and the saved desktop file is now called _emacs.desktop (truncated if
6454necessary).
6455
6456** When you kill a buffer that visits a file,
6457if there are any registers that save positions in the file,
6458these register values no longer become completely useless.
6459If you try to go to such a register with C-x j, then you are
6460asked whether to visit the file again. If you say yes,
6461it visits the file and then goes to the same position.
6462
6463** When you visit a file that changes frequently outside Emacs--for
6464example, a log of output from a process that continues to run--it may
6465be useful for Emacs to revert the file without querying you whenever
6466you visit the file afresh with C-x C-f.
6467
6468You can request this behavior for certain files by setting the
6469variable revert-without-query to a list of regular expressions. If a
6470file's name matches any of these regular expressions, find-file and
6471revert-buffer revert the buffer without asking for permission--but
6472only if you have not edited the buffer text yourself.
6473
6474** set-default-font has been renamed to set-frame-font
6475since it applies only to the current frame.
6476
6477** In TeX mode, you can use the variable tex-main-file to specify the
6478file for tex-file to run TeX on. (By default, tex-main-file is nil,
6479and tex-file runs TeX on the current visited file.)
6480
6481This is useful when you are editing a document that consists of
6482multiple files. In each of the included files, you can set up a local
6483variable list which specifies the top-level file of your document for
6484tex-main-file. Then tex-file will run TeX on the whole document
6485instead of just the file you are editing.
6486
6487** RefTeX mode
6488
6489RefTeX mode is a new minor mode with special support for \label, \ref
6490and \cite macros in LaTeX documents. RefTeX distinguishes labels of
6491different environments (equation, figure, ...) and has full support for
6492multifile documents. To use it, select a buffer with a LaTeX document and
6493turn the mode on with M-x reftex-mode. Here are the main user commands:
6494
6495C-c ( reftex-label
6496 Creates a label semi-automatically. RefTeX is context sensitive and
6497 knows which kind of label is needed.
6498
6499C-c ) reftex-reference
6500 Offers in a menu all labels in the document, along with context of the
6501 label definition. The selected label is referenced as \ref{LABEL}.
6502
6503C-c [ reftex-citation
6504 Prompts for a regular expression and displays a list of matching BibTeX
6505 database entries. The selected entry is cited with a \cite{KEY} macro.
6506
6507C-c & reftex-view-crossref
6508 Views the cross reference of a \ref or \cite command near point.
6509
6510C-c = reftex-toc
6511 Shows a table of contents of the (multifile) document. From there you
6512 can quickly jump to every section.
6513
6514Under X, RefTeX installs a "Ref" menu in the menu bar, with additional
6515commands. Press `?' to get help when a prompt mentions this feature.
6516Full documentation and customization examples are in the file
6517reftex.el. You can use the finder to view the file documentation:
6518C-h p --> tex --> reftex.el
6519
6520** Changes in BibTeX mode.
6521
6522*** Info documentation is now available.
6523
6524*** Don't allow parentheses in string constants anymore. This confused
6525both the BibTeX program and Emacs BibTeX mode.
6526
6527*** Renamed variable bibtex-mode-user-optional-fields to
6528bibtex-user-optional-fields.
6529
6530*** Removed variable bibtex-include-OPTannote
6531(use bibtex-user-optional-fields instead).
6532
6533*** New interactive functions to copy and kill fields and complete
6534entries to the BibTeX kill ring, from where they can be yanked back by
6535appropriate functions.
6536
6537*** New interactive functions for repositioning and marking of
6538entries. They are bound by default to M-C-l and M-C-h.
6539
6540*** New hook bibtex-clean-entry-hook. It is called after entry has
6541been cleaned.
6542
6543*** New variable bibtex-field-delimiters, which replaces variables
6544bibtex-field-{left|right}-delimiter.
6545
6546*** New variable bibtex-entry-delimiters to determine how entries
6547shall be delimited.
6548
6549*** Allow preinitialization of fields. See documentation of
6550bibtex-user-optional-fields, bibtex-entry-field-alist, and
6551bibtex-include-OPTkey for details.
6552
6553*** Book and InBook entries require either an author or an editor
6554field. This is now supported by bibtex.el. Alternative fields are
6555prefixed with `ALT'.
6556
6557*** New variable bibtex-entry-format, which replaces variable
6558bibtex-clean-entry-zap-empty-opts and allows specification of many
6559formatting options performed on cleaning an entry (see variable
6560documentation).
6561
6562*** Even more control on how automatic keys are generated. See
6563documentation of bibtex-generate-autokey for details. Transcriptions
6564for foreign languages other than German are now handled, too.
6565
6566*** New boolean user option bibtex-comma-after-last-field to decide if
6567comma should be inserted at end of last field.
6568
6569*** New boolean user option bibtex-align-at-equal-sign to determine if
6570alignment should be made at left side of field contents or at equal
6571signs. New user options to control entry layout (e.g. indentation).
6572
6573*** New function bibtex-fill-entry to realign entries.
6574
6575*** New function bibtex-reformat to reformat region or buffer.
6576
6577*** New function bibtex-convert-alien to convert a BibTeX database
6578from alien sources.
6579
6580*** New function bibtex-complete-key (similar to bibtex-complete-string)
6581to complete prefix to a key defined in buffer. Mainly useful in
6582crossref entries.
6583
6584*** New function bibtex-count-entries to count entries in buffer or
6585region.
6586
6587*** Added support for imenu.
6588
6589*** The function `bibtex-validate' now checks current region instead
6590of buffer if mark is active. Now it shows all errors of buffer in a
6591`compilation mode' buffer. You can use the normal commands (e.g.
6592`next-error') for compilation modes to jump to errors.
6593
6594*** New variable `bibtex-string-file-path' to determine where the files
6595from `bibtex-string-files' are searched.
6596
6597** Iso Accents mode now supports Latin-3 as an alternative.
6598
6599** The command next-error now opens blocks hidden by hideshow.
6600
6601** The function using-unix-filesystems has been replaced by the
6602functions add-untranslated-filesystem and remove-untranslated-filesystem.
6603Each of these functions takes the name of a drive letter or directory
6604as an argument.
6605
6606When a filesystem is added as untranslated, all files on it are read
6607and written in binary mode (no cr/lf translation is performed).
6608
6609** browse-url changes
6610
6611*** New methods for: Grail (browse-url-generic), MMM (browse-url-mmm),
6612Lynx in a separate xterm (browse-url-lynx-xterm) or in an Emacs window
6613(browse-url-lynx-emacs), remote W3 (browse-url-w3-gnudoit), generic
6614non-remote-controlled browsers (browse-url-generic) and associated
6615customization variables.
6616
6617*** New commands `browse-url-of-region' and `browse-url'.
6618
6619*** URLs marked up with <URL:...> (RFC1738) work if broken across
6620lines. Browsing methods can be associated with URL regexps
6621(e.g. mailto: URLs) via `browse-url-browser-function'.
6622
6623** Changes in Ediff
6624
6625*** Clicking Mouse-2 on a brief command description in Ediff control panel
6626pops up the Info file for this command.
6627
6628*** There is now a variable, ediff-autostore-merges, which controls whether
6629the result of a merge is saved in a file. By default, this is done only when
6630merge is done from a session group (eg, when merging files in two different
6631directories).
6632
6633*** Since Emacs 19.31 (this hasn't been announced before), Ediff can compare
6634and merge groups of files residing in different directories, or revisions of
6635files in the same directory.
6636
6637*** Since Emacs 19.31, Ediff can apply multi-file patches interactively.
6638The patches must be in the context format or GNU unified format. (The bug
6639related to the GNU format has now been fixed.)
6640
6641** Changes in Viper
6642
6643*** The startup file is now .viper instead of .vip
6644*** All variable/function names have been changed to start with viper-
6645 instead of vip-.
6646*** C-\ now simulates the meta-key in all Viper states.
6647*** C-z in Insert state now escapes to Vi for the duration of the next
6648Viper command. In Vi and Insert states, C-z behaves as before.
6649*** C-c \ escapes to Vi for one command if Viper is in Insert or Emacs states.
6650*** _ is no longer the meta-key in Vi state.
6651*** The variable viper-insert-state-cursor-color can be used to change cursor
6652color when Viper is in insert state.
6653*** If search lands the cursor near the top or the bottom of the window,
6654Viper pulls the window up or down to expose more context. The variable
6655viper-adjust-window-after-search controls this behavior.
6656
6657** Etags changes.
6658
6659*** In C, C++, Objective C and Java, Etags tags global variables by
6660default. The resulting tags files are inflated by 30% on average.
6661Use --no-globals to turn this feature off. Etags can also tag
6662variables which are members of structure-like constructs, but it does
6663not by default. Use --members to turn this feature on.
6664
6665*** C++ member functions are now recognized as tags.
6666
6667*** Java is tagged like C++. In addition, "extends" and "implements"
6668constructs are tagged. Files are recognised by the extension .java.
6669
6670*** Etags can now handle programs written in Postscript. Files are
6671recognised by the extensions .ps and .pdb (Postscript with C syntax).
6672In Postscript, tags are lines that start with a slash.
6673
6674*** Etags now handles Objective C and Objective C++ code. The usual C and
6675C++ tags are recognized in these languages; in addition, etags
6676recognizes special Objective C syntax for classes, class categories,
6677methods and protocols.
6678
6679*** Etags also handles Cobol. Files are recognised by the extension
6680.cobol. The tagged lines are those containing a word that begins in
6681column 8 and ends in a full stop, i.e. anything that could be a
6682paragraph name.
6683
6684*** Regexps in Etags now support intervals, as in ed or grep. The syntax of
6685an interval is \{M,N\}, and it means to match the preceding expression
6686at least M times and as many as N times.
6687
6688** The format for specifying a custom format for time-stamp to insert
6689in files has changed slightly.
6690
6691With the new enhancements to the functionality of format-time-string,
6692time-stamp-format will change to be eventually compatible with it.
6693This conversion is being done in two steps to maintain compatibility
6694with old time-stamp-format values.
6695
6696In the new scheme, alternate case is signified by the number-sign
6697(`#') modifier, rather than changing the case of the format character.
6698This feature is as yet incompletely implemented for compatibility
6699reasons.
6700
6701In the old time-stamp-format, all numeric fields defaulted to their
6702natural width. (With format-time-string, each format has a
6703fixed-width default.) In this version, you can specify the colon
6704(`:') modifier to a numeric conversion to mean "give me the historical
6705time-stamp-format width default." Do not use colon if you are
6706specifying an explicit width, as in "%02d".
6707
6708Numbers are no longer truncated to the requested width, except in the
6709case of "%02y", which continues to give a two-digit year. Digit
6710truncation probably wasn't being used for anything else anyway.
6711
6712The new formats will work with old versions of Emacs. New formats are
6713being recommended now to allow time-stamp-format to change in the
6714future to be compatible with format-time-string. The new forms being
6715recommended now will continue to work then.
6716
6717See the documentation string for the variable time-stamp-format for
6718details.
6719
6720** There are some additional major modes:
6721
6722dcl-mode, for editing VMS DCL files.
6723m4-mode, for editing files of m4 input.
6724meta-mode, for editing MetaFont and MetaPost source files.
6725
6726** In Shell mode, the command shell-copy-environment-variable lets you
6727copy the value of a specified environment variable from the subshell
6728into Emacs.
6729
6730** New Lisp packages include:
6731
6732*** battery.el displays battery status for laptops.
6733
6734*** M-x bruce (named after Lenny Bruce) is a program that might
6735be used for adding some indecent words to your email.
6736
6737*** M-x crisp-mode enables an emulation for the CRiSP editor.
6738
6739*** M-x dirtrack arranges for better tracking of directory changes
6740in shell buffers.
6741
6742*** The new library elint.el provides for linting of Emacs Lisp code.
6743See the documentation for `elint-initialize', `elint-current-buffer'
6744and `elint-defun'.
6745
6746*** M-x expand-add-abbrevs defines a special kind of abbrev which is
6747meant for programming constructs. These abbrevs expand like ordinary
6748ones, when you type SPC, but only at the end of a line and not within
6749strings or comments.
6750
6751These abbrevs can act as templates: you can define places within an
6752abbrev for insertion of additional text. Once you expand the abbrev,
6753you can then use C-x a p and C-x a n to move back and forth to these
6754insertion points. Thus you can conveniently insert additional text
6755at these points.
6756
6757*** filecache.el remembers the location of files so that you
6758can visit them by short forms of their names.
6759
6760*** find-func.el lets you find the definition of the user-loaded
6761Emacs Lisp function at point.
6762
6763*** M-x handwrite converts text to a "handwritten" picture.
6764
6765*** M-x iswitchb-buffer is a command for switching to a buffer, much like
6766switch-buffer, but it reads the argument in a more helpful way.
6767
6768*** M-x landmark implements a neural network for landmark learning.
6769
6770*** M-x locate provides a convenient interface to the `locate' program.
6771
6772*** M4 mode is a new mode for editing files of m4 input.
6773
6774*** mantemp.el creates C++ manual template instantiations
6775from the GCC error messages which indicate which instantiations are needed.
6776
6777*** mouse-copy.el provides a one-click copy and move feature.
6778You can drag a region with M-mouse-1, and it is automatically
6779inserted at point. M-Shift-mouse-1 deletes the text from its
6780original place after inserting the copy.
6781
6782*** mouse-drag.el lets you do scrolling by dragging Mouse-2
6783on the buffer.
6784
6785You click the mouse and move; that distance either translates into the
6786velocity to scroll (with mouse-drag-throw) or the distance to scroll
6787(with mouse-drag-drag). Horizontal scrolling is enabled when needed.
6788
6789Enable mouse-drag with:
6790 (global-set-key [down-mouse-2] 'mouse-drag-throw)
6791-or-
6792 (global-set-key [down-mouse-2] 'mouse-drag-drag)
6793
6794*** mspools.el is useful for determining which mail folders have
6795mail waiting to be read in them. It works with procmail.
6796
6797*** Octave mode is a major mode for editing files of input for Octave.
6798It comes with a facility for communicating with an Octave subprocess.
6799
6800*** ogonek
6801
6802The ogonek package provides functions for changing the coding of
6803Polish diacritic characters in buffers. Codings known from various
6804platforms are supported such as ISO8859-2, Mazovia, IBM Latin2, and
6805TeX. For example, you can change the coding from Mazovia to
6806ISO8859-2. Another example is a change of coding from ISO8859-2 to
6807prefix notation (in which `/a' stands for the aogonek character, for
6808instance) and vice versa.
6809
6810To use this package load it using
6811 M-x load-library [enter] ogonek
6812Then, you may get an explanation by calling one of
6813 M-x ogonek-jak -- in Polish
6814 M-x ogonek-how -- in English
6815The info specifies the commands and variables provided as well as the
6816ways of customization in `.emacs'.
6817
6818*** Interface to ph.
6819
6820Emacs provides a client interface to CCSO Nameservers (ph/qi)
6821
6822The CCSO nameserver is used in many universities to provide directory
6823services about people. ph.el provides a convenient Emacs interface to
6824these servers.
6825
6826*** uce.el is useful for replying to unsolicited commercial email.
6827
6828*** vcursor.el implements a "virtual cursor" feature.
6829You can move the virtual cursor with special commands
6830while the real cursor does not move.
6831
6832*** webjump.el is a "hot list" package which you can set up
6833for visiting your favorite web sites.
6834
6835*** M-x winner-mode is a minor mode which saves window configurations,
6836so you can move back to other configurations that you have recently used.
6837
6838** movemail change
6839
6840Movemail no longer needs to be installed setuid root in order for POP
6841mail retrieval to function properly. This is because it no longer
6842supports the RPOP (reserved-port POP) protocol; instead, it uses the
6843user's POP password to authenticate to the mail server.
6844
6845This change was made earlier, but not reported in NEWS before.
6846
6847* Emacs 20.1 changes for MS-DOS and MS-Windows.
6848
6849** Changes in handling MS-DOS/MS-Windows text files.
6850
6851Emacs handles three different conventions for representing
6852end-of-line: CRLF for MSDOS, LF for Unix and GNU, and CR (used on the
6853Macintosh). Emacs determines which convention is used in a specific
6854file based on the contents of that file (except for certain special
6855file names), and when it saves the file, it uses the same convention.
6856
6857To save the file and change the end-of-line convention, you can use
6858C-x RET f (set-buffer-file-coding-system) to specify a different
6859coding system for the buffer. Then, when you save the file, the newly
6860specified coding system will take effect. For example, to save with
6861LF, specify undecided-unix (or some other ...-unix coding system); to
6862save with CRLF, specify undecided-dos.
6863
6864* Lisp Changes in Emacs 20.1
6865
6866** Byte-compiled files made with Emacs 20 will, in general, work in
6867Emacs 19 as well, as long as the source code runs in Emacs 19. And
6868vice versa: byte-compiled files made with Emacs 19 should also run in
6869Emacs 20, as long as the program itself works in Emacs 20.
6870
6871** Windows-specific functions and variables have been renamed
6872to start with w32- instead of win32-.
6873
6874In hacker language, calling something a "win" is a form of praise. We
6875don't want to praise a non-free Microsoft system, so we don't call it
6876"win".
6877
6878** Basic Lisp changes
6879
6880*** A symbol whose name starts with a colon now automatically
6881evaluates to itself. Therefore such a symbol can be used as a constant.
6882
6883*** The defined purpose of `defconst' has been changed. It should now
6884be used only for values that should not be changed whether by a program
6885or by the user.
6886
6887The actual behavior of defconst has not been changed.
6888
6889*** There are new macros `when' and `unless'
6890
6891(when CONDITION BODY...) is short for (if CONDITION (progn BODY...))
6892(unless CONDITION BODY...) is short for (if CONDITION nil BODY...)
6893
6894*** Emacs now defines functions caar, cadr, cdar and cddr with their
6895usual Lisp meanings. For example, caar returns the car of the car of
6896its argument.
6897
6898*** equal, when comparing strings, now ignores their text properties.
6899
6900*** The new function `functionp' tests whether an object is a function.
6901
6902*** arrayp now returns t for char-tables and bool-vectors.
6903
6904*** Certain primitives which use characters (as integers) now get an
6905error if the integer is not a valid character code. These primitives
6906include insert-char, char-to-string, and the %c construct in the
6907`format' function.
6908
6909*** The `require' function now insists on adding a suffix, either .el
6910or .elc, to the file name. Thus, (require 'foo) will not use a file
6911whose name is just foo. It insists on foo.el or foo.elc.
6912
6913*** The `autoload' function, when the file name does not contain
6914either a directory name or the suffix .el or .elc, insists on
6915adding one of these suffixes.
6916
6917*** string-to-number now takes an optional second argument BASE
6918which specifies the base to use when converting an integer.
6919If BASE is omitted, base 10 is used.
6920
6921We have not implemented other radices for floating point numbers,
6922because that would be much more work and does not seem useful.
6923
6924*** substring now handles vectors as well as strings.
6925
6926*** The Common Lisp function eql is no longer defined normally.
6927You must load the `cl' library to define it.
6928
6929*** The new macro `with-current-buffer' lets you evaluate an expression
6930conveniently with a different current buffer. It looks like this:
6931
6932 (with-current-buffer BUFFER BODY-FORMS...)
6933
6934BUFFER is the expression that says which buffer to use.
6935BODY-FORMS say what to do in that buffer.
6936
6937*** The new primitive `save-current-buffer' saves and restores the
6938choice of current buffer, like `save-excursion', but without saving or
6939restoring the value of point or the mark. `with-current-buffer'
6940works using `save-current-buffer'.
6941
6942*** The new macro `with-temp-file' lets you do some work in a new buffer and
6943write the output to a specified file. Like `progn', it returns the value
6944of the last form.
6945
6946*** The new macro `with-temp-buffer' lets you do some work in a new buffer,
6947which is discarded after use. Like `progn', it returns the value of the
6948last form. If you wish to return the buffer contents, use (buffer-string)
6949as the last form.
6950
6951*** The new function split-string takes a string, splits it at certain
6952characters, and returns a list of the substrings in between the
6953matches.
6954
6955For example, (split-string "foo bar lose" " +") returns ("foo" "bar" "lose").
6956
6957*** The new macro with-output-to-string executes some Lisp expressions
6958with standard-output set up so that all output feeds into a string.
6959Then it returns that string.
6960
6961For example, if the current buffer name is `foo',
6962
6963(with-output-to-string
6964 (princ "The buffer is ")
6965 (princ (buffer-name)))
6966
6967returns "The buffer is foo".
6968
6969** Non-ASCII characters are now supported, if enable-multibyte-characters
6970is non-nil.
6971
6972These characters have character codes above 256. When inserted in the
6973buffer or stored in a string, they are represented as multibyte
6974characters that occupy several buffer positions each.
6975
6976*** When enable-multibyte-characters is non-nil, a single character in
6977a buffer or string can be two or more bytes (as many as four).
6978
6979Buffers and strings are still made up of unibyte elements;
6980character positions and string indices are always measured in bytes.
6981Therefore, moving forward one character can increase the buffer
6982position by 2, 3 or 4. The function forward-char moves by whole
6983characters, and therefore is no longer equivalent to
6984 (lambda (n) (goto-char (+ (point) n))).
6985
6986ASCII characters (codes 0 through 127) are still single bytes, always.
6987Sequences of byte values 128 through 255 are used to represent
6988non-ASCII characters. These sequences are called "multibyte
6989characters".
6990
6991The first byte of a multibyte character is always in the range 128
6992through 159 (octal 0200 through 0237). These values are called
6993"leading codes". The second and subsequent bytes are always in the
6994range 160 through 255 (octal 0240 through 0377). The first byte, the
6995leading code, determines how many bytes long the sequence is.
6996
6997*** The function forward-char moves over characters, and therefore
6998(forward-char 1) may increase point by more than 1 if it moves over a
6999multibyte character. Likewise, delete-char always deletes a
7000character, which may be more than one buffer position.
7001
7002This means that some Lisp programs, which assume that a character is
7003always one buffer position, need to be changed.
7004
7005However, all ASCII characters are always one buffer position.
7006
7007*** The regexp [\200-\377] no longer matches all non-ASCII characters,
7008because when enable-multibyte-characters is non-nil, these characters
7009have codes that are not in the range octal 200 to octal 377. However,
7010the regexp [^\000-\177] does match all non-ASCII characters,
7011guaranteed.
7012
7013*** The function char-boundary-p returns non-nil if position POS is
7014between two characters in the buffer (not in the middle of a
7015character).
7016
7017When the value is non-nil, it says what kind of character follows POS:
7018
7019 0 if POS is at an ASCII character or at the end of range,
7020 1 if POS is before a 2-byte length multi-byte form,
7021 2 if POS is at a head of 3-byte length multi-byte form,
7022 3 if POS is at a head of 4-byte length multi-byte form,
7023 4 if POS is at a head of multi-byte form of a composite character.
7024
7025*** The function char-bytes returns how many bytes the character CHAR uses.
7026
7027*** Strings can contain multibyte characters. The function
7028`length' returns the string length counting bytes, which may be
7029more than the number of characters.
7030
7031You can include a multibyte character in a string constant by writing
7032it literally. You can also represent it with a hex escape,
7033\xNNNNNNN..., using as many digits as necessary. Any character which
7034is not a valid hex digit terminates this construct. If you want to
7035follow it with a character that is a hex digit, write backslash and
7036newline in between; that will terminate the hex escape.
7037
7038*** The function concat-chars takes arguments which are characters
7039and returns a string containing those characters.
7040
7041*** The function sref access a multibyte character in a string.
7042(sref STRING INDX) returns the character in STRING at INDEX. INDEX
7043counts from zero. If INDEX is at a position in the middle of a
7044character, sref signals an error.
7045
7046*** The function chars-in-string returns the number of characters
7047in a string. This is less than the length of the string, if the
7048string contains multibyte characters (the length counts bytes).
7049
7050*** The function chars-in-region returns the number of characters
7051in a region from BEG to END. This is less than (- END BEG) if the
7052region contains multibyte characters (the length counts bytes).
7053
7054*** The function string-to-list converts a string to a list of
7055the characters in it. string-to-vector converts a string
7056to a vector of the characters in it.
7057
7058*** The function store-substring alters part of the contents
7059of a string. You call it as follows:
7060
7061 (store-substring STRING IDX OBJ)
7062
7063This says to alter STRING, by storing OBJ starting at index IDX in
7064STRING. OBJ may be either a character or a (smaller) string.
7065This function really does alter the contents of STRING.
7066Since it is impossible to change the length of an existing string,
7067it is an error if OBJ doesn't fit within STRING's actual length.
7068
7069*** char-width returns the width (in columns) of the character CHAR,
7070if it were displayed in the current buffer and the selected window.
7071
7072*** string-width returns the width (in columns) of the text in STRING,
7073if it were displayed in the current buffer and the selected window.
7074
7075*** truncate-string-to-width shortens a string, if necessary,
7076to fit within a certain number of columns. (Of course, it does
7077not alter the string that you give it; it returns a new string
7078which contains all or just part of the existing string.)
7079
7080(truncate-string-to-width STR END-COLUMN &optional START-COLUMN PADDING)
7081
7082This returns the part of STR up to column END-COLUMN.
7083
7084The optional argument START-COLUMN specifies the starting column.
7085If this is non-nil, then the first START-COLUMN columns of the string
7086are not included in the resulting value.
7087
7088The optional argument PADDING, if non-nil, is a padding character to be added
7089at the beginning and end the resulting string, to extend it to exactly
7090WIDTH columns. If PADDING is nil, that means do not pad; then, if STRING
7091is narrower than WIDTH, the value is equal to STRING.
7092
7093If PADDING and START-COLUMN are both non-nil, and if there is no clean
7094place in STRING that corresponds to START-COLUMN (because one
7095character extends across that column), then the padding character
7096PADDING is added one or more times at the beginning of the result
7097string, so that its columns line up as if it really did start at
7098column START-COLUMN.
7099
7100*** When the functions in the list after-change-functions are called,
7101the third argument is the number of bytes in the pre-change text, not
7102necessarily the number of characters. It is, in effect, the
7103difference in buffer position between the beginning and the end of the
7104changed text, before the change.
7105
7106*** The characters Emacs uses are classified in various character
7107sets, each of which has a name which is a symbol. In general there is
7108one character set for each script, not for each language.
7109
7110**** The function charsetp tests whether an object is a character set name.
7111
7112**** The variable charset-list holds a list of character set names.
7113
7114**** char-charset, given a character code, returns the name of the character
7115set that the character belongs to. (The value is a symbol.)
7116
7117**** split-char, given a character code, returns a list containing the
7118name of the character set, followed by one or two byte-values
7119which identify the character within that character set.
7120
7121**** make-char, given a character set name and one or two subsequent
7122byte-values, constructs a character code. This is roughly the
7123opposite of split-char.
7124
7125**** find-charset-region returns a list of the character sets
7126of all the characters between BEG and END.
7127
7128**** find-charset-string returns a list of the character sets
7129of all the characters in a string.
7130
7131*** Here are the Lisp facilities for working with coding systems
7132and specifying coding systems.
7133
7134**** The function coding-system-list returns a list of all coding
7135system names (symbols). With optional argument t, it returns a list
7136of all distinct base coding systems, not including variants.
7137(Variant coding systems are those like latin-1-dos, latin-1-unix
7138and latin-1-mac which specify the end-of-line conversion as well
7139as what to do about code conversion.)
7140
7141**** coding-system-p tests a symbol to see if it is a coding system
7142name. It returns t if so, nil if not.
7143
7144**** file-coding-system-alist specifies which coding systems to use
7145for certain file names. It works like network-coding-system-alist,
7146except that the PATTERN is matched against the file name.
7147
7148Each element has the format (PATTERN . VAL), where PATTERN determines
7149which file names the element applies to. PATTERN should be a regexp
7150to match against a file name.
7151
7152VAL is a coding system, a cons cell containing two coding systems, or
7153a function symbol. If VAL is a coding system, it is used for both
7154decoding what received from the network stream and encoding what sent
7155to the network stream. If VAL is a cons cell containing two coding
7156systems, the car specifies the coding system for decoding, and the cdr
7157specifies the coding system for encoding.
7158
7159If VAL is a function symbol, the function must return a coding system
7160or a cons cell containing two coding systems, which is used as above.
7161
7162**** The variable network-coding-system-alist specifies
7163the coding system to use for network sockets.
7164
7165Each element has the format (PATTERN . VAL), where PATTERN determines
7166which network sockets the element applies to. PATTERN should be
7167either a port number or a regular expression matching some network
7168service names.
7169
7170VAL is a coding system, a cons cell containing two coding systems, or
7171a function symbol. If VAL is a coding system, it is used for both
7172decoding what received from the network stream and encoding what sent
7173to the network stream. If VAL is a cons cell containing two coding
7174systems, the car specifies the coding system for decoding, and the cdr
7175specifies the coding system for encoding.
7176
7177If VAL is a function symbol, the function must return a coding system
7178or a cons cell containing two coding systems, which is used as above.
7179
7180**** process-coding-system-alist specifies which coding systems to use
7181for certain subprocess. It works like network-coding-system-alist,
7182except that the PATTERN is matched against the program name used to
7183start the subprocess.
7184
7185**** The variable default-process-coding-system specifies the coding
7186systems to use for subprocess (and net connection) input and output,
7187when nothing else specifies what to do. The value is a cons cell
7188(OUTPUT-CODING . INPUT-CODING). OUTPUT-CODING applies to output
7189to the subprocess, and INPUT-CODING applies to input from it.
7190
7191**** The variable coding-system-for-write, if non-nil, specifies the
7192coding system to use for writing a file, or for output to a synchronous
7193subprocess.
7194
7195It also applies to any asynchronous subprocess or network connection,
7196but in a different way: the value of coding-system-for-write when you
7197start the subprocess or connection affects that subprocess or
7198connection permanently or until overridden.
7199
7200The variable coding-system-for-write takes precedence over
7201file-coding-system-alist, process-coding-system-alist and
7202network-coding-system-alist, and all other methods of specifying a
7203coding system for output. But most of the time this variable is nil.
7204It exists so that Lisp programs can bind it to a specific coding
7205system for one operation at a time.
7206
7207**** coding-system-for-read applies similarly to input from
7208files, subprocesses or network connections.
7209
7210**** The function process-coding-system tells you what
7211coding systems(s) an existing subprocess is using.
7212The value is a cons cell,
7213 (DECODING-CODING-SYSTEM . ENCODING-CODING-SYSTEM)
7214where DECODING-CODING-SYSTEM is used for decoding output from
7215the subprocess, and ENCODING-CODING-SYSTEM is used for encoding
7216input to the subprocess.
7217
7218**** The function set-process-coding-system can be used to
7219change the coding systems in use for an existing subprocess.
7220
7221** Emacs has a new facility to help users manage the many
7222customization options. To make a Lisp program work with this facility,
7223you need to use the new macros defgroup and defcustom.
7224
7225You use defcustom instead of defvar, for defining a user option
7226variable. The difference is that you specify two additional pieces of
7227information (usually): the "type" which says what values are
7228legitimate, and the "group" which specifies the hierarchy for
7229customization.
7230
7231Thus, instead of writing
7232
7233 (defvar foo-blurgoze nil
7234 "*Non-nil means that foo will act very blurgozely.")
7235
7236you would now write this:
7237
7238 (defcustom foo-blurgoze nil
7239 "*Non-nil means that foo will act very blurgozely."
7240 :type 'boolean
7241 :group foo)
7242
7243The type `boolean' means that this variable has only
7244two meaningful states: nil and non-nil. Other type values
7245describe other possibilities; see the manual for Custom
7246for a description of them.
7247
7248The "group" argument is used to specify a group which the option
7249should belong to. You define a new group like this:
7250
7251 (defgroup ispell nil
7252 "Spell checking using Ispell."
7253 :group 'processes)
7254
7255The "group" argument in defgroup specifies the parent group. The root
7256group is called `emacs'; it should not contain any variables itself,
7257but only other groups. The immediate subgroups of `emacs' correspond
7258to the keywords used by C-h p. Under these subgroups come
7259second-level subgroups that belong to individual packages.
7260
7261Each Emacs package should have its own set of groups. A simple
7262package should have just one group; a more complex package should
7263have a hierarchy of its own groups. The sole or root group of a
7264package should be a subgroup of one or more of the "keyword"
7265first-level subgroups.
7266
7267** New `widget' library for inserting UI components in buffers.
7268
7269This library, used by the new custom library, is documented in a
7270separate manual that accompanies Emacs.
7271
7272** easy-mmode
7273
7274The easy-mmode package provides macros and functions that make
7275developing minor modes easier. Roughly, the programmer has to code
7276only the functionality of the minor mode. All the rest--toggles,
7277predicate, and documentation--can be done in one call to the macro
7278`easy-mmode-define-minor-mode' (see the documentation). See also
7279`easy-mmode-define-keymap'.
7280
7281** Text property changes
7282
7283*** The `intangible' property now works on overlays as well as on a
7284text property.
7285
7286*** The new functions next-char-property-change and
7287previous-char-property-change scan through the buffer looking for a
7288place where either a text property or an overlay might change. The
7289functions take two arguments, POSITION and LIMIT. POSITION is the
7290starting position for the scan. LIMIT says where to stop the scan.
7291
7292If no property change is found before LIMIT, the value is LIMIT. If
7293LIMIT is nil, scan goes to the beginning or end of the accessible part
7294of the buffer. If no property change is found, the value is the
7295position of the beginning or end of the buffer.
7296
7297*** In the `local-map' text property or overlay property, the property
7298value can now be a symbol whose function definition is a keymap. This
7299is an alternative to using the keymap itself.
7300
7301** Changes in invisibility features
7302
7303*** Isearch can now temporarily show parts of the buffer which are
7304hidden by an overlay with a invisible property, when the search match
7305is inside that portion of the buffer. To enable this the overlay
7306should have a isearch-open-invisible property which is a function that
7307would be called having the overlay as an argument, the function should
7308make the overlay visible.
7309
7310During incremental search the overlays are shown by modifying the
7311invisible and intangible properties, if beside this more actions are
7312needed the overlay should have a isearch-open-invisible-temporary
7313which is a function. The function is called with 2 arguments: one is
7314the overlay and the second is nil when it should show the overlay and
7315t when it should hide it.
7316
7317*** add-to-invisibility-spec, remove-from-invisibility-spec
7318
7319Modes that use overlays to hide portions of a buffer should set the
7320invisible property of the overlay to the mode's name (or another symbol)
7321and modify the `buffer-invisibility-spec' to include that symbol.
7322Use `add-to-invisibility-spec' and `remove-from-invisibility-spec' to
7323manipulate the `buffer-invisibility-spec'.
7324Here is an example of how to do this:
7325
7326 ;; If we want to display an ellipsis:
7327 (add-to-invisibility-spec '(my-symbol . t))
7328 ;; If you don't want ellipsis:
7329 (add-to-invisibility-spec 'my-symbol)
7330
7331 ...
7332 (overlay-put (make-overlay beginning end) 'invisible 'my-symbol)
7333
7334 ...
7335 ;; When done with the overlays:
7336 (remove-from-invisibility-spec '(my-symbol . t))
7337 ;; Or respectively:
7338 (remove-from-invisibility-spec 'my-symbol)
7339
7340** Changes in syntax parsing.
7341
7342*** The syntax-directed buffer-scan functions (such as
7343`parse-partial-sexp', `forward-word' and similar functions) can now
7344obey syntax information specified by text properties, if the variable
7345`parse-sexp-lookup-properties' is non-nil.
7346
7347If the value of `parse-sexp-lookup-properties' is nil, the behavior
7348is as before: the syntax-table of the current buffer is always
7349used to determine the syntax of the character at the position.
7350
7351When `parse-sexp-lookup-properties' is non-nil, the syntax of a
7352character in the buffer is calculated thus:
7353
7354 a) if the `syntax-table' text-property of that character
7355 is a cons, this cons becomes the syntax-type;
7356
7357 Valid values of `syntax-table' text-property are: nil, a valid
7358 syntax-table, and a valid syntax-table element, i.e.,
7359 a cons cell of the form (SYNTAX-CODE . MATCHING-CHAR).
7360
7361 b) if the character's `syntax-table' text-property
7362 is a syntax table, this syntax table is used
7363 (instead of the syntax-table of the current buffer) to
7364 determine the syntax type of the character.
7365
7366 c) otherwise the syntax-type is determined by the syntax-table
7367 of the current buffer.
7368
7369*** The meaning of \s in regular expressions is also affected by the
7370value of `parse-sexp-lookup-properties'. The details are the same as
7371for the syntax-directed buffer-scan functions.
7372
7373*** There are two new syntax-codes, `!' and `|' (numeric values 14
7374and 15). A character with a code `!' starts a comment which is ended
7375only by another character with the same code (unless quoted). A
7376character with a code `|' starts a string which is ended only by
7377another character with the same code (unless quoted).
7378
7379These codes are mainly meant for use as values of the `syntax-table'
7380text property.
7381
7382*** The function `parse-partial-sexp' has new semantics for the sixth
7383arg COMMENTSTOP. If it is `syntax-table', parse stops after the start
7384of a comment or a string, or after end of a comment or a string.
7385
7386*** The state-list which the return value from `parse-partial-sexp'
7387(and can also be used as an argument) now has an optional ninth
7388element: the character address of the start of last comment or string;
7389nil if none. The fourth and eighth elements have special values if the
7390string/comment is started by a "!" or "|" syntax-code.
7391
7392*** Since new features of `parse-partial-sexp' allow a complete
7393syntactic parsing, `font-lock' no longer supports
7394`font-lock-comment-start-regexp'.
7395
7396** Changes in face features
7397
7398*** The face functions are now unconditionally defined in Emacs, even
7399if it does not support displaying on a device that supports faces.
7400
7401*** The function face-documentation returns the documentation string
7402of a face (or nil if it doesn't have one).
7403
7404*** The function face-bold-p returns t if a face should be bold.
7405set-face-bold-p sets that flag.
7406
7407*** The function face-italic-p returns t if a face should be italic.
7408set-face-italic-p sets that flag.
7409
7410*** You can now specify foreground and background colors for text
7411by adding elements of the form (foreground-color . COLOR-NAME)
7412and (background-color . COLOR-NAME) to the list of faces in
7413the `face' property (either the character's text property or an
7414overlay property).
7415
7416This means that you no longer need to create named faces to use
7417arbitrary colors in a Lisp package.
7418
7419** Changes in file-handling functions
7420
7421*** File-access primitive functions no longer discard an extra redundant
7422directory name from the beginning of the file name. In other words,
7423they no longer do anything special with // or /~. That conversion
7424is now done only in substitute-in-file-name.
7425
7426This makes it possible for a Lisp program to open a file whose name
7427begins with ~.
7428
7429*** If copy-file is unable to set the date of the output file,
7430it now signals an error with the condition file-date-error.
7431
7432*** The inode number returned by file-attributes may be an integer (if
7433the number fits in a Lisp integer) or a list of integers.
7434
7435*** insert-file-contents can now read from a special file,
7436as long as the arguments VISIT and REPLACE are nil.
7437
7438*** The RAWFILE arg to find-file-noselect, if non-nil, now suppresses
7439character code conversion as well as other things.
7440
7441Meanwhile, this feature does work with remote file names
7442(formerly it did not).
7443
7444*** Lisp packages which create temporary files should use the TMPDIR
7445environment variable to decide which directory to put them in.
7446
7447*** interpreter-mode-alist elements now specify regexps
7448instead of constant strings.
7449
7450*** expand-file-name no longer treats `//' or `/~' specially. It used
7451to delete all the text of a file name up through the first slash of
7452any `//' or `/~' sequence. Now it passes them straight through.
7453
7454substitute-in-file-name continues to treat those sequences specially,
7455in the same way as before.
7456
7457*** The variable `format-alist' is more general now.
7458The FROM-FN and TO-FN in a format definition can now be strings
7459which specify shell commands to use as filters to perform conversion.
7460
7461*** The new function access-file tries to open a file, and signals an
7462error if that fails. If the open succeeds, access-file does nothing
7463else, and returns nil.
7464
7465*** The function insert-directory now signals an error if the specified
7466directory cannot be listed.
7467
7468** Changes in minibuffer input
7469
7470*** The functions read-buffer, read-variable, read-command, read-string
7471read-file-name, read-from-minibuffer and completing-read now take an
7472additional argument which specifies the default value. If this
7473argument is non-nil, it should be a string; that string is used in two
7474ways:
7475
7476 It is returned if the user enters empty input.
7477 It is available through the history command M-n.
7478
7479*** The functions read-string, read-from-minibuffer,
7480read-no-blanks-input and completing-read now take an additional
7481argument INHERIT-INPUT-METHOD. If this is non-nil, then the
7482minibuffer inherits the current input method and the setting of
7483enable-multibyte-characters from the previously current buffer.
7484
7485In an interactive spec, you can use M instead of s to read an
7486argument in this way.
7487
7488*** All minibuffer input functions discard text properties
7489from the text you enter in the minibuffer, unless the variable
7490minibuffer-allow-text-properties is non-nil.
7491
7492** Echo area features
7493
7494*** Clearing the echo area now runs the normal hook
7495echo-area-clear-hook. Note that the echo area can be used while the
7496minibuffer is active; in that case, the minibuffer is still active
7497after the echo area is cleared.
7498
7499*** The function current-message returns the message currently displayed
7500in the echo area, or nil if there is none.
7501
7502** Keyboard input features
7503
7504*** tty-erase-char is a new variable that reports which character was
7505set up as the terminal's erase character when time Emacs was started.
7506
7507*** num-nonmacro-input-events is the total number of input events
7508received so far from the terminal. It does not count those generated
7509by keyboard macros.
7510
7511** Frame-related changes
7512
7513*** make-frame runs the normal hook before-make-frame-hook just before
7514creating a frame, and just after creating a frame it runs the abnormal
7515hook after-make-frame-functions with the new frame as arg.
7516
7517*** The new hook window-configuration-change-hook is now run every time
7518the window configuration has changed. The frame whose configuration
7519has changed is the selected frame when the hook is run.
7520
7521*** Each frame now independently records the order for recently
7522selected buffers, in its buffer-list frame parameter, so that the
7523value of other-buffer is now based on the buffers recently displayed
7524in the selected frame.
7525
7526*** The value of the frame parameter vertical-scroll-bars
7527is now `left', `right' or nil. A non-nil value specifies
7528which side of the window to put the scroll bars on.
7529
7530** X Windows features
7531
7532*** You can examine X resources for other applications by binding
7533x-resource-class around a call to x-get-resource. The usual value of
7534x-resource-class is "Emacs", which is the correct value for Emacs.
7535
7536*** In menus, checkboxes and radio buttons now actually work.
7537The menu displays the current status of the box or button.
7538
7539*** The function x-list-fonts now takes an optional fourth argument
7540MAXIMUM which sets a limit on how many matching fonts to return.
7541A smaller value of MAXIMUM makes the function faster.
7542
7543If the only question is whether *any* font matches the pattern,
7544it is good to supply 1 for this argument.
7545
7546** Subprocess features
7547
7548*** A reminder: it is no longer necessary for subprocess filter
7549functions and sentinels to do save-match-data, because Emacs does this
7550automatically.
7551
7552*** The new function shell-command-to-string executes a shell command
7553and returns the output from the command as a string.
7554
7555*** The new function process-contact returns t for a child process,
7556and (HOSTNAME SERVICE) for a net connection.
7557
7558** An error in running pre-command-hook or post-command-hook
7559does clear the variable to nil. The documentation was wrong before.
7560
7561** In define-key-after, if AFTER is t, the new binding now always goes
7562at the end of the keymap. If the keymap is a menu, this means it
7563goes after the other menu items.
7564
7565** If you have a program that makes several changes in the same area
7566of the buffer, you can use the macro combine-after-change-calls
7567around that Lisp code to make it faster when after-change hooks
7568are in use.
7569
7570The macro arranges to call the after-change functions just once for a
7571series of several changes--if that seems safe.
7572
7573Don't alter the variables after-change-functions and
7574after-change-function within the body of a combine-after-change-calls
7575form.
7576
7577** If you define an abbrev (with define-abbrev) whose EXPANSION
7578is not a string, then the abbrev does not expand in the usual sense,
7579but its hook is still run.
7580
7581** Normally, the Lisp debugger is not used (even if you have enabled it)
7582for errors that are handled by condition-case.
7583
7584If you set debug-on-signal to a non-nil value, then the debugger is called
7585regardless of whether there is a handler for the condition. This is
7586useful for debugging problems that happen inside of a condition-case.
7587
7588This mode of operation seems to be unreliable in other ways. Errors that
7589are normal and ought to be handled, perhaps in timers or process
7590filters, will instead invoke the debugger. So don't say you weren't
7591warned.
7592
7593** The new variable ring-bell-function lets you specify your own
7594way for Emacs to "ring the bell".
7595
7596** If run-at-time's TIME argument is t, the action is repeated at
7597integral multiples of REPEAT from the epoch; this is useful for
7598functions like display-time.
7599
7600** You can use the function locate-library to find the precise file
7601name of a Lisp library. This isn't new, but wasn't documented before.
7602
7603** Commands for entering view mode have new optional arguments that
7604can be used from Lisp. Low-level entrance to and exit from view mode
7605is done by functions view-mode-enter and view-mode-exit.
7606
7607** batch-byte-compile-file now makes Emacs return a nonzero status code
7608if there is an error in compilation.
7609
7610** pop-to-buffer, switch-to-buffer-other-window and
7611switch-to-buffer-other-frame now accept an additional optional
7612argument NORECORD, much like switch-to-buffer. If it is non-nil,
7613they don't put the buffer at the front of the buffer list.
7614
7615** If your .emacs file leaves the *scratch* buffer non-empty,
7616Emacs does not display the startup message, so as to avoid changing
7617the *scratch* buffer.
7618
7619** The new function regexp-opt returns an efficient regexp to match a string.
7620The arguments are STRINGS and (optionally) PAREN. This function can be used
7621where regexp matching or searching is intensively used and speed is important,
7622e.g., in Font Lock mode.
7623
7624** The variable buffer-display-count is local to each buffer,
7625and is incremented each time the buffer is displayed in a window.
7626It starts at 0 when the buffer is created.
7627
7628** The new function compose-mail starts composing a mail message
7629using the user's chosen mail composition agent (specified with the
7630variable mail-user-agent). It has variants compose-mail-other-window
7631and compose-mail-other-frame.
7632
7633** The `user-full-name' function now takes an optional parameter which
7634can either be a number (the UID) or a string (the login name). The
7635full name of the specified user will be returned.
7636
7637** Lisp packages that load files of customizations, or any other sort
7638of user profile, should obey the variable init-file-user in deciding
7639where to find it. They should load the profile of the user name found
7640in that variable. If init-file-user is nil, meaning that the -q
7641option was used, then Lisp packages should not load the customization
7642files at all.
7643
7644** format-time-string now allows you to specify the field width
7645and type of padding. This works as in printf: you write the field
7646width as digits in the middle of a %-construct. If you start
7647the field width with 0, it means to pad with zeros.
7648
7649For example, %S normally specifies the number of seconds since the
7650minute; %03S means to pad this with zeros to 3 positions, %_3S to pad
7651with spaces to 3 positions. Plain %3S pads with zeros, because that
7652is how %S normally pads to two positions.
7653
7654** thing-at-point now supports a new kind of "thing": url.
7655
7656** imenu.el changes.
7657
7658You can now specify a function to be run when selecting an
7659item from menu created by imenu.
7660
7661An example of using this feature: if we define imenu items for the
7662#include directives in a C file, we can open the included file when we
7663select one of those items.
7664
7665* Emacs 19.34 is a bug-fix release with no user-visible changes.
7666
7667* Changes in Emacs 19.33.
7668
7669** Bibtex mode no longer turns on Auto Fill automatically. (No major
7670mode should do that--it is the user's choice.)
7671
7672** The variable normal-auto-fill-function specifies the function to
7673use for auto-fill-function, if and when Auto Fill is turned on.
7674Major modes can set this locally to alter how Auto Fill works.
7675
7676* Editing Changes in Emacs 19.32
7677
7678** C-x f with no argument now signals an error.
7679To set the fill column at the current column, use C-u C-x f.
7680
7681** Expanding dynamic abbrevs with M-/ is now smarter about case
7682conversion. If you type the abbreviation with mixed case, and it
7683matches the beginning of the expansion including case, then the
7684expansion is copied verbatim. Using SPC M-/ to copy an additional
7685word always copies it verbatim except when the previous copied word is
7686all caps.
7687
7688** On a non-windowing terminal, which can display only one Emacs frame
7689at a time, creating a new frame with C-x 5 2 also selects that frame.
7690
7691When using a display that can show multiple frames at once, C-x 5 2
7692does make the frame visible, but does not select it. This is the same
7693as in previous Emacs versions.
7694
7695** You can use C-x 5 2 to create multiple frames on MSDOS, just as on a
7696non-X terminal on Unix. Of course, only one frame is visible at any
7697time, since your terminal doesn't have the ability to display multiple
7698frames.
7699
7700** On Windows, set win32-pass-alt-to-system to a non-nil value
7701if you would like tapping the Alt key to invoke the Windows menu.
7702This feature is not enabled by default; since the Alt key is also the
7703Meta key, it is too easy and painful to activate this feature by
7704accident.
7705
7706** The command apply-macro-to-region-lines repeats the last defined
7707keyboard macro once for each complete line within the current region.
7708It does this line by line, by moving point to the beginning of that
7709line and then executing the macro.
7710
7711This command is not new, but was never documented before.
7712
7713** You can now use Mouse-1 to place the region around a string constant
7714(something surrounded by doublequote characters or other delimiter
7715characters of like syntax) by double-clicking on one of the delimiting
7716characters.
7717
7718** Font Lock mode
7719
7720*** Font Lock support modes
7721
7722Font Lock can be configured to use Fast Lock mode and Lazy Lock mode (see
7723below) in a flexible way. Rather than adding the appropriate function to the
7724hook font-lock-mode-hook, you can use the new variable font-lock-support-mode
7725to control which modes have Fast Lock mode or Lazy Lock mode turned on when
7726Font Lock mode is enabled.
7727
7728For example, to use Fast Lock mode when Font Lock mode is turned on, put:
7729
7730 (setq font-lock-support-mode 'fast-lock-mode)
7731
7732in your ~/.emacs.
7733
7734*** lazy-lock
7735
7736The lazy-lock package speeds up Font Lock mode by making fontification occur
7737only when necessary, such as when a previously unfontified part of the buffer
7738becomes visible in a window. When you create a buffer with Font Lock mode and
7739Lazy Lock mode turned on, the buffer is not fontified. When certain events
7740occur (such as scrolling), Lazy Lock makes sure that the visible parts of the
7741buffer are fontified. Lazy Lock also defers on-the-fly fontification until
7742Emacs has been idle for a given amount of time.
7743
7744To use this package, put in your ~/.emacs:
7745
7746 (setq font-lock-support-mode 'lazy-lock-mode)
7747
7748To control the package behaviour, see the documentation for `lazy-lock-mode'.
7749
7750** Changes in BibTeX mode.
7751
7752*** For all entries allow spaces and tabs between opening brace or
7753paren and key.
7754
7755*** Non-escaped double-quoted characters (as in `Sch"of') are now
7756supported.
7757
7758** Gnus changes.
7759
7760Gnus, the Emacs news reader, has undergone further rewriting. Many new
7761commands and variables have been added. There should be no
7762significant incompatibilities between this Gnus version and the
7763previously released version, except in the message composition area.
7764
7765Below is a list of the more user-visible changes. Coding changes
7766between Gnus 5.1 and 5.2 are more extensive.
7767
7768*** A new message composition mode is used. All old customization
7769variables for mail-mode, rnews-reply-mode and gnus-msg are now
7770obsolete.
7771
7772*** Gnus is now able to generate "sparse" threads -- threads where
7773missing articles are represented by empty nodes.
7774
7775 (setq gnus-build-sparse-threads 'some)
7776
7777*** Outgoing articles are stored on a special archive server.
7778
7779 To disable this: (setq gnus-message-archive-group nil)
7780
7781*** Partial thread regeneration now happens when articles are
7782referred.
7783
7784*** Gnus can make use of GroupLens predictions:
7785
7786 (setq gnus-use-grouplens t)
7787
7788*** A trn-line tree buffer can be displayed.
7789
7790 (setq gnus-use-trees t)
7791
7792*** An nn-like pick-and-read minor mode is available for the summary
7793buffers.
7794
7795 (add-hook 'gnus-summary-mode-hook 'gnus-pick-mode)
7796
7797*** In binary groups you can use a special binary minor mode:
7798
7799 `M-x gnus-binary-mode'
7800
7801*** Groups can be grouped in a folding topic hierarchy.
7802
7803 (add-hook 'gnus-group-mode-hook 'gnus-topic-mode)
7804
7805*** Gnus can re-send and bounce mail.
7806
7807 Use the `S D r' and `S D b'.
7808
7809*** Groups can now have a score, and bubbling based on entry frequency
7810is possible.
7811
7812 (add-hook 'gnus-summary-exit-hook 'gnus-summary-bubble-group)
7813
7814*** Groups can be process-marked, and commands can be performed on
7815groups of groups.
7816
7817*** Caching is possible in virtual groups.
7818
7819*** nndoc now understands all kinds of digests, mail boxes, rnews news
7820batches, ClariNet briefs collections, and just about everything else.
7821
7822*** Gnus has a new backend (nnsoup) to create/read SOUP packets.
7823
7824*** The Gnus cache is much faster.
7825
7826*** Groups can be sorted according to many criteria.
7827
7828 For instance: (setq gnus-group-sort-function 'gnus-group-sort-by-rank)
7829
7830*** New group parameters have been introduced to set list-address and
7831expiration times.
7832
7833*** All formatting specs allow specifying faces to be used.
7834
7835*** There are several more commands for setting/removing/acting on
7836process marked articles on the `M P' submap.
7837
7838*** The summary buffer can be limited to show parts of the available
7839articles based on a wide range of criteria. These commands have been
7840bound to keys on the `/' submap.
7841
7842*** Articles can be made persistent -- as an alternative to saving
7843articles with the `*' command.
7844
7845*** All functions for hiding article elements are now toggles.
7846
7847*** Article headers can be buttonized.
7848
7849 (add-hook 'gnus-article-display-hook 'gnus-article-add-buttons-to-head)
7850
7851*** All mail backends support fetching articles by Message-ID.
7852
7853*** Duplicate mail can now be treated properly. See the
7854`nnmail-treat-duplicates' variable.
7855
7856*** All summary mode commands are available directly from the article
7857buffer.
7858
7859*** Frames can be part of `gnus-buffer-configuration'.
7860
7861*** Mail can be re-scanned by a daemonic process.
7862
7863*** Gnus can make use of NoCeM files to filter spam.
7864
7865 (setq gnus-use-nocem t)
7866
7867*** Groups can be made permanently visible.
7868
7869 (setq gnus-permanently-visible-groups "^nnml:")
7870
7871*** Many new hooks have been introduced to make customizing easier.
7872
7873*** Gnus respects the Mail-Copies-To header.
7874
7875*** Threads can be gathered by looking at the References header.
7876
7877 (setq gnus-summary-thread-gathering-function
7878 'gnus-gather-threads-by-references)
7879
7880*** Read articles can be stored in a special backlog buffer to avoid
7881refetching.
7882
7883 (setq gnus-keep-backlog 50)
7884
7885*** A clean copy of the current article is always stored in a separate
7886buffer to allow easier treatment.
7887
7888*** Gnus can suggest where to save articles. See `gnus-split-methods'.
7889
7890*** Gnus doesn't have to do as much prompting when saving.
7891
7892 (setq gnus-prompt-before-saving t)
7893
7894*** gnus-uu can view decoded files asynchronously while fetching
7895articles.
7896
7897 (setq gnus-uu-grabbed-file-functions 'gnus-uu-grab-view)
7898
7899*** Filling in the article buffer now works properly on cited text.
7900
7901*** Hiding cited text adds buttons to toggle hiding, and how much
7902cited text to hide is now customizable.
7903
7904 (setq gnus-cited-lines-visible 2)
7905
7906*** Boring headers can be hidden.
7907
7908 (add-hook 'gnus-article-display-hook 'gnus-article-hide-boring-headers)
7909
7910*** Default scoring values can now be set from the menu bar.
7911
7912*** Further syntax checking of outgoing articles have been added.
7913
7914The Gnus manual has been expanded. It explains all these new features
7915in greater detail.
7916
7917* Lisp Changes in Emacs 19.32
7918
7919** The function set-visited-file-name now accepts an optional
7920second argument NO-QUERY. If it is non-nil, then the user is not
7921asked for confirmation in the case where the specified file already
7922exists.
7923
7924** The variable print-length applies to printing vectors and bitvectors,
7925as well as lists.
7926
7927** The new function keymap-parent returns the parent keymap
7928of a given keymap.
7929
7930** The new function set-keymap-parent specifies a new parent for a
7931given keymap. The arguments are KEYMAP and PARENT. PARENT must be a
7932keymap or nil.
7933
7934** Sometimes menu keymaps use a command name, a symbol, which is really
7935an automatically generated alias for some other command, the "real"
7936name. In such a case, you should give that alias symbol a non-nil
7937menu-alias property. That property tells the menu system to look for
7938equivalent keys for the real name instead of equivalent keys for the
7939alias.
7940
7941* Editing Changes in Emacs 19.31
7942
7943** Freedom of the press restricted in the United States.
7944
7945Emacs has been censored in accord with the Communications Decency Act.
7946This includes removing some features of the doctor program. That law
7947was described by its supporters as a ban on pornography, but it bans
7948far more than that. The Emacs distribution has never contained any
7949pornography, but parts of it were nonetheless prohibited.
7950
7951For information on US government censorship of the Internet, and what
7952you can do to bring back freedom of the press, see the web site
7953`http://www.vtw.org/'.
7954
7955** A note about C mode indentation customization.
7956
7957The old (Emacs 19.29) ways of specifying a C indentation style
7958do not normally work in the new implementation of C mode.
7959It has its own methods of customizing indentation, which are
7960much more powerful than the old C mode. See the Editing Programs
7961chapter of the manual for details.
7962
7963However, you can load the library cc-compat to make the old
7964customization variables take effect.
7965
7966** Marking with the mouse.
7967
7968When you mark a region with the mouse, the region now remains
7969highlighted until the next input event, regardless of whether you are
7970using M-x transient-mark-mode.
7971
7972** Improved Windows NT/95 support.
7973
7974*** Emacs now supports scroll bars on Windows NT and Windows 95.
7975
7976*** Emacs now supports subprocesses on Windows 95. (Subprocesses used
7977to work on NT only and not on 95.)
7978
7979*** There are difficulties with subprocesses, though, due to problems
7980in Windows, beyond the control of Emacs. They work fine as long as
7981you run Windows applications. The problems arise when you run a DOS
7982application in a subprocesses. Since current shells run as DOS
7983applications, these problems are significant.
7984
7985If you run a DOS application in a subprocess, then the application is
7986likely to busy-wait, which means that your machine will be 100% busy.
7987However, if you don't mind the temporary heavy load, the subprocess
7988will work OK as long as you tell it to terminate before you start any
7989other DOS application as a subprocess.
7990
7991Emacs is unable to terminate or interrupt a DOS subprocess.
7992You have to do this by providing input directly to the subprocess.
7993
7994If you run two DOS applications at the same time in two separate
7995subprocesses, even if one of them is asynchronous, you will probably
7996have to reboot your machine--until then, it will remain 100% busy.
7997Windows simply does not cope when one Windows process tries to run two
7998separate DOS subprocesses. Typing CTL-ALT-DEL and then choosing
7999Shutdown seems to work although it may take a few minutes.
8000
8001** M-x resize-minibuffer-mode.
8002
8003This command, not previously mentioned in NEWS, toggles a mode in
8004which the minibuffer window expands to show as many lines as the
8005minibuffer contains.
8006
8007** `title' frame parameter and resource.
8008
8009The `title' X resource now specifies just the frame title, nothing else.
8010It does not affect the name used for looking up other X resources.
8011It works by setting the new `title' frame parameter, which likewise
8012affects just the displayed title of the frame.
8013
8014The `name' parameter continues to do what it used to do:
8015it specifies the frame name for looking up X resources,
8016and also serves as the default for the displayed title
8017when the `title' parameter is unspecified or nil.
8018
8019** Emacs now uses the X toolkit by default, if you have a new
8020enough version of X installed (X11R5 or newer).
8021
8022** When you compile Emacs with the Motif widget set, Motif handles the
8023F10 key by activating the menu bar. To avoid confusion, the usual
8024Emacs binding of F10 is replaced with a no-op when using Motif.
8025
8026If you want to be able to use F10 in Emacs, you can rebind the Motif
8027menubar to some other key which you don't use. To do so, add
8028something like this to your X resources file. This example rebinds
8029the Motif menu bar activation key to S-F12:
8030
8031 Emacs*defaultVirtualBindings: osfMenuBar : Shift<Key>F12
8032
8033** In overwrite mode, DEL now inserts spaces in most cases
8034to replace the characters it "deletes".
8035
8036** The Rmail summary now shows the number of lines in each message.
8037
8038** Rmail has a new command M-x unforward-rmail-message, which extracts
8039a forwarded message from the message that forwarded it. To use it,
8040select a message which contains a forwarded message and then type the command.
8041It inserts the forwarded message as a separate Rmail message
8042immediately after the selected one.
8043
8044This command also undoes the textual modifications that are standardly
8045made, as part of forwarding, by Rmail and other mail reader programs.
8046
8047** Turning off saving of .saves-... files in your home directory.
8048
8049Each Emacs session writes a file named .saves-... in your home
8050directory to record which files M-x recover-session should recover.
8051If you exit Emacs normally with C-x C-c, it deletes that file. If
8052Emacs or the operating system crashes, the file remains for M-x
8053recover-session.
8054
8055You can turn off the writing of these files by setting
8056auto-save-list-file-name to nil. If you do this, M-x recover-session
8057will not work.
8058
8059Some previous Emacs versions failed to delete these files even on
8060normal exit. This is fixed now. If you are thinking of turning off
8061this feature because of past experiences with versions that had this
8062bug, it would make sense to check whether you still want to do so
8063now that the bug is fixed.
8064
8065** Changes to Version Control (VC)
8066
8067There is a new variable, vc-follow-symlinks. It indicates what to do
8068when you visit a link to a file that is under version control.
8069Editing the file through the link bypasses the version control system,
8070which is dangerous and probably not what you want.
8071
8072If this variable is t, VC follows the link and visits the real file,
8073telling you about it in the echo area. If it is `ask' (the default),
8074VC asks for confirmation whether it should follow the link. If nil,
8075the link is visited and a warning displayed.
8076
8077** iso-acc.el now lets you specify a choice of language.
8078Languages include "latin-1" (the default) and "latin-2" (which
8079is designed for entering ISO Latin-2 characters).
8080
8081There are also choices for specific human languages such as French and
8082Portuguese. These are subsets of Latin-1, which differ in that they
8083enable only the accent characters needed for particular language.
8084The other accent characters, not needed for the chosen language,
8085remain normal.
8086
8087** Posting articles and sending mail now has M-TAB completion on various
8088header fields (Newsgroups, To, CC, ...).
8089
8090Completion in the Newsgroups header depends on the list of groups
8091known to your news reader. Completion in the Followup-To header
8092offers those groups which are in the Newsgroups header, since
8093Followup-To usually just holds one of those.
8094
8095Completion in fields that hold mail addresses works based on the list
8096of local users plus your aliases. Additionally, if your site provides
8097a mail directory or a specific host to use for any unrecognized user
8098name, you can arrange to query that host for completion also. (See the
8099documentation of variables `mail-directory-process' and
8100`mail-directory-stream'.)
8101
8102** A greatly extended sgml-mode offers new features such as (to be configured)
8103skeletons with completing read for tags and attributes, typing named
8104characters including optionally all 8bit characters, making tags invisible
8105with optional alternate display text, skipping and deleting tag(pair)s.
8106
8107Note: since Emacs' syntax feature cannot limit the special meaning of ', " and
8108- to inside <>, for some texts the result, especially of font locking, may be
8109wrong (see `sgml-specials' if you get wrong results).
8110
8111The derived html-mode configures this with tags and attributes more or
8112less HTML3ish. It also offers optional quick keys like C-c 1 for
8113headline or C-c u for unordered list (see `html-quick-keys'). Edit /
8114Text Properties / Face or M-g combinations create tags as applicable.
8115Outline minor mode is supported and level 1 font-locking tries to
8116fontify tag contents (which only works when they fit on one line, due
8117to a limitation in font-lock).
8118
8119External viewing via browse-url can occur automatically upon saving.
8120
8121** M-x imenu-add-to-menubar now adds to the menu bar for the current
8122buffer only. If you want to put an Imenu item in the menu bar for all
8123buffers that use a particular major mode, use the mode hook, as in
8124this example:
8125
8126 (add-hook 'emacs-lisp-mode-hook
8127 '(lambda () (imenu-add-to-menubar "Index")))
8128
8129** Changes in BibTeX mode.
8130
8131*** Field names may now contain digits, hyphens, and underscores.
8132
8133*** Font Lock mode is now supported.
8134
8135*** bibtex-make-optional-field is no longer interactive.
8136
8137*** If bibtex-maintain-sorted-entries is non-nil, inserting new
8138entries is now done with a faster algorithm. However, inserting
8139will fail in this case if the buffer contains invalid entries or
8140isn't in sorted order, so you should finish each entry with C-c C-c
8141(bibtex-close-entry) after you have inserted or modified it.
8142The default value of bibtex-maintain-sorted-entries is nil.
8143
8144*** Function `show-all' is no longer bound to a key, since C-u C-c C-q
8145does the same job.
8146
8147*** Entries with quotes inside quote-delimited fields (as `author =
8148"Stefan Sch{\"o}f"') are now supported.
8149
8150*** Case in field names doesn't matter anymore when searching for help
8151text.
8152
8153** Font Lock mode
8154
8155*** Global Font Lock mode
8156
8157Font Lock mode can be turned on globally, in buffers that support it, by the
8158new command global-font-lock-mode. You can use the new variable
8159font-lock-global-modes to control which modes have Font Lock mode automagically
8160turned on. By default, this variable is set so that Font Lock mode is turned
8161on globally where the buffer mode supports it.
8162
8163For example, to automagically turn on Font Lock mode where supported, put:
8164
8165 (global-font-lock-mode t)
8166
8167in your ~/.emacs.
8168
8169*** Local Refontification
8170
8171In Font Lock mode, editing a line automatically refontifies that line only.
8172However, if your change alters the syntactic context for following lines,
8173those lines remain incorrectly fontified. To refontify them, use the new
8174command M-g M-g (font-lock-fontify-block).
8175
8176In certain major modes, M-g M-g refontifies the entire current function.
8177(The variable font-lock-mark-block-function controls how to find the
8178current function.) In other major modes, M-g M-g refontifies 16 lines
8179above and below point.
8180
8181With a prefix argument N, M-g M-g refontifies N lines above and below point.
8182
8183** Follow mode
8184
8185Follow mode is a new minor mode combining windows showing the same
8186buffer into one tall "virtual window". The windows are typically two
8187side-by-side windows. Follow mode makes them scroll together as if
8188they were a unit. To use it, go to a frame with just one window,
8189split it into two side-by-side windows using C-x 3, and then type M-x
8190follow-mode.
8191
8192M-x follow-mode turns off Follow mode if it is already enabled.
8193
8194To display two side-by-side windows and activate Follow mode, use the
8195command M-x follow-delete-other-windows-and-split.
8196
8197** hide-show changes.
8198
8199The hooks hs-hide-hooks and hs-show-hooks have been renamed
8200to hs-hide-hook and hs-show-hook, to follow the convention for
8201normal hooks.
8202
8203** Simula mode now has a menu containing the most important commands.
8204The new command simula-indent-exp is bound to C-M-q.
8205
8206** etags can now handle programs written in Erlang. Files are
8207recognised by the extensions .erl and .hrl. The tagged lines are
8208those that begin a function, record, or macro.
8209
8210** MSDOS Changes
8211
8212*** It is now possible to compile Emacs with the version 2 of DJGPP.
8213Compilation with DJGPP version 1 also still works.
8214
8215*** The documentation of DOS-specific aspects of Emacs was rewritten
8216and expanded; see the ``MS-DOS'' node in the on-line docs.
8217
8218*** Emacs now uses ~ for backup file names, not .bak.
8219
8220*** You can simulate mouse-3 on two-button mice by simultaneously
8221pressing both mouse buttons.
8222
8223*** A number of packages and commands which previously failed or had
8224restricted functionality on MS-DOS, now work. The most important ones
8225are:
8226
8227**** Printing (both with `M-x lpr-buffer' and with `ps-print' package)
8228now works.
8229
8230**** `Ediff' works (in a single-frame mode).
8231
8232**** `M-x display-time' can be used on MS-DOS (due to the new
8233implementation of Emacs timers, see below).
8234
8235**** `Dired' supports Unix-style shell wildcards.
8236
8237**** The `c-macro-expand' command now works as on other platforms.
8238
8239**** `M-x recover-session' works.
8240
8241**** `M-x list-colors-display' displays all the available colors.
8242
8243**** The `TPU-EDT' package works.
8244
8245* Lisp changes in Emacs 19.31.
8246
8247** The function using-unix-filesystems on Windows NT and Windows 95
8248tells Emacs to read and write files assuming that they reside on a
8249remote Unix filesystem. No CR/LF translation is done on any files in
8250this case. Invoking using-unix-filesystems with t activates this
8251behavior, and invoking it with any other value deactivates it.
8252
8253** Change in system-type and system-configuration values.
8254
8255The value of system-type on a Linux-based GNU system is now `lignux',
8256not `linux'. This means that some programs which use `system-type'
8257need to be changed. The value of `system-configuration' will also
8258be different.
8259
8260It is generally recommended to use `system-configuration' rather
8261than `system-type'.
8262
8263See the file LINUX-GNU in this directory for more about this.
8264
8265** The functions shell-command and dired-call-process
8266now run file name handlers for default-directory, if it has them.
8267
8268** Undoing the deletion of text now restores the positions of markers
8269that pointed into or next to the deleted text.
8270
8271** Timers created with run-at-time now work internally to Emacs, and
8272no longer use a separate process. Therefore, they now work more
8273reliably and can be used for shorter time delays.
8274
8275The new function run-with-timer is a convenient way to set up a timer
8276to run a specified amount of time after the present. A call looks
8277like this:
8278
8279 (run-with-timer SECS REPEAT FUNCTION ARGS...)
8280
8281SECS says how many seconds should elapse before the timer happens.
8282It may be an integer or a floating point number. When the timer
8283becomes ripe, the action is to call FUNCTION with arguments ARGS.
8284
8285REPEAT gives the interval for repeating the timer (measured in
8286seconds). It may be an integer or a floating point number. nil or 0
8287means don't repeat at all--call FUNCTION just once.
8288
8289*** with-timeout provides an easy way to do something but give
8290up if too much time passes.
8291
8292 (with-timeout (SECONDS TIMEOUT-FORMS...) BODY...)
8293
8294This executes BODY, but gives up after SECONDS seconds.
8295If it gives up, it runs the TIMEOUT-FORMS and returns the value
8296of the last one of them. Normally it returns the value of the last
8297form in BODY.
8298
8299*** You can now arrange to call a function whenever Emacs is idle for
8300a certain length of time. To do this, call run-with-idle-timer. A
8301call looks like this:
8302
8303 (run-with-idle-timer SECS REPEAT FUNCTION ARGS...)
8304
8305SECS says how many seconds of idleness should elapse before the timer
8306runs. It may be an integer or a floating point number. When the
8307timer becomes ripe, the action is to call FUNCTION with arguments
8308ARGS.
8309
8310Emacs becomes idle whenever it finishes executing a keyboard or mouse
8311command. It remains idle until it receives another keyboard or mouse
8312command.
8313
8314REPEAT, if non-nil, means this timer should be activated again each
8315time Emacs becomes idle and remains idle for SECS seconds The timer
8316does not repeat if Emacs *remains* idle; it runs at most once after
8317each time Emacs becomes idle.
8318
8319If REPEAT is nil, the timer runs just once, the first time Emacs is
8320idle for SECS seconds.
8321
8322*** post-command-idle-hook is now obsolete; you shouldn't use it at
8323all, because it interferes with the idle timer mechanism. If your
8324programs use post-command-idle-hook, convert them to use idle timers
8325instead.
8326
8327*** y-or-n-p-with-timeout lets you ask a question but give up if
8328there is no answer within a certain time.
8329
8330 (y-or-n-p-with-timeout PROMPT SECONDS DEFAULT-VALUE)
8331
8332asks the question PROMPT (just like y-or-n-p). If the user answers
8333within SECONDS seconds, it returns the answer that the user gave.
8334Otherwise it gives up after SECONDS seconds, and returns DEFAULT-VALUE.
8335
8336** Minor change to `encode-time': you can now pass more than seven
8337arguments. If you do that, the first six arguments have the usual
8338meaning, the last argument is interpreted as the time zone, and the
8339arguments in between are ignored.
8340
8341This means that it works to use the list returned by `decode-time' as
8342the list of arguments for `encode-time'.
8343
8344** The default value of load-path now includes the directory
8345/usr/local/share/emacs/VERSION/site-lisp In addition to
8346/usr/local/share/emacs/site-lisp. You can use this new directory for
8347site-specific Lisp packages that belong with a particular Emacs
8348version.
8349
8350It is not unusual for a Lisp package that works well in one Emacs
8351version to cause trouble in another. Sometimes packages need updating
8352for incompatible changes; sometimes they look at internal data that
8353has changed; sometimes the package has been installed in Emacs itself
8354and the installed version should be used. Whatever the reason for the
8355problem, this new feature makes it easier to solve.
8356
8357** When your program contains a fixed file name (like .completions or
8358.abbrev.defs), the file name usually needs to be different on operating
8359systems with limited file name syntax.
8360
8361Now you can avoid ad-hoc conditionals by using the function
8362convert-standard-filename to convert the file name to a proper form
8363for each operating system. Here is an example of use, from the file
8364completions.el:
8365
8366(defvar save-completions-file-name
8367 (convert-standard-filename "~/.completions")
8368 "*The filename to save completions to.")
8369
8370This sets the variable save-completions-file-name to a value that
8371depends on the operating system, because the definition of
8372convert-standard-filename depends on the operating system. On
8373Unix-like systems, it returns the specified file name unchanged. On
8374MS-DOS, it adapts the name to fit the limitations of that system.
8375
8376** The interactive spec N now returns the numeric prefix argument
8377rather than the raw prefix argument. (It still reads a number using the
8378minibuffer if there is no prefix argument at all.)
8379
8380** When a process is deleted, this no longer disconnects the process
8381marker from its buffer position.
8382
8383** The variable garbage-collection-messages now controls whether
8384Emacs displays a message at the beginning and end of garbage collection.
8385The default is nil, meaning there are no messages.
8386
8387** The variable debug-ignored-errors specifies certain kinds of errors
8388that should not enter the debugger. Its value is a list of error
8389condition symbols and/or regular expressions. If the error has any
8390of the condition symbols listed, or if any of the regular expressions
8391matches the error message, then that error does not enter the debugger,
8392regardless of the value of debug-on-error.
8393
8394This variable is initialized to match certain common but uninteresting
8395errors that happen often during editing.
8396
8397** The new function error-message-string converts an error datum
8398into its error message. The error datum is what condition-case
8399puts into the variable, to describe the error that happened.
8400
8401** Anything that changes which buffer appears in a given window
8402now runs the window-scroll-functions for that window.
8403
8404** The new function get-buffer-window-list returns a list of windows displaying
8405a buffer. The function is called with the buffer (a buffer object or a buffer
8406name) and two optional arguments specifying the minibuffer windows and frames
8407to search. Therefore this function takes optional args like next-window etc.,
8408and not get-buffer-window.
8409
8410** buffer-substring now runs the hook buffer-access-fontify-functions,
8411calling each function with two arguments--the range of the buffer
8412being accessed. buffer-substring-no-properties does not call them.
8413
8414If you use this feature, you should set the variable
8415buffer-access-fontified-property to a non-nil symbol, which is a
8416property name. Then, if all the characters in the buffer range have a
8417non-nil value for that property, the buffer-access-fontify-functions
8418are not called. When called, these functions should put a non-nil
8419property on the text that they fontify, so that they won't get called
8420over and over for the same text.
8421
8422** Changes in lisp-mnt.el
8423
8424*** The lisp-mnt package can now recognize file headers that are written
8425in the formats used by the `what' command and the RCS `ident' command:
8426
8427;; @(#) HEADER: text
8428;; $HEADER: text $
8429
8430in addition to the normal
8431
8432;; HEADER: text
8433
8434*** The commands lm-verify and lm-synopsis are now interactive. lm-verify
8435checks that the library file has proper sections and headers, and
8436lm-synopsis extracts first line "synopsis'"information.
8437
8438
3459 8439
3460* For older news, see the file NEWS.1. 8440* For older news, see the file ONEWS
3461 8441
3462---------------------------------------------------------------------- 8442----------------------------------------------------------------------
3463Copyright information: 8443Copyright information:
diff --git a/etc/NEWS.1 b/etc/NEWS.1
index 0cb7daf09d2..06b5405be1e 100644
--- a/etc/NEWS.1
+++ b/etc/NEWS.1
@@ -1,4994 +1,1154 @@
1GNU Emacs NEWS -- history of user-visible changes. 5 Jan 2000 1Old GNU Emacs NEWS -- history of user-visible changes thru version 15.
2Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc. 2Copyright (C) 1985 Richard M. Stallman.
3See the end for copying conditions. 3See the end for copying conditions.
4
5Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
6For older news, see the file ONEWS.
7
8^L
9* Emacs 20.7 is a bug-fix release with few user-visible changes
10
11** It is now possible to use CCL-based coding systems for keyboard
12input.
13
14** ange-ftp now handles FTP security extensions, like Kerberos.
15
16** Rmail has been extended to recognize more forms of digest messages.
17
18** Now, most coding systems set in keyboard coding system work not
19only for character input, but also in incremental search. The
20exceptions are such coding systems that handle 2-byte character sets
21(e.g euc-kr, euc-jp) and that use ISO's escape sequence
22(e.g. iso-2022-jp). They are ignored in incremental search.
23
24** Support for Macintosh PowerPC-based machines running GNU/Linux has
25been added.
26
27^L
28* Emacs 20.6 is a bug-fix release with one user-visible change
29
30** Support for ARM-based non-RISCiX machines has been added.
31
32^L
33* Emacs 20.5 is a bug-fix release with no user-visible changes.
34
35** Not new, but not mentioned before:
36M-w when Transient Mark mode is enabled disables the mark.
37 4
38* Changes in Emacs 20.4 5Changes in Emacs 15
39 6
40** Init file may be called .emacs.el. 7* Emacs now runs on Sun and Megatest 68000 systems;
41 8 also on at least one 16000 system running 4.2.
42You can now call the Emacs init file `.emacs.el'. 9
43Formerly the name had to be `.emacs'. If you use the name 10* Emacs now alters the output-start and output-stop characters
44`.emacs.el', you can byte-compile the file in the usual way. 11 to prevent C-s and C-q from being considered as flow control
45 12 by cretinous rlogin software in 4.2.
46If both `.emacs' and `.emacs.el' exist, the latter file 13
47is the one that is used. 14* It is now possible convert Mocklisp code (for Gosling Emacs) to Lisp code
48 15 that can run in GNU Emacs. M-x convert-mocklisp-buffer
49** shell-command, and shell-command-on-region, now return 16 converts the contents of the current buffer from Mocklisp to
50the exit code of the command (unless it is asynchronous). 17 GNU Emacs Lisp. You should then save the converted buffer with C-x C-w
51Also, you can specify a place to put the error output, 18 under a name ending in ".el"
52separate from the command's regular output. 19
53Interactively, the variable shell-command-default-error-buffer 20 There are probably some Mocklisp constructs that are not handled.
54says where to put error output; set it to a buffer name. 21 If you encounter one, feel free to report the failure as a bug.
55In calls from Lisp, an optional argument ERROR-BUFFER specifies 22 The construct will be handled in a future Emacs release, if that is not
56the buffer name. 23 not too hard to do.
57 24
58When you specify a non-nil error buffer (or buffer name), any error 25 Note that lisp code converted from Mocklisp code will not necessarily
59output is inserted before point in that buffer, with \f\n to separate 26 run as fast as code specifically written for GNU Emacs, nor will it use
60it from the previous batch of error output. The error buffer is not 27 the many features of GNU Emacs which are not present in Gosling's emacs.
61cleared, so error output from successive commands accumulates there. 28 (In particular, the byte-compiler (m-x byte-compile-file) knows little
62 29 about compilation of code directly converted from mocklisp.)
63** Setting the default value of enable-multibyte-characters to nil in 30 It is envisaged that old mocklisp code will be incrementally converted
64the .emacs file, either explicitly using setq-default, or via Custom, 31 to GNU lisp code, with M-x convert-mocklisp-buffer being the first
65is now essentially equivalent to using --unibyte: all buffers 32 step in this process.
66created during startup will be made unibyte after loading .emacs. 33
67 34* Control-x n (narrow-to-region) is now by default a disabled command.
68** C-x C-f now handles the wildcards * and ? in file names. For 35
69example, typing C-x C-f c*.c RET visits all the files whose names 36 This means that, if you issue this command, it will ask whether
70match c*.c. To visit a file whose name contains * or ?, add the 37 you really mean it. You have the opportunity to enable the
71quoting sequence /: to the beginning of the file name. 38 command permanently at that time, so you will not be asked again.
72 39 This will place the form "(put 'narrow-to-region 'disabled nil)" in your
73** The M-x commands keep-lines, flush-lines and count-matches 40 .emacs file.
74now have the same feature as occur and query-replace: 41
75if the pattern contains any upper case letters, then 42* Tags now prompts for the tag table file name to use.
76they never ignore case. 43
77 44 All the tags commands ask for the tag table file name
78** The end-of-line format conversion feature previously mentioned 45 if you have not yet specified one.
79under `* Emacs 20.1 changes for MS-DOS and MS-Windows' actually 46
80applies to all operating systems. Emacs recognizes from the contents 47 Also, the command M-x visit-tag-table can now be used to
81of a file what convention it uses to separate lines--newline, CRLF, or 48 specify the tag table file name initially, or to switch
82just CR--and automatically converts the contents to the normal Emacs 49 to a new tag table.
83convention (using newline to separate lines) for editing. This is a 50
84part of the general feature of coding system conversion. 51* If truncate-partial-width-windows is non-nil (as it intially is),
85 52 all windows less than the full screen width (that is,
86If you subsequently save the buffer, Emacs converts the text back to 53 made by side-by-side splitting) truncate lines rather than continuing
87the same format that was used in the file before. 54 them.
88 55
89You can turn off end-of-line conversion by setting the variable 56* Emacs now checks for Lisp stack overflow to avoid fatal errors.
90`inhibit-eol-conversion' to non-nil, e.g. with Custom in the MULE group. 57 The depth in eval, apply and funcall may not exceed max-lisp-eval-depth.
91 58 The depth in variable bindings and unwind-protects may not exceed
92** The character set property `prefered-coding-system' has been 59 max-specpdl-size. If either limit is exceeded, an error occurs.
93renamed to `preferred-coding-system', for the sake of correct spelling. 60 You can set the limits to larger values if you wish, but if you make them
94This is a fairly internal feature, so few programs should be affected. 61 too large, you are vulnerable to a fatal error if you invoke
95 62 Lisp code that does infinite recursion.
96** Mode-line display of end-of-line format is changed. 63
97The indication of the end-of-line format of the file visited by a 64* New hooks find-file-hook and write-file-hook.
98buffer is now more explicit when that format is not the usual one for 65 Both of these variables if non-nil should be functions of no arguments.
99your operating system. For example, the DOS-style end-of-line format 66 At the time they are called (current-buffer) will be the buffer being
100is displayed as "(DOS)" on Unix and GNU/Linux systems. The usual 67 read or written respectively.
101end-of-line format is still displayed as a single character (colon for 68
102Unix, backslash for DOS and Windows, and forward slash for the Mac). 69 find-file-hook is called whenever a file is read into its own buffer,
103 70 such as by calling find-file, revert-buffer, etc. It is not called by
104The values of the variables eol-mnemonic-unix, eol-mnemonic-dos, 71 functions such as insert-file which do not read the file into a buffer of
105eol-mnemonic-mac, and eol-mnemonic-undecided, which are strings, 72 its own.
106control what is displayed in the mode line for each end-of-line 73 find-file-hook is called after the file has been read in and its
107format. You can now customize these variables. 74 local variables (if any) have been processed.
108 75
109** In the previous version of Emacs, tar-mode didn't work well if a 76 write-file-hook is called just before writing out a file from a buffer.
110filename contained non-ASCII characters. Now this is fixed. Such a 77
111filename is decoded by file-name-coding-system if the default value of 78* The initial value of shell-prompt-pattern is now "^[^#$%>]*[#$%>] *"
112enable-multibyte-characters is non-nil. 79
113 80* If the .emacs file sets inhibit-startup-message to non-nil,
114** The command temp-buffer-resize-mode toggles a minor mode 81 the messages normally printed by Emacs at startup time
115in which temporary buffers (such as help buffers) are given 82 are inhibited.
116windows just big enough to hold the whole contents. 83
117 84* Facility for run-time conditionalization on the basis of emacs features.
118** If you use completion.el, you must now run the function 85
119dynamic-completion-mode to enable it. Just loading the file 86 The new variable features is a list of symbols which represent "features"
120doesn't have any effect. 87 of the executing emacs, for use in run-time conditionalization.
121 88
122** In Flyspell mode, the default is now to make just one Ispell process, 89 The function featurep of one argument may be used to test for the
123not one per buffer. 90 presence of a feature. It is just the same as
124 91 (not (null (memq FEATURE features))) where FEATURE is its argument.
125** If you use iswitchb but do not call (iswitchb-default-keybindings) to 92 For example, (if (featurep 'magic-window-hack)
126use the default keybindings, you will need to add the following line: 93 (transmogrify-window 'vertical)
127 (add-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup) 94 (split-window-vertically))
128 95
129** Auto-show mode is no longer enabled just by loading auto-show.el. 96 The function provide of one argument "announces" that FEATURE is present.
130To control it, set `auto-show-mode' via Custom or use the 97 It is much the same as (if (not (featurep FEATURE))
131`auto-show-mode' command. 98 (setq features (cons FEATURE features)))
132 99
133** Handling of X fonts' ascent/descent parameters has been changed to 100 The function require with arguments FEATURE and FILE-NAME loads FILE-NAME
134avoid redisplay problems. As a consequence, compared with previous 101 (which should contain the form (provide FEATURE)) unless FEATURE is present.
135versions the line spacing and frame size now differ with some font 102 It is much the same as (if (not (featurep FEATURE))
136choices, typically increasing by a pixel per line. This change 103 (progn (load FILE-NAME)
137occurred in version 20.3 but was not documented then. 104 (if (not featurep FEATURE) (error ...))))
138 105 FILE-NAME is optional and defaults to FEATURE.
139** If you select the bar cursor style, it uses the frame's 106
140cursor-color, rather than the cursor foreground pixel. 107* New function load-average.
141 108
142** In multibyte mode, Rmail decodes incoming MIME messages using the 109 This returns a list of three integers, which are
143character set specified in the message. If you want to disable this 110 the current 1 minute, 5 minute and 15 minute load averages,
144feature, set the variable rmail-decode-mime-charset to nil. 111 each multiplied by a hundred (since normally they are floating
145 112 point numbers).
146** Not new, but not mentioned previously in NEWS: when you use #! at 113
147the beginning of a file to make it executable and specify an 114* Per-terminal libraries loaded automatically.
148interpreter program, Emacs looks on the second line for the -*- mode 115
149and variable specification, as well as on the first line. 116 Emacs when starting up on terminal type T automatically loads
150 117 a library named term-T. T is the value of the TERM environment variable.
151** Support for IBM codepage encoding of non-ASCII characters. 118 Thus, on terminal type vt100, Emacs would do (load "term-vt100" t t).
152 119 Such libraries are good places to set the character translation table.
153The new command M-x codepage-setup creates a special coding system 120
154that can be used to convert text between a specific IBM codepage and 121 It is a bad idea to redefine lots of commands in a per-terminal library,
155one of the character sets built into Emacs which matches that 122 since this affects all users. Instead, define a command to do the
156codepage. For example, codepage 850 corresponds to Latin-1 character 123 redefinitions and let the user's init file, which is loaded later,
157set, codepage 855 corresponds to Cyrillic-ISO character set, etc. 124 call that command or not, as the user prefers.
158 125
159Windows codepages 1250, 1251 and some others, where Windows deviates 126* Programmer's note: detecting killed buffers.
160from the corresponding ISO character set, are also supported. 127
161 128 Buffers are eliminated by explicitly killing them, using
162IBM box-drawing characters and other glyphs which don't have 129 the function kill-buffer. This does not eliminate or affect
163equivalents in the corresponding ISO character set, are converted to 130 the pointers to the buffer which may exist in list structure.
164a character defined by dos-unsupported-char-glyph on MS-DOS, and to 131 If you have a pointer to a buffer and wish to tell whether
165`?' on other systems. 132 the buffer has been killed, use the function buffer-name.
166 133 It returns nil on a killed buffer, and a string on a live buffer.
167IBM codepages are widely used on MS-DOS and MS-Windows, so this 134
168feature is most useful on those platforms, but it can also be used on 135* New ways to access the last command input character.
169Unix. 136
170 137 The function last-key-struck, which used to return the last
171Emacs compiled for MS-DOS automatically loads the support for the 138 input character that was read by command input, is eliminated.
172current codepage when it starts. 139 Instead, you can find this information as the value of the
173 140 variable last-command-char. (This variable used to be called
174** Mail changes 141 last-key).
175 142
176*** When mail is sent using compose-mail (C-x m), and if 143 Another new variable, last-input-char, holds the last character
177`mail-send-nonascii' is set to the new default value `mime', 144 read from the command input stream regardless of what it was
178appropriate MIME headers are added. The headers are added only if 145 read for. last-input-char and last-command-char are different
179non-ASCII characters are present in the body of the mail, and no other 146 only inside a command that has called read-char to read input.
180MIME headers are already present. For example, the following three 147
181headers are added if the coding system used in the *mail* buffer is 148* The new switch -kill causes Emacs to exit after processing the
182latin-1: 149 preceding command line arguments. Thus,
183 150 emacs -l lib data -e do-it -kill
184 MIME-version: 1.0 151 means to load lib, find file data, call do-it on no arguments,
185 Content-type: text/plain; charset=iso-8859-1 152 and then exit.
186 Content-Transfer-Encoding: 8bit 153
187 154* The config.h file has been modularized.
188*** The new variable default-sendmail-coding-system specifies the 155
189default way to encode outgoing mail. This has higher priority than 156 Options that depend on the machine you are running on are defined
190default-buffer-file-coding-system but has lower priority than 157 in a file whose name starts with "m-", such as m-vax.h.
191sendmail-coding-system and the local value of 158 Options that depend on the operating system software version you are
192buffer-file-coding-system. 159 running on are defined in a file whose name starts with "s-",
193 160 such as s-bsd4.2.h.
194You should not set this variable manually. Instead, set 161
195sendmail-coding-system to specify a fixed encoding for all outgoing 162 config.h includes one m- file and one s- file. It also defines a
196mail. 163 few other options whose values do not follow from the machine type
197 164 and system type being used. Installers normally will have to
198*** When you try to send a message that contains non-ASCII characters, 165 select the correct m- and s- files but will never have to change their
199if the coding system specified by those variables doesn't handle them, 166 contents.
200Emacs will ask you to select a suitable coding system while showing a
201list of possible coding systems.
202
203** CC Mode changes
204
205*** c-default-style can now take an association list that maps major
206modes to style names. When this variable is an alist, Java mode no
207longer hardcodes a setting to "java" style. See the variable's
208docstring for details.
209
210*** It's now possible to put a list as the offset on a syntactic
211symbol. The list is evaluated recursively until a non-nil offset is
212found. This is useful to combine several lineup functions to act in a
213prioritized order on a single line. However, none of the supplied
214lineup functions use this feature currently.
215
216*** New syntactic symbol catch-clause, which is used on the "catch" and
217"finally" lines in try-catch constructs in C++ and Java.
218
219*** New cleanup brace-catch-brace on c-cleanup-list, which does for
220"catch" lines what brace-elseif-brace does for "else if" lines.
221
222*** The braces of Java anonymous inner classes are treated separately
223from the braces of other classes in auto-newline mode. Two new
224symbols inexpr-class-open and inexpr-class-close may be used on
225c-hanging-braces-alist to control the automatic newlines used for
226anonymous classes.
227
228*** Support for the Pike language added, along with new Pike specific
229syntactic symbols: inlambda, lambda-intro-cont
230
231*** Support for Java anonymous classes via new syntactic symbol
232inexpr-class. New syntactic symbol inexpr-statement for Pike
233support and gcc-style statements inside expressions. New lineup
234function c-lineup-inexpr-block.
235
236*** New syntactic symbol brace-entry-open which is used in brace lists
237(i.e. static initializers) when a list entry starts with an open
238brace. These used to be recognized as brace-list-entry's.
239c-electric-brace also recognizes brace-entry-open braces
240(brace-list-entry's can no longer be electrified).
241
242*** New command c-indent-line-or-region, not bound by default.
243
244*** `#' is only electric when typed in the indentation of a line.
245
246*** Parentheses are now electric (via the new command c-electric-paren)
247for auto-reindenting lines when parens are typed.
248
249*** In "gnu" style, inline-open offset is now set to zero.
250
251*** Uniform handling of the inclass syntactic symbol. The indentation
252associated with it is now always relative to the class opening brace.
253This means that the indentation behavior has changed in some
254circumstances, but only if you've put anything besides 0 on the
255class-open syntactic symbol (none of the default styles do that).
256
257** Gnus changes.
258
259*** New functionality for using Gnus as an offline newsreader has been
260added. A plethora of new commands and modes have been added. See the
261Gnus manual for the full story.
262
263*** The nndraft backend has returned, but works differently than
264before. All Message buffers are now also articles in the nndraft
265group, which is created automatically.
266
267*** `gnus-alter-header-function' can now be used to alter header
268values.
269
270*** `gnus-summary-goto-article' now accept Message-ID's.
271
272*** A new Message command for deleting text in the body of a message
273outside the region: `C-c C-v'.
274
275*** You can now post to component group in nnvirtual groups with
276`C-u C-c C-c'.
277
278*** `nntp-rlogin-program' -- new variable to ease customization.
279
280*** `C-u C-c C-c' in `gnus-article-edit-mode' will now inhibit
281re-highlighting of the article buffer.
282
283*** New element in `gnus-boring-article-headers' -- `long-to'.
284
285*** `M-i' symbolic prefix command. See the section "Symbolic
286Prefixes" in the Gnus manual for details.
287
288*** `L' and `I' in the summary buffer now take the symbolic prefix
289`a' to add the score rule to the "all.SCORE" file.
290
291*** `gnus-simplify-subject-functions' variable to allow greater
292control over simplification.
293
294*** `A T' -- new command for fetching the current thread.
295
296*** `/ T' -- new command for including the current thread in the
297limit.
298
299*** `M-RET' is a new Message command for breaking cited text.
300
301*** \\1-expressions are now valid in `nnmail-split-methods'.
302
303*** The `custom-face-lookup' function has been removed.
304If you used this function in your initialization files, you must
305rewrite them to use `face-spec-set' instead.
306
307*** Cancelling now uses the current select method. Symbolic prefix
308`a' forces normal posting method.
309
310*** New command to translate M******** sm*rtq**t*s into proper text
311-- `W d'.
312
313*** For easier debugging of nntp, you can set `nntp-record-commands'
314to a non-nil value.
315
316*** nntp now uses ~/.authinfo, a .netrc-like file, for controlling
317where and how to send AUTHINFO to NNTP servers.
318
319*** A command for editing group parameters from the summary buffer
320has been added.
321
322*** A history of where mails have been split is available.
323
324*** A new article date command has been added -- `article-date-iso8601'.
325
326*** Subjects can be simplified when threading by setting
327`gnus-score-thread-simplify'.
328
329*** A new function for citing in Message has been added --
330`message-cite-original-without-signature'.
331
332*** `article-strip-all-blank-lines' -- new article command.
333
334*** A new Message command to kill to the end of the article has
335been added.
336 167
337*** A minimum adaptive score can be specified by using the 168* Termcap AL and DL strings are understood.
338`gnus-adaptive-word-minimum' variable. 169
170 If the termcap entry defines AL and DL strings, for insertion
171 and deletion of multiple lines in one blow, Emacs now uses them.
172 This matters most on certain bit map display terminals for which
173 scrolling is comparatively slow.
339 174
340*** The "lapsed date" article header can be kept continually 175* Bias against scrolling screen far on fast terminals.
341updated by the `gnus-start-date-timer' command.
342 176
343*** Web listserv archives can be read with the nnlistserv backend. 177 Emacs now prefers to redraw a few lines rather than
178 shift them a long distance on the screen, when the terminal is fast.
344 179
345*** Old dejanews archives can now be read by nnweb. 180* New major mode, mim-mode.
181
182 This major mode is for editing MDL code. Perhaps a MDL
183 user can explain why it is not called mdl-mode.
184 You must load the library mim-mode explicitly to use this.
185
186* GNU documentation formatter `texinfo'.
187
188 The `texinfo' library defines a format for documentation
189 files which can be passed through Tex to make a printed manual
190 or passed through texinfo to make an Info file. Texinfo is
191 documented fully by its own Info file; compare this file
192 with its source, texinfo.texinfo, for additional guidance.
193
194 All documentation files for GNU utilities should be written
195 in texinfo input format.
196
197 Tex processing of texinfo files requires the Botex macro package.
198 This is not ready for distribution yet, but will appear at
199 a later time.
200
201* New function read-from-string (emacs 15.29)
346 202
347*** `gnus-posting-styles' has been re-activated. 203 read-from-string takes three arguments: a string to read from,
204 and optionally start and end indices which delimit a substring
205 from which to read. (They default to 0 and the length of the string,
206 respectively.)
348 207
349** Changes to TeX and LaTeX mode 208 This function returns a cons cell whose car is the object produced
209 by reading from the string and whose cdr is a number giving the
210 index in the string of the first character not read. That index may
211 be passed as the second argument to a later call to read-from-string
212 to read the next form represented by the string.
350 213
351*** The new variable `tex-start-options-string' can be used to give 214 In addition, the function read now accepts a string as its argument.
352options for the TeX run. The default value causes TeX to run in 215 In this case, it calls read-from-string on the whole string, and
353nonstopmode. For an interactive TeX run set it to nil or "". 216 returns the car of the result. (ie the actual object read.)
354
355*** The command `tex-feed-input' sends input to the Tex Shell. In a
356TeX buffer it is bound to the keys C-RET, C-c RET, and C-c C-m (some
357of these keys may not work on all systems). For instance, if you run
358TeX interactively and if the TeX run stops because of an error, you
359can continue it without leaving the TeX buffer by typing C-RET.
360
361*** The Tex Shell Buffer is now in `compilation-shell-minor-mode'.
362All error-parsing commands of the Compilation major mode are available
363but bound to keys that don't collide with the shell. Thus you can use
364the Tex Shell for command line executions like a usual shell.
365
366*** The commands `tex-validate-region' and `tex-validate-buffer' check
367the matching of braces and $'s. The errors are listed in a *Occur*
368buffer and you can use C-c C-c or mouse-2 to go to a particular
369mismatch.
370
371** Changes to RefTeX mode
372
373*** The table of contents buffer can now also display labels and
374file boundaries in addition to sections. Use `l', `i', and `c' keys.
375
376*** Labels derived from context (the section heading) are now
377lowercase by default. To make the label legal in LaTeX, latin-1
378characters will lose their accent. All Mule characters will be
379removed from the label.
380
381*** The automatic display of cross reference information can also use
382a window instead of the echo area. See variable `reftex-auto-view-crossref'.
383
384*** kpsewhich can be used by RefTeX to find TeX and BibTeX files. See the
385customization group `reftex-finding-files'.
386
387*** The option `reftex-bibfile-ignore-list' has been renamed to
388`reftex-bibfile-ignore-regexps' and indeed can be fed with regular
389expressions.
390
391*** Multiple Selection buffers are now hidden buffers.
392
393** New/deleted modes and packages
394
395*** The package snmp-mode.el provides major modes for editing SNMP and
396SNMPv2 MIBs. It has entries on `auto-mode-alist'.
397
398*** The package sql.el provides a major mode, M-x sql-mode, for
399editing SQL files, and M-x sql-interactive-mode for interacting with
400SQL interpreters. It has an entry on `auto-mode-alist'.
401
402*** M-x highlight-changes-mode provides a minor mode displaying buffer
403changes with a special face.
404
405*** ispell4.el has been deleted. It got in the way of ispell.el and
406this was hard to fix reliably. It has long been obsolete -- use
407Ispell 3.1 and ispell.el.
408 217
409* MS-DOS changes in Emacs 20.4 218Changes in Emacs 14
410 219
411** Emacs compiled for MS-DOS now supports MULE features better. 220* Completion now prints various messages such as [Sole Completion]
412This includes support for display of all ISO 8859-N character sets, 221 or [Next Character Not Unique] to describe the results obtained.
413conversion to and from IBM codepage encoding of non-ASCII characters, 222 These messages appear after the text in the minibuffer, and remain
414and automatic setup of the MULE environment at startup. For details, 223 on the screen until a few seconds go by or you type a key.
415check out the section `MS-DOS and MULE' in the manual. 224
416 225* The buffer-read-only flag is implemented.
417The MS-DOS installation procedure automatically configures and builds 226 Setting or binding this per-buffer variable to a non-nil value
418Emacs with input method support if it finds an unpacked Leim 227 makes illegal any operation which would modify the textual content of
419distribution when the config.bat script is run. 228 the buffer. (Such operations signal a buffer-read-only error)
420 229 The read-only state of a buffer may be altered using toggle-read-only
421** Formerly, the value of lpr-command did not affect printing on 230 (C-x C-q)
422MS-DOS unless print-region-function was set to nil, but now it 231 The buffers used by Rmail, Dired, Rnews, and Info are now read-only
423controls whether an external program is invoked or output is written 232 by default to prevent accidental damage to the information in those
424directly to a printer port. Similarly, in the previous version of 233 buffers.
425Emacs, the value of ps-lpr-command did not affect PostScript printing 234
426on MS-DOS unless ps-printer-name was set to something other than a 235* Functions car-safe and cdr-safe.
427string (eg. t or `pipe'), but now it controls whether an external 236 These functions are like car and cdr when the argument is a cons.
428program is used. (These changes were made so that configuration of 237 Given an argument not a cons, car-safe always returns nil, with
429printing variables would be almost identical across all platforms.) 238 no error; the same for cdr-safe.
430 239
431** In the previous version of Emacs, PostScript and non-PostScript 240* The new function user-real-login-name returns the name corresponding
432output was piped to external programs, but because most print programs 241 to the real uid of the Emacs process. This is usually the same
433available for MS-DOS and MS-Windows cannot read data from their standard 242 as what user-login-name returns; however, when Emacs is invoked
434input, on those systems the data to be output is now written to a 243 from su, user-real-login-name returns "root" but user-login-name
435temporary file whose name is passed as the last argument to the external 244 returns the name of the user who invoked su.
436program.
437
438An exception is made for `print', a standard program on Windows NT,
439and `nprint', a standard program on Novell Netware. For both of these
440programs, the command line is constructed in the appropriate syntax
441automatically, using only the value of printer-name or ps-printer-name
442as appropriate--the value of the relevant `-switches' variable is
443ignored, as both programs have no useful switches.
444
445** The value of the variable dos-printer (cf. dos-ps-printer), if it has
446a value, overrides the value of printer-name (cf. ps-printer-name), on
447MS-DOS and MS-Windows only. This has been true since version 20.3, but
448was not documented clearly before.
449
450** All the Emacs games now work on MS-DOS terminals.
451This includes Tetris and Snake.
452 245
453* Lisp changes in Emacs 20.4 246Changes in Emacs 13
454
455** New functions line-beginning-position and line-end-position
456return the position of the beginning or end of the current line.
457They both accept an optional argument, which has the same
458meaning as the argument to beginning-of-line or end-of-line.
459
460** find-file and allied functions now have an optional argument
461WILDCARD. If this is non-nil, they do wildcard processing,
462and visit all files that match the wildcard pattern.
463
464** Changes in the file-attributes function.
465
466*** The file size returned by file-attributes may be an integer or a float.
467It is an integer if the size fits in a Lisp integer, float otherwise.
468
469*** The inode number returned by file-attributes may be an integer (if
470the number fits in a Lisp integer) or a cons cell containing two
471integers.
472
473** The new function directory-files-and-attributes returns a list of
474files in a directory and their attributes. It accepts the same
475arguments as directory-files and has similar semantics, except that
476file names and attributes are returned.
477
478** The new function file-attributes-lessp is a helper function for
479sorting the list generated by directory-files-and-attributes. It
480accepts two arguments, each a list of a file name and its atttributes.
481It compares the file names of each according to string-lessp and
482returns the result.
483
484** The new function file-expand-wildcards expands a wildcard-pattern
485to produce a list of existing files that match the pattern.
486
487** New functions for base64 conversion:
488
489The function base64-encode-region converts a part of the buffer
490into the base64 code used in MIME. base64-decode-region
491performs the opposite conversion. Line-breaking is supported
492optionally.
493
494Functions base64-encode-string and base64-decode-string do a similar
495job on the text in a string. They return the value as a new string.
496
497**
498The new function process-running-child-p
499will tell you if a subprocess has given control of its
500terminal to its own child process.
501
502** interrupt-process and such functions have a new feature:
503when the second argument is `lambda', they send a signal
504to the running child of the subshell, if any, but if the shell
505itself owns its terminal, no signal is sent.
506
507** There are new widget types `plist' and `alist' which can
508be used for customizing variables whose values are plists or alists.
509
510** easymenu.el Now understands `:key-sequence' and `:style button'.
511:included is an alias for :visible.
512
513easy-menu-add-item now understands the values returned by
514easy-menu-remove-item and easy-menu-item-present-p. This can be used
515to move or copy menu entries.
516
517** Multibyte editing changes
518
519*** The definitions of sref and char-bytes are changed. Now, sref is
520an alias of aref and char-bytes always returns 1. This change is to
521make some Emacs Lisp code which works on 20.2 and earlier also
522work on the latest Emacs. Such code uses a combination of sref and
523char-bytes in a loop typically as below:
524 (setq char (sref str idx)
525 idx (+ idx (char-bytes idx)))
526The byte-compiler now warns that this is obsolete.
527
528If you want to know how many bytes a specific multibyte character
529(say, CH) occupies in a multibyte buffer, use this code:
530 (charset-bytes (char-charset ch))
531
532*** In multibyte mode, when you narrow a buffer to some region, and the
533region is preceded or followed by non-ASCII codes, inserting or
534deleting at the head or the end of the region may signal this error:
535
536 Byte combining across boundary of accessible buffer text inhibitted
537
538This is to avoid some bytes being combined together into a character
539across the boundary.
540
541*** The functions find-charset-region and find-charset-string include
542`unknown' in the returned list in the following cases:
543 o The current buffer or the target string is unibyte and
544 contains 8-bit characters.
545 o The current buffer or the target string is multibyte and
546 contains invalid characters.
547
548*** The functions decode-coding-region and encode-coding-region remove
549text properties of the target region. Ideally, they should correctly
550preserve text properties, but for the moment, it's hard. Removing
551text properties is better than preserving them in a less-than-correct
552way.
553
554*** prefer-coding-system sets EOL conversion of default coding systems.
555If the argument to prefer-coding-system specifies a certain type of
556end of line conversion, the default coding systems set by
557prefer-coding-system will specify that conversion type for end of line.
558
559*** The new function thai-compose-string can be used to properly
560compose Thai characters in a string.
561
562** The primitive `define-prefix-command' now takes an optional third
563argument NAME, which should be a string. It supplies the menu name
564for the created keymap. Keymaps created in order to be displayed as
565menus should always use the third argument.
566
567** The meanings of optional second arguments for read-char,
568read-event, and read-char-exclusive are flipped. Now the second
569arguments are INHERIT-INPUT-METHOD. These functions use the current
570input method (if any) if and only if INHERIT-INPUT-METHOD is non-nil.
571
572** The new function clear-this-command-keys empties out the contents
573of the vector that (this-command-keys) returns. This is useful in
574programs that read passwords, to prevent the passwords from echoing
575inadvertently as part of the next command in certain cases.
576
577** The new macro `with-temp-message' displays a temporary message in
578the echo area, while executing some Lisp code. Like `progn', it
579returns the value of the last form, but it also restores the previous
580echo area contents.
581
582 (with-temp-message MESSAGE &rest BODY)
583
584** The function `require' now takes an optional third argument
585NOERROR. If it is non-nil, then there is no error if the
586requested feature cannot be loaded.
587
588** In the function modify-face, an argument of (nil) for the
589foreground color, background color or stipple pattern
590means to clear out that attribute.
591
592** The `outer-window-id' frame property of an X frame
593gives the window number of the outermost X window for the frame.
594
595** Temporary buffers made with with-output-to-temp-buffer are now
596read-only by default, and normally use the major mode Help mode
597unless you put them in some other non-Fundamental mode before the
598end of with-output-to-temp-buffer.
599
600** The new functions gap-position and gap-size return information on
601the gap of the current buffer.
602
603** The new functions position-bytes and byte-to-position provide a way
604to convert between character positions and byte positions in the
605current buffer.
606
607** vc.el defines two new macros, `edit-vc-file' and `with-vc-file', to
608facilitate working with version-controlled files from Lisp programs.
609These macros check out a given file automatically if needed, and check
610it back in after any modifications have been made.
611
612* Installation Changes in Emacs 20.3
613
614** The default value of load-path now includes most subdirectories of
615the site-specific directories /usr/local/share/emacs/site-lisp and
616/usr/local/share/emacs/VERSION/site-lisp, in addition to those
617directories themselves. Both immediate subdirectories and
618subdirectories multiple levels down are added to load-path.
619
620Not all subdirectories are included, though. Subdirectories whose
621names do not start with a letter or digit are excluded.
622Subdirectories named RCS or CVS are excluded. Also, a subdirectory
623which contains a file named `.nosearch' is excluded. You can use
624these methods to prevent certain subdirectories from being searched.
625
626Emacs finds these subdirectories and adds them to load-path when it
627starts up. While it would be cleaner to find the subdirectories each
628time Emacs loads a file, that would be much slower.
629
630This feature is an incompatible change. If you have stored some Emacs
631Lisp files in a subdirectory of the site-lisp directory specifically
632to prevent them from being used, you will need to rename the
633subdirectory to start with a non-alphanumeric character, or create a
634`.nosearch' file in it, in order to continue to achieve the desired
635results.
636
637** Emacs no longer includes an old version of the C preprocessor from
638GCC. This was formerly used to help compile Emacs with C compilers
639that had limits on the significant length of an identifier, but in
640fact we stopped supporting such compilers some time ago.
641
642* Changes in Emacs 20.3
643
644** The new command C-x z (repeat) repeats the previous command
645including its argument. If you repeat the z afterward,
646it repeats the command additional times; thus, you can
647perform many repetitions with one keystroke per repetition.
648
649** Emacs now supports "selective undo" which undoes only within a
650specified region. To do this, set point and mark around the desired
651region and type C-u C-x u (or C-u C-_). You can then continue undoing
652further, within the same region, by repeating the ordinary undo
653command C-x u or C-_. This will keep undoing changes that were made
654within the region you originally specified, until either all of them
655are undone, or it encounters a change which crosses the edge of that
656region.
657
658In Transient Mark mode, undoing when a region is active requests
659selective undo.
660
661** If you specify --unibyte when starting Emacs, then all buffers are
662unibyte, except when a Lisp program specifically creates a multibyte
663buffer. Setting the environment variable EMACS_UNIBYTE has the same
664effect. The --no-unibyte option overrides EMACS_UNIBYTE and directs
665Emacs to run normally in multibyte mode.
666
667The option --unibyte does not affect the reading of Emacs Lisp files,
668though. If you want a Lisp file to be read in unibyte mode, use
669-*-unibyte: t;-*- on its first line. That will force Emacs to
670load that file in unibyte mode, regardless of how Emacs was started.
671
672** toggle-enable-multibyte-characters no longer has a key binding and
673no longer appears in the menu bar. We've realized that changing the
674enable-multibyte-characters variable in an existing buffer is
675something that most users not do.
676
677** You can specify a coding system to use for the next cut or paste
678operations through the window system with the command C-x RET X.
679The coding system can make a difference for communication with other
680applications.
681
682C-x RET x specifies a coding system for all subsequent cutting and
683pasting operations.
684
685** You can specify the printer to use for commands that do printing by
686setting the variable `printer-name'. Just what a printer name looks
687like depends on your operating system. You can specify a different
688printer for the Postscript printing commands by setting
689`ps-printer-name'.
690
691** Emacs now supports on-the-fly spell checking by the means of a
692minor mode. It is called M-x flyspell-mode. You don't have to remember
693any other special commands to use it, and you will hardly notice it
694except when you make a spelling error. Flyspell works by highlighting
695incorrect words as soon as they are completed or as soon as the cursor
696hits a new word.
697
698Flyspell mode works with whichever dictionary you have selected for
699Ispell in Emacs. In TeX mode, it understands TeX syntax so as not
700to be confused by TeX commands.
701
702You can correct a misspelled word by editing it into something
703correct. You can also correct it, or accept it as correct, by
704clicking on the word with Mouse-2; that gives you a pop-up menu
705of various alternative replacements and actions.
706
707Flyspell mode also proposes "automatic" corrections. M-TAB replaces
708the current misspelled word with a possible correction. If several
709corrections are made possible, M-TAB cycles through them in
710alphabetical order, or in order of decreasing likelihood if
711flyspell-sort-corrections is nil.
712
713Flyspell mode also flags an error when a word is repeated, if
714flyspell-mark-duplications-flag is non-nil.
715
716** Changes in input method usage.
717
718Now you can use arrow keys (right, left, down, up) for selecting among
719the alternatives just the same way as you do by C-f, C-b, C-n, and C-p
720respectively.
721
722You can use the ENTER key to accept the current conversion.
723
724If you type TAB to display a list of alternatives, you can select one
725of the alternatives with Mouse-2.
726
727The meaning of the variable `input-method-verbose-flag' is changed so
728that you can set it to t, nil, `default', or `complex-only'.
729
730 If the value is nil, extra guidance is never given.
731
732 If the value is t, extra guidance is always given.
733
734 If the value is `complex-only', extra guidance is always given only
735 when you are using complex input methods such as chinese-py.
736
737 If the value is `default' (this is the default), extra guidance is
738 given in the following case:
739 o When you are using a complex input method.
740 o When you are using a simple input method but not in the minibuffer.
741
742If you are using Emacs through a very slow line, setting
743input-method-verbose-flag to nil or to complex-only is a good choice,
744and if you are using an input method you are not familiar with,
745setting it to t is helpful.
746
747The old command select-input-method is now called set-input-method.
748
749In the language environment "Korean", you can use the following
750keys:
751 Shift-SPC toggle-korean-input-method
752 C-F9 quail-hangul-switch-symbol-ksc
753 F9 quail-hangul-switch-hanja
754These key bindings are canceled when you switch to another language
755environment.
756
757** The minibuffer history of file names now records the specified file
758names, not the entire minibuffer input. For example, if the
759minibuffer starts out with /usr/foo/, you might type in /etc/passwd to
760get
761
762 /usr/foo//etc/passwd
763
764which stands for the file /etc/passwd.
765
766Formerly, this used to put /usr/foo//etc/passwd in the history list.
767Now this puts just /etc/passwd in the history list.
768
769** If you are root, Emacs sets backup-by-copying-when-mismatch to t
770at startup, so that saving a file will be sure to preserve
771its owner and group.
772
773** find-func.el can now also find the place of definition of Emacs
774Lisp variables in user-loaded libraries.
775
776** C-x r t (string-rectangle) now deletes the existing rectangle
777contents before inserting the specified string on each line.
778
779** There is a new command delete-whitespace-rectangle
780which deletes whitespace starting from a particular column
781in all the lines on a rectangle. The column is specified
782by the left edge of the rectangle.
783
784** You can now store a number into a register with C-u NUMBER C-x r n REG,
785increment it by INC with C-u INC C-x r + REG (to increment by one, omit
786C-u INC), and insert it in the buffer with C-x r g REG. This is useful
787for writing keyboard macros.
788
789** The new command M-x speedbar displays a frame in which directories,
790files, and tags can be displayed, manipulated, and jumped to. The
791frame defaults to 20 characters in width, and is the same height as
792the frame that it was started from. Some major modes define
793additional commands for the speedbar, including Rmail, GUD/GDB, and
794info.
795
796** query-replace-regexp is now bound to C-M-%.
797
798** In Transient Mark mode, when the region is active, M-x
799query-replace and the other replace commands now operate on the region
800contents only.
801
802** M-x write-region, when used interactively, now asks for
803confirmation before overwriting an existing file. When you call
804the function from a Lisp program, a new optional argument CONFIRM
805says whether to ask for confirmation in this case.
806
807** If you use find-file-literally and the file is already visited
808non-literally, the command asks you whether to revisit the file
809literally. If you say no, it signals an error.
810
811** Major modes defined with the "derived mode" feature
812now use the proper name for the mode hook: WHATEVER-mode-hook.
813Formerly they used the name WHATEVER-mode-hooks, but that is
814inconsistent with Emacs conventions.
815
816** shell-command-on-region (and shell-command) reports success or
817failure if the command produces no output.
818
819** Set focus-follows-mouse to nil if your window system or window
820manager does not transfer focus to another window when you just move
821the mouse.
822
823** mouse-menu-buffer-maxlen has been renamed to
824mouse-buffer-menu-maxlen to be consistent with the other related
825function and variable names.
826
827** The new variable auto-coding-alist specifies coding systems for
828reading specific files. This has higher priority than
829file-coding-system-alist.
830
831** If you set the variable unibyte-display-via-language-environment to
832t, then Emacs displays non-ASCII characters are displayed by
833converting them to the equivalent multibyte characters according to
834the current language environment. As a result, they are displayed
835according to the current fontset.
836
837** C-q's handling of codes in the range 0200 through 0377 is changed.
838
839The codes in the range 0200 through 0237 are inserted as one byte of
840that code regardless of the values of nonascii-translation-table and
841nonascii-insert-offset.
842
843For the codes in the range 0240 through 0377, if
844enable-multibyte-characters is non-nil and nonascii-translation-table
845nor nonascii-insert-offset can't convert them to valid multibyte
846characters, they are converted to Latin-1 characters.
847
848** If you try to find a file that is not read-accessible, you now get
849an error, rather than an empty buffer and a warning.
850
851** In the minibuffer history commands M-r and M-s, an upper case
852letter in the regular expression forces case-sensitive search.
853
854** In the *Help* buffer, cross-references to commands and variables
855are inferred and hyperlinked. Use C-h m in Help mode for the relevant
856command keys.
857
858** M-x apropos-command, with a prefix argument, no longer looks for
859user option variables--instead it looks for noninteractive functions.
860
861Meanwhile, the command apropos-variable normally searches for
862user option variables; with a prefix argument, it looks at
863all variables that have documentation.
864
865** When you type a long line in the minibuffer, and the minibuffer
866shows just one line, automatically scrolling works in a special way
867that shows you overlap with the previous line of text. The variable
868minibuffer-scroll-overlap controls how many characters of overlap
869it should show; the default is 20.
870
871Meanwhile, Resize Minibuffer mode is still available; in that mode,
872the minibuffer grows taller (up to a point) as needed to show the whole
873of your input.
874
875** The new command M-x customize-changed-options lets you customize
876all the options whose meanings or default values have changed in
877recent Emacs versions. You specify a previous Emacs version number as
878argument, and the command creates a customization buffer showing all
879the customizable options which were changed since that version.
880Newly added options are included as well.
881
882If you don't specify a particular version number argument,
883then the customization buffer shows all the customizable options
884for which Emacs versions of changes are recorded.
885
886This function is also bound to the Changed Options entry in the
887Customize menu.
888
889** When you run M-x grep with a prefix argument, it figures out
890the tag around point and puts that into the default grep command.
891
892** The new command M-* (pop-tag-mark) pops back through a history of
893buffer positions from which M-. or other tag-finding commands were
894invoked.
895
896** The new variable comment-padding specifies the number of spaces
897that `comment-region' will insert before the actual text of the comment.
898The default is 1.
899
900** In Fortran mode the characters `.', `_' and `$' now have symbol
901syntax, not word syntax. Fortran mode now supports `imenu' and has
902new commands fortran-join-line (M-^) and fortran-narrow-to-subprogram
903(C-x n d). M-q can be used to fill a statement or comment block
904sensibly.
905
906** GUD now supports jdb, the Java debugger, and pdb, the Python debugger.
907 247
908** If you set the variable add-log-keep-changes-together to a non-nil 248* There is a new version numbering scheme.
909value, the command `C-x 4 a' will automatically notice when you make
910two entries in one day for one file, and combine them.
911 249
912** You can use the command M-x diary-mail-entries to mail yourself a 250 What used to be the first version number, which was 1,
913reminder about upcoming diary entries. See the documentation string 251 has been discarded since it does not seem that I need three
914for a sample shell script for calling this function automatically 252 levels of version number.
915every night.
916 253
917** Desktop changes 254 However, a new third version number has been added to represent
255 changes by user sites. This number will always be zero in
256 Emacs when I distribute it; it will be incremented each time
257 Emacs is built at another site.
918 258
919*** All you need to do to enable use of the Desktop package, is to set 259* There is now a reader syntax for Meta characters:
920the variable desktop-enable to t with Custom. 260 \M-CHAR means CHAR or'ed with the Meta bit. For example:
921 261
922*** Minor modes are now restored. Which minor modes are restored 262 ?\M-x is (+ ?x 128)
923and how modes are restored is controlled by `desktop-minor-mode-table'. 263 ?\M-\n is (+ ?\n 128)
264 ?\M-\^f is (+ ?\^f 128)
924 265
925** There is no need to do anything special, now, to enable Gnus to 266 This syntax can be used in strings too. Note, however, that
926read and post multi-lingual articles. 267 Meta characters are not meaningful in key sequences being passed
268 to define-key or lookup-key; you must use ESC characters (\e)
269 in them instead.
927 270
928** Outline mode has now support for showing hidden outlines when 271 ?\C- can be used likewise for control characters. (13.9)
929doing an isearch. In order for this to happen search-invisible should
930be set to open (the default). If an isearch match is inside a hidden
931outline the outline is made visible. If you continue pressing C-s and
932the match moves outside the formerly invisible outline, the outline is
933made invisible again.
934 272
935** Mail reading and sending changes 273* Installation change
936 274 The string "../lisp" now adds to the front of the load-path
937*** The Rmail e command now switches to displaying the whole header of 275 used for searching for Lisp files during Emacs initialization.
938the message before it lets you edit the message. This is so that any 276 It used to replace the path specified in paths.h entirely.
939changes you make in the header will not be lost if you subsequently 277 Now the directory ../lisp is searched first and the directoris
940toggle. 278 specified in paths.h are searched afterward.
941
942*** The w command in Rmail, which writes the message body into a file,
943now works in the summary buffer as well. (The command to delete the
944summary buffer is now Q.) The default file name for the w command, if
945the message has no subject, is stored in the variable
946rmail-default-body-file.
947
948*** Most of the commands and modes that operate on mail and netnews no
949longer depend on the value of mail-header-separator. Instead, they
950handle whatever separator the buffer happens to use.
951
952*** If you set mail-signature to a value which is not t, nil, or a string,
953it should be an expression. When you send a message, this expression
954is evaluated to insert the signature.
955
956*** The new Lisp library feedmail.el (version 8) enhances processing of
957outbound email messages. It works in coordination with other email
958handling packages (e.g., rmail, VM, gnus) and is responsible for
959putting final touches on messages and actually submitting them for
960transmission. Users of the emacs program "fakemail" might be
961especially interested in trying feedmail.
962
963feedmail is not enabled by default. See comments at the top of
964feedmail.el for set-up instructions. Among the bigger features
965provided by feedmail are:
966
967**** you can park outgoing messages into a disk-based queue and
968stimulate sending some or all of them later (handy for laptop users);
969there is also a queue for draft messages
970
971**** you can get one last look at the prepped outbound message and
972be prompted for confirmation
973
974**** does smart filling of address headers
975
976**** can generate a MESSAGE-ID: line and a DATE: line; the date can be
977the time the message was written or the time it is being sent; this
978can make FCC copies more closely resemble copies that recipients get
979
980**** you can specify an arbitrary function for actually transmitting
981the message; included in feedmail are interfaces for /bin/[r]mail,
982/usr/lib/sendmail, and elisp smtpmail; it's easy to write a new
983function for something else (10-20 lines of elisp)
984
985** Dired changes
986
987*** The Dired function dired-do-toggle, which toggles marked and unmarked
988files, is now bound to "t" instead of "T".
989
990*** dired-at-point has been added to ffap.el. It allows one to easily
991run Dired on the directory name at point.
992
993*** Dired has a new command: %g. It searches the contents of
994files in the directory and marks each file that contains a match
995for a specified regexp.
996
997** VC Changes
998
999*** New option vc-ignore-vc-files lets you turn off version control
1000conveniently.
1001
1002*** VC Dired has been completely rewritten. It is now much
1003faster, especially for CVS, and works very similar to ordinary
1004Dired.
1005
1006VC Dired is invoked by typing C-x v d and entering the name of the
1007directory to display. By default, VC Dired gives you a recursive
1008listing of all files at or below the given directory which are
1009currently locked (for CVS, all files not up-to-date are shown).
1010
1011You can change the listing format by setting vc-dired-recurse to nil,
1012then it shows only the given directory, and you may also set
1013vc-dired-terse-display to nil, then it shows all files under version
1014control plus the names of any subdirectories, so that you can type `i'
1015on such lines to insert them manually, as in ordinary Dired.
1016
1017All Dired commands operate normally in VC Dired, except for `v', which
1018is redefined as the version control prefix. That means you may type
1019`v l', `v =' etc. to invoke `vc-print-log', `vc-diff' and the like on
1020the file named in the current Dired buffer line. `v v' invokes
1021`vc-next-action' on this file, or on all files currently marked.
1022
1023The new command `v t' (vc-dired-toggle-terse-mode) allows you to
1024toggle between terse display (only locked files) and full display (all
1025VC files plus subdirectories). There is also a special command,
1026`* l', to mark all files currently locked.
1027
1028Giving a prefix argument to C-x v d now does the same thing as in
1029ordinary Dired: it allows you to supply additional options for the ls
1030command in the minibuffer, to fine-tune VC Dired's output.
1031
1032*** Under CVS, if you merge changes from the repository into a working
1033file, and CVS detects conflicts, VC now offers to start an ediff
1034session to resolve them.
1035
1036Alternatively, you can use the new command `vc-resolve-conflicts' to
1037resolve conflicts in a file at any time. It works in any buffer that
1038contains conflict markers as generated by rcsmerge (which is what CVS
1039uses as well).
1040
1041*** You can now transfer changes between branches, using the new
1042command vc-merge (C-x v m). It is implemented for RCS and CVS. When
1043you invoke it in a buffer under version-control, you can specify
1044either an entire branch or a pair of versions, and the changes on that
1045branch or between the two versions are merged into the working file.
1046If this results in any conflicts, they may be resolved interactively,
1047using ediff.
1048
1049** Changes in Font Lock
1050
1051*** The face and variable previously known as font-lock-reference-face
1052are now called font-lock-constant-face to better reflect their typical
1053use for highlighting constants and labels. (Its face properties are
1054unchanged.) The variable font-lock-reference-face remains for now for
1055compatibility reasons, but its value is font-lock-constant-face.
1056
1057** Frame name display changes
1058
1059*** The command set-frame-name lets you set the name of the current
1060frame. You can use the new command select-frame-by-name to select and
1061raise a frame; this is mostly useful on character-only terminals, or
1062when many frames are invisible or iconified.
1063
1064*** On character-only terminal (not a window system), changing the
1065frame name is now reflected on the mode line and in the Buffers/Frames
1066menu.
1067
1068** Comint (subshell) changes
1069
1070*** In Comint modes, the commands to kill, stop or interrupt a
1071subjob now also kill pending input. This is for compatibility
1072with ordinary shells, where the signal characters do this.
1073
1074*** There are new commands in Comint mode.
1075
1076C-c C-x fetches the "next" line from the input history;
1077that is, the line after the last line you got.
1078You can use this command to fetch successive lines, one by one.
1079
1080C-c SPC accumulates lines of input. More precisely, it arranges to
1081send the current line together with the following line, when you send
1082the following line.
1083
1084C-c C-a if repeated twice consecutively now moves to the process mark,
1085which separates the pending input from the subprocess output and the
1086previously sent input.
1087
1088C-c M-r now runs comint-previous-matching-input-from-input;
1089it searches for a previous command, using the current pending input
1090as the search string.
1091
1092*** New option compilation-scroll-output can be set to scroll
1093automatically in compilation-mode windows.
1094
1095** C mode changes
1096
1097*** Multiline macros are now handled, both as they affect indentation,
1098and as recognized syntax. New syntactic symbol cpp-macro-cont is
1099assigned to second and subsequent lines of a multiline macro
1100definition.
1101
1102*** A new style "user" which captures all non-hook-ified
1103(i.e. top-level) .emacs file variable settings and customizations.
1104Style "cc-mode" is an alias for "user" and is deprecated. "gnu"
1105style is still the default however.
1106
1107*** "java" style now conforms to Sun's JDK coding style.
1108
1109*** There are new commands c-beginning-of-defun, c-end-of-defun which
1110are alternatives which you could bind to C-M-a and C-M-e if you prefer
1111them. They do not have key bindings by default.
1112
1113*** New and improved implementations of M-a (c-beginning-of-statement)
1114and M-e (c-end-of-statement).
1115
1116*** C++ namespace blocks are supported, with new syntactic symbols
1117namespace-open, namespace-close, and innamespace.
1118
1119*** File local variable settings of c-file-style and c-file-offsets
1120makes the style variables local to that buffer only.
1121
1122*** New indentation functions c-lineup-close-paren,
1123c-indent-one-line-block, c-lineup-dont-change.
1124
1125*** Improvements (hopefully!) to the way CC Mode is loaded. You
1126should now be able to do a (require 'cc-mode) to get the entire
1127package loaded properly for customization in your .emacs file. A new
1128variable c-initialize-on-load controls this and is t by default.
1129
1130** Changes to hippie-expand.
1131
1132*** New customization variable `hippie-expand-dabbrev-skip-space'. If
1133non-nil, trailing spaces may be included in the abbreviation to search for,
1134which then gives the same behavior as the original `dabbrev-expand'.
1135
1136*** New customization variable `hippie-expand-dabbrev-as-symbol'. If
1137non-nil, characters of syntax '_' is considered part of the word when
1138expanding dynamically.
1139
1140*** New customization variable `hippie-expand-no-restriction'. If
1141non-nil, narrowed buffers are widened before they are searched.
1142
1143*** New customization variable `hippie-expand-only-buffers'. If
1144non-empty, buffers searched are restricted to the types specified in
1145this list. Useful for example when constructing new special-purpose
1146expansion functions with `make-hippie-expand-function'.
1147
1148*** Text properties of the expansion are no longer copied.
1149
1150** Changes in BibTeX mode.
1151
1152*** Any titleword matching a regexp in the new variable
1153bibtex-autokey-titleword-ignore (case sensitive) is ignored during
1154automatic key generation. This replaces variable
1155bibtex-autokey-titleword-first-ignore, which only checked for matches
1156against the first word in the title.
1157
1158*** Autokey generation now uses all words from the title, not just
1159capitalized words. To avoid conflicts with existing customizations,
1160bibtex-autokey-titleword-ignore is set up such that words starting with
1161lowerkey characters will still be ignored. Thus, if you want to use
1162lowercase words from the title, you will have to overwrite the
1163bibtex-autokey-titleword-ignore standard setting.
1164
1165*** Case conversion of names and title words for automatic key
1166generation is more flexible. Variable bibtex-autokey-preserve-case is
1167replaced by bibtex-autokey-titleword-case-convert and
1168bibtex-autokey-name-case-convert.
1169
1170** Changes in vcursor.el.
1171
1172*** Support for character terminals is available: there is a new keymap
1173and the vcursor will appear as an arrow between buffer text. A
1174variable `vcursor-interpret-input' allows input from the vcursor to be
1175entered exactly as if typed. Numerous functions, including
1176`vcursor-compare-windows', have been rewritten to improve consistency
1177in the selection of windows and corresponding keymaps.
1178
1179*** vcursor options can now be altered with M-x customize under the
1180Editing group once the package is loaded.
1181
1182*** Loading vcursor now does not define keys by default, as this is
1183generally a bad side effect. Use M-x customize to set
1184vcursor-key-bindings to t to restore the old behaviour.
1185
1186*** vcursor-auto-disable can be `copy', which turns off copying from the
1187vcursor, but doesn't disable it, after any non-vcursor command.
1188
1189** Ispell changes.
1190
1191*** You can now spell check comments and strings in the current
1192buffer with M-x ispell-comments-and-strings. Comments and strings
1193are identified by syntax tables in effect.
1194
1195*** Generic region skipping implemented.
1196A single buffer can be broken into a number of regions where text will
1197and will not be checked. The definitions of the regions can be user
1198defined. New applications and improvements made available by this
1199include:
1200
1201 o URLs are automatically skipped
1202 o EMail message checking is vastly improved.
1203
1204*** Ispell can highlight the erroneous word even on non-window terminals.
1205
1206** Changes to RefTeX mode
1207
1208RefTeX has been updated in order to make it more usable with very
1209large projects (like a several volume math book). The parser has been
1210re-written from scratch. To get maximum speed from RefTeX, check the
1211section `Optimizations' in the manual.
1212
1213*** New recursive parser.
1214
1215The old version of RefTeX created a single large buffer containing the
1216entire multifile document in order to parse the document. The new
1217recursive parser scans the individual files.
1218
1219*** Parsing only part of a document.
1220
1221Reparsing of changed document parts can now be made faster by enabling
1222partial scans. To use this feature, read the documentation string of
1223the variable `reftex-enable-partial-scans' and set the variable to t.
1224
1225 (setq reftex-enable-partial-scans t)
1226
1227*** Storing parsing information in a file.
1228
1229This can improve startup times considerably. To turn it on, use
1230
1231 (setq reftex-save-parse-info t)
1232
1233*** Using multiple selection buffers
1234
1235If the creation of label selection buffers is too slow (this happens
1236for large documents), you can reuse these buffers by setting
1237
1238 (setq reftex-use-multiple-selection-buffers t)
1239
1240*** References to external documents.
1241
1242The LaTeX package `xr' allows to cross-reference labels in external
1243documents. RefTeX can provide information about the external
1244documents as well. To use this feature, set up the \externaldocument
1245macros required by the `xr' package and rescan the document with
1246RefTeX. The external labels can then be accessed with the `x' key in
1247the selection buffer provided by `reftex-reference' (bound to `C-c )').
1248The `x' key also works in the table of contents buffer.
1249
1250*** Many more labeled LaTeX environments are recognized by default.
1251
1252The builtin command list now covers all the standard LaTeX commands,
1253and all of the major packages included in the LaTeX distribution.
1254
1255Also, RefTeX now understands the \appendix macro and changes
1256the enumeration of sections in the *toc* buffer accordingly.
1257
1258*** Mouse support for selection and *toc* buffers
1259
1260The mouse can now be used to select items in the selection and *toc*
1261buffers. See also the new option `reftex-highlight-selection'.
1262
1263*** New keymaps for selection and table of contents modes.
1264
1265The selection processes for labels and citation keys, and the table of
1266contents buffer now have their own keymaps: `reftex-select-label-map',
1267`reftex-select-bib-map', `reftex-toc-map'. The selection processes
1268have a number of new keys predefined. In particular, TAB lets you
1269enter a label with completion. Check the on-the-fly help (press `?'
1270at the selection prompt) or read the Info documentation to find out
1271more.
1272
1273*** Support for the varioref package
1274
1275The `v' key in the label selection buffer toggles \ref versus \vref.
1276
1277*** New hooks
1278
1279Three new hooks can be used to redefine the way labels, references,
1280and citations are created. These hooks are
1281`reftex-format-label-function', `reftex-format-ref-function',
1282`reftex-format-cite-function'.
1283
1284*** Citations outside LaTeX
1285
1286The command `reftex-citation' may also be used outside LaTeX (e.g. in
1287a mail buffer). See the Info documentation for details.
1288
1289*** Short context is no longer fontified.
1290
1291The short context in the label menu no longer copies the
1292fontification from the text in the buffer. If you prefer it to be
1293fontified, use
1294
1295 (setq reftex-refontify-context t)
1296
1297** file-cache-minibuffer-complete now accepts a prefix argument.
1298With a prefix argument, it does not try to do completion of
1299the file name within its directory; it only checks for other
1300directories that contain the same file name.
1301
1302Thus, given the file name Makefile, and assuming that a file
1303Makefile.in exists in the same directory, ordinary
1304file-cache-minibuffer-complete will try to complete Makefile to
1305Makefile.in and will therefore never look for other directories that
1306have Makefile. A prefix argument tells it not to look for longer
1307names such as Makefile.in, so that instead it will look for other
1308directories--just as if the name were already complete in its present
1309directory.
1310
1311** New modes and packages
1312
1313*** There is a new alternative major mode for Perl, Cperl mode.
1314It has many more features than Perl mode, and some people prefer
1315it, but some do not.
1316
1317*** There is a new major mode, M-x vhdl-mode, for editing files of VHDL
1318code.
1319
1320*** M-x which-function-mode enables a minor mode that displays the
1321current function name continuously in the mode line, as you move
1322around in a buffer.
1323
1324Which Function mode is effective in major modes which support Imenu.
1325
1326*** Gametree is a major mode for editing game analysis trees. The author
1327uses it for keeping notes about his postal Chess games, but it should
1328be helpful for other two-player games as well, as long as they have an
1329established system of notation similar to Chess.
1330
1331*** The new minor mode checkdoc-minor-mode provides Emacs Lisp
1332documentation string checking for style and spelling. The style
1333guidelines are found in the Emacs Lisp programming manual.
1334
1335*** The net-utils package makes some common networking features
1336available in Emacs. Some of these functions are wrappers around
1337system utilities (ping, nslookup, etc); others are implementations of
1338simple protocols (finger, whois) in Emacs Lisp. There are also
1339functions to make simple connections to TCP/IP ports for debugging and
1340the like.
1341
1342*** highlight-changes-mode is a minor mode that uses colors to
1343identify recently changed parts of the buffer text.
1344
1345*** The new package `midnight' lets you specify things to be done
1346within Emacs at midnight--by default, kill buffers that you have not
1347used in a considerable time. To use this feature, customize
1348the user option `midnight-mode' to t.
1349
1350*** The file generic-x.el defines a number of simple major modes.
1351
1352 apache-generic-mode: For Apache and NCSA httpd configuration files
1353 samba-generic-mode: Samba configuration files
1354 fvwm-generic-mode: For fvwm initialization files
1355 x-resource-generic-mode: For X resource files
1356 hosts-generic-mode: For hosts files (.rhosts, /etc/hosts, etc)
1357 mailagent-rules-generic-mode: For mailagent .rules files
1358 javascript-generic-mode: For JavaScript files
1359 vrml-generic-mode: For VRML files
1360 java-manifest-generic-mode: For Java MANIFEST files
1361 java-properties-generic-mode: For Java property files
1362 mailrc-generic-mode: For .mailrc files
1363
1364 Platform-specific modes:
1365
1366 prototype-generic-mode: For Solaris/Sys V prototype files
1367 pkginfo-generic-mode: For Solaris/Sys V pkginfo files
1368 alias-generic-mode: For C shell alias files
1369 inf-generic-mode: For MS-Windows INF files
1370 ini-generic-mode: For MS-Windows INI files
1371 reg-generic-mode: For MS-Windows Registry files
1372 bat-generic-mode: For MS-Windows BAT scripts
1373 rc-generic-mode: For MS-Windows Resource files
1374 rul-generic-mode: For InstallShield scripts
1375 279
1376* Lisp changes in Emacs 20.3 since the Emacs Lisp Manual was published 280Changes in Emacs 1.12
1377 281
1378** If you want a Lisp file to be read in unibyte mode, 282* There is a new installation procedure.
1379use -*-unibyte: t;-*- on its first line. 283 See the file INSTALL that comes in the top level
1380That will force Emacs to read that file in unibyte mode. 284 directory in the tar file or tape.
1381Otherwise, the file will be loaded and byte-compiled in multibyte mode. 285
1382 286* The Meta key is now supported on terminals that have it.
1383Thus, each lisp file is read in a consistent way regardless of whether 287 This is a shift key which causes the high bit to be turned on
1384you started Emacs with --unibyte, so that a Lisp program gives 288 in all input characters typed while it is held down.
1385consistent results regardless of how Emacs was started. 289
1386 290 read-char now returns a value in the range 128-255 if
1387** The new function assoc-default is useful for searching an alist, 291 a Meta character is typed. When interpreted as command
1388and using a default value if the key is not found there. You can 292 input, a Meta character is equivalent to a two character
1389specify a comparison predicate, so this function is useful for 293 sequence, the meta prefix character followed by the un-metized
1390searching comparing a string against an alist of regular expressions. 294 character (Meta-G unmetized is G).
1391 295
1392** The functions unibyte-char-to-multibyte and 296 The meta prefix character
1393multibyte-char-to-unibyte convert between unibyte and multibyte 297 is specified by the value of the variable meta-prefix-char.
1394character codes, in a way that is appropriate for the current language 298 If this character (normally Escape) has been redefined locally
1395environment. 299 with a non-prefix definition (such as happens in completing
1396 300 minibuffers) then the local redefinition is suppressed when
1397** The functions read-event, read-char and read-char-exclusive now 301 the character is not the last one in a key sequence.
1398take two optional arguments. PROMPT, if non-nil, specifies a prompt 302 So the local redefinition is effective if you type the character
1399string. SUPPRESS-INPUT-METHOD, if non-nil, says to disable the 303 explicitly, but not effective if the character comes from
1400current input method for reading this one event. 304 the use of the Meta key.
1401 305
1402** Two new variables print-escape-nonascii and print-escape-multibyte 306* `-' is no longer a completion command in the minibuffer.
1403now control whether to output certain characters as 307 It is an ordinary self-inserting character.
1404backslash-sequences. print-escape-nonascii applies to single-byte 308
1405non-ASCII characters; print-escape-multibyte applies to multibyte 309* The list load-path of directories load to search for Lisp files
1406characters. Both of these variables are used only when printing 310 is now controlled by the EMACSLOADPATH environment variable
1407in readable fashion (prin1 uses them, princ does not). 311[[ Note this was originally EMACS-LOAD-PATH and has been changed
312 again; sh does not deal properly with hyphens in env variable names]]
313 rather than the EPATH environment variable. This is to avoid
314 conflicts with other Emacses.
315
316 While Emacs is being built initially, the load-path
317 is now just ("../lisp"), ignoring paths.h. It does not
318 ignore EMACSLOADPATH, however; you should avoid having
319 this variable set while building Emacs.
320
321* You can now specify a translation table for keyboard
322 input characters, as a way of exchanging or substituting
323 keys on the keyboard.
324
325 If the value of keyboard-translate-table is a string,
326 every character received from the keyboard is used as an
327 index in that string, and the character at that index in
328 the string is used as input instead of what was actually
329 typed. If the actual input character is >= the length of
330 the string, it is used unchanged.
331
332 One way this feature can be used is to fix bad keyboard
333 designes. For example, on some terminals, Delete is
334 Shift-Underscore. Since Delete is a more useful character
335 than Underscore, it is an improvement to make the unshifted
336 character Delete and the shifted one Underscore. This can
337 be done with
338
339 ;; First make a translate table that does the identity translation.
340 (setq keyboard-translate-table (make-string 128 0))
341 (let ((i 0))
342 (while (< i 128)
343 (aset keyboard-translate-table i i)
344 (setq i (1+ i))))
345
346 ;; Now alter translations of some characters.
347 (aset keyboard-translate-table ?\_ ?\^?)
348 (aset keyboard-translate-table ?\^? ?\_)
349
350 If your terminal has a Meta key and can therefore send
351 codes up to 255, Meta characters are translated through
352 elements 128 through 255 of the translate table, and therefore
353 are translated independently of the corresponding non-Meta
354 characters. You must therefore establish translations
355 independently for the Meta characters if you want them too:
356
357 ;; First make a translate table that does the identity translation.
358 (setq keyboard-translate-table (make-string 256 0))
359 (let ((i 0))
360 (while (< i 256)
361 (aset keyboard-translate-table i i)
362 (setq i (1+ i))))
363
364 ;; Now alter translations of some characters.
365 (aset keyboard-translate-table ?\_ ?\^?)
366 (aset keyboard-translate-table ?\^? ?\_)
367
368 ;; Now alter translations of some Meta characters.
369 (aset keyboard-translate-table (+ 128 ?\_) (+ 128 ?\^?))
370 (aset keyboard-translate-table (+ 128 ?\^?) (+ 128 ?\_))
371
372* (process-kill-without-query PROCESS)
373
374This marks the process so that, when you kill Emacs,
375you will not on its account be queried about active subprocesses.
1408 376
1409* Lisp changes in Emacs 20.3 before the Emacs Lisp Manual was published 377Changes in Emacs 1.11
1410 378
1411** Compiled Emacs Lisp files made with the modified "MBSK" version 379* The commands C-c and C-z have been interchanged,
1412of Emacs 20.2 do not work in Emacs 20.3. 380 for greater compatibility with normal Unix usage.
1413 381 C-z now runs suspend-emacs and C-c runs exit-recursive-edit.
1414** Buffer positions are now measured in characters, as they were 382
1415in Emacs 19 and before. This means that (forward-char 1) 383* The value returned by file-name-directory now ends
1416always increases point by 1. 384 with a slash. (file-name-directory "foo/bar") => "foo/".
1417 385 This avoids confusing results when dealing with files
1418The function chars-in-region now just subtracts its arguments. It is 386 in the root directory.
1419considered obsolete. The function char-boundary-p has been deleted. 387
1420 388 The value of the per-buffer variable default-directory
1421See below for additional changes relating to multibyte characters. 389 is also supposed to have a final slash now.
1422 390
1423** defcustom, defface and defgroup now accept the keyword `:version'. 391* There are now variables to control the switches passed to
1424Use this to specify in which version of Emacs a certain variable's 392 `ls' by the C-x C-d command (list-directory).
1425default value changed. For example, 393 list-directory-brief-switches is a string, initially "-CF",
1426 394 used for brief listings, and list-directory-verbose-switches
1427 (defcustom foo-max 34 "*Maximum number of foo's allowed." 395 is a string, initially "-l", used for verbose ones.
1428 :type 'integer 396
1429 :group 'foo 397* For Ann Arbor Ambassador terminals, the termcap "ti" string
1430 :version "20.3") 398 is now used to initialize the screen geometry on entry to Emacs,
1431 399 and the "te" string is used to set it back on exit.
1432 (defgroup foo-group nil "The foo group." 400 If the termcap entry does not define the "ti" or "te" string,
1433 :version "20.3") 401 Emacs does what it used to do.
1434
1435If an entire new group is added or the variables in it have the
1436default values changed, then just add a `:version' to that group. It
1437is recommended that new packages added to the distribution contain a
1438`:version' in the top level group.
1439
1440This information is used to control the customize-changed-options command.
1441
1442** It is now an error to change the value of a symbol whose name
1443starts with a colon--if it is interned in the standard obarray.
1444
1445However, setting such a symbol to its proper value, which is that
1446symbol itself, is not an error. This is for the sake of programs that
1447support previous Emacs versions by explicitly setting these variables
1448to themselves.
1449
1450If you set the variable keyword-symbols-constant-flag to nil,
1451this error is suppressed, and you can set these symbols to any
1452values whatever.
1453
1454** There is a new debugger command, R.
1455It evaluates an expression like e, but saves the result
1456in the buffer *Debugger-record*.
1457
1458** Frame-local variables.
1459
1460You can now make a variable local to various frames. To do this, call
1461the function make-variable-frame-local; this enables frames to have
1462local bindings for that variable.
1463
1464These frame-local bindings are actually frame parameters: you create a
1465frame-local binding in a specific frame by calling
1466modify-frame-parameters and specifying the variable name as the
1467parameter name.
1468
1469Buffer-local bindings take precedence over frame-local bindings.
1470Thus, if the current buffer has a buffer-local binding, that binding is
1471active; otherwise, if the selected frame has a frame-local binding,
1472that binding is active; otherwise, the default binding is active.
1473
1474It would not be hard to implement window-local bindings, but it is not
1475clear that this would be very useful; windows tend to come and go in a
1476very transitory fashion, so that trying to produce any specific effect
1477through a window-local binding would not be very robust.
1478
1479** `sregexq' and `sregex' are two new functions for constructing
1480"symbolic regular expressions." These are Lisp expressions that, when
1481evaluated, yield conventional string-based regexps. The symbolic form
1482makes it easier to construct, read, and maintain complex patterns.
1483See the documentation in sregex.el.
1484
1485** parse-partial-sexp's return value has an additional element which
1486is used to pass information along if you pass it to another call to
1487parse-partial-sexp, starting its scan where the first call ended.
1488The contents of this field are not yet finalized.
1489
1490** eval-region now accepts a fourth optional argument READ-FUNCTION.
1491If it is non-nil, that function is used instead of `read'.
1492
1493** unload-feature by default removes the feature's functions from
1494known hooks to avoid trouble, but a package providing FEATURE can
1495define a hook FEATURE-unload-hook to be run by unload-feature instead.
1496
1497** read-from-minibuffer no longer returns the argument DEFAULT-VALUE
1498when the user enters empty input. It now returns the null string, as
1499it did in Emacs 19. The default value is made available in the
1500history via M-n, but it is not applied here as a default.
1501
1502The other, more specialized minibuffer-reading functions continue to
1503return the default value (not the null string) when the user enters
1504empty input.
1505
1506** The new variable read-buffer-function controls which routine to use
1507for selecting buffers. For example, if you set this variable to
1508`iswitchb-read-buffer', iswitchb will be used to read buffer names.
1509Other functions can also be used if they accept the same arguments as
1510`read-buffer' and return the selected buffer name as a string.
1511
1512** The new function read-passwd reads a password from the terminal,
1513echoing a period for each character typed. It takes three arguments:
1514a prompt string, a flag which says "read it twice to make sure", and a
1515default password to use if the user enters nothing.
1516
1517** The variable fill-nobreak-predicate gives major modes a way to
1518specify not to break a line at certain places. Its value is a
1519function which is called with no arguments, with point located at the
1520place where a break is being considered. If the function returns
1521non-nil, then the line won't be broken there.
1522
1523** window-end now takes an optional second argument, UPDATE.
1524If this is non-nil, then the function always returns an accurate
1525up-to-date value for the buffer position corresponding to the
1526end of the window, even if this requires computation.
1527
1528** other-buffer now takes an optional argument FRAME
1529which specifies which frame's buffer list to use.
1530If it is nil, that means use the selected frame's buffer list.
1531
1532** The new variable buffer-display-time, always local in every buffer,
1533holds the value of (current-time) as of the last time that a window
1534was directed to display this buffer.
1535
1536** It is now meaningful to compare two window-configuration objects
1537with `equal'. Two window-configuration objects are equal if they
1538describe equivalent arrangements of windows, in the same frame--in
1539other words, if they would give the same results if passed to
1540set-window-configuration.
1541
1542** compare-window-configurations is a new function that compares two
1543window configurations loosely. It ignores differences in saved buffer
1544positions and scrolling, and considers only the structure and sizes of
1545windows and the choice of buffers to display.
1546
1547** The variable minor-mode-overriding-map-alist allows major modes to
1548override the key bindings of a minor mode. The elements of this alist
1549look like the elements of minor-mode-map-alist: (VARIABLE . KEYMAP).
1550
1551If the VARIABLE in an element of minor-mode-overriding-map-alist has a
1552non-nil value, the paired KEYMAP is active, and totally overrides the
1553map (if any) specified for the same variable in minor-mode-map-alist.
1554
1555minor-mode-overriding-map-alist is automatically local in all buffers,
1556and it is meant to be set by major modes.
1557
1558** The function match-string-no-properties is like match-string
1559except that it discards all text properties from the result.
1560
1561** The function load-average now accepts an optional argument
1562USE-FLOATS. If it is non-nil, the load average values are returned as
1563floating point numbers, rather than as integers to be divided by 100.
1564
1565** The new variable temporary-file-directory specifies the directory
1566to use for creating temporary files. The default value is determined
1567in a reasonable way for your operating system; on GNU and Unix systems
1568it is based on the TMP and TMPDIR environment variables.
1569
1570** Menu changes
1571
1572*** easymenu.el now uses the new menu item format and supports the
1573keywords :visible and :filter. The existing keyword :keys is now
1574better supported.
1575
1576The variable `easy-menu-precalculate-equivalent-keybindings' controls
1577a new feature which calculates keyboard equivalents for the menu when
1578you define the menu. The default is t. If you rarely use menus, you
1579can set the variable to nil to disable this precalculation feature;
1580then the calculation is done only if you use the menu bar.
1581
1582*** A new format for menu items is supported.
1583
1584In a keymap, a key binding that has the format
1585 (STRING . REAL-BINDING) or (STRING HELP-STRING . REAL-BINDING)
1586defines a menu item. Now a menu item definition may also be a list that
1587starts with the symbol `menu-item'.
1588
1589The format is:
1590 (menu-item ITEM-NAME) or
1591 (menu-item ITEM-NAME REAL-BINDING . ITEM-PROPERTY-LIST)
1592where ITEM-NAME is an expression which evaluates to the menu item
1593string, and ITEM-PROPERTY-LIST has the form of a property list.
1594The supported properties include
1595
1596:enable FORM Evaluate FORM to determine whether the
1597 item is enabled.
1598:visible FORM Evaluate FORM to determine whether the
1599 item should appear in the menu.
1600:filter FILTER-FN
1601 FILTER-FN is a function of one argument,
1602 which will be REAL-BINDING.
1603 It should return a binding to use instead.
1604:keys DESCRIPTION
1605 DESCRIPTION is a string that describes an equivalent keyboard
1606 binding for for REAL-BINDING. DESCRIPTION is expanded with
1607 `substitute-command-keys' before it is used.
1608:key-sequence KEY-SEQUENCE
1609 KEY-SEQUENCE is a key-sequence for an equivalent
1610 keyboard binding.
1611:key-sequence nil
1612 This means that the command normally has no
1613 keyboard equivalent.
1614:help HELP HELP is the extra help string (not currently used).
1615:button (TYPE . SELECTED)
1616 TYPE is :toggle or :radio.
1617 SELECTED is a form, to be evaluated, and its
1618 value says whether this button is currently selected.
1619
1620Buttons are at the moment only simulated by prefixes in the menu.
1621Eventually ordinary X-buttons may be supported.
1622
1623(menu-item ITEM-NAME) defines unselectable item.
1624
1625** New event types
1626
1627*** The new event type `mouse-wheel' is generated by a wheel on a
1628mouse (such as the MS Intellimouse). The event contains a delta that
1629corresponds to the amount and direction that the wheel is rotated,
1630which is typically used to implement a scroll or zoom. The format is:
1631
1632 (mouse-wheel POSITION DELTA)
1633
1634where POSITION is a list describing the position of the event in the
1635same format as a mouse-click event, and DELTA is a signed number
1636indicating the number of increments by which the wheel was rotated. A
1637negative DELTA indicates that the wheel was rotated backwards, towards
1638the user, and a positive DELTA indicates that the wheel was rotated
1639forward, away from the user.
1640
1641As of now, this event type is generated only on MS Windows.
1642
1643*** The new event type `drag-n-drop' is generated when a group of
1644files is selected in an application outside of Emacs, and then dragged
1645and dropped onto an Emacs frame. The event contains a list of
1646filenames that were dragged and dropped, which are then typically
1647loaded into Emacs. The format is:
1648
1649 (drag-n-drop POSITION FILES)
1650
1651where POSITION is a list describing the position of the event in the
1652same format as a mouse-click event, and FILES is the list of filenames
1653that were dragged and dropped.
1654
1655As of now, this event type is generated only on MS Windows.
1656
1657** Changes relating to multibyte characters.
1658
1659*** The variable enable-multibyte-characters is now read-only;
1660any attempt to set it directly signals an error. The only way
1661to change this value in an existing buffer is with set-buffer-multibyte.
1662
1663*** In a string constant, `\ ' now stands for "nothing at all". You
1664can use it to terminate a hex escape which is followed by a character
1665that could otherwise be read as part of the hex escape.
1666
1667*** String indices are now measured in characters, as they were
1668in Emacs 19 and before.
1669
1670The function chars-in-string has been deleted.
1671The function concat-chars has been renamed to `string'.
1672
1673*** The function set-buffer-multibyte sets the flag in the current
1674buffer that says whether the buffer uses multibyte representation or
1675unibyte representation. If the argument is nil, it selects unibyte
1676representation. Otherwise it selects multibyte representation.
1677
1678This function does not change the contents of the buffer, viewed
1679as a sequence of bytes. However, it does change the contents
1680viewed as characters; a sequence of two bytes which is treated as
1681one character when the buffer uses multibyte representation
1682will count as two characters using unibyte representation.
1683
1684This function sets enable-multibyte-characters to record which
1685representation is in use. It also adjusts various data in the buffer
1686(including its markers, overlays and text properties) so that they are
1687consistent with the new representation.
1688
1689*** string-make-multibyte takes a string and converts it to multibyte
1690representation. Most of the time, you don't need to care
1691about the representation, because Emacs converts when necessary;
1692however, it makes a difference when you compare strings.
1693
1694The conversion of non-ASCII characters works by adding the value of
1695nonascii-insert-offset to each character, or by translating them
1696using the table nonascii-translation-table.
1697
1698*** string-make-unibyte takes a string and converts it to unibyte
1699representation. Most of the time, you don't need to care about the
1700representation, but it makes a difference when you compare strings.
1701
1702The conversion from multibyte to unibyte representation
1703loses information; the only time Emacs performs it automatically
1704is when inserting a multibyte string into a unibyte buffer.
1705
1706*** string-as-multibyte takes a string, and returns another string
1707which contains the same bytes, but treats them as multibyte.
1708
1709*** string-as-unibyte takes a string, and returns another string
1710which contains the same bytes, but treats them as unibyte.
1711
1712*** The new function compare-strings lets you compare
1713portions of two strings. Unibyte strings are converted to multibyte,
1714so that a unibyte string can match a multibyte string.
1715You can specify whether to ignore case or not.
1716
1717*** assoc-ignore-case now uses compare-strings so that
1718it can treat unibyte and multibyte strings as equal.
1719
1720*** Regular expression operations and buffer string searches now
1721convert the search pattern to multibyte or unibyte to accord with the
1722buffer or string being searched.
1723
1724One consequence is that you cannot always use \200-\377 inside of
1725[...] to match all non-ASCII characters. This does still work when
1726searching or matching a unibyte buffer or string, but not when
1727searching or matching a multibyte string. Unfortunately, there is no
1728obvious choice of syntax to use within [...] for that job. But, what
1729you want is just to match all non-ASCII characters, the regular
1730expression [^\0-\177] works for it.
1731
1732*** Structure of coding system changed.
1733
1734All coding systems (including aliases and subsidiaries) are named
1735by symbols; the symbol's `coding-system' property is a vector
1736which defines the coding system. Aliases share the same vector
1737as the principal name, so that altering the contents of this
1738vector affects the principal name and its aliases. You can define
1739your own alias name of a coding system by the function
1740define-coding-system-alias.
1741
1742The coding system definition includes a property list of its own. Use
1743the new functions `coding-system-get' and `coding-system-put' to
1744access such coding system properties as post-read-conversion,
1745pre-write-conversion, character-translation-table-for-decode,
1746character-translation-table-for-encode, mime-charset, and
1747safe-charsets. For instance, (coding-system-get 'iso-latin-1
1748'mime-charset) gives the corresponding MIME-charset parameter
1749`iso-8859-1'.
1750
1751Among the coding system properties listed above, safe-charsets is new.
1752The value of this property is a list of character sets which this
1753coding system can correctly encode and decode. For instance:
1754(coding-system-get 'iso-latin-1 'safe-charsets) => (ascii latin-iso8859-1)
1755
1756Here, "correctly encode" means that the encoded character sets can
1757also be handled safely by systems other than Emacs as far as they
1758are capable of that coding system. Though, Emacs itself can encode
1759the other character sets and read it back correctly.
1760
1761*** The new function select-safe-coding-system can be used to find a
1762proper coding system for encoding the specified region or string.
1763This function requires a user interaction.
1764
1765*** The new functions find-coding-systems-region and
1766find-coding-systems-string are helper functions used by
1767select-safe-coding-system. They return a list of all proper coding
1768systems to encode a text in some region or string. If you don't want
1769a user interaction, use one of these functions instead of
1770select-safe-coding-system.
1771
1772*** The explicit encoding and decoding functions, such as
1773decode-coding-region and encode-coding-string, now set
1774last-coding-system-used to reflect the actual way encoding or decoding
1775was done.
1776
1777*** The new function detect-coding-with-language-environment can be
1778used to detect a coding system of text according to priorities of
1779coding systems used by some specific language environment.
1780
1781*** The functions detect-coding-region and detect-coding-string always
1782return a list if the arg HIGHEST is nil. Thus, if only ASCII
1783characters are found, they now return a list of single element
1784`undecided' or its subsidiaries.
1785
1786*** The new functions coding-system-change-eol-conversion and
1787coding-system-change-text-conversion can be used to get a different
1788coding system than what specified only in how end-of-line or text is
1789converted.
1790
1791*** The new function set-selection-coding-system can be used to set a
1792coding system for communicating with other X clients.
1793
1794*** The function `map-char-table' now passes as argument only valid
1795character codes, plus generic characters that stand for entire
1796character sets or entire subrows of a character set. In other words,
1797each time `map-char-table' calls its FUNCTION argument, the key value
1798either will be a valid individual character code, or will stand for a
1799range of characters.
1800
1801*** The new function `char-valid-p' can be used for checking whether a
1802Lisp object is a valid character code or not.
1803
1804*** The new function `charset-after' returns a charset of a character
1805in the current buffer at position POS.
1806
1807*** Input methods are now implemented using the variable
1808input-method-function. If this is non-nil, its value should be a
1809function; then, whenever Emacs reads an input event that is a printing
1810character with no modifier bits, it calls that function, passing the
1811event as an argument. Often this function will read more input, first
1812binding input-method-function to nil.
1813
1814The return value should be a list of the events resulting from input
1815method processing. These events will be processed sequentially as
1816input, before resorting to unread-command-events. Events returned by
1817the input method function are not passed to the input method function,
1818not even if they are printing characters with no modifier bits.
1819
1820The input method function is not called when reading the second and
1821subsequent events of a key sequence.
1822
1823*** You can customize any language environment by using
1824set-language-environment-hook and exit-language-environment-hook.
1825
1826The hook `exit-language-environment-hook' should be used to undo
1827customizations that you made with set-language-environment-hook. For
1828instance, if you set up a special key binding for a specific language
1829environment by set-language-environment-hook, you should set up
1830exit-language-environment-hook to restore the normal key binding.
1831 402
1832* Changes in Emacs 20.1 403Changes in Emacs 1.10
1833 404
1834** Emacs has a new facility for customization of its many user 405* GNU Emacs has been made almost 1/3 smaller.
1835options. It is called M-x customize. With this facility you can look 406 It now dumps out as only 530kbytes on Vax 4.2bsd.
1836at the many user options in an organized way; they are grouped into a 407
1837tree structure. 408* The term "checkpoint" has been replaced by "auto save"
1838 409 throughout the function names, variable names and documentation
1839M-x customize also knows what sorts of values are legitimate for each 410 of GNU Emacs.
1840user option and ensures that you don't use invalid values. 411
1841 412* The function load now tries appending ".elc" and ".el"
1842With M-x customize, you can set options either for the present Emacs 413 to the specified filename BEFORE it tries the filename
1843session or permanently. (Permanent settings are stored automatically 414 without change.
1844in your .emacs file.) 415
1845 416* rmail now makes the mode line display the total number
1846** Scroll bars are now on the left side of the window. 417 of messages and the current message number.
1847You can change this with M-x customize-option scroll-bar-mode. 418 The "f" command now means forward a message to another user.
1848 419 The command to search through all messages for a string is now "F".
1849** The mode line no longer includes the string `Emacs'. 420 The "u" command now means to move back to the previous
1850This makes more space in the mode line for other information. 421 message and undelete it. To undelete the selected message, use Meta-u.
1851 422
1852** When you select a region with the mouse, it is highlighted 423* The hyphen character is now equivalent to a Space while
1853immediately afterward. At that time, if you type the DELETE key, it 424 in completing minibuffers. Both mean to complete an additional word.
1854kills the region. 425
1855 426* The Lisp function error now takes args like format
1856The BACKSPACE key, and the ASCII character DEL, do not do this; they 427 which are used to construct the error message.
1857delete the character before point, as usual. 428
1858 429* Redisplay will refuse to start its display at the end of the buffer.
1859** In an incremental search the whole current match is highlighted 430 It will pick a new place to display from, rather than use that.
1860on terminals which support this. (You can disable this feature 431
1861by setting search-highlight to nil.) 432* The value returned by garbage-collect has been changed.
1862 433 Its first element is no longer a number but a cons,
1863** In the minibuffer, in some cases, you can now use M-n to 434 whose car is the number of cons cells now in use,
1864insert the default value into the minibuffer as text. In effect, 435 and whose cdr is the number of cons cells that have been
1865the default value (if the minibuffer routines know it) is tacked 436 made but are now free.
1866onto the history "in the future". (The more normal use of the 437 The second element is similar but describes symbols rather than cons cells.
1867history list is to use M-p to insert minibuffer input used in the 438 The third element is similar but describes markers.
1868past.) 439
1869 440* The variable buffer-name has been eliminated.
1870** In Text mode, now only blank lines separate paragraphs. 441 The function buffer-name still exists. This is to prevent
1871This makes it possible to get the full benefit of Adaptive Fill mode 442 user programs from changing buffer names without going
1872in Text mode, and other modes derived from it (such as Mail mode). 443 through the rename-buffer function.
1873TAB in Text mode now runs the command indent-relative; this
1874makes a practical difference only when you use indented paragraphs.
1875
1876As a result, the old Indented Text mode is now identical to Text mode,
1877and is an alias for it.
1878
1879If you want spaces at the beginning of a line to start a paragraph,
1880use the new mode, Paragraph Indent Text mode.
1881
1882** Scrolling changes
1883
1884*** Scroll commands to scroll a whole screen now preserve the screen
1885position of the cursor, if scroll-preserve-screen-position is non-nil.
1886
1887In this mode, if you scroll several screens back and forth, finishing
1888on the same screen where you started, the cursor goes back to the line
1889where it started.
1890
1891*** If you set scroll-conservatively to a small number, then when you
1892move point a short distance off the screen, Emacs will scroll the
1893screen just far enough to bring point back on screen, provided that
1894does not exceed `scroll-conservatively' lines.
1895
1896*** The new variable scroll-margin says how close point can come to the
1897top or bottom of a window. It is a number of screen lines; if point
1898comes within that many lines of the top or bottom of the window, Emacs
1899recenters the window.
1900
1901** International character set support (MULE)
1902
1903Emacs now supports a wide variety of international character sets,
1904including European variants of the Latin alphabet, as well as Chinese,
1905Devanagari (Hindi and Marathi), Ethiopian, Greek, IPA, Japanese,
1906Korean, Lao, Russian, Thai, Tibetan, and Vietnamese scripts. These
1907features have been merged from the modified version of Emacs known as
1908MULE (for "MULti-lingual Enhancement to GNU Emacs")
1909
1910Users of these scripts have established many more-or-less standard
1911coding systems for storing files. Emacs uses a single multibyte
1912character encoding within Emacs buffers; it can translate from a wide
1913variety of coding systems when reading a file and can translate back
1914into any of these coding systems when saving a file.
1915
1916Keyboards, even in the countries where these character sets are used,
1917generally don't have keys for all the characters in them. So Emacs
1918supports various "input methods", typically one for each script or
1919language, to make it possible to type them.
1920
1921The Emacs internal multibyte encoding represents a non-ASCII
1922character as a sequence of bytes in the range 0200 through 0377.
1923
1924The new prefix key C-x RET is used for commands that pertain
1925to multibyte characters, coding systems, and input methods.
1926
1927You can disable multibyte character support as follows:
1928
1929 (setq-default enable-multibyte-characters nil)
1930
1931Calling the function standard-display-european turns off multibyte
1932characters, unless you specify a non-nil value for the second
1933argument, AUTO. This provides compatibility for people who are
1934already using standard-display-european to continue using unibyte
1935characters for their work until they want to change.
1936
1937*** Input methods
1938
1939An input method is a kind of character conversion which is designed
1940specifically for interactive input. In Emacs, typically each language
1941has its own input method (though sometimes several languages which use
1942the same characters can share one input method). Some languages
1943support several input methods.
1944
1945The simplest kind of input method works by mapping ASCII letters into
1946another alphabet. This is how the Greek and Russian input methods
1947work.
1948
1949A more powerful technique is composition: converting sequences of
1950characters into one letter. Many European input methods use
1951composition to produce a single non-ASCII letter from a sequence which
1952consists of a letter followed by diacritics. For example, a' is one
1953sequence of two characters that might be converted into a single
1954letter.
1955
1956The input methods for syllabic scripts typically use mapping followed
1957by conversion. The input methods for Thai and Korean work this way.
1958First, letters are mapped into symbols for particular sounds or tone
1959marks; then, sequences of these which make up a whole syllable are
1960mapped into one syllable sign--most often a "composite character".
1961
1962None of these methods works very well for Chinese and Japanese, so
1963they are handled specially. First you input a whole word using
1964phonetic spelling; then, after the word is in the buffer, Emacs
1965converts it into one or more characters using a large dictionary.
1966
1967Since there is more than one way to represent a phonetically spelled
1968word using Chinese characters, Emacs can only guess which one to use;
1969typically these input methods give you a way to say "guess again" if
1970the first guess is wrong.
1971
1972*** The command C-x RET m (toggle-enable-multibyte-characters)
1973turns multibyte character support on or off for the current buffer.
1974
1975If multibyte character support is turned off in a buffer, then each
1976byte is a single character, even codes 0200 through 0377--exactly as
1977they did in Emacs 19.34. This includes the features for support for
1978the European characters, ISO Latin-1 and ISO Latin-2.
1979
1980However, there is no need to turn off multibyte character support to
1981use ISO Latin-1 or ISO Latin-2; the Emacs multibyte character set
1982includes all the characters in these character sets, and Emacs can
1983translate automatically to and from either one.
1984
1985*** Visiting a file in unibyte mode.
1986
1987Turning off multibyte character support in the buffer after visiting a
1988file with multibyte code conversion will display the multibyte
1989sequences already in the buffer, byte by byte. This is probably not
1990what you want.
1991
1992If you want to edit a file of unibyte characters (Latin-1, for
1993example), you can do it by specifying `no-conversion' as the coding
1994system when reading the file. This coding system also turns off
1995multibyte characters in that buffer.
1996
1997If you turn off multibyte character support entirely, this turns off
1998character conversion as well.
1999
2000*** Displaying international characters on X Windows.
2001
2002A font for X typically displays just one alphabet or script.
2003Therefore, displaying the entire range of characters Emacs supports
2004requires using many fonts.
2005
2006Therefore, Emacs now supports "fontsets". Each fontset is a
2007collection of fonts, each assigned to a range of character codes.
2008
2009A fontset has a name, like a font. Individual fonts are defined by
2010the X server; fontsets are defined within Emacs itself. But once you
2011have defined a fontset, you can use it in a face or a frame just as
2012you would use a font.
2013
2014If a fontset specifies no font for a certain character, or if it
2015specifies a font that does not exist on your system, then it cannot
2016display that character. It will display an empty box instead.
2017
2018The fontset height and width are determined by the ASCII characters
2019(that is, by the font in the fontset which is used for ASCII
2020characters). If another font in the fontset has a different height,
2021or the wrong width, then characters assigned to that font are clipped,
2022and displayed within a box if highlight-wrong-size-font is non-nil.
2023
2024*** Defining fontsets.
2025
2026Emacs does not use any fontset by default. Its default font is still
2027chosen as in previous versions. You can tell Emacs to use a fontset
2028with the `-fn' option or the `Font' X resource.
2029
2030Emacs creates a standard fontset automatically according to the value
2031of standard-fontset-spec. This fontset's short name is
2032`fontset-standard'. Bold, italic, and bold-italic variants of the
2033standard fontset are created automatically.
2034
2035If you specify a default ASCII font with the `Font' resource or `-fn'
2036argument, a fontset is generated from it. This works by replacing the
2037FOUNDARY, FAMILY, ADD_STYLE, and AVERAGE_WIDTH fields of the font name
2038with `*' then using this to specify a fontset. This fontset's short
2039name is `fontset-startup'.
2040
2041Emacs checks resources of the form Fontset-N where N is 0, 1, 2...
2042The resource value should have this form:
2043 FONTSET-NAME, [CHARSET-NAME:FONT-NAME]...
2044FONTSET-NAME should have the form of a standard X font name, except:
2045 * most fields should be just the wild card "*".
2046 * the CHARSET_REGISTRY field should be "fontset"
2047 * the CHARSET_ENCODING field can be any nickname of the fontset.
2048The construct CHARSET-NAME:FONT-NAME can be repeated any number
2049of times; each time specifies the font for one character set.
2050CHARSET-NAME should be the name name of a character set, and
2051FONT-NAME should specify an actual font to use for that character set.
2052
2053Each of these fontsets has an alias which is made from the
2054last two font name fields, CHARSET_REGISTRY and CHARSET_ENCODING.
2055You can refer to the fontset by that alias or by its full name.
2056
2057For any character sets that you don't mention, Emacs tries to choose a
2058font by substituting into FONTSET-NAME. For instance, with the
2059following resource,
2060 Emacs*Fontset-0: -*-fixed-medium-r-normal-*-24-*-*-*-*-*-fontset-24
2061the font for ASCII is generated as below:
2062 -*-fixed-medium-r-normal-*-24-*-ISO8859-1
2063Here is the substitution rule:
2064 Change CHARSET_REGISTRY and CHARSET_ENCODING to that of the charset
2065 defined in the variable x-charset-registries. For instance, ASCII has
2066 the entry (ascii . "ISO8859-1") in this variable. Then, reduce
2067 sequences of wild cards -*-...-*- with a single wildcard -*-.
2068 (This is to prevent use of auto-scaled fonts.)
2069
2070The function which processes the fontset resource value to create the
2071fontset is called create-fontset-from-fontset-spec. You can also call
2072that function explicitly to create a fontset.
2073
2074With the X resource Emacs.Font, you can specify a fontset name just
2075like an actual font name. But be careful not to specify a fontset
2076name in a wildcard resource like Emacs*Font--that tries to specify the
2077fontset for other purposes including menus, and they cannot handle
2078fontsets.
2079
2080*** The command M-x set-language-environment sets certain global Emacs
2081defaults for a particular choice of language.
2082
2083Selecting a language environment typically specifies a default input
2084method and which coding systems to recognize automatically when
2085visiting files. However, it does not try to reread files you have
2086already visited; the text in those buffers is not affected. The
2087language environment may also specify a default choice of coding
2088system for new files that you create.
2089
2090It makes no difference which buffer is current when you use
2091set-language-environment, because these defaults apply globally to the
2092whole Emacs session.
2093
2094For example, M-x set-language-environment RET Latin-1 RET
2095chooses the Latin-1 character set. In the .emacs file, you can do this
2096with (set-language-environment "Latin-1").
2097
2098*** The command C-x RET f (set-buffer-file-coding-system)
2099specifies the file coding system for the current buffer. This
2100specifies what sort of character code translation to do when saving
2101the file. As an argument, you must specify the name of one of the
2102coding systems that Emacs supports.
2103
2104*** The command C-x RET c (universal-coding-system-argument)
2105lets you specify a coding system when you read or write a file.
2106This command uses the minibuffer to read a coding system name.
2107After you exit the minibuffer, the specified coding system
2108is used for *the immediately following command*.
2109
2110So if the immediately following command is a command to read or
2111write a file, it uses the specified coding system for that file.
2112
2113If the immediately following command does not use the coding system,
2114then C-x RET c ultimately has no effect.
2115
2116For example, C-x RET c iso-8859-1 RET C-x C-f temp RET
2117visits the file `temp' treating it as ISO Latin-1.
2118
2119*** You can specify the coding system for a file using the -*-
2120construct. Include `coding: CODINGSYSTEM;' inside the -*-...-*-
2121to specify use of coding system CODINGSYSTEM. You can also
2122specify the coding system in a local variable list at the end
2123of the file.
2124
2125*** The command C-x RET t (set-terminal-coding-system) specifies
2126the coding system for terminal output. If you specify a character
2127code for terminal output, all characters output to the terminal are
2128translated into that character code.
2129
2130This feature is useful for certain character-only terminals built in
2131various countries to support the languages of those countries.
2132
2133By default, output to the terminal is not translated at all.
2134
2135*** The command C-x RET k (set-keyboard-coding-system) specifies
2136the coding system for keyboard input.
2137
2138Character code translation of keyboard input is useful for terminals
2139with keys that send non-ASCII graphic characters--for example,
2140some terminals designed for ISO Latin-1 or subsets of it.
2141
2142By default, keyboard input is not translated at all.
2143
2144Character code translation of keyboard input is similar to using an
2145input method, in that both define sequences of keyboard input that
2146translate into single characters. However, input methods are designed
2147to be convenient for interactive use, while the code translations are
2148designed to work with terminals.
2149
2150*** The command C-x RET p (set-buffer-process-coding-system)
2151specifies the coding system for input and output to a subprocess.
2152This command applies to the current buffer; normally, each subprocess
2153has its own buffer, and thus you can use this command to specify
2154translation to and from a particular subprocess by giving the command
2155in the corresponding buffer.
2156
2157By default, process input and output are not translated at all.
2158
2159*** The variable file-name-coding-system specifies the coding system
2160to use for encoding file names before operating on them.
2161It is also used for decoding file names obtained from the system.
2162
2163*** The command C-\ (toggle-input-method) activates or deactivates
2164an input method. If no input method has been selected before, the
2165command prompts for you to specify the language and input method you
2166want to use.
2167
2168C-u C-\ (select-input-method) lets you switch to a different input
2169method. C-h C-\ (or C-h I) describes the current input method.
2170
2171*** Some input methods remap the keyboard to emulate various keyboard
2172layouts commonly used for particular scripts. How to do this
2173remapping properly depends on your actual keyboard layout. To specify
2174which layout your keyboard has, use M-x quail-set-keyboard-layout.
2175
2176*** The command C-h C (describe-coding-system) displays
2177the coding systems currently selected for various purposes, plus
2178related information.
2179
2180*** The command C-h h (view-hello-file) displays a file called
2181HELLO, which has examples of text in many languages, using various
2182scripts.
2183
2184*** The command C-h L (describe-language-support) displays
2185information about the support for a particular language.
2186You specify the language as an argument.
2187
2188*** The mode line now contains a letter or character that identifies
2189the coding system used in the visited file. It normally follows the
2190first dash.
2191
2192A dash indicates the default state of affairs: no code conversion
2193(except CRLF => newline if appropriate). `=' means no conversion
2194whatsoever. The ISO 8859 coding systems are represented by digits
21951 through 9. Other coding systems are represented by letters:
2196
2197 A alternativnyj (Russian)
2198 B big5 (Chinese)
2199 C cn-gb-2312 (Chinese)
2200 C iso-2022-cn (Chinese)
2201 D in-is13194-devanagari (Indian languages)
2202 E euc-japan (Japanese)
2203 I iso-2022-cjk or iso-2022-ss2 (Chinese, Japanese, Korean)
2204 J junet (iso-2022-7) or old-jis (iso-2022-jp-1978-irv) (Japanese)
2205 K euc-korea (Korean)
2206 R koi8 (Russian)
2207 Q tibetan
2208 S shift_jis (Japanese)
2209 T lao
2210 T tis620 (Thai)
2211 V viscii or vscii (Vietnamese)
2212 i iso-2022-lock (Chinese, Japanese, Korean)
2213 k iso-2022-kr (Korean)
2214 v viqr (Vietnamese)
2215 z hz (Chinese)
2216
2217When you are using a character-only terminal (not a window system),
2218two additional characters appear in between the dash and the file
2219coding system. These two characters describe the coding system for
2220keyboard input, and the coding system for terminal output.
2221
2222*** The new variable rmail-file-coding-system specifies the code
2223conversion to use for RMAIL files. The default value is nil.
2224
2225When you read mail with Rmail, each message is decoded automatically
2226into Emacs' internal format. This has nothing to do with
2227rmail-file-coding-system. That variable controls reading and writing
2228Rmail files themselves.
2229
2230*** The new variable sendmail-coding-system specifies the code
2231conversion for outgoing mail. The default value is nil.
2232
2233Actually, there are three different ways of specifying the coding system
2234for sending mail:
2235
2236- If you use C-x RET f in the mail buffer, that takes priority.
2237- Otherwise, if you set sendmail-coding-system non-nil, that specifies it.
2238- Otherwise, the default coding system for new files is used,
2239 if that is non-nil. That comes from your language environment.
2240- Otherwise, Latin-1 is used.
2241
2242*** The command C-h t (help-with-tutorial) accepts a prefix argument
2243to specify the language for the tutorial file. Currently, English,
2244Japanese, Korean and Thai are supported. We welcome additional
2245translations.
2246
2247** An easy new way to visit a file with no code or format conversion
2248of any kind: Use M-x find-file-literally. There is also a command
2249insert-file-literally which inserts a file into the current buffer
2250without any conversion.
2251
2252** C-q's handling of octal character codes is changed.
2253You can now specify any number of octal digits.
2254RET terminates the digits and is discarded;
2255any other non-digit terminates the digits and is then used as input.
2256
2257** There are new commands for looking up Info documentation for
2258functions, variables and file names used in your programs.
2259
2260Type M-x info-lookup-symbol to look up a symbol in the buffer at point.
2261Type M-x info-lookup-file to look up a file in the buffer at point.
2262
2263Precisely which Info files are used to look it up depends on the major
2264mode. For example, in C mode, the GNU libc manual is used.
2265
2266** M-TAB in most programming language modes now runs the command
2267complete-symbol. This command performs completion on the symbol name
2268in the buffer before point.
2269
2270With a numeric argument, it performs completion based on the set of
2271symbols documented in the Info files for the programming language that
2272you are using.
2273
2274With no argument, it does completion based on the current tags tables,
2275just like the old binding of M-TAB (complete-tag).
2276
2277** File locking works with NFS now.
2278
2279The lock file for FILENAME is now a symbolic link named .#FILENAME,
2280in the same directory as FILENAME.
2281
2282This means that collision detection between two different machines now
2283works reasonably well; it also means that no file server or directory
2284can become a bottleneck.
2285
2286The new method does have drawbacks. It means that collision detection
2287does not operate when you edit a file in a directory where you cannot
2288create new files. Collision detection also doesn't operate when the
2289file server does not support symbolic links. But these conditions are
2290rare, and the ability to have collision detection while using NFS is
2291so useful that the change is worth while.
2292
2293When Emacs or a system crashes, this may leave behind lock files which
2294are stale. So you may occasionally get warnings about spurious
2295collisions. When you determine that the collision is spurious, just
2296tell Emacs to go ahead anyway.
2297
2298** If you wish to use Show Paren mode to display matching parentheses,
2299it is no longer sufficient to load paren.el. Instead you must call
2300show-paren-mode.
2301
2302** If you wish to use Delete Selection mode to replace a highlighted
2303selection when you insert new text, it is no longer sufficient to load
2304delsel.el. Instead you must call the function delete-selection-mode.
2305
2306** If you wish to use Partial Completion mode to complete partial words
2307within symbols or filenames, it is no longer sufficient to load
2308complete.el. Instead you must call the function partial-completion-mode.
2309
2310** If you wish to use uniquify to rename buffers for you,
2311it is no longer sufficient to load uniquify.el. You must also
2312set uniquify-buffer-name-style to one of the non-nil legitimate values.
2313
2314** Changes in View mode.
2315
2316*** Several new commands are available in View mode.
2317Do H in view mode for a list of commands.
2318
2319*** There are two new commands for entering View mode:
2320view-file-other-frame and view-buffer-other-frame.
2321
2322*** Exiting View mode does a better job of restoring windows to their
2323previous state.
2324
2325*** New customization variable view-scroll-auto-exit. If non-nil,
2326scrolling past end of buffer makes view mode exit.
2327
2328*** New customization variable view-exits-all-viewing-windows. If
2329non-nil, view-mode will at exit restore all windows viewing buffer,
2330not just the selected window.
2331
2332*** New customization variable view-read-only. If non-nil, visiting a
2333read-only file automatically enters View mode, and toggle-read-only
2334turns View mode on or off.
2335
2336*** New customization variable view-remove-frame-by-deleting controls
2337how to remove a not needed frame at view mode exit. If non-nil,
2338delete the frame, if nil make an icon of it.
2339
2340** C-x v l, the command to print a file's version control log,
2341now positions point at the entry for the file's current branch version.
2342
2343** C-x v =, the command to compare a file with the last checked-in version,
2344has a new feature. If the file is currently not locked, so that it is
2345presumably identical to the last checked-in version, the command now asks
2346which version to compare with.
2347
2348** When using hideshow.el, incremental search can temporarily show hidden
2349blocks if a match is inside the block.
2350
2351The block is hidden again if the search is continued and the next match
2352is outside the block. By customizing the variable
2353isearch-hide-immediately you can choose to hide all the temporarily
2354shown blocks only when exiting from incremental search.
2355
2356By customizing the variable hs-isearch-open you can choose what kind
2357of blocks to temporarily show during isearch: comment blocks, code
2358blocks, all of them or none.
2359
2360** The new command C-x 4 0 (kill-buffer-and-window) kills the
2361current buffer and deletes the selected window. It asks for
2362confirmation first.
2363
2364** C-x C-w, which saves the buffer into a specified file name,
2365now changes the major mode according to that file name.
2366However, the mode will not be changed if
2367(1) a local variables list or the `-*-' line specifies a major mode, or
2368(2) the current major mode is a "special" mode,
2369 not suitable for ordinary files, or
2370(3) the new file name does not particularly specify any mode.
2371
2372This applies to M-x set-visited-file-name as well.
2373
2374However, if you set change-major-mode-with-file-name to nil, then
2375these commands do not change the major mode.
2376
2377** M-x occur changes.
2378
2379*** If the argument to M-x occur contains upper case letters,
2380it performs a case-sensitive search.
2381
2382*** In the *Occur* buffer made by M-x occur,
2383if you type g or M-x revert-buffer, this repeats the search
2384using the same regular expression and the same buffer as before.
2385
2386** In Transient Mark mode, the region in any one buffer is highlighted
2387in just one window at a time. At first, it is highlighted in the
2388window where you set the mark. The buffer's highlighting remains in
2389that window unless you select to another window which shows the same
2390buffer--then the highlighting moves to that window.
2391
2392** The feature to suggest key bindings when you use M-x now operates
2393after the command finishes. The message suggesting key bindings
2394appears temporarily in the echo area. The previous echo area contents
2395come back after a few seconds, in case they contain useful information.
2396
2397** Each frame now independently records the order for recently
2398selected buffers, so that the default for C-x b is now based on the
2399buffers recently selected in the selected frame.
2400
2401** Outline mode changes.
2402
2403*** Outline mode now uses overlays (this is the former noutline.el).
2404
2405*** Incremental searches skip over invisible text in Outline mode.
2406
2407** When a minibuffer window is active but not the selected window, if
2408you try to use the minibuffer, you used to get a nested minibuffer.
2409Now, this not only gives an error, it also cancels the minibuffer that
2410was already active.
2411
2412The motive for this change is so that beginning users do not
2413unknowingly move away from minibuffers, leaving them active, and then
2414get confused by it.
2415
2416If you want to be able to have recursive minibuffers, you must
2417set enable-recursive-minibuffers to non-nil.
2418
2419** Changes in dynamic abbrevs.
2420
2421*** Expanding dynamic abbrevs with M-/ is now smarter about case
2422conversion. If the expansion has mixed case not counting the first
2423character, and the abbreviation matches the beginning of the expansion
2424including case, then the expansion is copied verbatim.
2425
2426The expansion is also copied verbatim if the abbreviation itself has
2427mixed case. And using SPC M-/ to copy an additional word always
2428copies it verbatim except when the previous copied word is all caps.
2429
2430*** The values of `dabbrev-case-replace' and `dabbrev-case-fold-search'
2431are no longer Lisp expressions. They have simply three possible
2432values.
2433
2434`dabbrev-case-replace' has these three values: nil (don't preserve
2435case), t (do), or `case-replace' (do like M-x query-replace).
2436`dabbrev-case-fold-search' has these three values: nil (don't ignore
2437case), t (do), or `case-fold-search' (do like search).
2438
2439** Minibuffer history lists are truncated automatically now to a
2440certain length. The variable history-length specifies how long they
2441can be. The default value is 30.
2442
2443** Changes in Mail mode.
2444
2445*** The key C-x m no longer runs the `mail' command directly.
2446Instead, it runs the command `compose-mail', which invokes the mail
2447composition mechanism you have selected with the variable
2448`mail-user-agent'. The default choice of user agent is
2449`sendmail-user-agent', which gives behavior compatible with the old
2450behavior.
2451
2452C-x 4 m now runs compose-mail-other-window, and C-x 5 m runs
2453compose-mail-other-frame.
2454
2455*** While composing a reply to a mail message, from Rmail, you can use
2456the command C-c C-r to cite just the region from the message you are
2457replying to. This copies the text which is the selected region in the
2458buffer that shows the original message.
2459
2460*** The command C-c C-i inserts a file at the end of the message,
2461with separator lines around the contents.
2462
2463*** The command M-x expand-mail-aliases expands all mail aliases
2464in suitable mail headers. Emacs automatically extracts mail alias
2465definitions from your mail alias file (e.g., ~/.mailrc). You do not
2466need to expand mail aliases yourself before sending mail.
2467
2468*** New features in the mail-complete command.
2469
2470**** The mail-complete command now inserts the user's full name,
2471for local users or if that is known. The variable mail-complete-style
2472controls the style to use, and whether to do this at all.
2473Its values are like those of mail-from-style.
2474
2475**** The variable mail-passwd-command lets you specify a shell command
2476to run to fetch a set of password-entries that add to the ones in
2477/etc/passwd.
2478
2479**** The variable mail-passwd-file now specifies a list of files to read
2480to get the list of user ids. By default, one file is used:
2481/etc/passwd.
2482
2483** You can "quote" a file name to inhibit special significance of
2484special syntax, by adding `/:' to the beginning. Thus, if you have a
2485directory named `/foo:', you can prevent it from being treated as a
2486reference to a remote host named `foo' by writing it as `/:/foo:'.
2487
2488Emacs uses this new construct automatically when necessary, such as
2489when you start it with a working directory whose name might otherwise
2490be taken to be magic.
2491
2492** There is a new command M-x grep-find which uses find to select
2493files to search through, and grep to scan them. The output is
2494available in a Compile mode buffer, as with M-x grep.
2495
2496M-x grep now uses the -e option if the grep program supports that.
2497(-e prevents problems if the search pattern starts with a dash.)
2498
2499** In Dired, the & command now flags for deletion the files whose names
2500suggest they are probably not needed in the long run.
2501
2502In Dired, * is now a prefix key for mark-related commands.
2503
2504new key dired.el binding old key
2505------- ---------------- -------
2506 * c dired-change-marks c
2507 * m dired-mark m
2508 * * dired-mark-executables * (binding deleted)
2509 * / dired-mark-directories / (binding deleted)
2510 * @ dired-mark-symlinks @ (binding deleted)
2511 * u dired-unmark u
2512 * DEL dired-unmark-backward DEL
2513 * ? dired-unmark-all-files M-C-?
2514 * ! dired-unmark-all-marks
2515 * % dired-mark-files-regexp % m
2516 * C-n dired-next-marked-file M-}
2517 * C-p dired-prev-marked-file M-{
2518
2519** Rmail changes.
2520
2521*** When Rmail cannot convert your incoming mail into Babyl format, it
2522saves the new mail in the file RMAILOSE.n, where n is an integer
2523chosen to make a unique name. This way, Rmail will not keep crashing
2524each time you run it.
2525
2526*** In Rmail, the variable rmail-summary-line-count-flag now controls
2527whether to include the line count in the summary. Non-nil means yes.
2528
2529*** In Rmail summary buffers, d and C-d (the commands to delete
2530messages) now take repeat counts as arguments. A negative argument
2531means to move in the opposite direction.
2532
2533*** In Rmail, the t command now takes an optional argument which lets
2534you specify whether to show the message headers in full or pruned.
2535
2536*** In Rmail, the new command w (rmail-output-body-to-file) writes
2537just the body of the current message into a file, without the headers.
2538It takes the file name from the message subject, by default, but you
2539can edit that file name in the minibuffer before it is actually used
2540for output.
2541
2542** Gnus changes.
2543
2544*** nntp.el has been totally rewritten in an asynchronous fashion.
2545
2546*** Article prefetching functionality has been moved up into
2547Gnus.
2548
2549*** Scoring can now be performed with logical operators like
2550`and', `or', `not', and parent redirection.
2551
2552*** Article washing status can be displayed in the
2553article mode line.
2554
2555*** gnus.el has been split into many smaller files.
2556
2557*** Suppression of duplicate articles based on Message-ID.
2558
2559(setq gnus-suppress-duplicates t)
2560
2561*** New variables for specifying what score and adapt files
2562are to be considered home score and adapt files. See
2563`gnus-home-score-file' and `gnus-home-adapt-files'.
2564
2565*** Groups can inherit group parameters from parent topics.
2566
2567*** Article editing has been revamped and is now usable.
2568
2569*** Signatures can be recognized in more intelligent fashions.
2570See `gnus-signature-separator' and `gnus-signature-limit'.
2571
2572*** Summary pick mode has been made to look more nn-like.
2573Line numbers are displayed and the `.' command can be
2574used to pick articles.
2575
2576*** Commands for moving the .newsrc.eld from one server to
2577another have been added.
2578
2579 `M-x gnus-change-server'
2580
2581*** A way to specify that "uninteresting" fields be suppressed when
2582generating lines in buffers.
2583
2584*** Several commands in the group buffer can be undone with
2585`M-C-_'.
2586
2587*** Scoring can be done on words using the new score type `w'.
2588
2589*** Adaptive scoring can be done on a Subject word-by-word basis:
2590
2591 (setq gnus-use-adaptive-scoring '(word))
2592
2593*** Scores can be decayed.
2594
2595 (setq gnus-decay-scores t)
2596
2597*** Scoring can be performed using a regexp on the Date header. The
2598Date is normalized to compact ISO 8601 format first.
2599
2600*** A new command has been added to remove all data on articles from
2601the native server.
2602
2603 `M-x gnus-group-clear-data-on-native-groups'
2604
2605*** A new command for reading collections of documents
2606(nndoc with nnvirtual on top) has been added -- `M-C-d'.
2607
2608*** Process mark sets can be pushed and popped.
2609
2610*** A new mail-to-news backend makes it possible to post
2611even when the NNTP server doesn't allow posting.
2612
2613*** A new backend for reading searches from Web search engines
2614(DejaNews, Alta Vista, InReference) has been added.
2615
2616 Use the `G w' command in the group buffer to create such
2617 a group.
2618
2619*** Groups inside topics can now be sorted using the standard
2620sorting functions, and each topic can be sorted independently.
2621
2622 See the commands under the `T S' submap.
2623
2624*** Subsets of the groups can be sorted independently.
2625
2626 See the commands under the `G P' submap.
2627
2628*** Cached articles can be pulled into the groups.
2629
2630 Use the `Y c' command.
2631
2632*** Score files are now applied in a more reliable order.
2633
2634*** Reports on where mail messages end up can be generated.
2635
2636 `M-x nnmail-split-history'
2637
2638*** More hooks and functions have been added to remove junk
2639from incoming mail before saving the mail.
2640
2641 See `nnmail-prepare-incoming-header-hook'.
2642
2643*** The nnml mail backend now understands compressed article files.
2644
2645*** To enable Gnus to read/post multi-lingual articles, you must execute
2646the following code, for instance, in your .emacs.
2647
2648 (add-hook 'gnus-startup-hook 'gnus-mule-initialize)
2649
2650Then, when you start Gnus, it will decode non-ASCII text automatically
2651and show appropriate characters. (Note: if you are using gnus-mime
2652from the SEMI package, formerly known as TM, you should NOT add this
2653hook to gnus-startup-hook; gnus-mime has its own method of handling
2654this issue.)
2655
2656Since it is impossible to distinguish all coding systems
2657automatically, you may need to specify a choice of coding system for a
2658particular news group. This can be done by:
2659
2660 (gnus-mule-add-group NEWSGROUP 'CODING-SYSTEM)
2661
2662Here NEWSGROUP should be a string which names a newsgroup or a tree
2663of newsgroups. If NEWSGROUP is "XXX.YYY", all news groups under
2664"XXX.YYY" (including "XXX.YYY.ZZZ") will use the specified coding
2665system. CODING-SYSTEM specifies which coding system to use (for both
2666for reading and posting).
2667
2668CODING-SYSTEM can also be a cons cell of the form
2669 (READ-CODING-SYSTEM . POST-CODING-SYSTEM)
2670Then READ-CODING-SYSTEM is used when you read messages from the
2671newsgroups, while POST-CODING-SYSTEM is used when you post messages
2672there.
2673
2674Emacs knows the right coding systems for certain newsgroups by
2675default. Here are some of these default settings:
2676
2677 (gnus-mule-add-group "fj" 'iso-2022-7)
2678 (gnus-mule-add-group "alt.chinese.text" 'hz-gb-2312)
2679 (gnus-mule-add-group "alt.hk" 'hz-gb-2312)
2680 (gnus-mule-add-group "alt.chinese.text.big5" 'cn-big5)
2681 (gnus-mule-add-group "soc.culture.vietnamese" '(nil . viqr))
2682
2683When you reply by mail to an article, these settings are ignored;
2684the mail is encoded according to sendmail-coding-system, as usual.
2685
2686** CC mode changes.
2687
2688*** If you edit primarily one style of C (or C++, Objective-C, Java)
2689code, you may want to make the CC Mode style variables have global
2690values so that you can set them directly in your .emacs file. To do
2691this, set c-style-variables-are-local-p to nil in your .emacs file.
2692Note that this only takes effect if you do it *before* cc-mode.el is
2693loaded.
2694
2695If you typically edit more than one style of C (or C++, Objective-C,
2696Java) code in a single Emacs session, you may want to make the CC Mode
2697style variables have buffer local values. By default, all buffers
2698share the same style variable settings; to make them buffer local, set
2699c-style-variables-are-local-p to t in your .emacs file. Note that you
2700must do this *before* CC Mode is loaded.
2701
2702*** The new variable c-indentation-style holds the C style name
2703of the current buffer.
2704
2705*** The variable c-block-comments-indent-p has been deleted, because
2706it is no longer necessary. C mode now handles all the supported styles
2707of block comments, with no need to say which one you will use.
2708
2709*** There is a new indentation style "python", which specifies the C
2710style that the Python developers like.
2711
2712*** There is a new c-cleanup-list option: brace-elseif-brace.
2713This says to put ...} else if (...) {... on one line,
2714just as brace-else-brace says to put ...} else {... on one line.
2715
2716** VC Changes [new]
2717
2718** In vc-retrieve-snapshot (C-x v r), if you don't specify a snapshot
2719name, it retrieves the *latest* versions of all files in the current
2720directory and its subdirectories (aside from files already locked).
2721
2722This feature is useful if your RCS directory is a link to a common
2723master directory, and you want to pick up changes made by other
2724developers.
2725
2726You can do the same thing for an individual file by typing C-u C-x C-q
2727RET in a buffer visiting that file.
2728
2729*** VC can now handle files under CVS that are being "watched" by
2730other developers. Such files are made read-only by CVS. To get a
2731writable copy, type C-x C-q in a buffer visiting such a file. VC then
2732calls "cvs edit", which notifies the other developers of it.
2733
2734*** vc-version-diff (C-u C-x v =) now suggests reasonable defaults for
2735version numbers, based on the current state of the file.
2736
2737** Calendar changes.
2738
2739A new function, list-holidays, allows you list holidays or subclasses
2740of holidays for ranges of years. Related menu items allow you do this
2741for the year of the selected date, or the following/previous years.
2742
2743** ps-print changes
2744
2745There are some new user variables for customizing the page layout.
2746
2747*** Paper size, paper orientation, columns
2748
2749The variable `ps-paper-type' determines the size of paper ps-print
2750formats for; it should contain one of the symbols:
2751`a4' `a3' `letter' `legal' `letter-small' `tabloid'
2752`ledger' `statement' `executive' `a4small' `b4' `b5'
2753It defaults to `letter'.
2754If you need other sizes, see the variable `ps-page-dimensions-database'.
2755
2756The variable `ps-landscape-mode' determines the orientation
2757of the printing on the page. nil, the default, means "portrait" mode,
2758non-nil means "landscape" mode.
2759
2760The variable `ps-number-of-columns' must be a positive integer.
2761It determines the number of columns both in landscape and portrait mode.
2762It defaults to 1.
2763
2764*** Horizontal layout
2765
2766The horizontal layout is determined by the variables
2767`ps-left-margin', `ps-inter-column', and `ps-right-margin'.
2768All are measured in points.
2769
2770*** Vertical layout
2771
2772The vertical layout is determined by the variables
2773`ps-bottom-margin', `ps-top-margin', and `ps-header-offset'.
2774All are measured in points.
2775
2776*** Headers
2777
2778If the variable `ps-print-header' is nil, no header is printed. Then
2779`ps-header-offset' is not relevant and `ps-top-margin' represents the
2780margin above the text.
2781
2782If the variable `ps-print-header-frame' is non-nil, a gaudy
2783framing box is printed around the header.
2784
2785The contents of the header are determined by `ps-header-lines',
2786`ps-show-n-of-n', `ps-left-header' and `ps-right-header'.
2787
2788The height of the header is determined by `ps-header-line-pad',
2789`ps-header-font-family', `ps-header-title-font-size' and
2790`ps-header-font-size'.
2791
2792*** Font managing
2793
2794The variable `ps-font-family' determines which font family is to be
2795used for ordinary text. Its value must be a key symbol in the alist
2796`ps-font-info-database'. You can add other font families by adding
2797elements to this alist.
2798
2799The variable `ps-font-size' determines the size of the font
2800for ordinary text. It defaults to 8.5 points.
2801
2802** hideshow changes.
2803
2804*** now supports hiding of blocks of single line comments (like // for
2805C++, ; for lisp).
2806
2807*** Support for java-mode added.
2808
2809*** When doing `hs-hide-all' it is now possible to also hide the comments
2810in the file if `hs-hide-comments-when-hiding-all' is set.
2811
2812*** The new function `hs-hide-initial-comment' hides the the comments at
2813the beginning of the files. Finally those huge RCS logs don't stay in your
2814way! This is run by default when entering the `hs-minor-mode'.
2815
2816*** Now uses overlays instead of `selective-display', so is more
2817robust and a lot faster.
2818
2819*** A block beginning can span multiple lines.
2820
2821*** The new variable `hs-show-hidden-short-form' if t, directs hideshow
2822to show only the beginning of a block when it is hidden. See the
2823documentation for more details.
2824
2825** Changes in Enriched mode.
2826
2827*** When you visit a file in enriched-mode, Emacs will make sure it is
2828filled to the current fill-column. This behavior is now independent
2829of the size of the window. When you save the file, the fill-column in
2830use is stored as well, so that the whole buffer need not be refilled
2831the next time unless the fill-column is different.
2832
2833*** use-hard-newlines is now a minor mode. When it is enabled, Emacs
2834distinguishes between hard and soft newlines, and treats hard newlines
2835as paragraph boundaries. Otherwise all newlines inserted are marked
2836as soft, and paragraph boundaries are determined solely from the text.
2837
2838** Font Lock mode
2839
2840*** Custom support
2841
2842The variables font-lock-face-attributes, font-lock-display-type and
2843font-lock-background-mode are now obsolete; the recommended way to specify the
2844faces to use for Font Lock mode is with M-x customize-group on the new custom
2845group font-lock-highlighting-faces. If you set font-lock-face-attributes in
2846your ~/.emacs file, Font Lock mode will respect its value. However, you should
2847consider converting from setting that variable to using M-x customize.
2848
2849You can still use X resources to specify Font Lock face appearances.
2850
2851*** Maximum decoration
2852
2853Fontification now uses the maximum level of decoration supported by
2854default. Previously, fontification used a mode-specific default level
2855of decoration, which is typically the minimum level of decoration
2856supported. You can set font-lock-maximum-decoration to nil
2857to get the old behavior.
2858
2859*** New support
2860
2861Support is now provided for Java, Objective-C, AWK and SIMULA modes.
2862
2863Note that Font Lock mode can be turned on without knowing exactly what modes
2864support Font Lock mode, via the command global-font-lock-mode.
2865
2866*** Configurable support
2867
2868Support for C, C++, Objective-C and Java can be more easily configured for
2869additional types and classes via the new variables c-font-lock-extra-types,
2870c++-font-lock-extra-types, objc-font-lock-extra-types and, you guessed it,
2871java-font-lock-extra-types. These value of each of these variables should be a
2872list of regexps matching the extra type names. For example, the default value
2873of c-font-lock-extra-types is ("\\sw+_t") which means fontification follows the
2874convention that C type names end in _t. This results in slower fontification.
2875
2876Of course, you can change the variables that specify fontification in whatever
2877way you wish, typically by adding regexps. However, these new variables make
2878it easier to make specific and common changes for the fontification of types.
2879
2880*** Adding highlighting patterns to existing support
2881
2882You can use the new function font-lock-add-keywords to add your own
2883highlighting patterns, such as for project-local or user-specific constructs,
2884for any mode.
2885
2886For example, to highlight `FIXME:' words in C comments, put:
2887
2888 (font-lock-add-keywords 'c-mode '(("\\<FIXME:" 0 font-lock-warning-face t)))
2889
2890in your ~/.emacs.
2891
2892*** New faces
2893
2894Font Lock now defines two new faces, font-lock-builtin-face and
2895font-lock-warning-face. These are intended to highlight builtin keywords,
2896distinct from a language's normal keywords, and objects that should be brought
2897to user attention, respectively. Various modes now use these new faces.
2898
2899*** Changes to fast-lock support mode
2900
2901The fast-lock package, one of the two Font Lock support modes, can now process
2902cache files silently. You can use the new variable fast-lock-verbose, in the
2903same way as font-lock-verbose, to control this feature.
2904
2905*** Changes to lazy-lock support mode
2906
2907The lazy-lock package, one of the two Font Lock support modes, can now fontify
2908according to the true syntactic context relative to other lines. You can use
2909the new variable lazy-lock-defer-contextually to control this feature. If
2910non-nil, changes to the buffer will cause subsequent lines in the buffer to be
2911refontified after lazy-lock-defer-time seconds of idle time. If nil, then only
2912the modified lines will be refontified; this is the same as the previous Lazy
2913Lock mode behaviour and the behaviour of Font Lock mode.
2914
2915This feature is useful in modes where strings or comments can span lines.
2916For example, if a string or comment terminating character is deleted, then if
2917this feature is enabled subsequent lines in the buffer will be correctly
2918refontified to reflect their new syntactic context. Previously, only the line
2919containing the deleted character would be refontified and you would have to use
2920the command M-g M-g (font-lock-fontify-block) to refontify some lines.
2921
2922As a consequence of this new feature, two other variables have changed:
2923
2924Variable `lazy-lock-defer-driven' is renamed `lazy-lock-defer-on-scrolling'.
2925Variable `lazy-lock-defer-time' can now only be a time, i.e., a number.
2926Buffer modes for which on-the-fly deferral applies can be specified via the
2927new variable `lazy-lock-defer-on-the-fly'.
2928
2929If you set these variables in your ~/.emacs, then you may have to change those
2930settings.
2931
2932** Ada mode changes.
2933
2934*** There is now better support for using find-file.el with Ada mode.
2935If you switch between spec and body, the cursor stays in the same
2936procedure (modulo overloading). If a spec has no body file yet, but
2937you try to switch to its body file, Ada mode now generates procedure
2938stubs.
2939
2940*** There are two new commands:
2941 - `ada-make-local' : invokes gnatmake on the current buffer
2942 - `ada-check-syntax' : check syntax of current buffer.
2943
2944The user options `ada-compiler-make', `ada-make-options',
2945`ada-language-version', `ada-compiler-syntax-check', and
2946`ada-compile-options' are used within these commands.
2947
2948*** Ada mode can now work with Outline minor mode. The outline level
2949is calculated from the indenting, not from syntactic constructs.
2950Outlining does not work if your code is not correctly indented.
2951
2952*** The new function `ada-gnat-style' converts the buffer to the style of
2953formatting used in GNAT. It places two blanks after a comment start,
2954places one blank between a word end and an opening '(', and puts one
2955space between a comma and the beginning of a word.
2956
2957** Scheme mode changes.
2958
2959*** Scheme mode indentation now uses many of the facilities of Lisp
2960mode; therefore, the variables to customize it are the variables used
2961for Lisp mode which have names starting with `lisp-'. The variables
2962with names starting with `scheme-' which used to do this no longer
2963have any effect.
2964
2965If you want to use different indentation for Scheme and Lisp, this is
2966still possible, but now you must do it by adding a hook to
2967scheme-mode-hook, which could work by setting the `lisp-' indentation
2968variables as buffer-local variables.
2969
2970*** DSSSL mode is a variant of Scheme mode, for editing DSSSL scripts.
2971Use M-x dsssl-mode.
2972
2973** Changes to the emacsclient program
2974
2975*** If a socket can't be found, and environment variables LOGNAME or
2976USER are set, emacsclient now looks for a socket based on the UID
2977associated with the name. That is an emacsclient running as root
2978can connect to an Emacs server started by a non-root user.
2979
2980*** The emacsclient program now accepts an option --no-wait which tells
2981it to return immediately without waiting for you to "finish" the
2982buffer in Emacs.
2983
2984*** The new option --alternate-editor allows to specify an editor to
2985use if Emacs is not running. The environment variable
2986ALTERNATE_EDITOR can be used for the same effect; the command line
2987option takes precedence.
2988
2989** M-x eldoc-mode enables a minor mode in which the echo area
2990constantly shows the parameter list for function being called at point
2991(in Emacs Lisp and Lisp Interaction modes only).
2992
2993** C-x n d now runs the new command narrow-to-defun,
2994which narrows the accessible parts of the buffer to just
2995the current defun.
2996
2997** Emacs now handles the `--' argument in the standard way; all
2998following arguments are treated as ordinary file names.
2999
3000** On MSDOS and Windows, the bookmark file is now called _emacs.bmk,
3001and the saved desktop file is now called _emacs.desktop (truncated if
3002necessary).
3003
3004** When you kill a buffer that visits a file,
3005if there are any registers that save positions in the file,
3006these register values no longer become completely useless.
3007If you try to go to such a register with C-x j, then you are
3008asked whether to visit the file again. If you say yes,
3009it visits the file and then goes to the same position.
3010
3011** When you visit a file that changes frequently outside Emacs--for
3012example, a log of output from a process that continues to run--it may
3013be useful for Emacs to revert the file without querying you whenever
3014you visit the file afresh with C-x C-f.
3015
3016You can request this behavior for certain files by setting the
3017variable revert-without-query to a list of regular expressions. If a
3018file's name matches any of these regular expressions, find-file and
3019revert-buffer revert the buffer without asking for permission--but
3020only if you have not edited the buffer text yourself.
3021
3022** set-default-font has been renamed to set-frame-font
3023since it applies only to the current frame.
3024
3025** In TeX mode, you can use the variable tex-main-file to specify the
3026file for tex-file to run TeX on. (By default, tex-main-file is nil,
3027and tex-file runs TeX on the current visited file.)
3028
3029This is useful when you are editing a document that consists of
3030multiple files. In each of the included files, you can set up a local
3031variable list which specifies the top-level file of your document for
3032tex-main-file. Then tex-file will run TeX on the whole document
3033instead of just the file you are editing.
3034
3035** RefTeX mode
3036
3037RefTeX mode is a new minor mode with special support for \label, \ref
3038and \cite macros in LaTeX documents. RefTeX distinguishes labels of
3039different environments (equation, figure, ...) and has full support for
3040multifile documents. To use it, select a buffer with a LaTeX document and
3041turn the mode on with M-x reftex-mode. Here are the main user commands:
3042
3043C-c ( reftex-label
3044 Creates a label semi-automatically. RefTeX is context sensitive and
3045 knows which kind of label is needed.
3046
3047C-c ) reftex-reference
3048 Offers in a menu all labels in the document, along with context of the
3049 label definition. The selected label is referenced as \ref{LABEL}.
3050
3051C-c [ reftex-citation
3052 Prompts for a regular expression and displays a list of matching BibTeX
3053 database entries. The selected entry is cited with a \cite{KEY} macro.
3054
3055C-c & reftex-view-crossref
3056 Views the cross reference of a \ref or \cite command near point.
3057
3058C-c = reftex-toc
3059 Shows a table of contents of the (multifile) document. From there you
3060 can quickly jump to every section.
3061
3062Under X, RefTeX installs a "Ref" menu in the menu bar, with additional
3063commands. Press `?' to get help when a prompt mentions this feature.
3064Full documentation and customization examples are in the file
3065reftex.el. You can use the finder to view the file documentation:
3066C-h p --> tex --> reftex.el
3067
3068** Changes in BibTeX mode.
3069
3070*** Info documentation is now available.
3071
3072*** Don't allow parentheses in string constants anymore. This confused
3073both the BibTeX program and Emacs BibTeX mode.
3074
3075*** Renamed variable bibtex-mode-user-optional-fields to
3076bibtex-user-optional-fields.
3077
3078*** Removed variable bibtex-include-OPTannote
3079(use bibtex-user-optional-fields instead).
3080
3081*** New interactive functions to copy and kill fields and complete
3082entries to the BibTeX kill ring, from where they can be yanked back by
3083appropriate functions.
3084
3085*** New interactive functions for repositioning and marking of
3086entries. They are bound by default to M-C-l and M-C-h.
3087
3088*** New hook bibtex-clean-entry-hook. It is called after entry has
3089been cleaned.
3090
3091*** New variable bibtex-field-delimiters, which replaces variables
3092bibtex-field-{left|right}-delimiter.
3093
3094*** New variable bibtex-entry-delimiters to determine how entries
3095shall be delimited.
3096
3097*** Allow preinitialization of fields. See documentation of
3098bibtex-user-optional-fields, bibtex-entry-field-alist, and
3099bibtex-include-OPTkey for details.
3100
3101*** Book and InBook entries require either an author or an editor
3102field. This is now supported by bibtex.el. Alternative fields are
3103prefixed with `ALT'.
3104
3105*** New variable bibtex-entry-format, which replaces variable
3106bibtex-clean-entry-zap-empty-opts and allows specification of many
3107formatting options performed on cleaning an entry (see variable
3108documentation).
3109
3110*** Even more control on how automatic keys are generated. See
3111documentation of bibtex-generate-autokey for details. Transcriptions
3112for foreign languages other than German are now handled, too.
3113
3114*** New boolean user option bibtex-comma-after-last-field to decide if
3115comma should be inserted at end of last field.
3116
3117*** New boolean user option bibtex-align-at-equal-sign to determine if
3118alignment should be made at left side of field contents or at equal
3119signs. New user options to control entry layout (e.g. indentation).
3120
3121*** New function bibtex-fill-entry to realign entries.
3122
3123*** New function bibtex-reformat to reformat region or buffer.
3124
3125*** New function bibtex-convert-alien to convert a BibTeX database
3126from alien sources.
3127
3128*** New function bibtex-complete-key (similar to bibtex-complete-string)
3129to complete prefix to a key defined in buffer. Mainly useful in
3130crossref entries.
3131
3132*** New function bibtex-count-entries to count entries in buffer or
3133region.
3134
3135*** Added support for imenu.
3136
3137*** The function `bibtex-validate' now checks current region instead
3138of buffer if mark is active. Now it shows all errors of buffer in a
3139`compilation mode' buffer. You can use the normal commands (e.g.
3140`next-error') for compilation modes to jump to errors.
3141
3142*** New variable `bibtex-string-file-path' to determine where the files
3143from `bibtex-string-files' are searched.
3144
3145** Iso Accents mode now supports Latin-3 as an alternative.
3146
3147** The command next-error now opens blocks hidden by hideshow.
3148
3149** The function using-unix-filesystems has been replaced by the
3150functions add-untranslated-filesystem and remove-untranslated-filesystem.
3151Each of these functions takes the name of a drive letter or directory
3152as an argument.
3153
3154When a filesystem is added as untranslated, all files on it are read
3155and written in binary mode (no cr/lf translation is performed).
3156
3157** browse-url changes
3158
3159*** New methods for: Grail (browse-url-generic), MMM (browse-url-mmm),
3160Lynx in a separate xterm (browse-url-lynx-xterm) or in an Emacs window
3161(browse-url-lynx-emacs), remote W3 (browse-url-w3-gnudoit), generic
3162non-remote-controlled browsers (browse-url-generic) and associated
3163customization variables.
3164
3165*** New commands `browse-url-of-region' and `browse-url'.
3166
3167*** URLs marked up with <URL:...> (RFC1738) work if broken across
3168lines. Browsing methods can be associated with URL regexps
3169(e.g. mailto: URLs) via `browse-url-browser-function'.
3170
3171** Changes in Ediff
3172
3173*** Clicking Mouse-2 on a brief command description in Ediff control panel
3174pops up the Info file for this command.
3175
3176*** There is now a variable, ediff-autostore-merges, which controls whether
3177the result of a merge is saved in a file. By default, this is done only when
3178merge is done from a session group (eg, when merging files in two different
3179directories).
3180
3181*** Since Emacs 19.31 (this hasn't been announced before), Ediff can compare
3182and merge groups of files residing in different directories, or revisions of
3183files in the same directory.
3184
3185*** Since Emacs 19.31, Ediff can apply multi-file patches interactively.
3186The patches must be in the context format or GNU unified format. (The bug
3187related to the GNU format has now been fixed.)
3188
3189** Changes in Viper
3190
3191*** The startup file is now .viper instead of .vip
3192*** All variable/function names have been changed to start with viper-
3193 instead of vip-.
3194*** C-\ now simulates the meta-key in all Viper states.
3195*** C-z in Insert state now escapes to Vi for the duration of the next
3196Viper command. In Vi and Insert states, C-z behaves as before.
3197*** C-c \ escapes to Vi for one command if Viper is in Insert or Emacs states.
3198*** _ is no longer the meta-key in Vi state.
3199*** The variable viper-insert-state-cursor-color can be used to change cursor
3200color when Viper is in insert state.
3201*** If search lands the cursor near the top or the bottom of the window,
3202Viper pulls the window up or down to expose more context. The variable
3203viper-adjust-window-after-search controls this behavior.
3204
3205** Etags changes.
3206
3207*** In C, C++, Objective C and Java, Etags tags global variables by
3208default. The resulting tags files are inflated by 30% on average.
3209Use --no-globals to turn this feature off. Etags can also tag
3210variables which are members of structure-like constructs, but it does
3211not by default. Use --members to turn this feature on.
3212
3213*** C++ member functions are now recognized as tags.
3214
3215*** Java is tagged like C++. In addition, "extends" and "implements"
3216constructs are tagged. Files are recognised by the extension .java.
3217
3218*** Etags can now handle programs written in Postscript. Files are
3219recognised by the extensions .ps and .pdb (Postscript with C syntax).
3220In Postscript, tags are lines that start with a slash.
3221
3222*** Etags now handles Objective C and Objective C++ code. The usual C and
3223C++ tags are recognized in these languages; in addition, etags
3224recognizes special Objective C syntax for classes, class categories,
3225methods and protocols.
3226
3227*** Etags also handles Cobol. Files are recognised by the extension
3228.cobol. The tagged lines are those containing a word that begins in
3229column 8 and ends in a full stop, i.e. anything that could be a
3230paragraph name.
3231
3232*** Regexps in Etags now support intervals, as in ed or grep. The syntax of
3233an interval is \{M,N\}, and it means to match the preceding expression
3234at least M times and as many as N times.
3235
3236** The format for specifying a custom format for time-stamp to insert
3237in files has changed slightly.
3238
3239With the new enhancements to the functionality of format-time-string,
3240time-stamp-format will change to be eventually compatible with it.
3241This conversion is being done in two steps to maintain compatibility
3242with old time-stamp-format values.
3243
3244In the new scheme, alternate case is signified by the number-sign
3245(`#') modifier, rather than changing the case of the format character.
3246This feature is as yet incompletely implemented for compatibility
3247reasons.
3248
3249In the old time-stamp-format, all numeric fields defaulted to their
3250natural width. (With format-time-string, each format has a
3251fixed-width default.) In this version, you can specify the colon
3252(`:') modifier to a numeric conversion to mean "give me the historical
3253time-stamp-format width default." Do not use colon if you are
3254specifying an explicit width, as in "%02d".
3255
3256Numbers are no longer truncated to the requested width, except in the
3257case of "%02y", which continues to give a two-digit year. Digit
3258truncation probably wasn't being used for anything else anyway.
3259
3260The new formats will work with old versions of Emacs. New formats are
3261being recommended now to allow time-stamp-format to change in the
3262future to be compatible with format-time-string. The new forms being
3263recommended now will continue to work then.
3264
3265See the documentation string for the variable time-stamp-format for
3266details.
3267
3268** There are some additional major modes:
3269
3270dcl-mode, for editing VMS DCL files.
3271m4-mode, for editing files of m4 input.
3272meta-mode, for editing MetaFont and MetaPost source files.
3273
3274** In Shell mode, the command shell-copy-environment-variable lets you
3275copy the value of a specified environment variable from the subshell
3276into Emacs.
3277
3278** New Lisp packages include:
3279
3280*** battery.el displays battery status for laptops.
3281
3282*** M-x bruce (named after Lenny Bruce) is a program that might
3283be used for adding some indecent words to your email.
3284
3285*** M-x crisp-mode enables an emulation for the CRiSP editor.
3286
3287*** M-x dirtrack arranges for better tracking of directory changes
3288in shell buffers.
3289
3290*** The new library elint.el provides for linting of Emacs Lisp code.
3291See the documentation for `elint-initialize', `elint-current-buffer'
3292and `elint-defun'.
3293
3294*** M-x expand-add-abbrevs defines a special kind of abbrev which is
3295meant for programming constructs. These abbrevs expand like ordinary
3296ones, when you type SPC, but only at the end of a line and not within
3297strings or comments.
3298
3299These abbrevs can act as templates: you can define places within an
3300abbrev for insertion of additional text. Once you expand the abbrev,
3301you can then use C-x a p and C-x a n to move back and forth to these
3302insertion points. Thus you can conveniently insert additional text
3303at these points.
3304
3305*** filecache.el remembers the location of files so that you
3306can visit them by short forms of their names.
3307
3308*** find-func.el lets you find the definition of the user-loaded
3309Emacs Lisp function at point.
3310
3311*** M-x handwrite converts text to a "handwritten" picture.
3312
3313*** M-x iswitchb-buffer is a command for switching to a buffer, much like
3314switch-buffer, but it reads the argument in a more helpful way.
3315
3316*** M-x landmark implements a neural network for landmark learning.
3317
3318*** M-x locate provides a convenient interface to the `locate' program.
3319
3320*** M4 mode is a new mode for editing files of m4 input.
3321
3322*** mantemp.el creates C++ manual template instantiations
3323from the GCC error messages which indicate which instantiations are needed.
3324
3325*** mouse-copy.el provides a one-click copy and move feature.
3326You can drag a region with M-mouse-1, and it is automatically
3327inserted at point. M-Shift-mouse-1 deletes the text from its
3328original place after inserting the copy.
3329
3330*** mouse-drag.el lets you do scrolling by dragging Mouse-2
3331on the buffer.
3332
3333You click the mouse and move; that distance either translates into the
3334velocity to scroll (with mouse-drag-throw) or the distance to scroll
3335(with mouse-drag-drag). Horizontal scrolling is enabled when needed.
3336
3337Enable mouse-drag with:
3338 (global-set-key [down-mouse-2] 'mouse-drag-throw)
3339-or-
3340 (global-set-key [down-mouse-2] 'mouse-drag-drag)
3341
3342*** mspools.el is useful for determining which mail folders have
3343mail waiting to be read in them. It works with procmail.
3344
3345*** Octave mode is a major mode for editing files of input for Octave.
3346It comes with a facility for communicating with an Octave subprocess.
3347
3348*** ogonek
3349
3350The ogonek package provides functions for changing the coding of
3351Polish diacritic characters in buffers. Codings known from various
3352platforms are supported such as ISO8859-2, Mazovia, IBM Latin2, and
3353TeX. For example, you can change the coding from Mazovia to
3354ISO8859-2. Another example is a change of coding from ISO8859-2 to
3355prefix notation (in which `/a' stands for the aogonek character, for
3356instance) and vice versa.
3357
3358To use this package load it using
3359 M-x load-library [enter] ogonek
3360Then, you may get an explanation by calling one of
3361 M-x ogonek-jak -- in Polish
3362 M-x ogonek-how -- in English
3363The info specifies the commands and variables provided as well as the
3364ways of customization in `.emacs'.
3365
3366*** Interface to ph.
3367
3368Emacs provides a client interface to CCSO Nameservers (ph/qi)
3369
3370The CCSO nameserver is used in many universities to provide directory
3371services about people. ph.el provides a convenient Emacs interface to
3372these servers.
3373
3374*** uce.el is useful for replying to unsolicited commercial email.
3375
3376*** vcursor.el implements a "virtual cursor" feature.
3377You can move the virtual cursor with special commands
3378while the real cursor does not move.
3379
3380*** webjump.el is a "hot list" package which you can set up
3381for visiting your favorite web sites.
3382
3383*** M-x winner-mode is a minor mode which saves window configurations,
3384so you can move back to other configurations that you have recently used.
3385
3386** movemail change
3387
3388Movemail no longer needs to be installed setuid root in order for POP
3389mail retrieval to function properly. This is because it no longer
3390supports the RPOP (reserved-port POP) protocol; instead, it uses the
3391user's POP password to authenticate to the mail server.
3392
3393This change was made earlier, but not reported in NEWS before.
3394 444
3395* Emacs 20.1 changes for MS-DOS and MS-Windows. 445Changes in Emacs 1.9
3396 446
3397** Changes in handling MS-DOS/MS-Windows text files. 447* When a fill prefix is in effect, paragraphs are started
3398 448 or separated by lines that do not start with the fill prefix.
3399Emacs handles three different conventions for representing 449 Also, a line which consists of the fill prefix followed by
3400end-of-line: CRLF for MSDOS, LF for Unix and GNU, and CR (used on the 450 white space separates paragraphs.
3401Macintosh). Emacs determines which convention is used in a specific 451
3402file based on the contents of that file (except for certain special 452* C-x C-v runs the new function find-alternate-file.
3403file names), and when it saves the file, it uses the same convention. 453 It finds the specified file, switches to that buffer,
3404 454 and kills the previous current buffer. (It requires
3405To save the file and change the end-of-line convention, you can use 455 confirmation if that buffer had changes.) This is
3406C-x RET f (set-buffer-file-coding-system) to specify a different 456 most useful after you find the wrong file due to a typo.
3407coding system for the buffer. Then, when you save the file, the newly 457
3408specified coding system will take effect. For example, to save with 458* Exiting the minibuffer moves the cursor to column 0,
3409LF, specify undecided-unix (or some other ...-unix coding system); to 459 to show you that it has really been exited.
3410save with CRLF, specify undecided-dos. 460
461* Meta-g (fill-region) now fills each paragraph in the
462 region individually. To fill the region as if it were
463 a single paragraph (for when the paragraph-delimiting mechanism
464 does the wrong thing), use fill-region-as-paragraph.
465
466* Tab in text mode now runs the function tab-to-tab-stop.
467 A new mode called indented-text-mode is like text-mode
468 except that in it Tab runs the function indent-relative,
469 which indents the line under the previous line.
470 If auto fill is enabled while in indented-text-mode,
471 the new lines that it makes are indented.
472
473* Functions kill-rectangle and yank-rectangle.
474 kill-rectangle deletes the rectangle specified by dot and mark
475 (or by two arguments) and saves it in the variable killed-rectangle.
476 yank-rectangle inserts the rectangle in that variable.
477
478 Tab characters in a rectangle being saved are replaced
479 by spaces in such a way that their appearance will
480 not be changed if the rectangle is later reinserted
481 at a different column position.
482
483* `+' in a regular expression now means
484 to repeat the previous expression one or more times.
485 `?' means to repeat it zero or one time.
486 They are in all regards like `*' except for the
487 number of repetitions they match.
488
489 \< in a regular expression now matches the null string
490 when it is at the beginning of a word; \> matches
491 the null string at the end of a word.
492
493* C-x p narrows the buffer so that only the current page
494 is visible.
495
496* C-x ) with argument repeats the kbd macro just
497 defined that many times, counting the definition
498 as one repetition.
499
500* C-x ( with argument begins defining a kbd macro
501 starting with the last one defined. It executes that
502 previous kbd macro initially, just as if you began
503 by typing it over again.
504
505* C-x q command queries the user during kbd macro execution.
506 With prefix argument, enters recursive edit,
507 reading keyboard commands even within a kbd macro.
508 You can give different commands each time the macro executes.
509 Without prefix argument, reads a character. Your options are:
510 Space -- execute the rest of the macro.
511 Delete -- skip the rest of the macro; start next repetition.
512 C-d -- skip rest of the macro and don't repeat it any more.
513 C-r -- enter a recursive edit, then on exit ask again for a character
514 C-l -- redisplay screen and ask again."
515
516* write-kbd-macro and append-kbd-macro are used to save
517 a kbd macro definition in a file (as Lisp code to
518 redefine the macro when the file is loaded).
519 These commands differ in that write-kbd-macro
520 discards the previous contents of the file.
521 If given a prefix argument, both commands
522 record the keys which invoke the macro as well as the
523 macro's definition.
524
525* The variable global-minor-modes is used to display
526 strings in the mode line of all buffers. It should be
527 a list of elements thaht are conses whose cdrs are strings
528 to be displayed. This complements the variable
529 minor-modes, which has the same effect but has a separate
530 value in each buffer.
531
532* C-x = describes horizontal scrolling in effect, if any.
533
534* Return now auto-fills the line it is ending, in auto fill mode.
535 Space with zero as argument auto-fills the line before it
536 just like Space without an argument.
3411 537
3412* Lisp Changes in Emacs 20.1 538Changes in Emacs 1.8
3413
3414** Byte-compiled files made with Emacs 20 will, in general, work in
3415Emacs 19 as well, as long as the source code runs in Emacs 19. And
3416vice versa: byte-compiled files made with Emacs 19 should also run in
3417Emacs 20, as long as the program itself works in Emacs 20.
3418
3419** Windows-specific functions and variables have been renamed
3420to start with w32- instead of win32-.
3421
3422In hacker language, calling something a "win" is a form of praise. We
3423don't want to praise a non-free Microsoft system, so we don't call it
3424"win".
3425
3426** Basic Lisp changes
3427
3428*** A symbol whose name starts with a colon now automatically
3429evaluates to itself. Therefore such a symbol can be used as a constant.
3430
3431*** The defined purpose of `defconst' has been changed. It should now
3432be used only for values that should not be changed whether by a program
3433or by the user.
3434
3435The actual behavior of defconst has not been changed.
3436
3437*** There are new macros `when' and `unless'
3438
3439(when CONDITION BODY...) is short for (if CONDITION (progn BODY...))
3440(unless CONDITION BODY...) is short for (if CONDITION nil BODY...)
3441
3442*** Emacs now defines functions caar, cadr, cdar and cddr with their
3443usual Lisp meanings. For example, caar returns the car of the car of
3444its argument.
3445
3446*** equal, when comparing strings, now ignores their text properties.
3447
3448*** The new function `functionp' tests whether an object is a function.
3449
3450*** arrayp now returns t for char-tables and bool-vectors.
3451
3452*** Certain primitives which use characters (as integers) now get an
3453error if the integer is not a valid character code. These primitives
3454include insert-char, char-to-string, and the %c construct in the
3455`format' function.
3456
3457*** The `require' function now insists on adding a suffix, either .el
3458or .elc, to the file name. Thus, (require 'foo) will not use a file
3459whose name is just foo. It insists on foo.el or foo.elc.
3460
3461*** The `autoload' function, when the file name does not contain
3462either a directory name or the suffix .el or .elc, insists on
3463adding one of these suffixes.
3464
3465*** string-to-number now takes an optional second argument BASE
3466which specifies the base to use when converting an integer.
3467If BASE is omitted, base 10 is used.
3468
3469We have not implemented other radices for floating point numbers,
3470because that would be much more work and does not seem useful.
3471
3472*** substring now handles vectors as well as strings.
3473
3474*** The Common Lisp function eql is no longer defined normally.
3475You must load the `cl' library to define it.
3476
3477*** The new macro `with-current-buffer' lets you evaluate an expression
3478conveniently with a different current buffer. It looks like this:
3479
3480 (with-current-buffer BUFFER BODY-FORMS...)
3481
3482BUFFER is the expression that says which buffer to use.
3483BODY-FORMS say what to do in that buffer.
3484
3485*** The new primitive `save-current-buffer' saves and restores the
3486choice of current buffer, like `save-excursion', but without saving or
3487restoring the value of point or the mark. `with-current-buffer'
3488works using `save-current-buffer'.
3489
3490*** The new macro `with-temp-file' lets you do some work in a new buffer and
3491write the output to a specified file. Like `progn', it returns the value
3492of the last form.
3493
3494*** The new macro `with-temp-buffer' lets you do some work in a new buffer,
3495which is discarded after use. Like `progn', it returns the value of the
3496last form. If you wish to return the buffer contents, use (buffer-string)
3497as the last form.
3498
3499*** The new function split-string takes a string, splits it at certain
3500characters, and returns a list of the substrings in between the
3501matches.
3502
3503For example, (split-string "foo bar lose" " +") returns ("foo" "bar" "lose").
3504
3505*** The new macro with-output-to-string executes some Lisp expressions
3506with standard-output set up so that all output feeds into a string.
3507Then it returns that string.
3508
3509For example, if the current buffer name is `foo',
3510
3511(with-output-to-string
3512 (princ "The buffer is ")
3513 (princ (buffer-name)))
3514
3515returns "The buffer is foo".
3516
3517** Non-ASCII characters are now supported, if enable-multibyte-characters
3518is non-nil.
3519
3520These characters have character codes above 256. When inserted in the
3521buffer or stored in a string, they are represented as multibyte
3522characters that occupy several buffer positions each.
3523
3524*** When enable-multibyte-characters is non-nil, a single character in
3525a buffer or string can be two or more bytes (as many as four).
3526
3527Buffers and strings are still made up of unibyte elements;
3528character positions and string indices are always measured in bytes.
3529Therefore, moving forward one character can increase the buffer
3530position by 2, 3 or 4. The function forward-char moves by whole
3531characters, and therefore is no longer equivalent to
3532 (lambda (n) (goto-char (+ (point) n))).
3533
3534ASCII characters (codes 0 through 127) are still single bytes, always.
3535Sequences of byte values 128 through 255 are used to represent
3536non-ASCII characters. These sequences are called "multibyte
3537characters".
3538
3539The first byte of a multibyte character is always in the range 128
3540through 159 (octal 0200 through 0237). These values are called
3541"leading codes". The second and subsequent bytes are always in the
3542range 160 through 255 (octal 0240 through 0377). The first byte, the
3543leading code, determines how many bytes long the sequence is.
3544
3545*** The function forward-char moves over characters, and therefore
3546(forward-char 1) may increase point by more than 1 if it moves over a
3547multibyte character. Likewise, delete-char always deletes a
3548character, which may be more than one buffer position.
3549
3550This means that some Lisp programs, which assume that a character is
3551always one buffer position, need to be changed.
3552
3553However, all ASCII characters are always one buffer position.
3554
3555*** The regexp [\200-\377] no longer matches all non-ASCII characters,
3556because when enable-multibyte-characters is non-nil, these characters
3557have codes that are not in the range octal 200 to octal 377. However,
3558the regexp [^\000-\177] does match all non-ASCII characters,
3559guaranteed.
3560
3561*** The function char-boundary-p returns non-nil if position POS is
3562between two characters in the buffer (not in the middle of a
3563character).
3564
3565When the value is non-nil, it says what kind of character follows POS:
3566
3567 0 if POS is at an ASCII character or at the end of range,
3568 1 if POS is before a 2-byte length multi-byte form,
3569 2 if POS is at a head of 3-byte length multi-byte form,
3570 3 if POS is at a head of 4-byte length multi-byte form,
3571 4 if POS is at a head of multi-byte form of a composite character.
3572
3573*** The function char-bytes returns how many bytes the character CHAR uses.
3574
3575*** Strings can contain multibyte characters. The function
3576`length' returns the string length counting bytes, which may be
3577more than the number of characters.
3578
3579You can include a multibyte character in a string constant by writing
3580it literally. You can also represent it with a hex escape,
3581\xNNNNNNN..., using as many digits as necessary. Any character which
3582is not a valid hex digit terminates this construct. If you want to
3583follow it with a character that is a hex digit, write backslash and
3584newline in between; that will terminate the hex escape.
3585
3586*** The function concat-chars takes arguments which are characters
3587and returns a string containing those characters.
3588
3589*** The function sref access a multibyte character in a string.
3590(sref STRING INDX) returns the character in STRING at INDEX. INDEX
3591counts from zero. If INDEX is at a position in the middle of a
3592character, sref signals an error.
3593
3594*** The function chars-in-string returns the number of characters
3595in a string. This is less than the length of the string, if the
3596string contains multibyte characters (the length counts bytes).
3597
3598*** The function chars-in-region returns the number of characters
3599in a region from BEG to END. This is less than (- END BEG) if the
3600region contains multibyte characters (the length counts bytes).
3601
3602*** The function string-to-list converts a string to a list of
3603the characters in it. string-to-vector converts a string
3604to a vector of the characters in it.
3605
3606*** The function store-substring alters part of the contents
3607of a string. You call it as follows:
3608
3609 (store-substring STRING IDX OBJ)
3610
3611This says to alter STRING, by storing OBJ starting at index IDX in
3612STRING. OBJ may be either a character or a (smaller) string.
3613This function really does alter the contents of STRING.
3614Since it is impossible to change the length of an existing string,
3615it is an error if OBJ doesn't fit within STRING's actual length.
3616
3617*** char-width returns the width (in columns) of the character CHAR,
3618if it were displayed in the current buffer and the selected window.
3619
3620*** string-width returns the width (in columns) of the text in STRING,
3621if it were displayed in the current buffer and the selected window.
3622
3623*** truncate-string-to-width shortens a string, if necessary,
3624to fit within a certain number of columns. (Of course, it does
3625not alter the string that you give it; it returns a new string
3626which contains all or just part of the existing string.)
3627
3628(truncate-string-to-width STR END-COLUMN &optional START-COLUMN PADDING)
3629
3630This returns the part of STR up to column END-COLUMN.
3631
3632The optional argument START-COLUMN specifies the starting column.
3633If this is non-nil, then the first START-COLUMN columns of the string
3634are not included in the resulting value.
3635
3636The optional argument PADDING, if non-nil, is a padding character to be added
3637at the beginning and end the resulting string, to extend it to exactly
3638WIDTH columns. If PADDING is nil, that means do not pad; then, if STRING
3639is narrower than WIDTH, the value is equal to STRING.
3640
3641If PADDING and START-COLUMN are both non-nil, and if there is no clean
3642place in STRING that corresponds to START-COLUMN (because one
3643character extends across that column), then the padding character
3644PADDING is added one or more times at the beginning of the result
3645string, so that its columns line up as if it really did start at
3646column START-COLUMN.
3647
3648*** When the functions in the list after-change-functions are called,
3649the third argument is the number of bytes in the pre-change text, not
3650necessarily the number of characters. It is, in effect, the
3651difference in buffer position between the beginning and the end of the
3652changed text, before the change.
3653
3654*** The characters Emacs uses are classified in various character
3655sets, each of which has a name which is a symbol. In general there is
3656one character set for each script, not for each language.
3657
3658**** The function charsetp tests whether an object is a character set name.
3659
3660**** The variable charset-list holds a list of character set names.
3661
3662**** char-charset, given a character code, returns the name of the character
3663set that the character belongs to. (The value is a symbol.)
3664
3665**** split-char, given a character code, returns a list containing the
3666name of the character set, followed by one or two byte-values
3667which identify the character within that character set.
3668
3669**** make-char, given a character set name and one or two subsequent
3670byte-values, constructs a character code. This is roughly the
3671opposite of split-char.
3672
3673**** find-charset-region returns a list of the character sets
3674of all the characters between BEG and END.
3675
3676**** find-charset-string returns a list of the character sets
3677of all the characters in a string.
3678
3679*** Here are the Lisp facilities for working with coding systems
3680and specifying coding systems.
3681
3682**** The function coding-system-list returns a list of all coding
3683system names (symbols). With optional argument t, it returns a list
3684of all distinct base coding systems, not including variants.
3685(Variant coding systems are those like latin-1-dos, latin-1-unix
3686and latin-1-mac which specify the end-of-line conversion as well
3687as what to do about code conversion.)
3688
3689**** coding-system-p tests a symbol to see if it is a coding system
3690name. It returns t if so, nil if not.
3691
3692**** file-coding-system-alist specifies which coding systems to use
3693for certain file names. It works like network-coding-system-alist,
3694except that the PATTERN is matched against the file name.
3695
3696Each element has the format (PATTERN . VAL), where PATTERN determines
3697which file names the element applies to. PATTERN should be a regexp
3698to match against a file name.
3699
3700VAL is a coding system, a cons cell containing two coding systems, or
3701a function symbol. If VAL is a coding system, it is used for both
3702decoding what received from the network stream and encoding what sent
3703to the network stream. If VAL is a cons cell containing two coding
3704systems, the car specifies the coding system for decoding, and the cdr
3705specifies the coding system for encoding.
3706
3707If VAL is a function symbol, the function must return a coding system
3708or a cons cell containing two coding systems, which is used as above.
3709
3710**** The variable network-coding-system-alist specifies
3711the coding system to use for network sockets.
3712
3713Each element has the format (PATTERN . VAL), where PATTERN determines
3714which network sockets the element applies to. PATTERN should be
3715either a port number or a regular expression matching some network
3716service names.
3717
3718VAL is a coding system, a cons cell containing two coding systems, or
3719a function symbol. If VAL is a coding system, it is used for both
3720decoding what received from the network stream and encoding what sent
3721to the network stream. If VAL is a cons cell containing two coding
3722systems, the car specifies the coding system for decoding, and the cdr
3723specifies the coding system for encoding.
3724
3725If VAL is a function symbol, the function must return a coding system
3726or a cons cell containing two coding systems, which is used as above.
3727
3728**** process-coding-system-alist specifies which coding systems to use
3729for certain subprocess. It works like network-coding-system-alist,
3730except that the PATTERN is matched against the program name used to
3731start the subprocess.
3732
3733**** The variable default-process-coding-system specifies the coding
3734systems to use for subprocess (and net connection) input and output,
3735when nothing else specifies what to do. The value is a cons cell
3736(OUTPUT-CODING . INPUT-CODING). OUTPUT-CODING applies to output
3737to the subprocess, and INPUT-CODING applies to input from it.
3738
3739**** The variable coding-system-for-write, if non-nil, specifies the
3740coding system to use for writing a file, or for output to a synchronous
3741subprocess.
3742
3743It also applies to any asynchronous subprocess or network connection,
3744but in a different way: the value of coding-system-for-write when you
3745start the subprocess or connection affects that subprocess or
3746connection permanently or until overridden.
3747
3748The variable coding-system-for-write takes precedence over
3749file-coding-system-alist, process-coding-system-alist and
3750network-coding-system-alist, and all other methods of specifying a
3751coding system for output. But most of the time this variable is nil.
3752It exists so that Lisp programs can bind it to a specific coding
3753system for one operation at a time.
3754
3755**** coding-system-for-read applies similarly to input from
3756files, subprocesses or network connections.
3757
3758**** The function process-coding-system tells you what
3759coding systems(s) an existing subprocess is using.
3760The value is a cons cell,
3761 (DECODING-CODING-SYSTEM . ENCODING-CODING-SYSTEM)
3762where DECODING-CODING-SYSTEM is used for decoding output from
3763the subprocess, and ENCODING-CODING-SYSTEM is used for encoding
3764input to the subprocess.
3765
3766**** The function set-process-coding-system can be used to
3767change the coding systems in use for an existing subprocess.
3768
3769** Emacs has a new facility to help users manage the many
3770customization options. To make a Lisp program work with this facility,
3771you need to use the new macros defgroup and defcustom.
3772
3773You use defcustom instead of defvar, for defining a user option
3774variable. The difference is that you specify two additional pieces of
3775information (usually): the "type" which says what values are
3776legitimate, and the "group" which specifies the hierarchy for
3777customization.
3778
3779Thus, instead of writing
3780
3781 (defvar foo-blurgoze nil
3782 "*Non-nil means that foo will act very blurgozely.")
3783
3784you would now write this:
3785
3786 (defcustom foo-blurgoze nil
3787 "*Non-nil means that foo will act very blurgozely."
3788 :type 'boolean
3789 :group foo)
3790
3791The type `boolean' means that this variable has only
3792two meaningful states: nil and non-nil. Other type values
3793describe other possibilities; see the manual for Custom
3794for a description of them.
3795
3796The "group" argument is used to specify a group which the option
3797should belong to. You define a new group like this:
3798
3799 (defgroup ispell nil
3800 "Spell checking using Ispell."
3801 :group 'processes)
3802
3803The "group" argument in defgroup specifies the parent group. The root
3804group is called `emacs'; it should not contain any variables itself,
3805but only other groups. The immediate subgroups of `emacs' correspond
3806to the keywords used by C-h p. Under these subgroups come
3807second-level subgroups that belong to individual packages.
3808
3809Each Emacs package should have its own set of groups. A simple
3810package should have just one group; a more complex package should
3811have a hierarchy of its own groups. The sole or root group of a
3812package should be a subgroup of one or more of the "keyword"
3813first-level subgroups.
3814
3815** New `widget' library for inserting UI components in buffers.
3816
3817This library, used by the new custom library, is documented in a
3818separate manual that accompanies Emacs.
3819
3820** easy-mmode
3821
3822The easy-mmode package provides macros and functions that make
3823developing minor modes easier. Roughly, the programmer has to code
3824only the functionality of the minor mode. All the rest--toggles,
3825predicate, and documentation--can be done in one call to the macro
3826`easy-mmode-define-minor-mode' (see the documentation). See also
3827`easy-mmode-define-keymap'.
3828
3829** Text property changes
3830
3831*** The `intangible' property now works on overlays as well as on a
3832text property.
3833
3834*** The new functions next-char-property-change and
3835previous-char-property-change scan through the buffer looking for a
3836place where either a text property or an overlay might change. The
3837functions take two arguments, POSITION and LIMIT. POSITION is the
3838starting position for the scan. LIMIT says where to stop the scan.
3839
3840If no property change is found before LIMIT, the value is LIMIT. If
3841LIMIT is nil, scan goes to the beginning or end of the accessible part
3842of the buffer. If no property change is found, the value is the
3843position of the beginning or end of the buffer.
3844
3845*** In the `local-map' text property or overlay property, the property
3846value can now be a symbol whose function definition is a keymap. This
3847is an alternative to using the keymap itself.
3848
3849** Changes in invisibility features
3850
3851*** Isearch can now temporarily show parts of the buffer which are
3852hidden by an overlay with a invisible property, when the search match
3853is inside that portion of the buffer. To enable this the overlay
3854should have a isearch-open-invisible property which is a function that
3855would be called having the overlay as an argument, the function should
3856make the overlay visible.
3857
3858During incremental search the overlays are shown by modifying the
3859invisible and intangible properties, if beside this more actions are
3860needed the overlay should have a isearch-open-invisible-temporary
3861which is a function. The function is called with 2 arguments: one is
3862the overlay and the second is nil when it should show the overlay and
3863t when it should hide it.
3864
3865*** add-to-invisibility-spec, remove-from-invisibility-spec
3866
3867Modes that use overlays to hide portions of a buffer should set the
3868invisible property of the overlay to the mode's name (or another symbol)
3869and modify the `buffer-invisibility-spec' to include that symbol.
3870Use `add-to-invisibility-spec' and `remove-from-invisibility-spec' to
3871manipulate the `buffer-invisibility-spec'.
3872Here is an example of how to do this:
3873
3874 ;; If we want to display an ellipsis:
3875 (add-to-invisibility-spec '(my-symbol . t))
3876 ;; If you don't want ellipsis:
3877 (add-to-invisibility-spec 'my-symbol)
3878
3879 ...
3880 (overlay-put (make-overlay beginning end) 'invisible 'my-symbol)
3881
3882 ...
3883 ;; When done with the overlays:
3884 (remove-from-invisibility-spec '(my-symbol . t))
3885 ;; Or respectively:
3886 (remove-from-invisibility-spec 'my-symbol)
3887
3888** Changes in syntax parsing.
3889
3890*** The syntax-directed buffer-scan functions (such as
3891`parse-partial-sexp', `forward-word' and similar functions) can now
3892obey syntax information specified by text properties, if the variable
3893`parse-sexp-lookup-properties' is non-nil.
3894
3895If the value of `parse-sexp-lookup-properties' is nil, the behavior
3896is as before: the syntax-table of the current buffer is always
3897used to determine the syntax of the character at the position.
3898
3899When `parse-sexp-lookup-properties' is non-nil, the syntax of a
3900character in the buffer is calculated thus:
3901
3902 a) if the `syntax-table' text-property of that character
3903 is a cons, this cons becomes the syntax-type;
3904
3905 Valid values of `syntax-table' text-property are: nil, a valid
3906 syntax-table, and a valid syntax-table element, i.e.,
3907 a cons cell of the form (SYNTAX-CODE . MATCHING-CHAR).
3908
3909 b) if the character's `syntax-table' text-property
3910 is a syntax table, this syntax table is used
3911 (instead of the syntax-table of the current buffer) to
3912 determine the syntax type of the character.
3913
3914 c) otherwise the syntax-type is determined by the syntax-table
3915 of the current buffer.
3916
3917*** The meaning of \s in regular expressions is also affected by the
3918value of `parse-sexp-lookup-properties'. The details are the same as
3919for the syntax-directed buffer-scan functions.
3920
3921*** There are two new syntax-codes, `!' and `|' (numeric values 14
3922and 15). A character with a code `!' starts a comment which is ended
3923only by another character with the same code (unless quoted). A
3924character with a code `|' starts a string which is ended only by
3925another character with the same code (unless quoted).
3926
3927These codes are mainly meant for use as values of the `syntax-table'
3928text property.
3929
3930*** The function `parse-partial-sexp' has new semantics for the sixth
3931arg COMMENTSTOP. If it is `syntax-table', parse stops after the start
3932of a comment or a string, or after end of a comment or a string.
3933
3934*** The state-list which the return value from `parse-partial-sexp'
3935(and can also be used as an argument) now has an optional ninth
3936element: the character address of the start of last comment or string;
3937nil if none. The fourth and eighth elements have special values if the
3938string/comment is started by a "!" or "|" syntax-code.
3939
3940*** Since new features of `parse-partial-sexp' allow a complete
3941syntactic parsing, `font-lock' no longer supports
3942`font-lock-comment-start-regexp'.
3943
3944** Changes in face features
3945
3946*** The face functions are now unconditionally defined in Emacs, even
3947if it does not support displaying on a device that supports faces.
3948
3949*** The function face-documentation returns the documentation string
3950of a face (or nil if it doesn't have one).
3951
3952*** The function face-bold-p returns t if a face should be bold.
3953set-face-bold-p sets that flag.
3954
3955*** The function face-italic-p returns t if a face should be italic.
3956set-face-italic-p sets that flag.
3957
3958*** You can now specify foreground and background colors for text
3959by adding elements of the form (foreground-color . COLOR-NAME)
3960and (background-color . COLOR-NAME) to the list of faces in
3961the `face' property (either the character's text property or an
3962overlay property).
3963
3964This means that you no longer need to create named faces to use
3965arbitrary colors in a Lisp package.
3966
3967** Changes in file-handling functions
3968
3969*** File-access primitive functions no longer discard an extra redundant
3970directory name from the beginning of the file name. In other words,
3971they no longer do anything special with // or /~. That conversion
3972is now done only in substitute-in-file-name.
3973
3974This makes it possible for a Lisp program to open a file whose name
3975begins with ~.
3976
3977*** If copy-file is unable to set the date of the output file,
3978it now signals an error with the condition file-date-error.
3979
3980*** The inode number returned by file-attributes may be an integer (if
3981the number fits in a Lisp integer) or a list of integers.
3982
3983*** insert-file-contents can now read from a special file,
3984as long as the arguments VISIT and REPLACE are nil.
3985
3986*** The RAWFILE arg to find-file-noselect, if non-nil, now suppresses
3987character code conversion as well as other things.
3988
3989Meanwhile, this feature does work with remote file names
3990(formerly it did not).
3991
3992*** Lisp packages which create temporary files should use the TMPDIR
3993environment variable to decide which directory to put them in.
3994
3995*** interpreter-mode-alist elements now specify regexps
3996instead of constant strings.
3997
3998*** expand-file-name no longer treats `//' or `/~' specially. It used
3999to delete all the text of a file name up through the first slash of
4000any `//' or `/~' sequence. Now it passes them straight through.
4001
4002substitute-in-file-name continues to treat those sequences specially,
4003in the same way as before.
4004
4005*** The variable `format-alist' is more general now.
4006The FROM-FN and TO-FN in a format definition can now be strings
4007which specify shell commands to use as filters to perform conversion.
4008
4009*** The new function access-file tries to open a file, and signals an
4010error if that fails. If the open succeeds, access-file does nothing
4011else, and returns nil.
4012
4013*** The function insert-directory now signals an error if the specified
4014directory cannot be listed.
4015
4016** Changes in minibuffer input
4017
4018*** The functions read-buffer, read-variable, read-command, read-string
4019read-file-name, read-from-minibuffer and completing-read now take an
4020additional argument which specifies the default value. If this
4021argument is non-nil, it should be a string; that string is used in two
4022ways:
4023
4024 It is returned if the user enters empty input.
4025 It is available through the history command M-n.
4026
4027*** The functions read-string, read-from-minibuffer,
4028read-no-blanks-input and completing-read now take an additional
4029argument INHERIT-INPUT-METHOD. If this is non-nil, then the
4030minibuffer inherits the current input method and the setting of
4031enable-multibyte-characters from the previously current buffer.
4032
4033In an interactive spec, you can use M instead of s to read an
4034argument in this way.
4035
4036*** All minibuffer input functions discard text properties
4037from the text you enter in the minibuffer, unless the variable
4038minibuffer-allow-text-properties is non-nil.
4039
4040** Echo area features
4041
4042*** Clearing the echo area now runs the normal hook
4043echo-area-clear-hook. Note that the echo area can be used while the
4044minibuffer is active; in that case, the minibuffer is still active
4045after the echo area is cleared.
4046
4047*** The function current-message returns the message currently displayed
4048in the echo area, or nil if there is none.
4049
4050** Keyboard input features
4051
4052*** tty-erase-char is a new variable that reports which character was
4053set up as the terminal's erase character when time Emacs was started.
4054
4055*** num-nonmacro-input-events is the total number of input events
4056received so far from the terminal. It does not count those generated
4057by keyboard macros.
4058
4059** Frame-related changes
4060
4061*** make-frame runs the normal hook before-make-frame-hook just before
4062creating a frame, and just after creating a frame it runs the abnormal
4063hook after-make-frame-functions with the new frame as arg.
4064
4065*** The new hook window-configuration-change-hook is now run every time
4066the window configuration has changed. The frame whose configuration
4067has changed is the selected frame when the hook is run.
4068
4069*** Each frame now independently records the order for recently
4070selected buffers, in its buffer-list frame parameter, so that the
4071value of other-buffer is now based on the buffers recently displayed
4072in the selected frame.
4073
4074*** The value of the frame parameter vertical-scroll-bars
4075is now `left', `right' or nil. A non-nil value specifies
4076which side of the window to put the scroll bars on.
4077
4078** X Windows features
4079
4080*** You can examine X resources for other applications by binding
4081x-resource-class around a call to x-get-resource. The usual value of
4082x-resource-class is "Emacs", which is the correct value for Emacs.
4083
4084*** In menus, checkboxes and radio buttons now actually work.
4085The menu displays the current status of the box or button.
4086
4087*** The function x-list-fonts now takes an optional fourth argument
4088MAXIMUM which sets a limit on how many matching fonts to return.
4089A smaller value of MAXIMUM makes the function faster.
4090
4091If the only question is whether *any* font matches the pattern,
4092it is good to supply 1 for this argument.
4093
4094** Subprocess features
4095
4096*** A reminder: it is no longer necessary for subprocess filter
4097functions and sentinels to do save-match-data, because Emacs does this
4098automatically.
4099
4100*** The new function shell-command-to-string executes a shell command
4101and returns the output from the command as a string.
4102
4103*** The new function process-contact returns t for a child process,
4104and (HOSTNAME SERVICE) for a net connection.
4105
4106** An error in running pre-command-hook or post-command-hook
4107does clear the variable to nil. The documentation was wrong before.
4108
4109** In define-key-after, if AFTER is t, the new binding now always goes
4110at the end of the keymap. If the keymap is a menu, this means it
4111goes after the other menu items.
4112
4113** If you have a program that makes several changes in the same area
4114of the buffer, you can use the macro combine-after-change-calls
4115around that Lisp code to make it faster when after-change hooks
4116are in use.
4117
4118The macro arranges to call the after-change functions just once for a
4119series of several changes--if that seems safe.
4120
4121Don't alter the variables after-change-functions and
4122after-change-function within the body of a combine-after-change-calls
4123form.
4124
4125** If you define an abbrev (with define-abbrev) whose EXPANSION
4126is not a string, then the abbrev does not expand in the usual sense,
4127but its hook is still run.
4128
4129** Normally, the Lisp debugger is not used (even if you have enabled it)
4130for errors that are handled by condition-case.
4131
4132If you set debug-on-signal to a non-nil value, then the debugger is called
4133regardless of whether there is a handler for the condition. This is
4134useful for debugging problems that happen inside of a condition-case.
4135
4136This mode of operation seems to be unreliable in other ways. Errors that
4137are normal and ought to be handled, perhaps in timers or process
4138filters, will instead invoke the debugger. So don't say you weren't
4139warned.
4140
4141** The new variable ring-bell-function lets you specify your own
4142way for Emacs to "ring the bell".
4143 539
4144** If run-at-time's TIME argument is t, the action is repeated at 540This release mostly fixes bugs. There are a few new features:
4145integral multiples of REPEAT from the epoch; this is useful for
4146functions like display-time.
4147 541
4148** You can use the function locate-library to find the precise file 542* apropos now sorts the symbols before displaying them.
4149name of a Lisp library. This isn't new, but wasn't documented before. 543 Also, it returns a list of the symbols found.
4150 544
4151** Commands for entering view mode have new optional arguments that 545 apropos now accepts a second arg PRED which should be a function
4152can be used from Lisp. Low-level entrance to and exit from view mode 546 of one argument; if PRED is non-nil, each symbol is tested
4153is done by functions view-mode-enter and view-mode-exit. 547 with PRED and only symbols for which PRED returns non-nil
548 appear in the output or the returned list.
4154 549
4155** batch-byte-compile-file now makes Emacs return a nonzero status code 550 If the third argument to apropos is non-nil, apropos does not
4156if there is an error in compilation. 551 display anything; it merely returns the list of symbols found.
4157 552
4158** pop-to-buffer, switch-to-buffer-other-window and 553 C-h a now runs the new function command-apropos rather than
4159switch-to-buffer-other-frame now accept an additional optional 554 apropos, and shows only symbols with definitions as commands.
4160argument NORECORD, much like switch-to-buffer. If it is non-nil,
4161they don't put the buffer at the front of the buffer list.
4162 555
4163** If your .emacs file leaves the *scratch* buffer non-empty, 556* M-x shell sends the command
4164Emacs does not display the startup message, so as to avoid changing 557 if (-f ~/.emacs_NAME)source ~/.emacs_NAME
4165the *scratch* buffer. 558 invisibly to the shell when it starts. Here NAME
559 is replaced by the name of shell used,
560 as it came from your ESHELL or SHELL environment variable
561 but with directory name, if any, removed.
4166 562
4167** The new function regexp-opt returns an efficient regexp to match a string. 563* M-, now runs the command tags-loop-continue, which is used
4168The arguments are STRINGS and (optionally) PAREN. This function can be used 564 to resume a terminated tags-search or tags-query-replace.
4169where regexp matching or searching is intensively used and speed is important,
4170e.g., in Font Lock mode.
4171
4172** The variable buffer-display-count is local to each buffer,
4173and is incremented each time the buffer is displayed in a window.
4174It starts at 0 when the buffer is created.
4175
4176** The new function compose-mail starts composing a mail message
4177using the user's chosen mail composition agent (specified with the
4178variable mail-user-agent). It has variants compose-mail-other-window
4179and compose-mail-other-frame.
4180
4181** The `user-full-name' function now takes an optional parameter which
4182can either be a number (the UID) or a string (the login name). The
4183full name of the specified user will be returned.
4184
4185** Lisp packages that load files of customizations, or any other sort
4186of user profile, should obey the variable init-file-user in deciding
4187where to find it. They should load the profile of the user name found
4188in that variable. If init-file-user is nil, meaning that the -q
4189option was used, then Lisp packages should not load the customization
4190files at all.
4191
4192** format-time-string now allows you to specify the field width
4193and type of padding. This works as in printf: you write the field
4194width as digits in the middle of a %-construct. If you start
4195the field width with 0, it means to pad with zeros.
4196
4197For example, %S normally specifies the number of seconds since the
4198minute; %03S means to pad this with zeros to 3 positions, %_3S to pad
4199with spaces to 3 positions. Plain %3S pads with zeros, because that
4200is how %S normally pads to two positions.
4201
4202** thing-at-point now supports a new kind of "thing": url.
4203
4204** imenu.el changes.
4205
4206You can now specify a function to be run when selecting an
4207item from menu created by imenu.
4208
4209An example of using this feature: if we define imenu items for the
4210#include directives in a C file, we can open the included file when we
4211select one of those items.
4212 565
4213* Emacs 19.34 is a bug-fix release with no user-visible changes. 566Changes in Emacs 1.7
567
568It's Beat CCA Week.
569
570* The initial buffer is now called "*scratch*" instead of "scratch",
571 so that all buffer names used automatically by Emacs now have *'s.
572
573* Undo information is now stored separately for each buffer.
574 The Undo command (C-x u) always applies to the current
575 buffer only.
576
577 C-_ is now a synonym for C-x u.
578
579 (buffer-flush-undo BUFFER) causes undo information not to
580 be kept for BUFFER, and frees the space that would have
581 been used to hold it. In any case, no undo information is
582 kept for buffers whose names start with spaces. (These
583 buffers also do not appear in the C-x C-b display.)
584
585* Rectangle operations are now implemented.
586 C-x r stores the rectangle described by dot and mark
587 into a register; it reads the register name from the keyboard.
588 C-x g, the command to insert the contents of a register,
589 can be used to reinsert the rectangle elsewhere.
590
591 Other rectangle commands include
592 open-rectangle:
593 insert a blank rectangle in the position and size
594 described by dot and mark, at its corners;
595 the existing text is pushed to the right.
596 clear-rectangle:
597 replace the rectangle described by dot ane mark
598 with blanks. The previous text is deleted.
599 delete-rectangle:
600 delete the text of the specified rectangle,
601 moving the text beyond it on each line leftward.
602
603* Side-by-side windows are allowed. Use C-x 5 to split the
604 current window into two windows side by side.
605 C-x } makes the selected window ARG columns wider at the
606 expense of the windows at its sides. C-x { makes the selected
607 window ARG columns narrower. An argument to C-x 5 specifies
608 how many columns to give to the leftmost of the two windows made.
609
610 C-x 2 now accepts a numeric argument to specify the number of
611 lines to give to the uppermost of the two windows it makes.
612
613* Horizontal scrolling of the lines in a window is now implemented.
614 C-x < (scroll-left) scrolls all displayed lines left,
615 with the numeric argument (default 1) saying how far to scroll.
616 When the window is scrolled left, some amount of the beginning
617 of each nonempty line is replaced by an "$".
618 C-x > scrolls right. If a window has no text hidden at the left
619 margin, it cannot be scrolled any farther right than that.
620 When nonzero leftwards scrolling is in effect in a window.
621 lines are automatically truncated at the window's right margin
622 regardless of the value of the variable truncate-lines in the
623 buffer being displayed.
624
625* C-x C-d now uses the default output format of `ls',
626 which gives just file names in multiple columns.
627 C-u C-x C-d passes the -l switch to `ls'.
628
629* C-t at the end of a line now exchanges the two preceding characters.
630
631 All the transpose commands now interpret zero as an argument
632 to mean to transpose the textual unit after or around dot
633 with the one after or around the mark.
634
635* M-! executes a shell command in an inferior shell
636 and displays the output from it. With a prefix argument,
637 it inserts the output in the current buffer after dot
638 and sets the mark after the output. The shell command
639 gets /dev/null as its standard input.
640
641 M-| is like M-! but passes the contents of the region
642 as input to the shell command. A prefix argument makes
643 the output from the command replace the contents of the region.
644
645* The mode line will now say "Def" after the major mode
646 while a keyboard macro is being defined.
647
648* The variable fill-prefix is now used by Meta-q.
649 Meta-q removes the fill prefix from lines that start with it
650 before filling, and inserts the fill prefix on each line
651 after filling.
652
653 The command C-x . sets the fill prefix equal to the text
654 on the current line before dot.
655
656* The new command Meta-j (indent-new-comment-line),
657 is like Linefeed (indent-new-line) except when dot is inside a comment;
658 in that case, Meta-j inserts a comment starter on the new line,
659 indented under the comment starter above. It also inserts
660 a comment terminator at the end of the line above,
661 if the language being edited calls for one.
662
663* Rmail should work correctly now, and has some C-h m documentation.
4214 664
4215* Changes in Emacs 19.33. 665Changes in Emacs 1.6
4216 666
4217** Bibtex mode no longer turns on Auto Fill automatically. (No major 667* save-buffers-kill-emacs is now on C-x C-c
4218mode should do that--it is the user's choice.) 668 while C-x C-z does suspend-emacs. This is to make
4219 669 C-x C-c like the normal Unix meaning of C-c
4220** The variable normal-auto-fill-function specifies the function to 670 and C-x C-z linke the normal Unix meaning of C-z.
4221use for auto-fill-function, if and when Auto Fill is turned on. 671
4222Major modes can set this locally to alter how Auto Fill works. 672* M-ESC (eval-expression) is now a disabled command by default.
673 This prevents users who type ESC ESC accidentally from
674 getting confusing results. Put
675 (put 'eval-expression 'disabled nil)
676 in your ~/.emacs file to enable the command.
677
678* Self-inserting text is grouped into bunches for undoing.
679 Each C-x u command undoes up to 20 consecutive self-inserting
680 characters.
681
682* Help f now uses as a default the function being called
683 in the innermost Lisp expression that dot is in.
684 This makes it more convenient to use while writing
685 Lisp code to run in Emacs.
686 (If the text around dot does not appear to be a call
687 to a Lisp function, there is no default.)
688
689 Likewise, Help v uses the symbol around or before dot
690 as a default, if that is a variable name.
691
692* Commands that read filenames now insert the default
693 directory in the minibuffer, to become part of your input.
694 This allows you to see what the default is.
695 You may type a filename which goes at the end of the
696 default directory, or you may edit the default directory
697 as you like to create the input you want to give.
698 You may also type an absolute pathname (starting with /)
699 or refer to a home directory (input starting with ~)
700 after the default; the presence of // or /~ causes
701 everything up through the slash that precedes your
702 type-in to be ignored.
703
704 Returning the default directory without change,
705 including the terminating slash, requests the use
706 of the default file name (usually the visited file's name).
707
708 Set the variable insert-default-directory to nil
709 to turn off this feature.
710
711* M-x shell now uses the environment variable ESHELL,
712 if it exists, as the file name of the shell to run.
713 If there is no ESHELL variable, the SHELL variable is used.
714 This is because some shells do not work properly as inferiors
715 of Emacs (or anything like Emacs).
716
717* A new variable minor-modes now exists, with a separate value
718 in each buffer. Its value should be an alist of elements
719 (MODE-FUNCTION-SYMBOL . PRETTY-NAME-STRING), one for each
720 minor mode that is turned on in the buffer. The pretty
721 name strings are displayed in the mode line after the name of the
722 major mode (with spaces between them). The mode function
723 symbols should be symbols whose function definitions will
724 turn on the minor mode if given 1 as an argument; they are present
725 so that Help m can find their documentation strings.
726
727* The format of tag table files has been changed.
728 The new format enables Emacs to find tags much faster.
729
730 A new program, etags, exists to make the kind of
731 tag table that Emacs wants. etags is invoked just
732 like ctags; in fact, if you give it any switches,
733 it does exactly what ctags would do. Give it the
734 empty switch ("-") to make it act like ctags with no switches.
735
736 etags names the tag table file "TAGS" rather than "tags",
737 so that these tag tables and the standard Unix ones
738 can coexist.
739
740 The tags library can no longer use standard ctags-style
741 tag tables files.
742
743* The file of Lisp code Emacs reads on startup is now
744 called ~/.emacs rather than ~/.emacs_pro.
745
746* copy-file now gives the copied file the same mode bits
747 as the original file.
748
749* Output from a process inserted into the process's buffer
750 no longer sets the buffer's mark. Instead it sets a
751 marker associated with the process to point to the end
752 of the inserted text. You can access this marker with
753 (process-mark PROCESS)
754 and then either examine its position with marker-position
755 or set its position with set-marker.
756
757* completing-read takes a new optional fifth argument which,
758 if non-nil, should be a string of text to insert into
759 the minibuffer before reading user commands.
760
761* The Lisp function elt now exists:
762 (elt ARRAY N) is like (aref ARRAY N),
763 (elt LIST N) is like (nth N LIST).
764
765* rplaca is now a synonym for setcar, and rplacd for setcdr.
766 eql is now a synonym for eq; it turns out that the Common Lisp
767 distinction between eq and eql is insignificant in Emacs.
768 numberp is a new synonym for integerp.
769
770* auto-save has been renamed to auto-save-mode.
771
772* Auto save file names for buffers are now created by the
773 function make-auto-save-file-name. This is so you can
774 redefine that function to change the way auto save file names
775 are chosen.
776
777* expand-file-name no longer discards a final slash.
778 (expand-file-name "foo" "/lose") => "/lose/foo"
779 (expand-file-name "foo/" "/lose") => "/lose/foo/"
780
781 Also, expand-file-name no longer substitutes $ constructs.
782 A new function substitute-in-file-name does this. Reading
783 a file name with read-file-name or the `f' or`F' option
784 of interactive calling uses substitute-in-file-name
785 on the file name that was read and returns the result.
786
787 All I/O primitives including insert-file-contents and
788 delete-file call expand-file-name on the file name supplied.
789 This change makes them considerably faster in the usual case.
790
791* Interactive calling spec strings allow the new code letter 'D'
792 which means to read a directory name. It is like 'f' except
793 that the default if the user makes no change in the minibuffer
794 is to return the current default directory rather than the
795 current visited file name.
4223 796
4224* Editing Changes in Emacs 19.32 797Changes in Emacs 1.5
4225
4226** C-x f with no argument now signals an error.
4227To set the fill column at the current column, use C-u C-x f.
4228
4229** Expanding dynamic abbrevs with M-/ is now smarter about case
4230conversion. If you type the abbreviation with mixed case, and it
4231matches the beginning of the expansion including case, then the
4232expansion is copied verbatim. Using SPC M-/ to copy an additional
4233word always copies it verbatim except when the previous copied word is
4234all caps.
4235
4236** On a non-windowing terminal, which can display only one Emacs frame
4237at a time, creating a new frame with C-x 5 2 also selects that frame.
4238
4239When using a display that can show multiple frames at once, C-x 5 2
4240does make the frame visible, but does not select it. This is the same
4241as in previous Emacs versions.
4242
4243** You can use C-x 5 2 to create multiple frames on MSDOS, just as on a
4244non-X terminal on Unix. Of course, only one frame is visible at any
4245time, since your terminal doesn't have the ability to display multiple
4246frames.
4247
4248** On Windows, set win32-pass-alt-to-system to a non-nil value
4249if you would like tapping the Alt key to invoke the Windows menu.
4250This feature is not enabled by default; since the Alt key is also the
4251Meta key, it is too easy and painful to activate this feature by
4252accident.
4253
4254** The command apply-macro-to-region-lines repeats the last defined
4255keyboard macro once for each complete line within the current region.
4256It does this line by line, by moving point to the beginning of that
4257line and then executing the macro.
4258
4259This command is not new, but was never documented before.
4260
4261** You can now use Mouse-1 to place the region around a string constant
4262(something surrounded by doublequote characters or other delimiter
4263characters of like syntax) by double-clicking on one of the delimiting
4264characters.
4265
4266** Font Lock mode
4267
4268*** Font Lock support modes
4269
4270Font Lock can be configured to use Fast Lock mode and Lazy Lock mode (see
4271below) in a flexible way. Rather than adding the appropriate function to the
4272hook font-lock-mode-hook, you can use the new variable font-lock-support-mode
4273to control which modes have Fast Lock mode or Lazy Lock mode turned on when
4274Font Lock mode is enabled.
4275
4276For example, to use Fast Lock mode when Font Lock mode is turned on, put:
4277
4278 (setq font-lock-support-mode 'fast-lock-mode)
4279
4280in your ~/.emacs.
4281
4282*** lazy-lock
4283
4284The lazy-lock package speeds up Font Lock mode by making fontification occur
4285only when necessary, such as when a previously unfontified part of the buffer
4286becomes visible in a window. When you create a buffer with Font Lock mode and
4287Lazy Lock mode turned on, the buffer is not fontified. When certain events
4288occur (such as scrolling), Lazy Lock makes sure that the visible parts of the
4289buffer are fontified. Lazy Lock also defers on-the-fly fontification until
4290Emacs has been idle for a given amount of time.
4291
4292To use this package, put in your ~/.emacs:
4293
4294 (setq font-lock-support-mode 'lazy-lock-mode)
4295
4296To control the package behaviour, see the documentation for `lazy-lock-mode'.
4297
4298** Changes in BibTeX mode.
4299
4300*** For all entries allow spaces and tabs between opening brace or
4301paren and key.
4302
4303*** Non-escaped double-quoted characters (as in `Sch"of') are now
4304supported.
4305
4306** Gnus changes.
4307
4308Gnus, the Emacs news reader, has undergone further rewriting. Many new
4309commands and variables have been added. There should be no
4310significant incompatibilities between this Gnus version and the
4311previously released version, except in the message composition area.
4312
4313Below is a list of the more user-visible changes. Coding changes
4314between Gnus 5.1 and 5.2 are more extensive.
4315
4316*** A new message composition mode is used. All old customization
4317variables for mail-mode, rnews-reply-mode and gnus-msg are now
4318obsolete.
4319
4320*** Gnus is now able to generate "sparse" threads -- threads where
4321missing articles are represented by empty nodes.
4322
4323 (setq gnus-build-sparse-threads 'some)
4324
4325*** Outgoing articles are stored on a special archive server.
4326
4327 To disable this: (setq gnus-message-archive-group nil)
4328
4329*** Partial thread regeneration now happens when articles are
4330referred.
4331
4332*** Gnus can make use of GroupLens predictions:
4333
4334 (setq gnus-use-grouplens t)
4335
4336*** A trn-line tree buffer can be displayed.
4337
4338 (setq gnus-use-trees t)
4339
4340*** An nn-like pick-and-read minor mode is available for the summary
4341buffers.
4342
4343 (add-hook 'gnus-summary-mode-hook 'gnus-pick-mode)
4344
4345*** In binary groups you can use a special binary minor mode:
4346
4347 `M-x gnus-binary-mode'
4348
4349*** Groups can be grouped in a folding topic hierarchy.
4350
4351 (add-hook 'gnus-group-mode-hook 'gnus-topic-mode)
4352
4353*** Gnus can re-send and bounce mail.
4354
4355 Use the `S D r' and `S D b'.
4356
4357*** Groups can now have a score, and bubbling based on entry frequency
4358is possible.
4359 798
4360 (add-hook 'gnus-summary-exit-hook 'gnus-summary-bubble-group) 799* suspend-emacs now accepts an optional argument
800 which is a string to be stuffed as terminal input
801 to be read by Emacs's superior shell after Emacs exits.
4361 802
4362*** Groups can be process-marked, and commands can be performed on 803 A library called ledit exists which uses this feature
4363groups of groups. 804 to transmit text to a Lisp job running as a sibling of
805 Emacs.
4364 806
4365*** Caching is possible in virtual groups. 807* If find-file is given the name of a directory,
808 it automatically invokes dired on that directory
809 rather than reading in the binary data that make up
810 the actual contents of the directory according to Unix.
4366 811
4367*** nndoc now understands all kinds of digests, mail boxes, rnews news 812* Saving an Emacs buffer now preserves the file modes
4368batches, ClariNet briefs collections, and just about everything else. 813 of any previously existing file with the same name.
814 This works using new Lisp functions file-modes and
815 set-file-modes, which can be used to read or set the mode
816 bits of any file.
4369 817
4370*** Gnus has a new backend (nnsoup) to create/read SOUP packets. 818* The Lisp function cond now exists, with its traditional meaning.
4371 819
4372*** The Gnus cache is much faster. 820* defvar and defconst now permit the documentation string
4373 821 to be omitted. defvar also permits the initial value
4374*** Groups can be sorted according to many criteria. 822 to be omitted; then it acts only as a comment.
4375
4376 For instance: (setq gnus-group-sort-function 'gnus-group-sort-by-rank)
4377
4378*** New group parameters have been introduced to set list-address and
4379expiration times.
4380
4381*** All formatting specs allow specifying faces to be used.
4382
4383*** There are several more commands for setting/removing/acting on
4384process marked articles on the `M P' submap.
4385
4386*** The summary buffer can be limited to show parts of the available
4387articles based on a wide range of criteria. These commands have been
4388bound to keys on the `/' submap.
4389
4390*** Articles can be made persistent -- as an alternative to saving
4391articles with the `*' command.
4392
4393*** All functions for hiding article elements are now toggles.
4394
4395*** Article headers can be buttonized.
4396
4397 (add-hook 'gnus-article-display-hook 'gnus-article-add-buttons-to-head)
4398
4399*** All mail backends support fetching articles by Message-ID.
4400
4401*** Duplicate mail can now be treated properly. See the
4402`nnmail-treat-duplicates' variable.
4403
4404*** All summary mode commands are available directly from the article
4405buffer.
4406
4407*** Frames can be part of `gnus-buffer-configuration'.
4408
4409*** Mail can be re-scanned by a daemonic process.
4410
4411*** Gnus can make use of NoCeM files to filter spam.
4412
4413 (setq gnus-use-nocem t)
4414
4415*** Groups can be made permanently visible.
4416
4417 (setq gnus-permanently-visible-groups "^nnml:")
4418
4419*** Many new hooks have been introduced to make customizing easier.
4420
4421*** Gnus respects the Mail-Copies-To header.
4422
4423*** Threads can be gathered by looking at the References header.
4424
4425 (setq gnus-summary-thread-gathering-function
4426 'gnus-gather-threads-by-references)
4427
4428*** Read articles can be stored in a special backlog buffer to avoid
4429refetching.
4430
4431 (setq gnus-keep-backlog 50)
4432
4433*** A clean copy of the current article is always stored in a separate
4434buffer to allow easier treatment.
4435
4436*** Gnus can suggest where to save articles. See `gnus-split-methods'.
4437
4438*** Gnus doesn't have to do as much prompting when saving.
4439
4440 (setq gnus-prompt-before-saving t)
4441
4442*** gnus-uu can view decoded files asynchronously while fetching
4443articles.
4444
4445 (setq gnus-uu-grabbed-file-functions 'gnus-uu-grab-view)
4446
4447*** Filling in the article buffer now works properly on cited text.
4448
4449*** Hiding cited text adds buttons to toggle hiding, and how much
4450cited text to hide is now customizable.
4451
4452 (setq gnus-cited-lines-visible 2)
4453
4454*** Boring headers can be hidden.
4455
4456 (add-hook 'gnus-article-display-hook 'gnus-article-hide-boring-headers)
4457
4458*** Default scoring values can now be set from the menu bar.
4459
4460*** Further syntax checking of outgoing articles have been added.
4461
4462The Gnus manual has been expanded. It explains all these new features
4463in greater detail.
4464 823
4465* Lisp Changes in Emacs 19.32 824Changes in Emacs 1.4
4466 825
4467** The function set-visited-file-name now accepts an optional 826* Auto-filling now normally indents the new line it creates
4468second argument NO-QUERY. If it is non-nil, then the user is not 827 by calling indent-according-to-mode. This function, meanwhile,
4469asked for confirmation in the case where the specified file already 828 has in Fundamental and Text modes the effect of making the line
4470exists. 829 have an indentation of the value of left-margin, a per-buffer variable.
4471 830
4472** The variable print-length applies to printing vectors and bitvectors, 831 Tab no longer precisely does indent-according-to-mode;
4473as well as lists. 832 it does that in all modes that supply their own indentation routine,
4474 833 but in Fundamental, Text and allied modes it inserts a tab character.
4475** The new function keymap-parent returns the parent keymap 834
4476of a given keymap. 835* The command M-x grep now invokes grep (on arguments
4477 836 supplied by the user) and reads the output from grep
4478** The new function set-keymap-parent specifies a new parent for a 837 asynchronously into a buffer. The command C-x ` can
4479given keymap. The arguments are KEYMAP and PARENT. PARENT must be a 838 be used to move to the lines that grep has found.
4480keymap or nil. 839 This is an adaptation of the mechanism used for
4481 840 running compilations and finding the loci of error messages.
4482** Sometimes menu keymaps use a command name, a symbol, which is really 841
4483an automatically generated alias for some other command, the "real" 842 You can now use C-x ` even while grep or compilation
4484name. In such a case, you should give that alias symbol a non-nil 843 is proceeding; as more matches or error messages arrive,
4485menu-alias property. That property tells the menu system to look for 844 C-x ` will parse them and be able to find them.
4486equivalent keys for the real name instead of equivalent keys for the 845
4487alias. 846* M-x mail now provides a command to send the message
847 and "exit"--that is, return to the previously selected
848 buffer. It is C-z C-z.
849
850* Tab in C mode now tries harder to adapt to all indentation styles.
851 If the line being indented is a statement that is not the first
852 one in the containing compound-statement, it is aligned under
853 the beginning of the first statement.
854
855* The functions screen-width and screen-height return the
856 total width and height of the screen as it is now being used.
857 set-screen-width and set-screen-height tell Emacs how big
858 to assume the screen is; they each take one argument,
859 an integer.
860
861* The Lisp function 'function' now exists. function is the
862 same as quote, except that it serves as a signal to the
863 Lisp compiler that the argument should be compiled as
864 a function. Example:
865 (mapcar (function (lambda (x) (+ x 5))) list)
866
867* The function set-key has been renamed to global-set-key.
868 undefine-key and local-undefine-key has been renamed to
869 global-unset-key and local-unset-key.
870
871* Emacs now collects input from asynchronous subprocesses
872 while waiting in the functions sleep-for and sit-for.
873
874* Shell mode's Newline command attempts to distinguish subshell
875 prompts from user input when issued in the middle of the buffer.
876 It no longer reexecutes from dot to the end of the line;
877 it reeexecutes the entire line minus any prompt.
878 The prompt is recognized by searching for the value of
879 shell-prompt-pattern, starting from the beginning of the line.
880 Anything thus skipped is not reexecuted.
4488 881
4489* Editing Changes in Emacs 19.31 882Changes in Emacs 1.3
4490 883
4491** Freedom of the press restricted in the United States. 884* An undo facility exists now. Type C-x u to undo a batch of
4492 885 changes (usually one command's changes, but some commands
4493Emacs has been censored in accord with the Communications Decency Act. 886 such as query-replace divide their changes into multiple
4494This includes removing some features of the doctor program. That law 887 batches. You can repeat C-x u to undo further. As long
4495was described by its supporters as a ban on pornography, but it bans 888 as no commands other than C-x u intervene, each one undoes
4496far more than that. The Emacs distribution has never contained any 889 another batch. A numeric argument to C-x u acts as a repeat
4497pornography, but parts of it were nonetheless prohibited. 890 count.
4498 891
4499For information on US government censorship of the Internet, and what 892 If you keep on undoing, eventually you may be told that
4500you can do to bring back freedom of the press, see the web site 893 you have used up all the recorded undo information.
4501`http://www.vtw.org/'. 894 Some actions, such as reading in files, discard all
4502 895 undo information.
4503** A note about C mode indentation customization. 896
4504 897 The undo information is not currently stored separately
4505The old (Emacs 19.29) ways of specifying a C indentation style 898 for each buffer, so it is mainly good if you do something
4506do not normally work in the new implementation of C mode. 899 totally spastic. [This has since been fixed.]
4507It has its own methods of customizing indentation, which are 900
4508much more powerful than the old C mode. See the Editing Programs 901* A learn-by-doing tutorial introduction to Emacs now exists.
4509chapter of the manual for details. 902 Type C-h t to enter it.
4510 903
4511However, you can load the library cc-compat to make the old 904* An Info documentation browser exists. Do M-x info to enter it.
4512customization variables take effect. 905 It contains a tutorial introduction so that no more documentation
4513 906 is needed here. As of now, the only documentation in it
4514** Marking with the mouse. 907 is that of Info itself.
4515 908
4516When you mark a region with the mouse, the region now remains 909* Help k and Help c are now different. Help c prints just the
4517highlighted until the next input event, regardless of whether you are 910 name of the function which the specified key invokes. Help k
4518using M-x transient-mark-mode. 911 prints the documentation of the function as well.
4519 912
4520** Improved Windows NT/95 support. 913* A document of the differences between GNU Emacs and Twenex Emacs
4521 914 now exists. It is called DIFF, in the same directory as this file.
4522*** Emacs now supports scroll bars on Windows NT and Windows 95. 915
4523 916* C mode can now indent comments better, including multi-line ones.
4524*** Emacs now supports subprocesses on Windows 95. (Subprocesses used 917 Meta-Control-q now reindents comment lines within the expression
4525to work on NT only and not on 95.) 918 being aligned.
4526 919
4527*** There are difficulties with subprocesses, though, due to problems 920* Insertion of a close-parenthesis now shows the matching open-parenthesis
4528in Windows, beyond the control of Emacs. They work fine as long as 921 even if it is off screen, by printing the text following it on its line
4529you run Windows applications. The problems arise when you run a DOS 922 in the minibuffer.
4530application in a subprocesses. Since current shells run as DOS 923
4531applications, these problems are significant. 924* A file can now contain a list of local variable values
4532 925 to be in effect when the file is edited. See the file DIFF
4533If you run a DOS application in a subprocess, then the application is 926 in the same directory as this file for full details.
4534likely to busy-wait, which means that your machine will be 100% busy. 927
4535However, if you don't mind the temporary heavy load, the subprocess 928* A function nth is defined. It means the same thing as in Common Lisp.
4536will work OK as long as you tell it to terminate before you start any 929
4537other DOS application as a subprocess. 930* The function install-command has been renamed to set-key.
4538 931 It now takes the key sequence as the first argument
4539Emacs is unable to terminate or interrupt a DOS subprocess. 932 and the definition for it as the second argument.
4540You have to do this by providing input directly to the subprocess. 933 Likewise, local-install-command has been renamed to local-set-key.
4541
4542If you run two DOS applications at the same time in two separate
4543subprocesses, even if one of them is asynchronous, you will probably
4544have to reboot your machine--until then, it will remain 100% busy.
4545Windows simply does not cope when one Windows process tries to run two
4546separate DOS subprocesses. Typing CTL-ALT-DEL and then choosing
4547Shutdown seems to work although it may take a few minutes.
4548
4549** M-x resize-minibuffer-mode.
4550
4551This command, not previously mentioned in NEWS, toggles a mode in
4552which the minibuffer window expands to show as many lines as the
4553minibuffer contains.
4554
4555** `title' frame parameter and resource.
4556
4557The `title' X resource now specifies just the frame title, nothing else.
4558It does not affect the name used for looking up other X resources.
4559It works by setting the new `title' frame parameter, which likewise
4560affects just the displayed title of the frame.
4561
4562The `name' parameter continues to do what it used to do:
4563it specifies the frame name for looking up X resources,
4564and also serves as the default for the displayed title
4565when the `title' parameter is unspecified or nil.
4566
4567** Emacs now uses the X toolkit by default, if you have a new
4568enough version of X installed (X11R5 or newer).
4569
4570** When you compile Emacs with the Motif widget set, Motif handles the
4571F10 key by activating the menu bar. To avoid confusion, the usual
4572Emacs binding of F10 is replaced with a no-op when using Motif.
4573
4574If you want to be able to use F10 in Emacs, you can rebind the Motif
4575menubar to some other key which you don't use. To do so, add
4576something like this to your X resources file. This example rebinds
4577the Motif menu bar activation key to S-F12:
4578
4579 Emacs*defaultVirtualBindings: osfMenuBar : Shift<Key>F12
4580
4581** In overwrite mode, DEL now inserts spaces in most cases
4582to replace the characters it "deletes".
4583
4584** The Rmail summary now shows the number of lines in each message.
4585
4586** Rmail has a new command M-x unforward-rmail-message, which extracts
4587a forwarded message from the message that forwarded it. To use it,
4588select a message which contains a forwarded message and then type the command.
4589It inserts the forwarded message as a separate Rmail message
4590immediately after the selected one.
4591
4592This command also undoes the textual modifications that are standardly
4593made, as part of forwarding, by Rmail and other mail reader programs.
4594
4595** Turning off saving of .saves-... files in your home directory.
4596
4597Each Emacs session writes a file named .saves-... in your home
4598directory to record which files M-x recover-session should recover.
4599If you exit Emacs normally with C-x C-c, it deletes that file. If
4600Emacs or the operating system crashes, the file remains for M-x
4601recover-session.
4602
4603You can turn off the writing of these files by setting
4604auto-save-list-file-name to nil. If you do this, M-x recover-session
4605will not work.
4606
4607Some previous Emacs versions failed to delete these files even on
4608normal exit. This is fixed now. If you are thinking of turning off
4609this feature because of past experiences with versions that had this
4610bug, it would make sense to check whether you still want to do so
4611now that the bug is fixed.
4612
4613** Changes to Version Control (VC)
4614
4615There is a new variable, vc-follow-symlinks. It indicates what to do
4616when you visit a link to a file that is under version control.
4617Editing the file through the link bypasses the version control system,
4618which is dangerous and probably not what you want.
4619
4620If this variable is t, VC follows the link and visits the real file,
4621telling you about it in the echo area. If it is `ask' (the default),
4622VC asks for confirmation whether it should follow the link. If nil,
4623the link is visited and a warning displayed.
4624
4625** iso-acc.el now lets you specify a choice of language.
4626Languages include "latin-1" (the default) and "latin-2" (which
4627is designed for entering ISO Latin-2 characters).
4628
4629There are also choices for specific human languages such as French and
4630Portuguese. These are subsets of Latin-1, which differ in that they
4631enable only the accent characters needed for particular language.
4632The other accent characters, not needed for the chosen language,
4633remain normal.
4634
4635** Posting articles and sending mail now has M-TAB completion on various
4636header fields (Newsgroups, To, CC, ...).
4637
4638Completion in the Newsgroups header depends on the list of groups
4639known to your news reader. Completion in the Followup-To header
4640offers those groups which are in the Newsgroups header, since
4641Followup-To usually just holds one of those.
4642
4643Completion in fields that hold mail addresses works based on the list
4644of local users plus your aliases. Additionally, if your site provides
4645a mail directory or a specific host to use for any unrecognized user
4646name, you can arrange to query that host for completion also. (See the
4647documentation of variables `mail-directory-process' and
4648`mail-directory-stream'.)
4649
4650** A greatly extended sgml-mode offers new features such as (to be configured)
4651skeletons with completing read for tags and attributes, typing named
4652characters including optionally all 8bit characters, making tags invisible
4653with optional alternate display text, skipping and deleting tag(pair)s.
4654
4655Note: since Emacs' syntax feature cannot limit the special meaning of ', " and
4656- to inside <>, for some texts the result, especially of font locking, may be
4657wrong (see `sgml-specials' if you get wrong results).
4658
4659The derived html-mode configures this with tags and attributes more or
4660less HTML3ish. It also offers optional quick keys like C-c 1 for
4661headline or C-c u for unordered list (see `html-quick-keys'). Edit /
4662Text Properties / Face or M-g combinations create tags as applicable.
4663Outline minor mode is supported and level 1 font-locking tries to
4664fontify tag contents (which only works when they fit on one line, due
4665to a limitation in font-lock).
4666
4667External viewing via browse-url can occur automatically upon saving.
4668
4669** M-x imenu-add-to-menubar now adds to the menu bar for the current
4670buffer only. If you want to put an Imenu item in the menu bar for all
4671buffers that use a particular major mode, use the mode hook, as in
4672this example:
4673
4674 (add-hook 'emacs-lisp-mode-hook
4675 '(lambda () (imenu-add-to-menubar "Index")))
4676
4677** Changes in BibTeX mode.
4678
4679*** Field names may now contain digits, hyphens, and underscores.
4680
4681*** Font Lock mode is now supported.
4682
4683*** bibtex-make-optional-field is no longer interactive.
4684
4685*** If bibtex-maintain-sorted-entries is non-nil, inserting new
4686entries is now done with a faster algorithm. However, inserting
4687will fail in this case if the buffer contains invalid entries or
4688isn't in sorted order, so you should finish each entry with C-c C-c
4689(bibtex-close-entry) after you have inserted or modified it.
4690The default value of bibtex-maintain-sorted-entries is nil.
4691
4692*** Function `show-all' is no longer bound to a key, since C-u C-c C-q
4693does the same job.
4694
4695*** Entries with quotes inside quote-delimited fields (as `author =
4696"Stefan Sch{\"o}f"') are now supported.
4697
4698*** Case in field names doesn't matter anymore when searching for help
4699text.
4700
4701** Font Lock mode
4702
4703*** Global Font Lock mode
4704
4705Font Lock mode can be turned on globally, in buffers that support it, by the
4706new command global-font-lock-mode. You can use the new variable
4707font-lock-global-modes to control which modes have Font Lock mode automagically
4708turned on. By default, this variable is set so that Font Lock mode is turned
4709on globally where the buffer mode supports it.
4710
4711For example, to automagically turn on Font Lock mode where supported, put:
4712
4713 (global-font-lock-mode t)
4714
4715in your ~/.emacs.
4716
4717*** Local Refontification
4718
4719In Font Lock mode, editing a line automatically refontifies that line only.
4720However, if your change alters the syntactic context for following lines,
4721those lines remain incorrectly fontified. To refontify them, use the new
4722command M-g M-g (font-lock-fontify-block).
4723
4724In certain major modes, M-g M-g refontifies the entire current function.
4725(The variable font-lock-mark-block-function controls how to find the
4726current function.) In other major modes, M-g M-g refontifies 16 lines
4727above and below point.
4728
4729With a prefix argument N, M-g M-g refontifies N lines above and below point.
4730
4731** Follow mode
4732
4733Follow mode is a new minor mode combining windows showing the same
4734buffer into one tall "virtual window". The windows are typically two
4735side-by-side windows. Follow mode makes them scroll together as if
4736they were a unit. To use it, go to a frame with just one window,
4737split it into two side-by-side windows using C-x 3, and then type M-x
4738follow-mode.
4739
4740M-x follow-mode turns off Follow mode if it is already enabled.
4741
4742To display two side-by-side windows and activate Follow mode, use the
4743command M-x follow-delete-other-windows-and-split.
4744
4745** hide-show changes.
4746
4747The hooks hs-hide-hooks and hs-show-hooks have been renamed
4748to hs-hide-hook and hs-show-hook, to follow the convention for
4749normal hooks.
4750
4751** Simula mode now has a menu containing the most important commands.
4752The new command simula-indent-exp is bound to C-M-q.
4753
4754** etags can now handle programs written in Erlang. Files are
4755recognised by the extensions .erl and .hrl. The tagged lines are
4756those that begin a function, record, or macro.
4757
4758** MSDOS Changes
4759
4760*** It is now possible to compile Emacs with the version 2 of DJGPP.
4761Compilation with DJGPP version 1 also still works.
4762
4763*** The documentation of DOS-specific aspects of Emacs was rewritten
4764and expanded; see the ``MS-DOS'' node in the on-line docs.
4765
4766*** Emacs now uses ~ for backup file names, not .bak.
4767
4768*** You can simulate mouse-3 on two-button mice by simultaneously
4769pressing both mouse buttons.
4770
4771*** A number of packages and commands which previously failed or had
4772restricted functionality on MS-DOS, now work. The most important ones
4773are:
4774
4775**** Printing (both with `M-x lpr-buffer' and with `ps-print' package)
4776now works.
4777
4778**** `Ediff' works (in a single-frame mode).
4779
4780**** `M-x display-time' can be used on MS-DOS (due to the new
4781implementation of Emacs timers, see below).
4782
4783**** `Dired' supports Unix-style shell wildcards.
4784
4785**** The `c-macro-expand' command now works as on other platforms.
4786
4787**** `M-x recover-session' works.
4788
4789**** `M-x list-colors-display' displays all the available colors.
4790
4791**** The `TPU-EDT' package works.
4792 934
4793* Lisp changes in Emacs 19.31. 935Changes in Emacs 1.2
4794 936
4795** The function using-unix-filesystems on Windows NT and Windows 95 937* A Lisp single-stepping and debugging facility exists.
4796tells Emacs to read and write files assuming that they reside on a 938 To cause the debugger to be entered when an error
4797remote Unix filesystem. No CR/LF translation is done on any files in 939 occurs, set the variable debug-on-error non-nil.
4798this case. Invoking using-unix-filesystems with t activates this 940
4799behavior, and invoking it with any other value deactivates it. 941 To cause the debugger to be entered whenever function foo
4800 942 is called, do (debug-on-entry 'foo). To cancel this,
4801** Change in system-type and system-configuration values. 943 do (cancel-debug-on-entry 'foo). debug-on-entry does
4802 944 not work for primitives (written in C), only functions
4803The value of system-type on a Linux-based GNU system is now `lignux', 945 written in Lisp. Most standard Emacs commands are in Lisp.
4804not `linux'. This means that some programs which use `system-type' 946
4805need to be changed. The value of `system-configuration' will also 947 When the debugger is entered, the selected window shows
4806be different. 948 a buffer called " *Backtrace" which displays a series
4807 949 of stack frames, most recently entered first. For each
4808It is generally recommended to use `system-configuration' rather 950 frame, the function name called is shown, usually followed
4809than `system-type'. 951 by the argument values unless arguments are still being
4810 952 calculated. At the beginning of the buffer is a description
4811See the file LINUX-GNU in this directory for more about this. 953 of why the debugger was entered: function entry, function exit,
4812 954 error, or simply that the user called the function `debug'.
4813** The functions shell-command and dired-call-process 955
4814now run file name handlers for default-directory, if it has them. 956 To exit the debugger and return to top level, type `q'.
4815 957
4816** Undoing the deletion of text now restores the positions of markers 958 In the debugger, you can evaluate Lisp expressions by
4817that pointed into or next to the deleted text. 959 typing `e'. This is equivalent to `M-ESC'.
4818 960
4819** Timers created with run-at-time now work internally to Emacs, and 961 When the debugger is entered due to an error, that is
4820no longer use a separate process. Therefore, they now work more 962 all you can do. When it is entered due to function entry
4821reliably and can be used for shorter time delays. 963 (such as, requested by debug-on-entry), you have two
4822 964 options:
4823The new function run-with-timer is a convenient way to set up a timer 965 Continue execution and reenter debugger after the
4824to run a specified amount of time after the present. A call looks 966 completion of the function being entered. Type `c'.
4825like this: 967 Continue execution but enter the debugger before
4826 968 the next subexpression. Type `d'.
4827 (run-with-timer SECS REPEAT FUNCTION ARGS...) 969
4828 970 You will see that some stack frames are marked with *.
4829SECS says how many seconds should elapse before the timer happens. 971 This means the debugger will be entered when those
4830It may be an integer or a floating point number. When the timer 972 frames exit. You will see the value being returned
4831becomes ripe, the action is to call FUNCTION with arguments ARGS. 973 in the first line of the backtrace buffer. Your options:
4832 974 Continue execution, and return that value. Type `c'.
4833REPEAT gives the interval for repeating the timer (measured in 975 Continue execution, and return a specified value. Type `r'.
4834seconds). It may be an integer or a floating point number. nil or 0 976
4835means don't repeat at all--call FUNCTION just once. 977 You can mark a frame to enter the debugger on exit
4836 978 with the `b' command, or clear such a mark with `u'.
4837*** with-timeout provides an easy way to do something but give 979
4838up if too much time passes. 980* Lisp macros now exist.
4839 981 For example, you can write
4840 (with-timeout (SECONDS TIMEOUT-FORMS...) BODY...) 982 (defmacro cadr (arg) (list 'car (list 'cdr arg)))
4841 983 and then the expression
4842This executes BODY, but gives up after SECONDS seconds. 984 (cadr foo)
4843If it gives up, it runs the TIMEOUT-FORMS and returns the value 985 will expand into
4844of the last one of them. Normally it returns the value of the last 986 (car (cdr foo))
4845form in BODY. 987
4846 988Changes in Emacs 1.1
4847*** You can now arrange to call a function whenever Emacs is idle for 989
4848a certain length of time. To do this, call run-with-idle-timer. A 990* The initial buffer is now called "scratch" and is in a
4849call looks like this: 991 new major mode, Lisp Interaction mode. This mode is
4850 992 intended for typing Lisp expressions, evaluating them,
4851 (run-with-idle-timer SECS REPEAT FUNCTION ARGS...) 993 and having the values printed into the buffer.
4852 994
4853SECS says how many seconds of idleness should elapse before the timer 995 Type Linefeed after a Lisp expression, to evaluate the
4854runs. It may be an integer or a floating point number. When the 996 expression and have its value printed into the buffer,
4855timer becomes ripe, the action is to call FUNCTION with arguments 997 advancing dot.
4856ARGS. 998
4857 999 The other commands of Lisp mode are available.
4858Emacs becomes idle whenever it finishes executing a keyboard or mouse 1000
4859command. It remains idle until it receives another keyboard or mouse 1001* The C-x C-e command for evaluating the Lisp expression
4860command. 1002 before dot has been changed to print the value in the
4861 1003 minibuffer line rather than insert it in the buffer.
4862REPEAT, if non-nil, means this timer should be activated again each 1004 A numeric argument causes the printed value to appear
4863time Emacs becomes idle and remains idle for SECS seconds The timer 1005 in the buffer instead.
4864does not repeat if Emacs *remains* idle; it runs at most once after 1006
4865each time Emacs becomes idle. 1007* In Lisp mode, the command M-C-x evaluates the defun
4866 1008 containing or following dot. The value is printed in
4867If REPEAT is nil, the timer runs just once, the first time Emacs is 1009 the minibuffer.
4868idle for SECS seconds. 1010
4869 1011* The value of a Lisp expression evaluated using M-ESC
4870*** post-command-idle-hook is now obsolete; you shouldn't use it at 1012 is now printed in the minibuffer.
4871all, because it interferes with the idle timer mechanism. If your 1013
4872programs use post-command-idle-hook, convert them to use idle timers 1014* M-q now runs fill-paragraph, independent of major mode.
4873instead. 1015
4874 1016* C-h m now prints documentation on the current buffer's
4875*** y-or-n-p-with-timeout lets you ask a question but give up if 1017 major mode. What it prints is the documentation of the
4876there is no answer within a certain time. 1018 major mode name as a function. All major modes have been
4877 1019 equipped with documentation that describes all commands
4878 (y-or-n-p-with-timeout PROMPT SECONDS DEFAULT-VALUE) 1020 peculiar to the major mode, for this purpose.
4879 1021
4880asks the question PROMPT (just like y-or-n-p). If the user answers 1022* You can display a Unix manual entry with
4881within SECONDS seconds, it returns the answer that the user gave. 1023 the M-x manual-entry command.
4882Otherwise it gives up after SECONDS seconds, and returns DEFAULT-VALUE. 1024
4883 1025* You can run a shell, displaying its output in a buffer,
4884** Minor change to `encode-time': you can now pass more than seven 1026 with the M-x shell command. The Return key sends input
4885arguments. If you do that, the first six arguments have the usual 1027 to the subshell. Output is printed inserted automatically
4886meaning, the last argument is interpreted as the time zone, and the 1028 in the buffer. Commands C-c, C-d, C-u, C-w and C-z are redefined
4887arguments in between are ignored. 1029 for controlling the subshell and its subjobs.
4888 1030 "cd", "pushd" and "popd" commands are recognized as you
4889This means that it works to use the list returned by `decode-time' as 1031 enter them, so that the default directory of the Emacs buffer
4890the list of arguments for `encode-time'. 1032 always remains the same as that of the subshell.
4891 1033
4892** The default value of load-path now includes the directory 1034* C-x $ (that's a real dollar sign) controls line-hiding based
4893/usr/local/share/emacs/VERSION/site-lisp In addition to 1035 on indentation. With a numeric arg N > 0, it causes all lines
4894/usr/local/share/emacs/site-lisp. You can use this new directory for 1036 indented by N or more columns to become invisible.
4895site-specific Lisp packages that belong with a particular Emacs 1037 They are, effectively, tacked onto the preceding line, where
4896version. 1038 they are represented by " ..." on the screen.
4897 1039 (The end of the preceding visible line corresponds to a
4898It is not unusual for a Lisp package that works well in one Emacs 1040 screen cursor position before the "...". Anywhere in the
4899version to cause trouble in another. Sometimes packages need updating 1041 invisible lines that follow appears on the screen as a cursor
4900for incompatible changes; sometimes they look at internal data that 1042 position after the "...".)
4901has changed; sometimes the package has been installed in Emacs itself 1043 Currently, all editing commands treat invisible lines just
4902and the installed version should be used. Whatever the reason for the 1044 like visible ones, except for C-n and C-p, which have special
4903problem, this new feature makes it easier to solve. 1045 code to count visible lines only.
4904 1046 C-x $ with no argument turns off this mode, which in any case
4905** When your program contains a fixed file name (like .completions or 1047 is remembered separately for each buffer.
4906.abbrev.defs), the file name usually needs to be different on operating 1048
4907systems with limited file name syntax. 1049* Outline mode is another form of selective display.
4908 1050 It is a major mode invoked with M-x outline-mode.
4909Now you can avoid ad-hoc conditionals by using the function 1051 It is intended for editing files that are structured as
4910convert-standard-filename to convert the file name to a proper form 1052 outlines, with heading lines (lines that begin with one
4911for each operating system. Here is an example of use, from the file 1053 or more asterisks) and text lines (all other lines).
4912completions.el: 1054 The number of asterisks in a heading line are its level;
4913 1055 the subheadings of a heading line are all following heading
4914(defvar save-completions-file-name 1056 lines at higher levels, until but not including the next
4915 (convert-standard-filename "~/.completions") 1057 heading line at the same or a lower level, regardless
4916 "*The filename to save completions to.") 1058 of intervening text lines.
4917 1059
4918This sets the variable save-completions-file-name to a value that 1060 In outline mode, you have commands to hide (remove from display)
4919depends on the operating system, because the definition of 1061 or show the text or subheadings under each heading line
4920convert-standard-filename depends on the operating system. On 1062 independently. Hidden text or subheadings are invisibly
4921Unix-like systems, it returns the specified file name unchanged. On 1063 attached to the end of the preceding heading line, so that
4922MS-DOS, it adapts the name to fit the limitations of that system. 1064 if you kill the hading line and yank it back elsewhere
4923 1065 all the invisible lines accompany it.
4924** The interactive spec N now returns the numeric prefix argument 1066
4925rather than the raw prefix argument. (It still reads a number using the 1067 All editing commands treat hidden outline-mode lines
4926minibuffer if there is no prefix argument at all.) 1068 as part of the preceding visible line.
4927 1069
4928** When a process is deleted, this no longer disconnects the process 1070* C-x C-z runs save-buffers-kill-emacs
4929marker from its buffer position. 1071 offers to save each file buffer, then exits.
4930 1072
4931** The variable garbage-collection-messages now controls whether 1073* C-c's function is now called suspend-emacs.
4932Emacs displays a message at the beginning and end of garbage collection. 1074
4933The default is nil, meaning there are no messages. 1075* The command C-x m runs mail, which switches to a buffer *mail*
4934 1076 and lets you compose a message to send. C-x 4 m runs mail in
4935** The variable debug-ignored-errors specifies certain kinds of errors 1077 another window. Type C-z C-s in the mail buffer to send the
4936that should not enter the debugger. Its value is a list of error 1078 message according to what you have entered in the buffer.
4937condition symbols and/or regular expressions. If the error has any 1079
4938of the condition symbols listed, or if any of the regular expressions 1080 You must separate the headers from the message text with
4939matches the error message, then that error does not enter the debugger, 1081 an empty line.
4940regardless of the value of debug-on-error. 1082
4941 1083* You can now dired partial directories (specified with names
4942This variable is initialized to match certain common but uninteresting 1084 containing *'s, etc, all processed by the shell). Also, you
4943errors that happen often during editing. 1085 can dired more than one directory; dired names the buffer
4944 1086 according to the filespec or directory name. Reinvoking
4945** The new function error-message-string converts an error datum 1087 dired on a directory already direded just switches back to
4946into its error message. The error datum is what condition-case 1088 the same directory used last time; do M-x revert if you want
4947puts into the variable, to describe the error that happened. 1089 to read in the current contents of the directory.
4948 1090
4949** Anything that changes which buffer appears in a given window 1091 C-x d runs dired, and C-x 4 d runs dired in another window.
4950now runs the window-scroll-functions for that window. 1092
4951 1093 C-x C-d (list-directory) also allows partial directories now.
4952** The new function get-buffer-window-list returns a list of windows displaying 1094
4953a buffer. The function is called with the buffer (a buffer object or a buffer 1095Lisp programming changes
4954name) and two optional arguments specifying the minibuffer windows and frames 1096
4955to search. Therefore this function takes optional args like next-window etc., 1097* t as an output stream now means "print to the minibuffer".
4956and not get-buffer-window. 1098 If there is already text in the minibuffer printed via t
4957 1099 as an output stream, the new text is appended to the old
4958** buffer-substring now runs the hook buffer-access-fontify-functions, 1100 (or is truncated and lost at the margin). If the minibuffer
4959calling each function with two arguments--the range of the buffer 1101 contains text put there for some other reason, it is cleared
4960being accessed. buffer-substring-no-properties does not call them. 1102 first.
4961 1103
4962If you use this feature, you should set the variable 1104 t is now the top-level value of standard-output.
4963buffer-access-fontified-property to a non-nil symbol, which is a 1105
4964property name. Then, if all the characters in the buffer range have a 1106 t as an input stream now means "read via the minibuffer".
4965non-nil value for that property, the buffer-access-fontify-functions 1107 The minibuffer is used to read a line of input, with editing,
4966are not called. When called, these functions should put a non-nil 1108 and this line is then parsed. Any excess not used by `read'
4967property on the text that they fontify, so that they won't get called 1109 is ignored; each `read' from t reads fresh input.
4968over and over for the same text. 1110 t is now the top-level value of standard-input.
4969 1111
4970** Changes in lisp-mnt.el 1112* A marker may be used as an input stream or an output stream.
4971 1113 The effect is to grab input from where the marker points,
4972*** The lisp-mnt package can now recognize file headers that are written 1114 advancing it over the characters read, or to insert output
4973in the formats used by the `what' command and the RCS `ident' command: 1115 at the marker and advance it.
4974 1116
4975;; @(#) HEADER: text 1117* Output from an asynchronous subprocess is now inserted at
4976;; $HEADER: text $ 1118 the end of the associated buffer, not at the buffer's dot,
4977 1119 and the buffer's mark is set to the end of the inserted output
4978in addition to the normal 1120 each time output is inserted.
4979 1121
4980;; HEADER: text 1122* (pos-visible-in-window-p POS WINDOW)
4981 1123 returns t if position POS in WINDOW's buffer is in the range
4982*** The commands lm-verify and lm-synopsis are now interactive. lm-verify 1124 that is being displayed in WINDOW; nil if it is scrolled
4983checks that the library file has proper sections and headers, and 1125 vertically out of visibility.
4984lm-synopsis extracts first line "synopsis'"information. 1126
1127 If display in WINDOW is not currently up to date, this function
1128 calculates carefully whether POS would appear if display were
1129 done immediately based on the current (window-start WINDOW).
1130
1131 POS defaults to (dot), and WINDOW to (selected-window).
1132
1133* Variable buffer-alist replaced by function (buffer-list).
1134 The actual alist of buffers used internally by Emacs is now
1135 no longer accessible, to prevent the user from crashing Emacs
1136 by modifying it. The function buffer-list returns a list
1137 of all existing buffers. Modifying this list cannot hurt anything
1138 as a new list is constructed by each call to buffer-list.
1139
1140* load now takes an optional third argument NOMSG which, if non-nil,
1141 prevents load from printing a message when it starts and when
1142 it is done.
1143
1144* byte-recompile-directory is a new function which finds all
1145 the .elc files in a directory, and regenerates each one which
1146 is older than the corresponding .el (Lisp source) file.
4985 1147
4986* For older news, see the file ONEWS.
4987
4988---------------------------------------------------------------------- 1148----------------------------------------------------------------------
4989Copyright information: 1149Copyright information:
4990 1150
4991Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc. 1151Copyright (C) 1985 Richard M. Stallman
4992 1152
4993 Permission is granted to anyone to make or distribute verbatim copies 1153 Permission is granted to anyone to make or distribute verbatim copies
4994 of this document as received, in any medium, provided that the 1154 of this document as received, in any medium, provided that the
@@ -5001,6 +1161,5 @@ Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
5001 carry prominent notices stating who last changed them. 1161 carry prominent notices stating who last changed them.
5002 1162
5003Local variables: 1163Local variables:
5004mode: outline 1164mode: text
5005paragraph-separate: "[ ]*$"
5006end: 1165end:
diff --git a/etc/OOOONEWS b/etc/NEWS.2
index 26ca0281c54..96dabd85968 100644
--- a/etc/OOOONEWS
+++ b/etc/NEWS.2
@@ -2,7 +2,7 @@ GNU Emacs NEWS -- history of user-visible changes. 26-Mar-1986
2Copyright (C) 1986 Richard M. Stallman. 2Copyright (C) 1986 Richard M. Stallman.
3See the end for copying conditions. 3See the end for copying conditions.
4 4
5For older news, see the file OOOOONEWS. 5For older news, see the file NEWS.1.
6 6
7Changes in Emacs 17 7Changes in Emacs 17
8 8
@@ -1326,7 +1326,7 @@ except when `-batch' has been specified.
1326 1326
1327This is because -batch (see above) is now used in building Emacs. 1327This is because -batch (see above) is now used in building Emacs.
1328 1328
1329For older news, see the file OOOONEWS. 1329For older news, see the file NEWS.1.
1330 1330
1331---------------------------------------------------------------------- 1331----------------------------------------------------------------------
1332Copyright information: 1332Copyright information:
diff --git a/etc/OOONEWS b/etc/NEWS.3
index 68f9fabe6f7..224d958ab05 100644
--- a/etc/OOONEWS
+++ b/etc/NEWS.3
@@ -2,7 +2,7 @@ GNU Emacs NEWS -- history of user-visible changes. 17-Aug-1988
2Copyright (C) 1988 Free Software Foundation, Inc. 2Copyright (C) 1988 Free Software Foundation, Inc.
3See the end for copying conditions. 3See the end for copying conditions.
4 4
5For older news, see the file OOOONEWS. 5For older news, see the file NEWS.2.
6 6
7Changes in version 18.52. 7Changes in version 18.52.
8 8
@@ -1587,7 +1587,7 @@ C_DEBUG_SWITCH defines the switches to give `cc' when debugging. Default `-g'.
1587C_OPTIMIZE_SWITCH defines the switches to give `cc' to optimize. Default `-O'. 1587C_OPTIMIZE_SWITCH defines the switches to give `cc' to optimize. Default `-O'.
1588C_SWITCH_MACHINE can be defined by the m- file to specify extra `cc' switches. 1588C_SWITCH_MACHINE can be defined by the m- file to specify extra `cc' switches.
1589 1589
1590For older news, see the file OOONEWS. 1590For older news, see the file NEWS.2.
1591 1591
1592---------------------------------------------------------------------- 1592----------------------------------------------------------------------
1593Copyright information: 1593Copyright information:
diff --git a/etc/OONEWS b/etc/NEWS.4
index f6f31d11895..9779d5a0fbe 100644
--- a/etc/OONEWS
+++ b/etc/NEWS.4
@@ -2,7 +2,7 @@ GNU Emacs NEWS -- history of user-visible changes. 1992.
2Copyright (C) 1992 Free Software Foundation, Inc. 2Copyright (C) 1992 Free Software Foundation, Inc.
3See the end for copying conditions. 3See the end for copying conditions.
4 4
5For older news, see the file OOONEWS. 5For older news, see the file NEWS.3.
6 6
7Changes in version 18.58. 7Changes in version 18.58.
8 8
@@ -1669,7 +1669,7 @@ C_DEBUG_SWITCH defines the switches to give `cc' when debugging. Default `-g'.
1669C_OPTIMIZE_SWITCH defines the switches to give `cc' to optimize. Default `-O'. 1669C_OPTIMIZE_SWITCH defines the switches to give `cc' to optimize. Default `-O'.
1670C_SWITCH_MACHINE can be defined by the m- file to specify extra `cc' switches. 1670C_SWITCH_MACHINE can be defined by the m- file to specify extra `cc' switches.
1671 1671
1672For older news, see the file OONEWS. 1672For older news, see the file NEWS.3.
1673 1673
1674---------------------------------------------------------------------- 1674----------------------------------------------------------------------
1675Copyright information: 1675Copyright information:
diff --git a/etc/ONEWS b/etc/ONEWS
index 933d338b5a9..534e603e3c7 100644
--- a/etc/ONEWS
+++ b/etc/ONEWS
@@ -2,7 +2,7 @@ GNU Emacs NEWS -- history of user-visible changes. 1992.
2Copyright (C) 1995 Free Software Foundation, Inc. 2Copyright (C) 1995 Free Software Foundation, Inc.
3See the end for copying conditions. 3See the end for copying conditions.
4 4
5For older news, see the file OONEWS. 5For older news, see the file NEWS.4.
6 6
7* Editing Changes in Emacs 19.30. 7* Editing Changes in Emacs 19.30.
8 8
@@ -254,7 +254,7 @@ your working file with the latest version from the master.
254*** RCS customization. 254*** RCS customization.
255 255
256There is a new variable vc-consult-headers. If it is t (the default), 256There is a new variable vc-consult-headers. If it is t (the default),
257VC searches for RCS headers in working files (like `$Id$') and 257VC searches for RCS headers in working files (like `$Id: ONEWS,v 1.1 1999/10/03 11:59:45 fx Exp $') and
258determines the state of the file from them, not from the master file. 258determines the state of the file from them, not from the master file.
259This is fast and more reliable when you use branches. (The variable 259This is fast and more reliable when you use branches. (The variable
260was already present in Emacs 19.29, but didn't get mentioned in the 260was already present in Emacs 19.29, but didn't get mentioned in the
@@ -5685,7 +5685,7 @@ old file versions, executables, DOC files, and other
5685architecture-specific or easy-to-recreate files are not included in 5685architecture-specific or easy-to-recreate files are not included in
5686the tar file. 5686the tar file.
5687 5687
5688* For older news, see the file OONEWS. For Lisp changes in (the first 5688* For older news, see the file NEWS.4. For Lisp changes in (the first
5689* release of) Emacs 19, see the file LNEWS. 5689* release of) Emacs 19, see the file LNEWS.
5690 5690
5691---------------------------------------------------------------------- 5691----------------------------------------------------------------------
diff --git a/etc/OOOOONEWS b/etc/OOOOONEWS
deleted file mode 100644
index 06b5405be1e..00000000000
--- a/etc/OOOOONEWS
+++ /dev/null
@@ -1,1165 +0,0 @@
1Old GNU Emacs NEWS -- history of user-visible changes thru version 15.
2Copyright (C) 1985 Richard M. Stallman.
3See the end for copying conditions.
4
5Changes in Emacs 15
6
7* Emacs now runs on Sun and Megatest 68000 systems;
8 also on at least one 16000 system running 4.2.
9
10* Emacs now alters the output-start and output-stop characters
11 to prevent C-s and C-q from being considered as flow control
12 by cretinous rlogin software in 4.2.
13
14* It is now possible convert Mocklisp code (for Gosling Emacs) to Lisp code
15 that can run in GNU Emacs. M-x convert-mocklisp-buffer
16 converts the contents of the current buffer from Mocklisp to
17 GNU Emacs Lisp. You should then save the converted buffer with C-x C-w
18 under a name ending in ".el"
19
20 There are probably some Mocklisp constructs that are not handled.
21 If you encounter one, feel free to report the failure as a bug.
22 The construct will be handled in a future Emacs release, if that is not
23 not too hard to do.
24
25 Note that lisp code converted from Mocklisp code will not necessarily
26 run as fast as code specifically written for GNU Emacs, nor will it use
27 the many features of GNU Emacs which are not present in Gosling's emacs.
28 (In particular, the byte-compiler (m-x byte-compile-file) knows little
29 about compilation of code directly converted from mocklisp.)
30 It is envisaged that old mocklisp code will be incrementally converted
31 to GNU lisp code, with M-x convert-mocklisp-buffer being the first
32 step in this process.
33
34* Control-x n (narrow-to-region) is now by default a disabled command.
35
36 This means that, if you issue this command, it will ask whether
37 you really mean it. You have the opportunity to enable the
38 command permanently at that time, so you will not be asked again.
39 This will place the form "(put 'narrow-to-region 'disabled nil)" in your
40 .emacs file.
41
42* Tags now prompts for the tag table file name to use.
43
44 All the tags commands ask for the tag table file name
45 if you have not yet specified one.
46
47 Also, the command M-x visit-tag-table can now be used to
48 specify the tag table file name initially, or to switch
49 to a new tag table.
50
51* If truncate-partial-width-windows is non-nil (as it intially is),
52 all windows less than the full screen width (that is,
53 made by side-by-side splitting) truncate lines rather than continuing
54 them.
55
56* Emacs now checks for Lisp stack overflow to avoid fatal errors.
57 The depth in eval, apply and funcall may not exceed max-lisp-eval-depth.
58 The depth in variable bindings and unwind-protects may not exceed
59 max-specpdl-size. If either limit is exceeded, an error occurs.
60 You can set the limits to larger values if you wish, but if you make them
61 too large, you are vulnerable to a fatal error if you invoke
62 Lisp code that does infinite recursion.
63
64* New hooks find-file-hook and write-file-hook.
65 Both of these variables if non-nil should be functions of no arguments.
66 At the time they are called (current-buffer) will be the buffer being
67 read or written respectively.
68
69 find-file-hook is called whenever a file is read into its own buffer,
70 such as by calling find-file, revert-buffer, etc. It is not called by
71 functions such as insert-file which do not read the file into a buffer of
72 its own.
73 find-file-hook is called after the file has been read in and its
74 local variables (if any) have been processed.
75
76 write-file-hook is called just before writing out a file from a buffer.
77
78* The initial value of shell-prompt-pattern is now "^[^#$%>]*[#$%>] *"
79
80* If the .emacs file sets inhibit-startup-message to non-nil,
81 the messages normally printed by Emacs at startup time
82 are inhibited.
83
84* Facility for run-time conditionalization on the basis of emacs features.
85
86 The new variable features is a list of symbols which represent "features"
87 of the executing emacs, for use in run-time conditionalization.
88
89 The function featurep of one argument may be used to test for the
90 presence of a feature. It is just the same as
91 (not (null (memq FEATURE features))) where FEATURE is its argument.
92 For example, (if (featurep 'magic-window-hack)
93 (transmogrify-window 'vertical)
94 (split-window-vertically))
95
96 The function provide of one argument "announces" that FEATURE is present.
97 It is much the same as (if (not (featurep FEATURE))
98 (setq features (cons FEATURE features)))
99
100 The function require with arguments FEATURE and FILE-NAME loads FILE-NAME
101 (which should contain the form (provide FEATURE)) unless FEATURE is present.
102 It is much the same as (if (not (featurep FEATURE))
103 (progn (load FILE-NAME)
104 (if (not featurep FEATURE) (error ...))))
105 FILE-NAME is optional and defaults to FEATURE.
106
107* New function load-average.
108
109 This returns a list of three integers, which are
110 the current 1 minute, 5 minute and 15 minute load averages,
111 each multiplied by a hundred (since normally they are floating
112 point numbers).
113
114* Per-terminal libraries loaded automatically.
115
116 Emacs when starting up on terminal type T automatically loads
117 a library named term-T. T is the value of the TERM environment variable.
118 Thus, on terminal type vt100, Emacs would do (load "term-vt100" t t).
119 Such libraries are good places to set the character translation table.
120
121 It is a bad idea to redefine lots of commands in a per-terminal library,
122 since this affects all users. Instead, define a command to do the
123 redefinitions and let the user's init file, which is loaded later,
124 call that command or not, as the user prefers.
125
126* Programmer's note: detecting killed buffers.
127
128 Buffers are eliminated by explicitly killing them, using
129 the function kill-buffer. This does not eliminate or affect
130 the pointers to the buffer which may exist in list structure.
131 If you have a pointer to a buffer and wish to tell whether
132 the buffer has been killed, use the function buffer-name.
133 It returns nil on a killed buffer, and a string on a live buffer.
134
135* New ways to access the last command input character.
136
137 The function last-key-struck, which used to return the last
138 input character that was read by command input, is eliminated.
139 Instead, you can find this information as the value of the
140 variable last-command-char. (This variable used to be called
141 last-key).
142
143 Another new variable, last-input-char, holds the last character
144 read from the command input stream regardless of what it was
145 read for. last-input-char and last-command-char are different
146 only inside a command that has called read-char to read input.
147
148* The new switch -kill causes Emacs to exit after processing the
149 preceding command line arguments. Thus,
150 emacs -l lib data -e do-it -kill
151 means to load lib, find file data, call do-it on no arguments,
152 and then exit.
153
154* The config.h file has been modularized.
155
156 Options that depend on the machine you are running on are defined
157 in a file whose name starts with "m-", such as m-vax.h.
158 Options that depend on the operating system software version you are
159 running on are defined in a file whose name starts with "s-",
160 such as s-bsd4.2.h.
161
162 config.h includes one m- file and one s- file. It also defines a
163 few other options whose values do not follow from the machine type
164 and system type being used. Installers normally will have to
165 select the correct m- and s- files but will never have to change their
166 contents.
167
168* Termcap AL and DL strings are understood.
169
170 If the termcap entry defines AL and DL strings, for insertion
171 and deletion of multiple lines in one blow, Emacs now uses them.
172 This matters most on certain bit map display terminals for which
173 scrolling is comparatively slow.
174
175* Bias against scrolling screen far on fast terminals.
176
177 Emacs now prefers to redraw a few lines rather than
178 shift them a long distance on the screen, when the terminal is fast.
179
180* New major mode, mim-mode.
181
182 This major mode is for editing MDL code. Perhaps a MDL
183 user can explain why it is not called mdl-mode.
184 You must load the library mim-mode explicitly to use this.
185
186* GNU documentation formatter `texinfo'.
187
188 The `texinfo' library defines a format for documentation
189 files which can be passed through Tex to make a printed manual
190 or passed through texinfo to make an Info file. Texinfo is
191 documented fully by its own Info file; compare this file
192 with its source, texinfo.texinfo, for additional guidance.
193
194 All documentation files for GNU utilities should be written
195 in texinfo input format.
196
197 Tex processing of texinfo files requires the Botex macro package.
198 This is not ready for distribution yet, but will appear at
199 a later time.
200
201* New function read-from-string (emacs 15.29)
202
203 read-from-string takes three arguments: a string to read from,
204 and optionally start and end indices which delimit a substring
205 from which to read. (They default to 0 and the length of the string,
206 respectively.)
207
208 This function returns a cons cell whose car is the object produced
209 by reading from the string and whose cdr is a number giving the
210 index in the string of the first character not read. That index may
211 be passed as the second argument to a later call to read-from-string
212 to read the next form represented by the string.
213
214 In addition, the function read now accepts a string as its argument.
215 In this case, it calls read-from-string on the whole string, and
216 returns the car of the result. (ie the actual object read.)
217
218Changes in Emacs 14
219
220* Completion now prints various messages such as [Sole Completion]
221 or [Next Character Not Unique] to describe the results obtained.
222 These messages appear after the text in the minibuffer, and remain
223 on the screen until a few seconds go by or you type a key.
224
225* The buffer-read-only flag is implemented.
226 Setting or binding this per-buffer variable to a non-nil value
227 makes illegal any operation which would modify the textual content of
228 the buffer. (Such operations signal a buffer-read-only error)
229 The read-only state of a buffer may be altered using toggle-read-only
230 (C-x C-q)
231 The buffers used by Rmail, Dired, Rnews, and Info are now read-only
232 by default to prevent accidental damage to the information in those
233 buffers.
234
235* Functions car-safe and cdr-safe.
236 These functions are like car and cdr when the argument is a cons.
237 Given an argument not a cons, car-safe always returns nil, with
238 no error; the same for cdr-safe.
239
240* The new function user-real-login-name returns the name corresponding
241 to the real uid of the Emacs process. This is usually the same
242 as what user-login-name returns; however, when Emacs is invoked
243 from su, user-real-login-name returns "root" but user-login-name
244 returns the name of the user who invoked su.
245
246Changes in Emacs 13
247
248* There is a new version numbering scheme.
249
250 What used to be the first version number, which was 1,
251 has been discarded since it does not seem that I need three
252 levels of version number.
253
254 However, a new third version number has been added to represent
255 changes by user sites. This number will always be zero in
256 Emacs when I distribute it; it will be incremented each time
257 Emacs is built at another site.
258
259* There is now a reader syntax for Meta characters:
260 \M-CHAR means CHAR or'ed with the Meta bit. For example:
261
262 ?\M-x is (+ ?x 128)
263 ?\M-\n is (+ ?\n 128)
264 ?\M-\^f is (+ ?\^f 128)
265
266 This syntax can be used in strings too. Note, however, that
267 Meta characters are not meaningful in key sequences being passed
268 to define-key or lookup-key; you must use ESC characters (\e)
269 in them instead.
270
271 ?\C- can be used likewise for control characters. (13.9)
272
273* Installation change
274 The string "../lisp" now adds to the front of the load-path
275 used for searching for Lisp files during Emacs initialization.
276 It used to replace the path specified in paths.h entirely.
277 Now the directory ../lisp is searched first and the directoris
278 specified in paths.h are searched afterward.
279
280Changes in Emacs 1.12
281
282* There is a new installation procedure.
283 See the file INSTALL that comes in the top level
284 directory in the tar file or tape.
285
286* The Meta key is now supported on terminals that have it.
287 This is a shift key which causes the high bit to be turned on
288 in all input characters typed while it is held down.
289
290 read-char now returns a value in the range 128-255 if
291 a Meta character is typed. When interpreted as command
292 input, a Meta character is equivalent to a two character
293 sequence, the meta prefix character followed by the un-metized
294 character (Meta-G unmetized is G).
295
296 The meta prefix character
297 is specified by the value of the variable meta-prefix-char.
298 If this character (normally Escape) has been redefined locally
299 with a non-prefix definition (such as happens in completing
300 minibuffers) then the local redefinition is suppressed when
301 the character is not the last one in a key sequence.
302 So the local redefinition is effective if you type the character
303 explicitly, but not effective if the character comes from
304 the use of the Meta key.
305
306* `-' is no longer a completion command in the minibuffer.
307 It is an ordinary self-inserting character.
308
309* The list load-path of directories load to search for Lisp files
310 is now controlled by the EMACSLOADPATH environment variable
311[[ Note this was originally EMACS-LOAD-PATH and has been changed
312 again; sh does not deal properly with hyphens in env variable names]]
313 rather than the EPATH environment variable. This is to avoid
314 conflicts with other Emacses.
315
316 While Emacs is being built initially, the load-path
317 is now just ("../lisp"), ignoring paths.h. It does not
318 ignore EMACSLOADPATH, however; you should avoid having
319 this variable set while building Emacs.
320
321* You can now specify a translation table for keyboard
322 input characters, as a way of exchanging or substituting
323 keys on the keyboard.
324
325 If the value of keyboard-translate-table is a string,
326 every character received from the keyboard is used as an
327 index in that string, and the character at that index in
328 the string is used as input instead of what was actually
329 typed. If the actual input character is >= the length of
330 the string, it is used unchanged.
331
332 One way this feature can be used is to fix bad keyboard
333 designes. For example, on some terminals, Delete is
334 Shift-Underscore. Since Delete is a more useful character
335 than Underscore, it is an improvement to make the unshifted
336 character Delete and the shifted one Underscore. This can
337 be done with
338
339 ;; First make a translate table that does the identity translation.
340 (setq keyboard-translate-table (make-string 128 0))
341 (let ((i 0))
342 (while (< i 128)
343 (aset keyboard-translate-table i i)
344 (setq i (1+ i))))
345
346 ;; Now alter translations of some characters.
347 (aset keyboard-translate-table ?\_ ?\^?)
348 (aset keyboard-translate-table ?\^? ?\_)
349
350 If your terminal has a Meta key and can therefore send
351 codes up to 255, Meta characters are translated through
352 elements 128 through 255 of the translate table, and therefore
353 are translated independently of the corresponding non-Meta
354 characters. You must therefore establish translations
355 independently for the Meta characters if you want them too:
356
357 ;; First make a translate table that does the identity translation.
358 (setq keyboard-translate-table (make-string 256 0))
359 (let ((i 0))
360 (while (< i 256)
361 (aset keyboard-translate-table i i)
362 (setq i (1+ i))))
363
364 ;; Now alter translations of some characters.
365 (aset keyboard-translate-table ?\_ ?\^?)
366 (aset keyboard-translate-table ?\^? ?\_)
367
368 ;; Now alter translations of some Meta characters.
369 (aset keyboard-translate-table (+ 128 ?\_) (+ 128 ?\^?))
370 (aset keyboard-translate-table (+ 128 ?\^?) (+ 128 ?\_))
371
372* (process-kill-without-query PROCESS)
373
374This marks the process so that, when you kill Emacs,
375you will not on its account be queried about active subprocesses.
376
377Changes in Emacs 1.11
378
379* The commands C-c and C-z have been interchanged,
380 for greater compatibility with normal Unix usage.
381 C-z now runs suspend-emacs and C-c runs exit-recursive-edit.
382
383* The value returned by file-name-directory now ends
384 with a slash. (file-name-directory "foo/bar") => "foo/".
385 This avoids confusing results when dealing with files
386 in the root directory.
387
388 The value of the per-buffer variable default-directory
389 is also supposed to have a final slash now.
390
391* There are now variables to control the switches passed to
392 `ls' by the C-x C-d command (list-directory).
393 list-directory-brief-switches is a string, initially "-CF",
394 used for brief listings, and list-directory-verbose-switches
395 is a string, initially "-l", used for verbose ones.
396
397* For Ann Arbor Ambassador terminals, the termcap "ti" string
398 is now used to initialize the screen geometry on entry to Emacs,
399 and the "te" string is used to set it back on exit.
400 If the termcap entry does not define the "ti" or "te" string,
401 Emacs does what it used to do.
402
403Changes in Emacs 1.10
404
405* GNU Emacs has been made almost 1/3 smaller.
406 It now dumps out as only 530kbytes on Vax 4.2bsd.
407
408* The term "checkpoint" has been replaced by "auto save"
409 throughout the function names, variable names and documentation
410 of GNU Emacs.
411
412* The function load now tries appending ".elc" and ".el"
413 to the specified filename BEFORE it tries the filename
414 without change.
415
416* rmail now makes the mode line display the total number
417 of messages and the current message number.
418 The "f" command now means forward a message to another user.
419 The command to search through all messages for a string is now "F".
420 The "u" command now means to move back to the previous
421 message and undelete it. To undelete the selected message, use Meta-u.
422
423* The hyphen character is now equivalent to a Space while
424 in completing minibuffers. Both mean to complete an additional word.
425
426* The Lisp function error now takes args like format
427 which are used to construct the error message.
428
429* Redisplay will refuse to start its display at the end of the buffer.
430 It will pick a new place to display from, rather than use that.
431
432* The value returned by garbage-collect has been changed.
433 Its first element is no longer a number but a cons,
434 whose car is the number of cons cells now in use,
435 and whose cdr is the number of cons cells that have been
436 made but are now free.
437 The second element is similar but describes symbols rather than cons cells.
438 The third element is similar but describes markers.
439
440* The variable buffer-name has been eliminated.
441 The function buffer-name still exists. This is to prevent
442 user programs from changing buffer names without going
443 through the rename-buffer function.
444
445Changes in Emacs 1.9
446
447* When a fill prefix is in effect, paragraphs are started
448 or separated by lines that do not start with the fill prefix.
449 Also, a line which consists of the fill prefix followed by
450 white space separates paragraphs.
451
452* C-x C-v runs the new function find-alternate-file.
453 It finds the specified file, switches to that buffer,
454 and kills the previous current buffer. (It requires
455 confirmation if that buffer had changes.) This is
456 most useful after you find the wrong file due to a typo.
457
458* Exiting the minibuffer moves the cursor to column 0,
459 to show you that it has really been exited.
460
461* Meta-g (fill-region) now fills each paragraph in the
462 region individually. To fill the region as if it were
463 a single paragraph (for when the paragraph-delimiting mechanism
464 does the wrong thing), use fill-region-as-paragraph.
465
466* Tab in text mode now runs the function tab-to-tab-stop.
467 A new mode called indented-text-mode is like text-mode
468 except that in it Tab runs the function indent-relative,
469 which indents the line under the previous line.
470 If auto fill is enabled while in indented-text-mode,
471 the new lines that it makes are indented.
472
473* Functions kill-rectangle and yank-rectangle.
474 kill-rectangle deletes the rectangle specified by dot and mark
475 (or by two arguments) and saves it in the variable killed-rectangle.
476 yank-rectangle inserts the rectangle in that variable.
477
478 Tab characters in a rectangle being saved are replaced
479 by spaces in such a way that their appearance will
480 not be changed if the rectangle is later reinserted
481 at a different column position.
482
483* `+' in a regular expression now means
484 to repeat the previous expression one or more times.
485 `?' means to repeat it zero or one time.
486 They are in all regards like `*' except for the
487 number of repetitions they match.
488
489 \< in a regular expression now matches the null string
490 when it is at the beginning of a word; \> matches
491 the null string at the end of a word.
492
493* C-x p narrows the buffer so that only the current page
494 is visible.
495
496* C-x ) with argument repeats the kbd macro just
497 defined that many times, counting the definition
498 as one repetition.
499
500* C-x ( with argument begins defining a kbd macro
501 starting with the last one defined. It executes that
502 previous kbd macro initially, just as if you began
503 by typing it over again.
504
505* C-x q command queries the user during kbd macro execution.
506 With prefix argument, enters recursive edit,
507 reading keyboard commands even within a kbd macro.
508 You can give different commands each time the macro executes.
509 Without prefix argument, reads a character. Your options are:
510 Space -- execute the rest of the macro.
511 Delete -- skip the rest of the macro; start next repetition.
512 C-d -- skip rest of the macro and don't repeat it any more.
513 C-r -- enter a recursive edit, then on exit ask again for a character
514 C-l -- redisplay screen and ask again."
515
516* write-kbd-macro and append-kbd-macro are used to save
517 a kbd macro definition in a file (as Lisp code to
518 redefine the macro when the file is loaded).
519 These commands differ in that write-kbd-macro
520 discards the previous contents of the file.
521 If given a prefix argument, both commands
522 record the keys which invoke the macro as well as the
523 macro's definition.
524
525* The variable global-minor-modes is used to display
526 strings in the mode line of all buffers. It should be
527 a list of elements thaht are conses whose cdrs are strings
528 to be displayed. This complements the variable
529 minor-modes, which has the same effect but has a separate
530 value in each buffer.
531
532* C-x = describes horizontal scrolling in effect, if any.
533
534* Return now auto-fills the line it is ending, in auto fill mode.
535 Space with zero as argument auto-fills the line before it
536 just like Space without an argument.
537
538Changes in Emacs 1.8
539
540This release mostly fixes bugs. There are a few new features:
541
542* apropos now sorts the symbols before displaying them.
543 Also, it returns a list of the symbols found.
544
545 apropos now accepts a second arg PRED which should be a function
546 of one argument; if PRED is non-nil, each symbol is tested
547 with PRED and only symbols for which PRED returns non-nil
548 appear in the output or the returned list.
549
550 If the third argument to apropos is non-nil, apropos does not
551 display anything; it merely returns the list of symbols found.
552
553 C-h a now runs the new function command-apropos rather than
554 apropos, and shows only symbols with definitions as commands.
555
556* M-x shell sends the command
557 if (-f ~/.emacs_NAME)source ~/.emacs_NAME
558 invisibly to the shell when it starts. Here NAME
559 is replaced by the name of shell used,
560 as it came from your ESHELL or SHELL environment variable
561 but with directory name, if any, removed.
562
563* M-, now runs the command tags-loop-continue, which is used
564 to resume a terminated tags-search or tags-query-replace.
565
566Changes in Emacs 1.7
567
568It's Beat CCA Week.
569
570* The initial buffer is now called "*scratch*" instead of "scratch",
571 so that all buffer names used automatically by Emacs now have *'s.
572
573* Undo information is now stored separately for each buffer.
574 The Undo command (C-x u) always applies to the current
575 buffer only.
576
577 C-_ is now a synonym for C-x u.
578
579 (buffer-flush-undo BUFFER) causes undo information not to
580 be kept for BUFFER, and frees the space that would have
581 been used to hold it. In any case, no undo information is
582 kept for buffers whose names start with spaces. (These
583 buffers also do not appear in the C-x C-b display.)
584
585* Rectangle operations are now implemented.
586 C-x r stores the rectangle described by dot and mark
587 into a register; it reads the register name from the keyboard.
588 C-x g, the command to insert the contents of a register,
589 can be used to reinsert the rectangle elsewhere.
590
591 Other rectangle commands include
592 open-rectangle:
593 insert a blank rectangle in the position and size
594 described by dot and mark, at its corners;
595 the existing text is pushed to the right.
596 clear-rectangle:
597 replace the rectangle described by dot ane mark
598 with blanks. The previous text is deleted.
599 delete-rectangle:
600 delete the text of the specified rectangle,
601 moving the text beyond it on each line leftward.
602
603* Side-by-side windows are allowed. Use C-x 5 to split the
604 current window into two windows side by side.
605 C-x } makes the selected window ARG columns wider at the
606 expense of the windows at its sides. C-x { makes the selected
607 window ARG columns narrower. An argument to C-x 5 specifies
608 how many columns to give to the leftmost of the two windows made.
609
610 C-x 2 now accepts a numeric argument to specify the number of
611 lines to give to the uppermost of the two windows it makes.
612
613* Horizontal scrolling of the lines in a window is now implemented.
614 C-x < (scroll-left) scrolls all displayed lines left,
615 with the numeric argument (default 1) saying how far to scroll.
616 When the window is scrolled left, some amount of the beginning
617 of each nonempty line is replaced by an "$".
618 C-x > scrolls right. If a window has no text hidden at the left
619 margin, it cannot be scrolled any farther right than that.
620 When nonzero leftwards scrolling is in effect in a window.
621 lines are automatically truncated at the window's right margin
622 regardless of the value of the variable truncate-lines in the
623 buffer being displayed.
624
625* C-x C-d now uses the default output format of `ls',
626 which gives just file names in multiple columns.
627 C-u C-x C-d passes the -l switch to `ls'.
628
629* C-t at the end of a line now exchanges the two preceding characters.
630
631 All the transpose commands now interpret zero as an argument
632 to mean to transpose the textual unit after or around dot
633 with the one after or around the mark.
634
635* M-! executes a shell command in an inferior shell
636 and displays the output from it. With a prefix argument,
637 it inserts the output in the current buffer after dot
638 and sets the mark after the output. The shell command
639 gets /dev/null as its standard input.
640
641 M-| is like M-! but passes the contents of the region
642 as input to the shell command. A prefix argument makes
643 the output from the command replace the contents of the region.
644
645* The mode line will now say "Def" after the major mode
646 while a keyboard macro is being defined.
647
648* The variable fill-prefix is now used by Meta-q.
649 Meta-q removes the fill prefix from lines that start with it
650 before filling, and inserts the fill prefix on each line
651 after filling.
652
653 The command C-x . sets the fill prefix equal to the text
654 on the current line before dot.
655
656* The new command Meta-j (indent-new-comment-line),
657 is like Linefeed (indent-new-line) except when dot is inside a comment;
658 in that case, Meta-j inserts a comment starter on the new line,
659 indented under the comment starter above. It also inserts
660 a comment terminator at the end of the line above,
661 if the language being edited calls for one.
662
663* Rmail should work correctly now, and has some C-h m documentation.
664
665Changes in Emacs 1.6
666
667* save-buffers-kill-emacs is now on C-x C-c
668 while C-x C-z does suspend-emacs. This is to make
669 C-x C-c like the normal Unix meaning of C-c
670 and C-x C-z linke the normal Unix meaning of C-z.
671
672* M-ESC (eval-expression) is now a disabled command by default.
673 This prevents users who type ESC ESC accidentally from
674 getting confusing results. Put
675 (put 'eval-expression 'disabled nil)
676 in your ~/.emacs file to enable the command.
677
678* Self-inserting text is grouped into bunches for undoing.
679 Each C-x u command undoes up to 20 consecutive self-inserting
680 characters.
681
682* Help f now uses as a default the function being called
683 in the innermost Lisp expression that dot is in.
684 This makes it more convenient to use while writing
685 Lisp code to run in Emacs.
686 (If the text around dot does not appear to be a call
687 to a Lisp function, there is no default.)
688
689 Likewise, Help v uses the symbol around or before dot
690 as a default, if that is a variable name.
691
692* Commands that read filenames now insert the default
693 directory in the minibuffer, to become part of your input.
694 This allows you to see what the default is.
695 You may type a filename which goes at the end of the
696 default directory, or you may edit the default directory
697 as you like to create the input you want to give.
698 You may also type an absolute pathname (starting with /)
699 or refer to a home directory (input starting with ~)
700 after the default; the presence of // or /~ causes
701 everything up through the slash that precedes your
702 type-in to be ignored.
703
704 Returning the default directory without change,
705 including the terminating slash, requests the use
706 of the default file name (usually the visited file's name).
707
708 Set the variable insert-default-directory to nil
709 to turn off this feature.
710
711* M-x shell now uses the environment variable ESHELL,
712 if it exists, as the file name of the shell to run.
713 If there is no ESHELL variable, the SHELL variable is used.
714 This is because some shells do not work properly as inferiors
715 of Emacs (or anything like Emacs).
716
717* A new variable minor-modes now exists, with a separate value
718 in each buffer. Its value should be an alist of elements
719 (MODE-FUNCTION-SYMBOL . PRETTY-NAME-STRING), one for each
720 minor mode that is turned on in the buffer. The pretty
721 name strings are displayed in the mode line after the name of the
722 major mode (with spaces between them). The mode function
723 symbols should be symbols whose function definitions will
724 turn on the minor mode if given 1 as an argument; they are present
725 so that Help m can find their documentation strings.
726
727* The format of tag table files has been changed.
728 The new format enables Emacs to find tags much faster.
729
730 A new program, etags, exists to make the kind of
731 tag table that Emacs wants. etags is invoked just
732 like ctags; in fact, if you give it any switches,
733 it does exactly what ctags would do. Give it the
734 empty switch ("-") to make it act like ctags with no switches.
735
736 etags names the tag table file "TAGS" rather than "tags",
737 so that these tag tables and the standard Unix ones
738 can coexist.
739
740 The tags library can no longer use standard ctags-style
741 tag tables files.
742
743* The file of Lisp code Emacs reads on startup is now
744 called ~/.emacs rather than ~/.emacs_pro.
745
746* copy-file now gives the copied file the same mode bits
747 as the original file.
748
749* Output from a process inserted into the process's buffer
750 no longer sets the buffer's mark. Instead it sets a
751 marker associated with the process to point to the end
752 of the inserted text. You can access this marker with
753 (process-mark PROCESS)
754 and then either examine its position with marker-position
755 or set its position with set-marker.
756
757* completing-read takes a new optional fifth argument which,
758 if non-nil, should be a string of text to insert into
759 the minibuffer before reading user commands.
760
761* The Lisp function elt now exists:
762 (elt ARRAY N) is like (aref ARRAY N),
763 (elt LIST N) is like (nth N LIST).
764
765* rplaca is now a synonym for setcar, and rplacd for setcdr.
766 eql is now a synonym for eq; it turns out that the Common Lisp
767 distinction between eq and eql is insignificant in Emacs.
768 numberp is a new synonym for integerp.
769
770* auto-save has been renamed to auto-save-mode.
771
772* Auto save file names for buffers are now created by the
773 function make-auto-save-file-name. This is so you can
774 redefine that function to change the way auto save file names
775 are chosen.
776
777* expand-file-name no longer discards a final slash.
778 (expand-file-name "foo" "/lose") => "/lose/foo"
779 (expand-file-name "foo/" "/lose") => "/lose/foo/"
780
781 Also, expand-file-name no longer substitutes $ constructs.
782 A new function substitute-in-file-name does this. Reading
783 a file name with read-file-name or the `f' or`F' option
784 of interactive calling uses substitute-in-file-name
785 on the file name that was read and returns the result.
786
787 All I/O primitives including insert-file-contents and
788 delete-file call expand-file-name on the file name supplied.
789 This change makes them considerably faster in the usual case.
790
791* Interactive calling spec strings allow the new code letter 'D'
792 which means to read a directory name. It is like 'f' except
793 that the default if the user makes no change in the minibuffer
794 is to return the current default directory rather than the
795 current visited file name.
796
797Changes in Emacs 1.5
798
799* suspend-emacs now accepts an optional argument
800 which is a string to be stuffed as terminal input
801 to be read by Emacs's superior shell after Emacs exits.
802
803 A library called ledit exists which uses this feature
804 to transmit text to a Lisp job running as a sibling of
805 Emacs.
806
807* If find-file is given the name of a directory,
808 it automatically invokes dired on that directory
809 rather than reading in the binary data that make up
810 the actual contents of the directory according to Unix.
811
812* Saving an Emacs buffer now preserves the file modes
813 of any previously existing file with the same name.
814 This works using new Lisp functions file-modes and
815 set-file-modes, which can be used to read or set the mode
816 bits of any file.
817
818* The Lisp function cond now exists, with its traditional meaning.
819
820* defvar and defconst now permit the documentation string
821 to be omitted. defvar also permits the initial value
822 to be omitted; then it acts only as a comment.
823
824Changes in Emacs 1.4
825
826* Auto-filling now normally indents the new line it creates
827 by calling indent-according-to-mode. This function, meanwhile,
828 has in Fundamental and Text modes the effect of making the line
829 have an indentation of the value of left-margin, a per-buffer variable.
830
831 Tab no longer precisely does indent-according-to-mode;
832 it does that in all modes that supply their own indentation routine,
833 but in Fundamental, Text and allied modes it inserts a tab character.
834
835* The command M-x grep now invokes grep (on arguments
836 supplied by the user) and reads the output from grep
837 asynchronously into a buffer. The command C-x ` can
838 be used to move to the lines that grep has found.
839 This is an adaptation of the mechanism used for
840 running compilations and finding the loci of error messages.
841
842 You can now use C-x ` even while grep or compilation
843 is proceeding; as more matches or error messages arrive,
844 C-x ` will parse them and be able to find them.
845
846* M-x mail now provides a command to send the message
847 and "exit"--that is, return to the previously selected
848 buffer. It is C-z C-z.
849
850* Tab in C mode now tries harder to adapt to all indentation styles.
851 If the line being indented is a statement that is not the first
852 one in the containing compound-statement, it is aligned under
853 the beginning of the first statement.
854
855* The functions screen-width and screen-height return the
856 total width and height of the screen as it is now being used.
857 set-screen-width and set-screen-height tell Emacs how big
858 to assume the screen is; they each take one argument,
859 an integer.
860
861* The Lisp function 'function' now exists. function is the
862 same as quote, except that it serves as a signal to the
863 Lisp compiler that the argument should be compiled as
864 a function. Example:
865 (mapcar (function (lambda (x) (+ x 5))) list)
866
867* The function set-key has been renamed to global-set-key.
868 undefine-key and local-undefine-key has been renamed to
869 global-unset-key and local-unset-key.
870
871* Emacs now collects input from asynchronous subprocesses
872 while waiting in the functions sleep-for and sit-for.
873
874* Shell mode's Newline command attempts to distinguish subshell
875 prompts from user input when issued in the middle of the buffer.
876 It no longer reexecutes from dot to the end of the line;
877 it reeexecutes the entire line minus any prompt.
878 The prompt is recognized by searching for the value of
879 shell-prompt-pattern, starting from the beginning of the line.
880 Anything thus skipped is not reexecuted.
881
882Changes in Emacs 1.3
883
884* An undo facility exists now. Type C-x u to undo a batch of
885 changes (usually one command's changes, but some commands
886 such as query-replace divide their changes into multiple
887 batches. You can repeat C-x u to undo further. As long
888 as no commands other than C-x u intervene, each one undoes
889 another batch. A numeric argument to C-x u acts as a repeat
890 count.
891
892 If you keep on undoing, eventually you may be told that
893 you have used up all the recorded undo information.
894 Some actions, such as reading in files, discard all
895 undo information.
896
897 The undo information is not currently stored separately
898 for each buffer, so it is mainly good if you do something
899 totally spastic. [This has since been fixed.]
900
901* A learn-by-doing tutorial introduction to Emacs now exists.
902 Type C-h t to enter it.
903
904* An Info documentation browser exists. Do M-x info to enter it.
905 It contains a tutorial introduction so that no more documentation
906 is needed here. As of now, the only documentation in it
907 is that of Info itself.
908
909* Help k and Help c are now different. Help c prints just the
910 name of the function which the specified key invokes. Help k
911 prints the documentation of the function as well.
912
913* A document of the differences between GNU Emacs and Twenex Emacs
914 now exists. It is called DIFF, in the same directory as this file.
915
916* C mode can now indent comments better, including multi-line ones.
917 Meta-Control-q now reindents comment lines within the expression
918 being aligned.
919
920* Insertion of a close-parenthesis now shows the matching open-parenthesis
921 even if it is off screen, by printing the text following it on its line
922 in the minibuffer.
923
924* A file can now contain a list of local variable values
925 to be in effect when the file is edited. See the file DIFF
926 in the same directory as this file for full details.
927
928* A function nth is defined. It means the same thing as in Common Lisp.
929
930* The function install-command has been renamed to set-key.
931 It now takes the key sequence as the first argument
932 and the definition for it as the second argument.
933 Likewise, local-install-command has been renamed to local-set-key.
934
935Changes in Emacs 1.2
936
937* A Lisp single-stepping and debugging facility exists.
938 To cause the debugger to be entered when an error
939 occurs, set the variable debug-on-error non-nil.
940
941 To cause the debugger to be entered whenever function foo
942 is called, do (debug-on-entry 'foo). To cancel this,
943 do (cancel-debug-on-entry 'foo). debug-on-entry does
944 not work for primitives (written in C), only functions
945 written in Lisp. Most standard Emacs commands are in Lisp.
946
947 When the debugger is entered, the selected window shows
948 a buffer called " *Backtrace" which displays a series
949 of stack frames, most recently entered first. For each
950 frame, the function name called is shown, usually followed
951 by the argument values unless arguments are still being
952 calculated. At the beginning of the buffer is a description
953 of why the debugger was entered: function entry, function exit,
954 error, or simply that the user called the function `debug'.
955
956 To exit the debugger and return to top level, type `q'.
957
958 In the debugger, you can evaluate Lisp expressions by
959 typing `e'. This is equivalent to `M-ESC'.
960
961 When the debugger is entered due to an error, that is
962 all you can do. When it is entered due to function entry
963 (such as, requested by debug-on-entry), you have two
964 options:
965 Continue execution and reenter debugger after the
966 completion of the function being entered. Type `c'.
967 Continue execution but enter the debugger before
968 the next subexpression. Type `d'.
969
970 You will see that some stack frames are marked with *.
971 This means the debugger will be entered when those
972 frames exit. You will see the value being returned
973 in the first line of the backtrace buffer. Your options:
974 Continue execution, and return that value. Type `c'.
975 Continue execution, and return a specified value. Type `r'.
976
977 You can mark a frame to enter the debugger on exit
978 with the `b' command, or clear such a mark with `u'.
979
980* Lisp macros now exist.
981 For example, you can write
982 (defmacro cadr (arg) (list 'car (list 'cdr arg)))
983 and then the expression
984 (cadr foo)
985 will expand into
986 (car (cdr foo))
987
988Changes in Emacs 1.1
989
990* The initial buffer is now called "scratch" and is in a
991 new major mode, Lisp Interaction mode. This mode is
992 intended for typing Lisp expressions, evaluating them,
993 and having the values printed into the buffer.
994
995 Type Linefeed after a Lisp expression, to evaluate the
996 expression and have its value printed into the buffer,
997 advancing dot.
998
999 The other commands of Lisp mode are available.
1000
1001* The C-x C-e command for evaluating the Lisp expression
1002 before dot has been changed to print the value in the
1003 minibuffer line rather than insert it in the buffer.
1004 A numeric argument causes the printed value to appear
1005 in the buffer instead.
1006
1007* In Lisp mode, the command M-C-x evaluates the defun
1008 containing or following dot. The value is printed in
1009 the minibuffer.
1010
1011* The value of a Lisp expression evaluated using M-ESC
1012 is now printed in the minibuffer.
1013
1014* M-q now runs fill-paragraph, independent of major mode.
1015
1016* C-h m now prints documentation on the current buffer's
1017 major mode. What it prints is the documentation of the
1018 major mode name as a function. All major modes have been
1019 equipped with documentation that describes all commands
1020 peculiar to the major mode, for this purpose.
1021
1022* You can display a Unix manual entry with
1023 the M-x manual-entry command.
1024
1025* You can run a shell, displaying its output in a buffer,
1026 with the M-x shell command. The Return key sends input
1027 to the subshell. Output is printed inserted automatically
1028 in the buffer. Commands C-c, C-d, C-u, C-w and C-z are redefined
1029 for controlling the subshell and its subjobs.
1030 "cd", "pushd" and "popd" commands are recognized as you
1031 enter them, so that the default directory of the Emacs buffer
1032 always remains the same as that of the subshell.
1033
1034* C-x $ (that's a real dollar sign) controls line-hiding based
1035 on indentation. With a numeric arg N > 0, it causes all lines
1036 indented by N or more columns to become invisible.
1037 They are, effectively, tacked onto the preceding line, where
1038 they are represented by " ..." on the screen.
1039 (The end of the preceding visible line corresponds to a
1040 screen cursor position before the "...". Anywhere in the
1041 invisible lines that follow appears on the screen as a cursor
1042 position after the "...".)
1043 Currently, all editing commands treat invisible lines just
1044 like visible ones, except for C-n and C-p, which have special
1045 code to count visible lines only.
1046 C-x $ with no argument turns off this mode, which in any case
1047 is remembered separately for each buffer.
1048
1049* Outline mode is another form of selective display.
1050 It is a major mode invoked with M-x outline-mode.
1051 It is intended for editing files that are structured as
1052 outlines, with heading lines (lines that begin with one
1053 or more asterisks) and text lines (all other lines).
1054 The number of asterisks in a heading line are its level;
1055 the subheadings of a heading line are all following heading
1056 lines at higher levels, until but not including the next
1057 heading line at the same or a lower level, regardless
1058 of intervening text lines.
1059
1060 In outline mode, you have commands to hide (remove from display)
1061 or show the text or subheadings under each heading line
1062 independently. Hidden text or subheadings are invisibly
1063 attached to the end of the preceding heading line, so that
1064 if you kill the hading line and yank it back elsewhere
1065 all the invisible lines accompany it.
1066
1067 All editing commands treat hidden outline-mode lines
1068 as part of the preceding visible line.
1069
1070* C-x C-z runs save-buffers-kill-emacs
1071 offers to save each file buffer, then exits.
1072
1073* C-c's function is now called suspend-emacs.
1074
1075* The command C-x m runs mail, which switches to a buffer *mail*
1076 and lets you compose a message to send. C-x 4 m runs mail in
1077 another window. Type C-z C-s in the mail buffer to send the
1078 message according to what you have entered in the buffer.
1079
1080 You must separate the headers from the message text with
1081 an empty line.
1082
1083* You can now dired partial directories (specified with names
1084 containing *'s, etc, all processed by the shell). Also, you
1085 can dired more than one directory; dired names the buffer
1086 according to the filespec or directory name. Reinvoking
1087 dired on a directory already direded just switches back to
1088 the same directory used last time; do M-x revert if you want
1089 to read in the current contents of the directory.
1090
1091 C-x d runs dired, and C-x 4 d runs dired in another window.
1092
1093 C-x C-d (list-directory) also allows partial directories now.
1094
1095Lisp programming changes
1096
1097* t as an output stream now means "print to the minibuffer".
1098 If there is already text in the minibuffer printed via t
1099 as an output stream, the new text is appended to the old
1100 (or is truncated and lost at the margin). If the minibuffer
1101 contains text put there for some other reason, it is cleared
1102 first.
1103
1104 t is now the top-level value of standard-output.
1105
1106 t as an input stream now means "read via the minibuffer".
1107 The minibuffer is used to read a line of input, with editing,
1108 and this line is then parsed. Any excess not used by `read'
1109 is ignored; each `read' from t reads fresh input.
1110 t is now the top-level value of standard-input.
1111
1112* A marker may be used as an input stream or an output stream.
1113 The effect is to grab input from where the marker points,
1114 advancing it over the characters read, or to insert output
1115 at the marker and advance it.
1116
1117* Output from an asynchronous subprocess is now inserted at
1118 the end of the associated buffer, not at the buffer's dot,
1119 and the buffer's mark is set to the end of the inserted output
1120 each time output is inserted.
1121
1122* (pos-visible-in-window-p POS WINDOW)
1123 returns t if position POS in WINDOW's buffer is in the range
1124 that is being displayed in WINDOW; nil if it is scrolled
1125 vertically out of visibility.
1126
1127 If display in WINDOW is not currently up to date, this function
1128 calculates carefully whether POS would appear if display were
1129 done immediately based on the current (window-start WINDOW).
1130
1131 POS defaults to (dot), and WINDOW to (selected-window).
1132
1133* Variable buffer-alist replaced by function (buffer-list).
1134 The actual alist of buffers used internally by Emacs is now
1135 no longer accessible, to prevent the user from crashing Emacs
1136 by modifying it. The function buffer-list returns a list
1137 of all existing buffers. Modifying this list cannot hurt anything
1138 as a new list is constructed by each call to buffer-list.
1139
1140* load now takes an optional third argument NOMSG which, if non-nil,
1141 prevents load from printing a message when it starts and when
1142 it is done.
1143
1144* byte-recompile-directory is a new function which finds all
1145 the .elc files in a directory, and regenerates each one which
1146 is older than the corresponding .el (Lisp source) file.
1147
1148----------------------------------------------------------------------
1149Copyright information:
1150
1151Copyright (C) 1985 Richard M. Stallman
1152
1153 Permission is granted to anyone to make or distribute verbatim copies
1154 of this document as received, in any medium, provided that the
1155 copyright notice and this permission notice are preserved,
1156 thus giving the recipient permission to redistribute in turn.
1157
1158 Permission is granted to distribute modified versions
1159 of this document, or of portions of it,
1160 under the above conditions, provided also that they
1161 carry prominent notices stating who last changed them.
1162
1163Local variables:
1164mode: text
1165end:
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index f0d2b6d367d..3c67bce1502 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,11 @@
12000-08-17 Gerd Moellmann <gerd@gnu.org>
2
3 * help.el (view-emacs-news): Rewritten for new naming scheme
4 for old NEWS files.
5
6 * startup.el (command-line): Pop to *Messages* in case an error
7 is signaled while loading user-init-file.
8
12000-08-17 Andreas Schwab <schwab@suse.de> 92000-08-17 Andreas Schwab <schwab@suse.de>
2 10
3 * files.el (insert-directory): Don't lose original file name, 11 * files.el (insert-directory): Don't lose original file name,