diff options
| author | Stefan Monnier <monnier@iro.umontreal.ca> | 2022-07-18 17:39:55 -0400 |
|---|---|---|
| committer | Stefan Monnier <monnier@iro.umontreal.ca> | 2022-07-18 22:22:34 -0400 |
| commit | c32212bf966523e3a3153c5ad2c131d140aeff8a (patch) | |
| tree | 9b86675ba0f4eb4d847647d4f2b9dc8d467ba86c /etc/NEWS.1-17 | |
| parent | 6692df0279782a9956acf4f97a421d8775cf32a6 (diff) | |
| download | emacs-c32212bf966523e3a3153c5ad2c131d140aeff8a.tar.gz | |
(help-fns--first-release): Try and avoid false positives
We used to use a very "optimistic" regexp which worked well for
longish symbol names but suffered from too many false positives on
short names. Use a more restrictive regexp, which should make the
recent "weed out" change unnecessary.
This in turn requires the use of '...' more consistently in etc/NEWS* files.
* lisp/help-fns.el (help-fns--first-release-regexp): New function.
(help-fns--first-release): Use it. Fix minor issue with the Emacs
version regexp.
(help-fns--mention-first-release): Undo last change.
* etc/NEWS*: Replace `...' with '...'. Indent code examples by at
least 2 spaces. Add previously missing '...' quotes around many of
the variables and functions described.
Diffstat (limited to 'etc/NEWS.1-17')
| -rw-r--r-- | etc/NEWS.1-17 | 860 |
1 files changed, 433 insertions, 427 deletions
diff --git a/etc/NEWS.1-17 b/etc/NEWS.1-17 index ee6fa82b29f..9d7bacc9ec8 100644 --- a/etc/NEWS.1-17 +++ b/etc/NEWS.1-17 @@ -41,10 +41,10 @@ that Emacs has not been run on before. See etc/MACHINES. -** Portable `alloca' provided. +** Portable 'alloca' provided. Emacs can now run on machines that do not and cannot support the library -subroutine `alloca' in the canonical fashion, using an `alloca' emulation +subroutine 'alloca' in the canonical fashion, using an 'alloca' emulation written in C. ** On-line manual. @@ -74,39 +74,39 @@ highest previously used. Thus, the active, current file does not have a version number. Only the backups have them. -This feature is controlled by the variable `version-control'. If it -is `nil', as normally, then numbered backups are made only for files +This feature is controlled by the variable 'version-control'. If it +is 'nil', as normally, then numbered backups are made only for files that already have numbered backups. Backup names with just `~' are used for files that have no numbered backups. -If `version-control' is `never', then the backup file's name is +If 'version-control' is 'never', then the backup file's name is made with just `~' in any case. -If `version-control' is not `nil' or `never', numbered backups are +If 'version-control' is not 'nil' or 'never', numbered backups are made unconditionally. To prevent unlimited consumption of disk space, Emacs can delete old backup versions automatically. Generally Emacs keeps the first few backups and the latest few backups, deleting any in between. This happens every time a new backup is made. The two variables that -control the deletion are `kept-old-versions' and `kept-new-versions'. +control the deletion are 'kept-old-versions' and 'kept-new-versions'. Their values are, respectively, the number of oldest backups to keep and the number of newest ones to keep, each time a new backup is made. -The value of `kept-new-versions' includes the backup just created. +The value of 'kept-new-versions' includes the backup just created. By default, both values are 2. -If `trim-versions-without-asking' is non-`nil', the excess middle versions -are deleted without a murmur. If it is `nil', the default, then you +If 'trim-versions-without-asking' is non-'nil', the excess middle versions +are deleted without a murmur. If it is 'nil', the default, then you are asked whether the excess middle versions should really be deleted. Dired has a new command `.' which marks for deletion all but the latest -and oldest few of every numeric series of backups. `kept-old-versions' -controls the number of oldest versions to keep, and `dired-kept-versions' +and oldest few of every numeric series of backups. 'kept-old-versions' +controls the number of oldest versions to keep, and 'dired-kept-versions' controls the number of latest versions to keep. A numeric argument to the `.' command, if positive, specifies the number of latest versions -to keep, overriding `dired-kept-versions'. A negative argument specifies +to keep, overriding 'dired-kept-versions'. A negative argument specifies the number of oldest versions to keep, using minus the argument to override -`kept-old-versions'. +'kept-old-versions'. ** Immediate conflict detection. @@ -182,17 +182,17 @@ is now C-c C-o, and C-x C-v (show output) is now C-c C-r. The old M-= (copy previous input) command is now C-c C-y. -** Shell mode recognizes aliases for `pushd', `popd' and `cd'. +** Shell mode recognizes aliases for 'pushd', 'popd' and 'cd'. -Shell mode now uses the variable `shell-pushd-regexp' as a +Shell mode now uses the variable 'shell-pushd-regexp' as a regular expression to recognize any command name that is -equivalent to a `pushd' command. By default it is set up -to recognize just `pushd' itself. If you use aliases for -`pushd', change the regexp to recognize them as well. +equivalent to a 'pushd' command. By default it is set up +to recognize just 'pushd' itself. If you use aliases for +'pushd', change the regexp to recognize them as well. -There are also `shell-popd-regexp' to recognize commands -with the effect of a `popd', and `shell-cd-regexp' to recognize -commands with the effect of a `cd'. +There are also 'shell-popd-regexp' to recognize commands +with the effect of a 'popd', and 'shell-cd-regexp' to recognize +commands with the effect of a 'cd'. ** "Exit" command in certain modes now C-c C-c. @@ -203,7 +203,7 @@ modes, the command to exit used to be just C-c. ** Outline mode changes. Lines that are not heading lines are now called "body" lines. -The command `hide-text' is renamed to `hide-body'. +The command 'hide-text' is renamed to 'hide-body'. The key M-H is renamed to C-c C-h. The key M-S is renamed to C-c C-s. The key M-s is renamed to C-c C-i. @@ -229,7 +229,7 @@ o now outputs to an Rmail file, and C-o to a Unix mail file. The F command (rmail-find) is renamed to M-s (rmail-search). Various new commands and features exist; see the Emacs manual. -** Local bindings described first in describe-bindings. +** Local bindings described first in 'describe-bindings'. ** [...], {...} now balance in Fundamental mode. @@ -238,9 +238,9 @@ Various new commands and features exist; see the Emacs manual. There are two new major modes for editing nroff input and TeX input. See the Emacs manual for full information. -** New C indentation style variable `c-brace-imaginary-offset'. +** New C indentation style variable 'c-brace-imaginary-offset'. -The value of `c-brace-imaginary-offset', normally zero, controls the +The value of 'c-brace-imaginary-offset', normally zero, controls the indentation of a statement inside a brace-group where the open-brace is not the first thing on a line. The value says where the open-brace is imagined to be, relative to the first nonblank character on the line. @@ -251,47 +251,47 @@ Dired now normally keeps the cursor at the beginning of the file name, not at the beginning of the line. The most used motion commands are redefined in Dired to position the cursor this way. -`n' and `p' are now equivalent in dired to `C-n' and `C-p'. +'n' and 'p' are now equivalent in dired to 'C-n' and 'C-p'. If any files to be deleted cannot be deleted, their names are printed in an error message. -If the `v' command is invoked on a file which is a directory, +If the 'v' command is invoked on a file which is a directory, dired is run on that directory. -** `visit-tag-table' renamed `visit-tags-table'. +** 'visit-tag-table' renamed 'visit-tags-table'. -This is so apropos of `tags' finds everything you need to +This is so apropos of 'tags' finds everything you need to know about in connection with Tags. -** `mh-e' library uses C-c as prefix. +** 'mh-e' library uses C-c as prefix. -All the special commands of `mh-rmail' now are placed on a +All the special commands of 'mh-rmail' now are placed on a C-c prefix rather than on the C-x prefix. This is for consistency with other special modes with their own commands. -** M-$ or `spell-word' checks word before point. +** M-$ or 'spell-word' checks word before point. It used to check the word after point. ** Quitting during autoloading no longer causes trouble. Now, when a file is autoloaded, all function redefinitions -and `provide' calls are recorded and are undone if you quit +and 'provide' calls are recorded and are undone if you quit before the file is finished loading. As a result, it no longer happens that some of the entry points which are normally autoloading have been defined already, but the entire file is not really present to support them. -** `else' can now be indented correctly in C mode. +** 'else' can now be indented correctly in C mode. -TAB in C mode now knows which `if' statement an `else' matches -up with, and can indent the `else' correctly under the `if', -even if the `if' contained such things as another `if' statement, -or a `while' or `for' statement, with no braces around it. +TAB in C mode now knows which 'if' statement an 'else' matches +up with, and can indent the 'else' correctly under the 'if', +even if the 'if' contained such things as another 'if' statement, +or a 'while' or 'for' statement, with no braces around it. -** `batch-byte-compile' +** 'batch-byte-compile' Runs byte-compile-file on the files specified on the command line. All the rest of the command line arguments are taken as files to @@ -300,10 +300,10 @@ Must be used only with -batch, and kills emacs on completion. Each file will be processed even if an error occurred previously. For example, invoke `emacs -batch -f batch-byte-compile *.el'. -** `-batch' changes. +** '-batch' changes. -`-batch' now implies `-q': no init file is loaded by Emacs when -`-batch' is used. Also, no `term/TERMTYPE.el' file is loaded. Auto +'-batch' now implies '-q': no init file is loaded by Emacs when +'-batch' is used. Also, no `term/TERMTYPE.el' file is loaded. Auto saving is not done except in buffers in which it is explicitly requested. Also, many echo-area printouts describing what is going on are inhibited in batch mode, so that the only output you get is the @@ -311,7 +311,7 @@ output you program specifically. One echo-area message that is not suppressed is the one that says that a file is being loaded. That is because you can prevent this -message by passing `t' as the third argument to `load'. +message by passing 't' as the third argument to 'load'. ** Display of search string in incremental search. @@ -324,12 +324,12 @@ is actually going on. ** View commands. The commands C-x ], C-x [, C-x /, C-x j and C-x o are now -available inside `view-buffer' and `view-file', with their +available inside 'view-buffer' and 'view-file', with their normal meanings. ** Full-width windows preferred. -The ``other-window'' commands prefer other full width windows, +The 'other-window' commands prefer other full width windows, and will split only full width windows. ** M-x rename-file can copy if necessary. @@ -367,7 +367,7 @@ distance rather than a single column if used with no argument. ** Auto Save Files Deleted. -The default value of `delete-auto-save-files' is now `t', so that +The default value of 'delete-auto-save-files' is now 't', so that when you save a file for real, its auto save file is deleted. ** Rnews changes. @@ -392,18 +392,18 @@ to specify files in which copies of the message should be put. The message is written into those files in Unix mail file format. The message as sent does not contain any Fcc fields in its header. You can use any number of Fcc fields, but only one file name in each one. -The variable `mail-archive-file-name', if non-`nil', can be a string +The variable 'mail-archive-file-name', if non-'nil', can be a string which is a file name; an Fcc to that file will be inserted in every message when you begin to compose it. A new command C-c q now exists in Mail mode. It fills the paragraphs of an old message that had been inserted with C-c y. -When the *mail* buffer is put in Mail mode, text-mode-hook -is now run in addition to mail-mode-hook. text-mode-hook +When the *mail* buffer is put in Mail mode, 'text-mode-hook' +is now run in addition to 'mail-mode-hook'. text-mode-hook is run first. -The new variable `mail-header-separator' now specifies the string +The new variable 'mail-header-separator' now specifies the string to use on the line that goes between the headers and the message text. By default it is still "--text follows this line--". @@ -434,38 +434,38 @@ with (defun foo-1 (x y z) ... -** Functions `region-to-string' and `region-around-match' removed. +** Functions 'region-to-string' and 'region-around-match' removed. These functions were made for compatibility with Gosling Emacs, but it turns out to be undesirable to use them in GNU Emacs because they use the mark. They have been eliminated from Emacs proper, but are present in mlsupport.el for the sake of converted mocklisp programs. -If you were using `region-to-string', you should instead use -`buffer-substring'; then you can pass the bounds as arguments and +If you were using 'region-to-string', you should instead use +'buffer-substring'; then you can pass the bounds as arguments and can avoid setting the mark. -If you were using `region-around-match', you can use instead -the two functions `match-beginning' and `match-end'. These give +If you were using 'region-around-match', you can use instead +the two functions 'match-beginning' and 'match-end'. These give you one bound at a time, as a numeric value, without changing point or the mark. -** Function `function-type' removed. +** Function 'function-type' removed. This just appeared not to be very useful. It can easily be written in -Lisp if you happen to want it. Just use `symbol-function' to get the +Lisp if you happen to want it. Just use 'symbol-function' to get the function definition of a symbol, and look at its data type or its car if it is a list. -** Variable `buffer-number' removed. +** Variable 'buffer-number' removed. -You can still use the function `buffer-number' to find out +You can still use the function 'buffer-number' to find out a buffer's unique number (assigned in order of creation). -** Variable `executing-macro' renamed `executing-kbd-macro'. +** Variable 'executing-macro' renamed 'executing-kbd-macro'. This variable is the currently executing keyboard macro, as -a string, or `nil' when no keyboard macro is being executed. +a string, or 'nil' when no keyboard macro is being executed. ** Loading term/$TERM. @@ -478,15 +478,15 @@ term-$TERM; thus, for example, term-vt100.el, but now they live in a special subdirectory named term, and have names like term/vt100.el. -** `command-history' format changed. +** 'command-history' format changed. The elements of this list are now Lisp expressions which can be evaluated directly to repeat a command. ** Unused editing commands removed. -The functions `forward-to-word', `backward-to-word', -`upcase-char', `mark-beginning-of-buffer' and `mark-end-of-buffer' +The functions 'forward-to-word', 'backward-to-word', +'upcase-char', 'mark-beginning-of-buffer' and 'mark-end-of-buffer' have been removed. Their definitions can be found in file lisp/unused.el if you need them. @@ -496,53 +496,53 @@ lisp/unused.el if you need them. ** You can now continue after errors and quits. When the debugger is entered because of a C-g, due to -a non-`nil' value of `debug-on-quit', the `c' command in the debugger +a non-'nil' value of 'debug-on-quit', the 'c' command in the debugger resumes execution of the code that was running when the quit happened. -Use the `q' command to go ahead and quit. +Use the 'q' command to go ahead and quit. The same applies to some kinds of errors, but not all. Errors -signaled with the Lisp function `signal' can be continued; the `c' -command causes `signal' to return. The `r' command causes `signal' to -return the value you specify. The `c' command is equivalent to `r' -with the value `nil'. +signaled with the Lisp function 'signal' can be continued; the 'c' +command causes 'signal' to return. The 'r' command causes 'signal' to +return the value you specify. The 'c' command is equivalent to 'r' +with the value 'nil'. -For a `wrong-type-argument' error, the value returned with the `r' +For a 'wrong-type-argument' error, the value returned with the 'r' command is used in place of the invalid argument. If this new value is not valid, another error occurs. -Errors signaled with the function `error' cannot be continued. +Errors signaled with the function 'error' cannot be continued. If you try to continue, the error just happens again. -** `dot' renamed `point'. +** 'dot' renamed 'point'. -The word `dot' has been replaced with `point' in all +The word 'dot' has been replaced with 'point' in all function and variable names, including: - point, point-min, point-max, - point-marker, point-min-marker, point-max-marker, - window-point, set-window-point, - point-to-register, register-to-point, - exchange-point-and-mark. + 'point', 'point-min', 'point-max', + 'point-marker', 'point-min-marker', 'point-max-marker', + 'window-point', 'set-window-point', + 'point-to-register', 'register-to-point', + 'exchange-point-and-mark'. The old names are still supported, for now. -** `string-match' records position of end of match. +** 'string-match' records position of end of match. -After a successful call to `string-match', `(match-end 0)' will +After a successful call to 'string-match', `(match-end 0)' will return the index in the string of the first character after the match. -Also, `match-begin' and `match-end' with nonzero arguments can be +Also, 'match-begin' and 'match-end' with nonzero arguments can be used to find the indices of beginnings and ends of substrings matched by subpatterns surrounded by parentheses. -** New function `insert-before-markers'. +** New function 'insert-before-markers'. -This function is just like `insert' except in the handling of any +This function is just like 'insert' except in the handling of any relocatable markers that are located at the point of insertion. -With `insert', such markers end up pointing before the inserted text. -With `insert-before-markers', they end up pointing after the inserted +With 'insert', such markers end up pointing before the inserted text. +With 'insert-before-markers', they end up pointing after the inserted text. -** New function `copy-alist'. +** New function 'copy-alist'. This function takes one argument, a list, and makes a disjoint copy of the alist structure. The list itself is copied, and each element @@ -550,32 +550,32 @@ that is a cons cell is copied, but the cars and cdrs of elements remain shared with the original argument. This is what it takes to get two alists disjoint enough that changes -in one do not change the result of `assq' on the other. +in one do not change the result of 'assq' on the other. -** New function `copy-keymap'. +** New function 'copy-keymap'. This function takes a keymap as argument and returns a new keymap containing initially the same bindings. Rebindings in either one of them will not alter the bindings in the other. -** New function `copy-syntax-table'. +** New function 'copy-syntax-table'. This function takes a syntax table as argument and returns a new syntax table containing initially the same syntax settings. Changes in either one of them will not alter the other. -** Randomizing the random numbers. +** Randomizing the 'random' numbers. `(random t)' causes the random number generator's seed to be set based on the current time and Emacs's process id. -** Third argument to `modify-syntax-entry'. +** Third argument to 'modify-syntax-entry'. -The optional third argument to `modify-syntax-entry', if specified +The optional third argument to 'modify-syntax-entry', if specified should be a syntax table. The modification is made in that syntax table rather than in the current syntax table. -** New function `run-hooks'. +** New function 'run-hooks'. This function takes any number of symbols as arguments. It processes the symbols in order. For each symbol which @@ -584,29 +584,29 @@ called as a function, with no arguments. This is useful in major mode commands. -** Second arg to `switch-to-buffer'. +** Second arg to 'switch-to-buffer'. -If this function is given a non-`nil' second argument, then the +If this function is given a non-'nil' second argument, then the selection being done is not recorded on the selection history. The buffer's position in the history remains unchanged. This feature is used by the view commands, so that the selection history after exiting from viewing is the same as it was before. -** Second arg to `display-buffer' and `pop-to-buffer'. +** Second arg to 'display-buffer' and 'pop-to-buffer'. These two functions both accept an optional second argument which -defaults to `nil'. If the argument is not `nil', it means that +defaults to 'nil'. If the argument is not 'nil', it means that another window (not the selected one) must be found or created to display the specified buffer in, even if it is already shown in the selected window. -This feature is used by `switch-to-buffer-other-window'. +This feature is used by 'switch-to-buffer-other-window'. -** New variable `completion-ignore-case'. +** New variable 'completion-ignore-case'. -If this variable is non-`nil', completion allows strings +If this variable is non-'nil', completion allows strings in different cases to be considered matching. The global value -is `nil' +is 'nil' This variable exists for the sake of commands that are completing an argument in which case is not significant. It is possible @@ -617,13 +617,13 @@ where case makes a difference. ** Major modes related to Text mode call text-mode-hook, then their own hooks. For example, turning on Outline mode first calls the value of -`text-mode-hook' as a function, if it exists and is non-`nil', -and then does likewise for the variable `outline-mode-hook'. +'text-mode-hook' as a function, if it exists and is non-'nil', +and then does likewise for the variable 'outline-mode-hook'. ** Defining new command line switches. You can define a new command line switch in your .emacs file -by putting elements on the value of `command-switch-alist'. +by putting elements on the value of 'command-switch-alist'. Each element of this list should look like (SWITCHSTRING . FUNCTION) where SWITCHSTRING is a string containing the switch to be @@ -633,35 +633,35 @@ receives the command line argument, a string, as its argument. To implement a switch that uses up one or more following arguments, use the fact that the remaining command line arguments are kept -as a list in the variable `command-line-args'. FUNCTION can +as a list in the variable 'command-line-args'. FUNCTION can examine this variable, and do (setq command-line-args (cdr command-line-args) to "use up" an argument. -** New variable `load-in-progress'. +** New variable 'load-in-progress'. -This variable is non-`nil' when a file of Lisp code is being read -and executed by `load'. +This variable is non-'nil' when a file of Lisp code is being read +and executed by 'load'. -** New variable `print-length'. +** New variable 'print-length'. -The value of this variable is normally `nil'. It may instead be -a number; in that case, when a list is printed by `prin1' or -`princ' only that many initial elements are printed; the rest are +The value of this variable is normally 'nil'. It may instead be +a number; in that case, when a list is printed by 'prin1' or +'princ' only that many initial elements are printed; the rest are replaced by `...'. -** New variable `find-file-not-found-hook'. +** New variable 'find-file-not-found-hook'. -If `find-file' or any of its variants is used on a nonexistent file, -the value of `find-file-not-found-hook' is called (if it is not `nil') +If 'find-file' or any of its variants is used on a nonexistent file, +the value of 'find-file-not-found-hook' is called (if it is not 'nil') with no arguments, after creating an empty buffer. The file's name -can be found as the value of `buffer-file-name'. +can be found as the value of 'buffer-file-name'. ** Processes without buffers. -In the function `start-process', you can now specify `nil' as -the process's buffer. You can also set a process's buffer to `nil' -using `set-process-buffer'. +In the function 'start-process', you can now specify 'nil' as +the process's buffer. You can also set a process's buffer to 'nil' +using 'set-process-buffer'. The reason you might want to do this is to prevent the process from being killed because any particular buffer is killed. @@ -672,18 +672,18 @@ When a process has no buffer, its output is lost unless it has a filter, and no indication of its being stopped or killed is given unless it has a sentinel. -** New function `user-variable-p'. `v' arg prompting changed. +** New function 'user-variable-p'. 'v' arg prompting changed. -This function takes a symbol as argument and returns `t' if +This function takes a symbol as argument and returns 't' if the symbol is defined as a user option variable. This means -that it has a `variable-documentation' property whose value is +that it has a 'variable-documentation' property whose value is a string starting with `*'. -Code `v' in an interactive arg reading string now accepts +Code 'v' in an interactive arg reading string now accepts user variables only, and completion is limited to the space of user variables. -The function `read-variable' also now accepts and completes +The function 'read-variable' also now accepts and completes over user variables only. ** CBREAK mode input is the default in Unix 4.3 bsd. @@ -691,33 +691,33 @@ over user variables only. In Berkeley 4.3 Unix, there are sufficient features for Emacs to work fully correctly using CBREAK mode and not using SIGIO. Therefore, this mode is the default when running under 4.3. -This mode corresponds to `nil' as the first argument to -`set-input-mode'. You can still select either mode by calling +This mode corresponds to 'nil' as the first argument to +'set-input-mode'. You can still select either mode by calling that function. ** Information on memory usage. -The new variable `data-bytes-used' contains the number +The new variable 'data-bytes-used' contains the number of bytes of impure space allocated in Emacs. -`data-bytes-free' contains the number of additional bytes +'data-bytes-free' contains the number of additional bytes Emacs could allocate. Note that space formerly allocated -and freed again still counts as `used', since it is still +and freed again still counts as 'used', since it is still in Emacs's address space. -** No limit on size of output from `format'. +** No limit on size of output from 'format'. -The string output from `format' used to be truncated to +The string output from 'format' used to be truncated to 100 characters in length. Now it can have any length. -** New errors `void-variable' and `void-function' replace `void-symbol'. +** New errors 'void-variable' and 'void-function' replace 'void-symbol'. This change makes it possible to have error messages that clearly distinguish undefined variables from undefined functions. -It also allows `condition-case' to handle one case without the other. +It also allows 'condition-case' to handle one case without the other. -** `replace-match' handling of `\'. +** 'replace-match' handling of `\'. -In `replace-match', when the replacement is not literal, +In 'replace-match', when the replacement is not literal, `\' in the replacement string is always treated as an escape marker. The only two special `\' constructs are `\&' and `\DIGIT', so `\' followed by anything other than @@ -728,21 +728,21 @@ This level of escaping is comparable with what goes on in a regular expression. It is over and above the level of `\' escaping that goes on when strings are read in Lisp syntax. -** New error `invalid-regexp'. +** New error 'invalid-regexp'. A regexp search signals this type of error if the argument does not meet the rules for regexp syntax. -** `kill-emacs' with argument. +** 'kill-emacs' with argument. If the argument is a number, it is returned as the exit status code of the Emacs process. If the argument is a string, its contents are stuffed as pending terminal input, to be read by another program after Emacs is dead. -** New fifth argument to `subst-char-in-region'. +** New fifth argument to 'subst-char-in-region'. -This argument is optional and defaults to `nil'. If it is not `nil', +This argument is optional and defaults to 'nil'. If it is not 'nil', then the substitutions made by this function are not recorded in the Undo mechanism. @@ -757,25 +757,25 @@ another while in the debugger. Exiting from the debugger kills the `*Backtrace*' buffer, so you will not try to give commands in it when no longer really in the debugger. -** New function `switch-to-buffer-other-window'. +** New function 'switch-to-buffer-other-window'. This is the new primitive to select a specified buffer (the argument) in another window. It is not quite the same as -`pop-to-buffer', because it is guaranteed to create another +'pop-to-buffer', because it is guaranteed to create another window (assuming there is room on the screen) so that it can leave the current window's old buffer displayed as well. All functions to select a buffer in another window should do so by calling this new function. -** New variable `minibuffer-help-form'. +** New variable 'minibuffer-help-form'. -At entry to the minibuffer, the variable `help-form' is bound -to the value of `minibuffer-help-form'. +At entry to the minibuffer, the variable 'help-form' is bound +to the value of 'minibuffer-help-form'. -`help-form' is expected at all times to contain either `nil' +'help-form' is expected at all times to contain either 'nil' or an expression to be executed when C-h is typed (overriding -the definition of C-h as a command). `minibuffer-help-form' +the definition of C-h as a command). 'minibuffer-help-form' can be used to provide a different default way of handling C-h while in the minibuffer. @@ -791,7 +791,7 @@ be quoted with a second `\', to include it in the doc string.) This construct is normally used on a line by itself, with no blank lines before or after. -For example, the documentation string for the function `c-mode' contains +For example, the documentation string for the function 'c-mode' contains ... Paragraphs are separated by blank lines only. Delete converts tabs to spaces as it moves back. @@ -803,13 +803,13 @@ For example, the documentation string for the function `c-mode' contains Punctuation characters behave like whitespace in word and list parsing, but can be distinguished in regexps and in the -function `char-syntax'. Punctuation syntax is represented by -a period in `modify-syntax-entry'. +function 'char-syntax'. Punctuation syntax is represented by +a period in 'modify-syntax-entry'. -** `auto-mode-alist' no longer needs entries for backup-file names, +** 'auto-mode-alist' no longer needs entries for backup-file names, Backup suffixes of all kinds are now stripped from a file's name -before searching `auto-mode-alist'. +before searching 'auto-mode-alist'. @@ -846,14 +846,14 @@ arguments and then confirm, or abort with C-g. ** Incremental search does less redisplay on slow terminals. -If the terminal baud rate is <= the value of `isearch-slow-speed', +If the terminal baud rate is <= the value of 'isearch-slow-speed', incremental searching outside the text on the screen creates a single-line window and uses that to display the line on which a match has been found. Exiting or quitting the search restores the previous window configuration and redisplays the window you were searching in. -The initial value of `isearch-slow-speed' is 1200. +The initial value of 'isearch-slow-speed' is 1200. This feature is courtesy of crl@purdue. @@ -871,17 +871,17 @@ if you know enough to switch windows while in the minibuffer, you can probably understand recursive minibuffers. This may be overridden by binding the variable -`enable-recursive-minibuffers' to t. +'enable-recursive-minibuffers' to t. ** New major mode Emacs-Lisp mode, for editing Lisp code to run in Emacs. -The mode in which emacs lisp files is edited is now called emacs-lisp-mode -and is distinct from lisp-mode. The latter is intended for use with -lisps external to emacs. +The mode in which emacs lisp files is edited is now called 'emacs-lisp-mode' +and is distinct from 'lisp-mode'. The latter is intended for use with +lisps external to Emacs. The hook which is funcalled (if non-nil) on entry to elisp-mode is now -called emacs-lisp-mode-hook. A consequence of this changes is that -.emacs init files which set the value of lisp-mode-hook may need to be +called 'emacs-lisp-mode-hook'. A consequence of this changes is that +.emacs init files which set the value of 'lisp-mode-hook' may need to be changed to use the new names. ** Correct matching of parentheses is checked on insertion. @@ -898,18 +898,18 @@ This feature was originally written by shane@mit-ajax. ** M-x command-history-mode ** M-x electric-command-history -`list-command-history' displays forms from the command history subject +'list-command-history' displays forms from the command history subject to user controlled filtering and limit on number of forms. It leaves -the buffer in `command-history-mode'. M-x command-history-mode +the buffer in 'command-history-mode'. M-x command-history-mode recomputes the command history each time it is invoked via -`list-command-history'. It is like Emacs-Lisp mode except that characters +'list-command-history'. It is like Emacs-Lisp mode except that characters don't insert themselves and provision is made for re-evaluating an -expression from the list. `electric-command-history' pops up a type +expression from the list. 'electric-command-history' pops up a type out window with the command history displayed. If the very next character is Space, the window goes away and the previous window configuration is restored. Otherwise you can move around in the history and select an expression for evaluation *inside* the buffer -which invoked `electric-command-history'. The original window +which invoked 'electric-command-history'. The original window configuration is restored on exit unless the command selected changes it. @@ -924,7 +924,7 @@ Special commands for hacking tabs and tab stops are provided. Special commands for killing rectangles and overlaying them are provided. See the documentation of function edit-picture for more details. -Calls value of `edit-picture-hook' on entry if non-nil. +Calls value of 'edit-picture-hook' on entry if non-nil. ** Stupid C-s/C-q `flow control' supported. @@ -977,15 +977,15 @@ lisp-mode-hook, in that order, if non-nil. Meanwhile, in lisp-mode, the command C-M-x is defined to send the current defun as input to the `*lisp*' subprocess. -** Mode line says `Narrow' when buffer is clipped. +** Mode line says 'Narrow' when buffer is clipped. -If a buffer has a clipping restriction (made by `narrow-to-region') -then its mode line contains the word `Narrow' after the major and +If a buffer has a clipping restriction (made by 'narrow-to-region') +then its mode line contains the word 'Narrow' after the major and minor modes. -** Mode line says `Abbrev' when abbrev mode is on. +** Mode line says 'Abbrev' when abbrev mode is on. -** add-change-log-entry takes prefix argument +** 'add-change-log-entry' takes prefix argument Giving a prefix argument makes it prompt for login name, full name, and site name, with defaults. Otherwise the defaults are used @@ -994,27 +994,27 @@ with no confirmation. ** M-x view-buffer and M-x view-file view-buffer selects the named buffer, view-file finds the named file; the -resulting buffer is placed into view-mode (a recursive edit). The normal +resulting buffer is placed into 'view-mode' (a recursive edit). The normal emacs commands are not available. Instead a set of special commands is provided which facilitate moving around in the buffer, searching and scrolling by screenfuls. Exiting view-mode returns to the buffer in which the view-file or view-buffer command was given. Type ? or h when viewing for a complete list of view commands. -Each calls value of `view-hook' if non-nil on entry. +Each calls value of 'view-hook' if non-nil on entry. written by shane@mit-ajax. ** New key commands in dired. -`v' views (like more) the file on the current line. +'v' views (like more) the file on the current line. `#' marks auto-save files for deletion. `~' marks backup files for deletion. -`r' renames a file and updates the directory listing if the +'r' renames a file and updates the directory listing if the file is renamed to same directory. -`c' copies a file and updates the directory listing if the file is +'c' copies a file and updates the directory listing if the file is copied to the same directory. -** New function `electric-buffer-list'. +** New function 'electric-buffer-list'. This pops up a buffer describing the set of emacs buffers. Immediately typing space makes the buffer list go away and returns @@ -1026,18 +1026,18 @@ cursor's line. There are a number of other commands which are the same as those of buffer-menu-mode. This is a useful thing to bind to c-x c-b in your `.emacs' file if the -rather non-standard `electric' behavior of the buffer list suits your taste. +rather non-standard 'electric' behavior of the buffer list suits your taste. Type C-h after invoking electric-buffer-list for more information. -Calls value of `electric-buffer-menu-mode-hook' if non-nil on entry. -Calls value of `after-electric-buffer-menu' on exit (select) if non-nil. +Calls value of 'electric-buffer-menu-mode-hook' if non-nil on entry. +Calls value of 'after-electric-buffer-menu' on exit (select) if non-nil. ** Changes in version 16 for mail reading and sending *** sendmail prefix character is C-c (and not C-z). New command C-c w. For instance C-c C-c (or C-c C-s) sends mail now rather than C-z C-z. -C-c w inserts your `signature' (contents of ~/.signature) at the end +C-c w inserts your 'signature' (contents of ~/.signature) at the end of mail. *** New feature in C-c y command in sending mail. @@ -1063,26 +1063,26 @@ C-c and C-] are the only ways "back into Rmail", but you can switch to other buffers and edit them as usual. C-r in Rmail changes only the handling of the Rmail buffer. -*** Rmail command `t' toggles header display. +*** Rmail command 't' toggles header display. Normally Rmail reformats messages to hide most header fields. -`t' switches to display of all the header fields of the +'t' switches to display of all the header fields of the current message, as long as it remains current. -Another `t' switches back to the usual display. +Another 't' switches back to the usual display. *** Rmail command '>' goes to the last message. -*** Rmail commands `a' and `k' set message attributes. -`a' adds an attribute and `k' removes one. You specify +*** Rmail commands 'a' and 'k' set message attributes. +'a' adds an attribute and 'k' removes one. You specify the attribute by name. You can specify either a built-in flag such as "deleted" or "filed", or a user-defined keyword (anything not recognized as built-in). -*** Rmail commands `l' and `L' summarize by attributes. +*** Rmail commands 'l' and 'L' summarize by attributes. These commands create a summary with one line per message, -like `h', but they list only some of the messages. You -specify which attribute (for `l') or attributes (for `L') +like 'h', but they list only some of the messages. You +specify which attribute (for 'l') or attributes (for 'L') the messages should have. *** Rmail can parse mmdf mail files. @@ -1092,11 +1092,11 @@ the messages should have. mh-e is a front end for GNU emacs and the MH mail system. It provides a friendly and convenient interface to the MH commands. -To read mail, invoke mh-rmail. This will inc new mail and display the +To read mail, invoke 'mh-rmail'. This will inc new mail and display the scan listing on the screen. To see a summary of the mh-e commands, type ?. Help is available through the usual facilities. -To send mail, invoke mh-smail. +To send mail, invoke 'mh-smail'. mh-e requires a copy of MH.5 that has been compiled with the MHE compiler switch. @@ -1105,39 +1105,39 @@ From larus@berkeley. ** New hooks and parameters in version 16 -*** New variable `blink-matching-paren-distance'. +*** New variable 'blink-matching-paren-distance'. This is the maximum number of characters to search for an open-paren to match an inserted close-paren. The matching open-paren is shown and checked if it is found within this distance. -`nil' means search all the way to the beginning of the buffer. +'nil' means search all the way to the beginning of the buffer. In this case, a warning message is printed if no matching open-paren is found. This feature was originally written by shane@mit-ajax. -*** New variable `find-file-run-dired' +*** New variable 'find-file-run-dired' If nil, find-file will report an error if an attempt to visit a directory is detected; otherwise, it runs dired on that directory. The default is t. -*** Variable `dired-listing-switches' holds switches given to `ls' by dired. +*** Variable 'dired-listing-switches' holds switches given to 'ls' by dired. -The value should be a string containing `-' followed by letters. -The letter `l' had better be included and letter 'F' had better be excluded! +The value should be a string containing '-' followed by letters. +The letter 'l' had better be included and letter 'F' had better be excluded! The default is "-al". This feature was originally written by shane@mit-ajax. -*** New variable `display-time-day-and-date'. +*** New variable 'display-time-day-and-date'. -If this variable is set non-`nil', the function M-x display-time +If this variable is set non-'nil', the function M-x display-time displays the day and date, as well as the time. -*** New parameter `c-continued-statement-indent'. +*** New parameter 'c-continued-statement-indent'. This controls the extra indentation given to a line that continues a C statement started on the previous line. @@ -1147,19 +1147,20 @@ By default it is 2, which is why you would see bar (); -*** Changed meaning of `c-indent-level'. +*** Changed meaning of 'c-indent-level'. -The value of `c-brace-offset' used to be -subtracted from the value of `c-indent-level' whenever +The value of 'c-brace-offset' used to be +subtracted from the value of 'c-indent-level' whenever that value was used. Now it is not. -As a result, `c-indent-level' is now the offset of +As a result, 'c-indent-level' is now the offset of statements within a block, relative to the line containing the open-brace that starts the block. -*** turn-on-auto-fill is useful value for text-mode-hook. +*** 'turn-on-auto-fill' is useful value for 'text-mode-hook'. + + (setq text-mode-hook 'turn-on-auto-fill) -(setq text-mode-hook 'turn-on-auto-fill) is all you have to do to make sure Auto Fill mode is turned on whenever you enter Text mode. @@ -1187,8 +1188,8 @@ the following text, up to the next `]', is taken as a function name. Instead of printing that function name, the command that runs it is printed. (M-x is used to construct a command if no shorter one exists.) -For example, instead of putting `C-n' in a documentation string -to refer to the C-n command, put in `\[next-line]'. (In practice +For example, instead of putting 'C-n' in a documentation string +to refer to the 'next-line' command, put in `\[next-line]'. (In practice you will need to quote the backslash with another backslash, due to the syntax for strings in Lisp and C.) @@ -1197,34 +1198,34 @@ precede them with `\='. To include the characters `\=', precede them with `\='. For example, "\\=\\= is the way to quote \\=\\[" will come out as `\= is the way to quote \['. -The new function `substitute-command-keys' takes a string possibly +The new function 'substitute-command-keys' takes a string possibly containing \[...] constructs and replaces those constructs with the key sequences they currently stand for. -*** Primitives `find-line-comment' and `find-line-comment-body' flushed. +*** Primitives 'find-line-comment' and 'find-line-comment-body' flushed. -Search for the value of `comment-start-skip' if you want to find +Search for the value of 'comment-start-skip' if you want to find whether and where a line has a comment. -*** New function `auto-save-file-name-p' +*** New function 'auto-save-file-name-p' -Should return non-`nil' if given a string which is the name of an +Should return non-'nil' if given a string which is the name of an auto-save file (sans directory name). If you redefine -`make-auto-save-file-name', you should redefine this accordingly. By -default, this function returns `t' for filenames beginning with +'make-auto-save-file-name', you should redefine this accordingly. By +default, this function returns 't' for filenames beginning with character `#'. -*** The value of `exec-directory' now ends in a slash. +*** The value of 'exec-directory' now ends in a slash. This is to be compatible with most directory names in GNU Emacs. *** Dribble files and termscript files. -(open-dribble-file FILE) opens a dribble file named FILE. When a +'open-dribble-file' opens a dribble file. When a dribble file is open, every character Emacs reads from the terminal is written to the dribble file. -(open-termscript FILE) opens a termscript file named FILE. When a +'open-termscript' opens a termscript file. When a termscript file is open, all characters sent to the terminal by Emacs are also written in the termscript file. @@ -1240,15 +1241,15 @@ a synonym for C-x u (undo). *** Undefined function errors versus undefined variable errors. -Void-symbol errors now say "boundp" if the symbol's value was void -or "fboundp" if the function definition was void. +Void-symbol errors now say 'boundp' if the symbol's value was void +or 'fboundp' if the function definition was void. -*** New function `bury-buffer'. +*** New function 'bury-buffer'. -The new function `bury-buffer' takes one argument, a buffer object, +The new function 'bury-buffer' takes one argument, a buffer object, and puts that buffer at the end of the internal list of buffers. So it is the least preferred candidate for use as the default value -of C-x b, or for other-buffer to return. +of C-x b, or for 'other-buffer' to return. *** Already-displayed buffers have low priority for display. @@ -1256,14 +1257,14 @@ When a buffer is chosen automatically for display, or to be the default in C-x b, buffers already displayed in windows have lower priority than buffers not currently visible. -*** `set-window-start' accepts a third argument NOFORCE. +*** 'set-window-start' accepts a third argument NOFORCE. This argument, if non-nil, prevents the window's force_start flag from being set. Setting the force_start flag causes the next redisplay to insist on starting display at the specified starting point, even if dot must be moved to get it onto the screen. -*** New function `send-string-to-terminal'. +*** New function 'send-string-to-terminal'. This function takes one argument, a string, and outputs its contents to the terminal exactly as specified: control characters, escape @@ -1273,9 +1274,9 @@ sequences, and all. The terminal's keypad is now put into command mode, as opposed to numeric mode, while Emacs is running. This is done by means of the -termcap `ks' and `ke' strings. +termcap 'ks' and 'ke' strings. -*** New function `generate-new-buffer' +*** New function 'generate-new-buffer' This function takes a string as an argument NAME and looks for a creates and returns a buffer called NAME if one did not already exist. @@ -1283,38 +1284,38 @@ Otherwise, it successively tries appending suffixes of the form "<1>", "<2>" etc to NAME until it creates a string which does not name an existing buffer. A new buffer with that name is the created and returned. -*** New function `prin1-to-string' +*** New function 'prin1-to-string' This function takes one argument, a lisp object, and returns a string -containing that object's printed representation, such as `prin1' +containing that object's printed representation, such as 'prin1' would output. -*** New function `read-from-minibuffer' +*** New function 'read-from-minibuffer' Lets you supply a prompt, initial-contents, a keymap, and specify whether the result should be interpreted as a string or a lisp object. -Old functions `read-minibuffer', `eval-minibuffer', `read-string' all +Old functions 'read-minibuffer', 'eval-minibuffer', 'read-string' all take second optional string argument which is initial contents of minibuffer. *** minibuffer variable names changed (names of keymaps) -minibuf-local-map -> minibuffer-local-map -minibuf-local-ns-map -> minibuffer-local-ns-map -minibuf-local-completion-map -> minibuffer-local-completion-map -minibuf-local-must-match-map -> minibuffer-local-must-match-map +'minibuf-local-map' -> 'minibuffer-local-map' +'minibuf-local-ns-map' -> 'minibuffer-local-ns-map' +'minibuf-local-completion-map' -> 'minibuffer-local-completion-map' +'minibuf-local-must-match-map' -> 'minibuffer-local-must-match-map' ** Changes in version 16 affecting configuring and building Emacs *** Configuration switch VT100_INVERSE eliminated. You can control the use of inverse video on any terminal by setting -the variable `inverse-video', or by changing the termcap entry. If -you like, set `inverse-video' in your `.emacs' file based on +the variable 'inverse-video', or by changing the termcap entry. If +you like, set 'inverse-video' in your `.emacs' file based on examination of (getenv "TERM"). -*** New switch `-batch' makes Emacs run noninteractively. +*** New switch '-batch' makes Emacs run noninteractively. -If the switch `-batch' is used, Emacs treats its standard output +If the switch '-batch' is used, Emacs treats its standard output and input like ordinary files (even if they are a terminal). It does not display buffers or windows; the only output to standard output is what would appear as messages in the echo area, and each @@ -1322,13 +1323,13 @@ message is followed by a newline. The terminal modes are not changed, so that C-z and C-c retain their normal Unix meanings. Emacs does still read commands from -the terminal, but the idea of `-batch' is that you use it with +the terminal, but the idea of '-batch' is that you use it with other command line arguments that tell Emacs a complete task to perform, -including killing itself. `-kill' used as the last argument is a good +including killing itself. '-kill' used as the last argument is a good way to accomplish this. -The Lisp variable `noninteractive' is now defined, to be `nil' -except when `-batch' has been specified. +The Lisp variable 'noninteractive' is now defined, to be 'nil' +except when '-batch' has been specified. *** Emacs can be built with output redirected to a file. @@ -1359,7 +1360,7 @@ This is because -batch (see above) is now used in building Emacs. Note that lisp code converted from Mocklisp code will not necessarily run as fast as code specifically written for GNU Emacs, nor will it use the many features of GNU Emacs which are not present in Gosling's emacs. - (In particular, the byte-compiler (m-x byte-compile-file) knows little + (In particular, the byte-compiler (M-x byte-compile-file) knows little about compilation of code directly converted from mocklisp.) It is envisaged that old mocklisp code will be incrementally converted to GNU lisp code, with M-x convert-mocklisp-buffer being the first @@ -1382,63 +1383,66 @@ This is because -batch (see above) is now used in building Emacs. specify the tag table file name initially, or to switch to a new tag table. -** If truncate-partial-width-windows is non-nil (as it initially is), +** If 'truncate-partial-width-windows' is non-nil (as it initially is), all windows less than the full screen width (that is, made by side-by-side splitting) truncate lines rather than continuing them. ** Emacs now checks for Lisp stack overflow to avoid fatal errors. - The depth in eval, apply and funcall may not exceed max-lisp-eval-depth. + The depth in 'eval', 'apply' and 'funcall' may not exceed + 'max-lisp-eval-depth'. The depth in variable bindings and unwind-protects may not exceed - max-specpdl-size. If either limit is exceeded, an error occurs. + 'max-specpdl-size'. If either limit is exceeded, an error occurs. You can set the limits to larger values if you wish, but if you make them too large, you are vulnerable to a fatal error if you invoke Lisp code that does infinite recursion. -** New hooks find-file-hook and write-file-hook. +** New hooks 'find-file-hook' and 'write-file-hook'. Both of these variables if non-nil should be functions of no arguments. At the time they are called (current-buffer) will be the buffer being read or written respectively. - find-file-hook is called whenever a file is read into its own buffer, - such as by calling find-file, revert-buffer, etc. It is not called by - functions such as insert-file which do not read the file into a buffer of + 'find-file-hook' is called whenever a file is read into its own buffer, + such as by calling 'find-file', 'revert-buffer', etc. It is not called by + functions such as 'insert-file' which do not read the file into a buffer of its own. - find-file-hook is called after the file has been read in and its + 'find-file-hook' is called after the file has been read in and its local variables (if any) have been processed. - write-file-hook is called just before writing out a file from a buffer. + 'write-file-hook' is called just before writing out a file from a buffer. -** The initial value of shell-prompt-pattern is now "^[^#$%>]*[#$%>] *" +** The initial value of 'shell-prompt-pattern' is now "^[^#$%>]*[#$%>] *" -** If the .emacs file sets inhibit-startup-message to non-nil, +** If the .emacs file sets 'inhibit-startup-message' to non-nil, the messages normally printed by Emacs at startup time are inhibited. ** Facility for run-time conditionalization on the basis of emacs features. - The new variable features is a list of symbols which represent "features" + The new variable 'features' is a list of symbols which represent "features" of the executing emacs, for use in run-time conditionalization. - The function featurep of one argument may be used to test for the + The function 'featurep' of one argument may be used to test for the presence of a feature. It is just the same as - (not (null (memq FEATURE features))) where FEATURE is its argument. - For example, (if (featurep 'magic-window-hack) - (transmogrify-window 'vertical) - (split-window-vertically)) + (not (null (memq FEATURE features))) + where FEATURE is its argument. For example, + + (if (featurep 'magic-window-hack) + (transmogrify-window 'vertical) + (split-window-vertically)) - The function provide of one argument "announces" that FEATURE is present. + The function 'provide' of one argument "announces" that FEATURE is present. It is much the same as (if (not (featurep FEATURE)) (setq features (cons FEATURE features))) - The function require with arguments FEATURE and FILE-NAME loads FILE-NAME + The function 'require' with arguments FEATURE and FILE-NAME loads FILE-NAME (which should contain the form (provide FEATURE)) unless FEATURE is present. It is much the same as (if (not (featurep FEATURE)) (progn (load FILE-NAME) (if (not featurep FEATURE) (error ...)))) FILE-NAME is optional and defaults to FEATURE. -** New function load-average. +** New function 'load-average'. This returns a list of three integers, which are the current 1 minute, 5 minute and 15 minute load averages, @@ -1460,10 +1464,10 @@ This is because -batch (see above) is now used in building Emacs. ** Programmer's note: detecting killed buffers. Buffers are eliminated by explicitly killing them, using - the function kill-buffer. This does not eliminate or affect + the function 'kill-buffer'. This does not eliminate or affect the pointers to the buffer which may exist in list structure. If you have a pointer to a buffer and wish to tell whether - the buffer has been killed, use the function buffer-name. + the buffer has been killed, use the function 'buffer-name'. It returns nil on a killed buffer, and a string on a live buffer. ** New ways to access the last command input character. @@ -1471,13 +1475,13 @@ This is because -batch (see above) is now used in building Emacs. The function last-key-struck, which used to return the last input character that was read by command input, is eliminated. Instead, you can find this information as the value of the - variable last-command-char. (This variable used to be called + variable 'last-command-char'. (This variable used to be called last-key). - Another new variable, last-input-char, holds the last character + Another new variable, 'last-input-char', holds the last character read from the command input stream regardless of what it was read for. last-input-char and last-command-char are different - only inside a command that has called read-char to read input. + only inside a command that has called 'read-char' to read input. ** The new switch -kill causes Emacs to exit after processing the preceding command line arguments. Thus, @@ -1517,9 +1521,9 @@ This is because -batch (see above) is now used in building Emacs. user can explain why it is not called mdl-mode. You must load the library mim-mode explicitly to use this. -** GNU documentation formatter `texinfo'. +** GNU documentation formatter 'texinfo'. - The `texinfo' library defines a format for documentation + The 'texinfo' library defines a format for documentation files which can be passed through Tex to make a printed manual or passed through texinfo to make an Info file. Texinfo is documented fully by its own Info file; compare this file @@ -1532,7 +1536,7 @@ This is because -batch (see above) is now used in building Emacs. This is not ready for distribution yet, but will appear at a later time. -** New function read-from-string (emacs 15.29) +** New function 'read-from-string' (emacs 15.29) read-from-string takes three arguments: a string to read from, and optionally start and end indices which delimit a substring @@ -1558,25 +1562,25 @@ This is because -batch (see above) is now used in building Emacs. These messages appear after the text in the minibuffer, and remain on the screen until a few seconds go by or you type a key. -** The buffer-read-only flag is implemented. +** The 'buffer-read-only' flag is implemented. Setting or binding this per-buffer variable to a non-nil value makes illegal any operation which would modify the textual content of the buffer. (Such operations signal a buffer-read-only error) - The read-only state of a buffer may be altered using toggle-read-only + The read-only state of a buffer may be altered using 'toggle-read-only' (C-x C-q) The buffers used by Rmail, Dired, Rnews, and Info are now read-only by default to prevent accidental damage to the information in those buffers. -** Functions car-safe and cdr-safe. +** Functions 'car-safe' and 'cdr-safe'. These functions are like car and cdr when the argument is a cons. Given an argument not a cons, car-safe always returns nil, with no error; the same for cdr-safe. -** The new function user-real-login-name returns the name corresponding +** The new function 'user-real-login-name' returns the name corresponding to the real uid of the Emacs process. This is usually the same - as what user-login-name returns; however, when Emacs is invoked - from su, user-real-login-name returns "root" but user-login-name + as what 'user-login-name' returns; however, when Emacs is invoked + from su, 'user-real-login-name' returns "root" but user-login-name returns the name of the user who invoked su. @@ -1603,7 +1607,7 @@ This is because -batch (see above) is now used in building Emacs. This syntax can be used in strings too. Note, however, that Meta characters are not meaningful in key sequences being passed - to define-key or lookup-key; you must use ESC characters (\e) + to 'define-key' or 'lookup-key'; you must use ESC characters (\e) in them instead. ?\C- can be used likewise for control characters. (13.9) @@ -1627,14 +1631,14 @@ This is because -batch (see above) is now used in building Emacs. This is a shift key which causes the high bit to be turned on in all input characters typed while it is held down. - read-char now returns a value in the range 128-255 if + 'read-char' now returns a value in the range 128-255 if a Meta character is typed. When interpreted as command input, a Meta character is equivalent to a two character sequence, the meta prefix character followed by the unmetized character (Meta-G unmetized is G). The meta prefix character - is specified by the value of the variable meta-prefix-char. + is specified by the value of the variable 'meta-prefix-char'. If this character (normally Escape) has been redefined locally with a non-prefix definition (such as happens in completing minibuffers) then the local redefinition is suppressed when @@ -1643,10 +1647,10 @@ This is because -batch (see above) is now used in building Emacs. explicitly, but not effective if the character comes from the use of the Meta key. -** `-' is no longer a completion command in the minibuffer. +** '-' is no longer a completion command in the minibuffer. It is an ordinary self-inserting character. -** The list load-path of directories load to search for Lisp files +** The list 'load-path' of directories load to search for Lisp files is now controlled by the EMACSLOADPATH environment variable [[ Note this was originally EMACS-LOAD-PATH and has been changed again; sh does not deal properly with hyphens in env variable names]] @@ -1720,20 +1724,20 @@ you will not on its account be queried about active subprocesses. ** The commands C-c and C-z have been interchanged, for greater compatibility with normal Unix usage. - C-z now runs suspend-emacs and C-c runs exit-recursive-edit. + C-z now runs suspend-emacs and C-c runs 'exit-recursive-edit'. -** The value returned by file-name-directory now ends +** The value returned by 'file-name-directory' now ends with a slash. (file-name-directory "foo/bar") => "foo/". This avoids confusing results when dealing with files in the root directory. - The value of the per-buffer variable default-directory + The value of the per-buffer variable 'default-directory' is also supposed to have a final slash now. ** There are now variables to control the switches passed to - `ls' by the C-x C-d command (list-directory). - list-directory-brief-switches is a string, initially "-CF", - used for brief listings, and list-directory-verbose-switches + 'ls' by the C-x C-d command (list-directory). + 'list-directory-brief-switches' is a string, initially "-CF", + used for brief listings, and 'list-directory-verbose-switches' is a string, initially "-l", used for verbose ones. ** For Ann Arbor Ambassador terminals, the termcap "ti" string @@ -1757,7 +1761,7 @@ you will not on its account be queried about active subprocesses. to the specified filename BEFORE it tries the filename without change. -** rmail now makes the mode line display the total number +** 'rmail' now makes the mode line display the total number of messages and the current message number. The "f" command now means forward a message to another user. The command to search through all messages for a string is now "F". @@ -1767,13 +1771,13 @@ you will not on its account be queried about active subprocesses. ** The hyphen character is now equivalent to a Space while in completing minibuffers. Both mean to complete an additional word. -** The Lisp function error now takes args like format +** The Lisp function 'error' now takes args like 'format' which are used to construct the error message. ** Redisplay will refuse to start its display at the end of the buffer. It will pick a new place to display from, rather than use that. -** The value returned by garbage-collect has been changed. +** The value returned by 'garbage-collect' has been changed. Its first element is no longer a number but a cons, whose car is the number of cons cells now in use, and whose cdr is the number of cons cells that have been @@ -1782,9 +1786,9 @@ you will not on its account be queried about active subprocesses. The third element is similar but describes markers. ** The variable buffer-name has been eliminated. - The function buffer-name still exists. This is to prevent + The function 'buffer-name' still exists. This is to prevent user programs from changing buffer names without going - through the rename-buffer function. + through the 'rename-buffer' function. @@ -1795,7 +1799,7 @@ you will not on its account be queried about active subprocesses. Also, a line which consists of the fill prefix followed by white space separates paragraphs. -** C-x C-v runs the new function find-alternate-file. +** C-x C-v runs the new function 'find-alternate-file'. It finds the specified file, switches to that buffer, and kills the previous current buffer. (It requires confirmation if that buffer had changes.) This is @@ -1807,18 +1811,18 @@ you will not on its account be queried about active subprocesses. ** Meta-g (fill-region) now fills each paragraph in the region individually. To fill the region as if it were a single paragraph (for when the paragraph-delimiting mechanism - does the wrong thing), use fill-region-as-paragraph. + does the wrong thing), use 'fill-region-as-paragraph'. -** Tab in text mode now runs the function tab-to-tab-stop. - A new mode called indented-text-mode is like text-mode - except that in it Tab runs the function indent-relative, +** Tab in text mode now runs the function 'tab-to-tab-stop'. + A new mode called 'indented-text-mode' is like 'text-mode' + except that in it Tab runs the function 'indent-relative', which indents the line under the previous line. If auto fill is enabled while in indented-text-mode, the new lines that it makes are indented. -** Functions kill-rectangle and yank-rectangle. +** Functions 'kill-rectangle' and 'yank-rectangle'. kill-rectangle deletes the rectangle specified by dot and mark - (or by two arguments) and saves it in the variable killed-rectangle. + (or by two arguments) and saves it in the variable 'killed-rectangle'. yank-rectangle inserts the rectangle in that variable. Tab characters in a rectangle being saved are replaced @@ -1859,7 +1863,7 @@ you will not on its account be queried about active subprocesses. C-r -- enter a recursive edit, then on exit ask again for a character C-l -- redisplay screen and ask again." -** write-kbd-macro and append-kbd-macro are used to save +** 'write-kbd-macro' and 'append-kbd-macro' are used to save a kbd macro definition in a file (as Lisp code to redefine the macro when the file is loaded). These commands differ in that write-kbd-macro @@ -1868,11 +1872,11 @@ you will not on its account be queried about active subprocesses. record the keys which invoke the macro as well as the macro's definition. -** The variable global-minor-modes is used to display +** The variable 'global-minor-modes' is used to display strings in the mode line of all buffers. It should be a list of elements that are conses whose cdrs are strings to be displayed. This complements the variable - minor-modes, which has the same effect but has a separate + 'minor-modes', which has the same effect but has a separate value in each buffer. ** C-x = describes horizontal scrolling in effect, if any. @@ -1887,7 +1891,7 @@ you will not on its account be queried about active subprocesses. This release mostly fixes bugs. There are a few new features: -** apropos now sorts the symbols before displaying them. +** 'apropos' now sorts the symbols before displaying them. Also, it returns a list of the symbols found. apropos now accepts a second arg PRED which should be a function @@ -1898,7 +1902,7 @@ This release mostly fixes bugs. There are a few new features: If the third argument to apropos is non-nil, apropos does not display anything; it merely returns the list of symbols found. - C-h a now runs the new function command-apropos rather than + C-h a now runs the new function 'command-apropos' rather than apropos, and shows only symbols with definitions as commands. ** M-x shell sends the command @@ -1908,8 +1912,8 @@ This release mostly fixes bugs. There are a few new features: as it came from your ESHELL or SHELL environment variable but with directory name, if any, removed. -** M-, now runs the command tags-loop-continue, which is used - to resume a terminated tags-search or tags-query-replace. +** M-, now runs the command 'tags-loop-continue', which is used + to resume a terminated 'tags-search' or 'tags-query-replace'. @@ -1921,60 +1925,60 @@ It's Beat CCA Week. so that all buffer names used automatically by Emacs now have *'s. ** Undo information is now stored separately for each buffer. - The Undo command (C-x u) always applies to the current - buffer only. +The Undo command (C-x u) always applies to the current +buffer only. C-_ is now a synonym for C-x u. - (buffer-flush-undo BUFFER) causes undo information not to - be kept for BUFFER, and frees the space that would have - been used to hold it. In any case, no undo information is - kept for buffers whose names start with spaces. (These - buffers also do not appear in the C-x C-b display.) +'buffer-flush-undo' causes undo information not to +be kept for BUFFER, and frees the space that would have +been used to hold it. In any case, no undo information is +kept for buffers whose names start with spaces. (These +buffers also do not appear in the C-x C-b display.) ** Rectangle operations are now implemented. - C-x r stores the rectangle described by dot and mark - into a register; it reads the register name from the keyboard. - C-x g, the command to insert the contents of a register, - can be used to reinsert the rectangle elsewhere. +C-x r stores the rectangle described by dot and mark +into a register; it reads the register name from the keyboard. +C-x g, the command to insert the contents of a register, +can be used to reinsert the rectangle elsewhere. Other rectangle commands include - open-rectangle: + 'open-rectangle': insert a blank rectangle in the position and size described by dot and mark, at its corners; the existing text is pushed to the right. - clear-rectangle: + 'clear-rectangle': replace the rectangle described by dot and mark with blanks. The previous text is deleted. - delete-rectangle: + 'delete-rectangle': delete the text of the specified rectangle, moving the text beyond it on each line leftward. ** Side-by-side windows are allowed. Use C-x 5 to split the - current window into two windows side by side. - C-x } makes the selected window ARG columns wider at the - expense of the windows at its sides. C-x { makes the selected - window ARG columns narrower. An argument to C-x 5 specifies - how many columns to give to the leftmost of the two windows made. +current window into two windows side by side. +C-x } makes the selected window ARG columns wider at the +expense of the windows at its sides. C-x { makes the selected +window ARG columns narrower. An argument to C-x 5 specifies +how many columns to give to the leftmost of the two windows made. - C-x 2 now accepts a numeric argument to specify the number of - lines to give to the uppermost of the two windows it makes. +C-x 2 now accepts a numeric argument to specify the number of +lines to give to the uppermost of the two windows it makes. ** Horizontal scrolling of the lines in a window is now implemented. - C-x < (scroll-left) scrolls all displayed lines left, - with the numeric argument (default 1) saying how far to scroll. - When the window is scrolled left, some amount of the beginning - of each nonempty line is replaced by an "$". - C-x > scrolls right. If a window has no text hidden at the left - margin, it cannot be scrolled any farther right than that. - When nonzero leftwards scrolling is in effect in a window. - lines are automatically truncated at the window's right margin - regardless of the value of the variable truncate-lines in the - buffer being displayed. - -** C-x C-d now uses the default output format of `ls', - which gives just file names in multiple columns. - C-u C-x C-d passes the -l switch to `ls'. +C-x < (scroll-left) scrolls all displayed lines left, +with the numeric argument (default 1) saying how far to scroll. +When the window is scrolled left, some amount of the beginning +of each nonempty line is replaced by an "$". +C-x > scrolls right. If a window has no text hidden at the left +margin, it cannot be scrolled any farther right than that. +When nonzero leftwards scrolling is in effect in a window. +lines are automatically truncated at the window's right margin +regardless of the value of the variable 'truncate-lines' in the +buffer being displayed. + +** C-x C-d now uses the default output format of 'ls', +which gives just file names in multiple columns. +C-u C-x C-d passes the -l switch to 'ls'. ** C-t at the end of a line now exchanges the two preceding characters. @@ -1995,7 +1999,7 @@ It's Beat CCA Week. ** The mode line will now say "Def" after the major mode while a keyboard macro is being defined. -** The variable fill-prefix is now used by Meta-q. +** The variable 'fill-prefix' is now used by Meta-q. Meta-q removes the fill prefix from lines that start with it before filling, and inserts the fill prefix on each line after filling. @@ -2057,7 +2061,7 @@ It's Beat CCA Week. including the terminating slash, requests the use of the default file name (usually the visited file's name). - Set the variable insert-default-directory to nil + Set the variable 'insert-default-directory' to nil to turn off this feature. ** M-x shell now uses the environment variable ESHELL, @@ -2095,83 +2099,82 @@ It's Beat CCA Week. ** The file of Lisp code Emacs reads on startup is now called ~/.emacs rather than ~/.emacs_pro. -** copy-file now gives the copied file the same mode bits +** 'copy-file' now gives the copied file the same mode bits as the original file. ** Output from a process inserted into the process's buffer no longer sets the buffer's mark. Instead it sets a marker associated with the process to point to the end of the inserted text. You can access this marker with - (process-mark PROCESS) - and then either examine its position with marker-position - or set its position with set-marker. + 'process-mark' and then either examine its position with + 'marker-position' or set its position with 'set-marker'. -** completing-read takes a new optional fifth argument which, +** 'completing-read' takes a new optional fifth argument which, if non-nil, should be a string of text to insert into the minibuffer before reading user commands. -** The Lisp function elt now exists: +** The Lisp function 'elt' now exists: (elt ARRAY N) is like (aref ARRAY N), (elt LIST N) is like (nth N LIST). -** rplaca is now a synonym for setcar, and rplacd for setcdr. - eql is now a synonym for eq; it turns out that the Common Lisp +** 'rplaca' is now a synonym for 'setcar', and 'rplacd' for 'setcdr'. + 'eql' is now a synonym for 'eq'; it turns out that the Common Lisp distinction between eq and eql is insignificant in Emacs. - numberp is a new synonym for integerp. + 'numberp' is a new synonym for 'integerp'. -** auto-save has been renamed to auto-save-mode. +** auto-save has been renamed to 'auto-save-mode'. ** Auto save file names for buffers are now created by the - function make-auto-save-file-name. This is so you can + function 'make-auto-save-file-name'. This is so you can redefine that function to change the way auto save file names are chosen. -** expand-file-name no longer discards a final slash. +** 'expand-file-name' no longer discards a final slash. (expand-file-name "foo" "/lose") => "/lose/foo" (expand-file-name "foo/" "/lose") => "/lose/foo/" - Also, expand-file-name no longer substitutes $ constructs. - A new function substitute-in-file-name does this. Reading - a file name with read-file-name or the `f' or`F' option - of interactive calling uses substitute-in-file-name - on the file name that was read and returns the result. +Also, expand-file-name no longer substitutes $ constructs. +A new function 'substitute-in-file-name' does this. Reading +a file name with 'read-file-name' or the 'f' or'F' option +of 'interactive' calling uses substitute-in-file-name +on the file name that was read and returns the result. - All I/O primitives including insert-file-contents and - delete-file call expand-file-name on the file name supplied. - This change makes them considerably faster in the usual case. +All I/O primitives including 'insert-file-contents' and +'delete-file' call 'expand-file-name' on the file name supplied. +This change makes them considerably faster in the usual case. ** Interactive calling spec strings allow the new code letter 'D' - which means to read a directory name. It is like 'f' except - that the default if the user makes no change in the minibuffer - is to return the current default directory rather than the - current visited file name. +which means to read a directory name. It is like 'f' except +that the default if the user makes no change in the minibuffer +is to return the current default directory rather than the +current visited file name. * Changes in Emacs 1.5 -** suspend-emacs now accepts an optional argument - which is a string to be stuffed as terminal input - to be read by Emacs's superior shell after Emacs exits. +** 'suspend-emacs' now accepts an optional argument +which is a string to be stuffed as terminal input +to be read by Emacs's superior shell after Emacs exits. A library called ledit exists which uses this feature to transmit text to a Lisp job running as a sibling of Emacs. -** If find-file is given the name of a directory, +** If 'find-file' is given the name of a directory, it automatically invokes dired on that directory rather than reading in the binary data that make up the actual contents of the directory according to Unix. ** Saving an Emacs buffer now preserves the file modes of any previously existing file with the same name. - This works using new Lisp functions file-modes and - set-file-modes, which can be used to read or set the mode + This works using new Lisp functions 'file-modes' and + 'set-file-modes', which can be used to read or set the mode bits of any file. -** The Lisp function cond now exists, with its traditional meaning. +** The Lisp function 'cond' now exists, with its traditional meaning. -** defvar and defconst now permit the documentation string +** 'defvar' and 'defconst' now permit the documentation string to be omitted. defvar also permits the initial value to be omitted; then it acts only as a comment. @@ -2180,9 +2183,9 @@ It's Beat CCA Week. * Changes in Emacs 1.4 ** Auto-filling now normally indents the new line it creates - by calling indent-according-to-mode. This function, meanwhile, + by calling 'indent-according-to-mode'. This function, meanwhile, has in Fundamental and Text modes the effect of making the line - have an indentation of the value of left-margin, a per-buffer variable. + have an indentation of the value of 'left-margin', a per-buffer variable. Tab no longer precisely does indent-according-to-mode; it does that in all modes that supply their own indentation routine, @@ -2215,33 +2218,33 @@ It's Beat CCA Week. an integer. ** The Lisp function 'function' now exists. function is the - same as quote, except that it serves as a signal to the + same as 'quote', except that it serves as a signal to the Lisp compiler that the argument should be compiled as a function. Example: (mapcar (function (lambda (x) (+ x 5))) list) -** The function set-key has been renamed to global-set-key. - undefine-key and local-undefine-key has been renamed to - global-unset-key and local-unset-key. +** The function set-key has been renamed to 'global-set-key'. + 'undefine-key' and 'local-undefine-key' has been renamed to + 'global-unset-key' and 'local-unset-key'. ** Emacs now collects input from asynchronous subprocesses - while waiting in the functions sleep-for and sit-for. + while waiting in the functions 'sleep-for' and 'sit-for'. ** Shell mode's Newline command attempts to distinguish subshell prompts from user input when issued in the middle of the buffer. It no longer reexecutes from dot to the end of the line; it reeexecutes the entire line minus any prompt. The prompt is recognized by searching for the value of - shell-prompt-pattern, starting from the beginning of the line. + 'shell-prompt-pattern', starting from the beginning of the line. Anything thus skipped is not reexecuted. * Changes in Emacs 1.3 -** An undo facility exists now. Type C-x u to undo a batch of +** An undo facility exists now. Type C-x u to 'undo' a batch of changes (usually one command's changes, but some commands - such as query-replace divide their changes into multiple + such as 'query-replace' divide their changes into multiple batches. You can repeat C-x u to undo further. As long as no commands other than C-x u intervene, each one undoes another batch. A numeric argument to C-x u acts as a repeat @@ -2283,12 +2286,12 @@ It's Beat CCA Week. to be in effect when the file is edited. See the file DIFF in the same directory as this file for full details. -** A function nth is defined. It means the same thing as in Common Lisp. +** A function 'nth' is defined. It means the same thing as in Common Lisp. ** The function install-command has been renamed to set-key. It now takes the key sequence as the first argument and the definition for it as the second argument. - Likewise, local-install-command has been renamed to local-set-key. + Likewise, local-install-command has been renamed to 'local-set-key'. @@ -2296,11 +2299,11 @@ It's Beat CCA Week. ** A Lisp single-stepping and debugging facility exists. To cause the debugger to be entered when an error - occurs, set the variable debug-on-error non-nil. + occurs, set the variable 'debug-on-error' non-nil. To cause the debugger to be entered whenever function foo - is called, do (debug-on-entry 'foo). To cancel this, - do (cancel-debug-on-entry 'foo). debug-on-entry does + is called, use 'debug-on-entry'. To cancel this, + use 'cancel-debug-on-entry'. debug-on-entry does not work for primitives (written in C), only functions written in Lisp. Most standard Emacs commands are in Lisp. @@ -2311,31 +2314,31 @@ It's Beat CCA Week. by the argument values unless arguments are still being calculated. At the beginning of the buffer is a description of why the debugger was entered: function entry, function exit, - error, or simply that the user called the function `debug'. + error, or simply that the user called the function 'debug'. - To exit the debugger and return to top level, type `q'. + To exit the debugger and return to top level, type 'q'. In the debugger, you can evaluate Lisp expressions by - typing `e'. This is equivalent to `M-ESC'. + typing 'e'. This is equivalent to 'M-ESC'. When the debugger is entered due to an error, that is all you can do. When it is entered due to function entry (such as, requested by debug-on-entry), you have two options: Continue execution and reenter debugger after the - completion of the function being entered. Type `c'. + completion of the function being entered. Type 'c'. Continue execution but enter the debugger before - the next subexpression. Type `d'. + the next subexpression. Type 'd'. You will see that some stack frames are marked with *. This means the debugger will be entered when those frames exit. You will see the value being returned in the first line of the backtrace buffer. Your options: - Continue execution, and return that value. Type `c'. - Continue execution, and return a specified value. Type `r'. + Continue execution, and return that value. Type 'c'. + Continue execution, and return a specified value. Type 'r'. You can mark a frame to enter the debugger on exit - with the `b' command, or clear such a mark with `u'. + with the 'b' command, or clear such a mark with 'u'. ** Lisp macros now exist. For example, you can write @@ -2373,7 +2376,7 @@ It's Beat CCA Week. ** The value of a Lisp expression evaluated using M-ESC is now printed in the minibuffer. -** M-q now runs fill-paragraph, independent of major mode. +** M-q now runs 'fill-paragraph', independent of major mode. ** C-h m now prints documentation on the current buffer's major mode. What it prints is the documentation of the @@ -2429,12 +2432,12 @@ It's Beat CCA Week. All editing commands treat hidden outline-mode lines as part of the preceding visible line. -** C-x C-z runs save-buffers-kill-emacs +** C-x C-z runs 'save-buffers-kill-emacs' offers to save each file buffer, then exits. -** C-c's function is now called suspend-emacs. +** C-c's function is now called 'suspend-emacs'. -** The command C-x m runs mail, which switches to a buffer *mail* +** The command C-x m runs 'mail', which switches to a buffer *mail* and lets you compose a message to send. C-x 4 m runs mail in another window. Type C-z C-s in the mail buffer to send the message according to what you have entered in the buffer. @@ -2442,7 +2445,7 @@ It's Beat CCA Week. You must separate the headers from the message text with an empty line. -** You can now dired partial directories (specified with names +** You can now 'dired' partial directories (specified with names containing *'s, etc, all processed by the shell). Also, you can dired more than one directory; dired names the buffer according to the filespec or directory name. Reinvoking @@ -2464,13 +2467,13 @@ It's Beat CCA Week. contains text put there for some other reason, it is cleared first. - t is now the top-level value of standard-output. + t is now the top-level value of 'standard-output'. t as an input stream now means "read via the minibuffer". The minibuffer is used to read a line of input, with editing, - and this line is then parsed. Any excess not used by `read' - is ignored; each `read' from t reads fresh input. - t is now the top-level value of standard-input. + and this line is then parsed. Any excess not used by 'read' + is ignored; each 'read' from t reads fresh input. + t is now the top-level value of 'standard-input'. *** A marker may be used as an input stream or an output stream. The effect is to grab input from where the marker points, @@ -2482,29 +2485,32 @@ It's Beat CCA Week. and the buffer's mark is set to the end of the inserted output each time output is inserted. -*** (pos-visible-in-window-p POS WINDOW) - returns t if position POS in WINDOW's buffer is in the range - that is being displayed in WINDOW; nil if it is scrolled - vertically out of visibility. +*** New function 'pos-visible-in-window-p' + + (pos-visible-in-window-p POS WINDOW) + +returns t if position POS in WINDOW's buffer is in the range +that is being displayed in WINDOW; nil if it is scrolled +vertically out of visibility. - If display in WINDOW is not currently up to date, this function - calculates carefully whether POS would appear if display were - done immediately based on the current (window-start WINDOW). +If display in WINDOW is not currently up to date, this function +calculates carefully whether POS would appear if display were +done immediately based on the current 'window-start'. - POS defaults to (dot), and WINDOW to (selected-window). +POS defaults to (dot), and WINDOW to (selected-window). *** Variable buffer-alist replaced by function (buffer-list). - The actual alist of buffers used internally by Emacs is now - no longer accessible, to prevent the user from crashing Emacs - by modifying it. The function buffer-list returns a list - of all existing buffers. Modifying this list cannot hurt anything - as a new list is constructed by each call to buffer-list. +The actual alist of buffers used internally by Emacs is now +no longer accessible, to prevent the user from crashing Emacs +by modifying it. The function buffer-list returns a list +of all existing buffers. Modifying this list cannot hurt anything +as a new list is constructed by each call to buffer-list. -*** load now takes an optional third argument NOMSG which, if non-nil, - prevents load from printing a message when it starts and when - it is done. +*** 'load' now takes an optional third argument NOMSG which, if non-nil, +prevents load from printing a message when it starts and when +it is done. -*** byte-recompile-directory is a new function which finds all +*** 'byte-recompile-directory' is a new function which finds all the .elc files in a directory, and regenerates each one which is older than the corresponding .el (Lisp source) file. |