(Fsignal): Add hyperlink to the definition of `signal' in the Elisp manual.

[bpt/emacs.git] / lispref / ChangeLog

2003-12-30  Luc Teirlinck  <teirllm@auburn.edu>

	* errors.texi (Standard Errors): Various small corrections and
	additions.

	* control.texi: Various small changes in addition to the
	following.
	(Signaling Errors): Provide some more details on how `signal'
	constructs the error message.  Add anchor to the definition of
	`signal'.
	(Error Symbols): Describe special treatment of `quit'.
	(Cleanups): Rename BODY argument of `unwind-protect' to BODY-FORM
	to emphasize that it has to be a single form.

	* buffers.texi: Add anchor.

2003-12-29  Richard M. Stallman  <rms@gnu.org>

	* windows.texi (Choosing Window): Add same-window-p, special-display-p.
	(Window Configurations): Add window-configuration-frame.

	* variables.texi (Creating Buffer-Local): Add local-variable-if-set-p.

	* text.texi (Examining Properties): Add get-char-property-and-overlay.
	Change arg name in get-char-property.
	(Special Properties): Update handling of keymap property.

	* strings.texi (Modifying Strings): Add clear-string.
	(Text Comparison): Add assoc-string and remove
	assoc-ignore-case, assoc-ignore-representation.

	* os.texi (Time of Day): Add set-time-zone-rule.

	* numbers.texi (Math Functions): asin, acos, log, log10
	report domain-error errors.

	* nonascii.texi (Converting Representations):
	Add multibyte-char-to-unibyte and unibyte-char-to-multibyte.
	(Encoding and I/O): Add file-name-coding-system.

	* modes.texi (Search-based Fontification): Explain that
	face specs are symbols with face names as values.

	* minibuf.texi (Minibuffer Misc): Add set-minibuffer-window.

	* lists.texi (Building Lists): remq moved elsewhere.
	(Sets And Lists): remq moved here.
	(Association Lists): Refer to assoc-string.

	* internals.texi (Garbage Collection): Add memory-use-counts.

	* frames.texi (Frames and Windows): Add set-frame-selected-window
	and frame-root-window.

	* files.texi (Contents of Directories):
	Add directory-files-and-attributes.

	* display.texi (Refresh Screen): Add force-window-update.
	(Invisible Text): Explain about moving point out of invis text.
	(Overlay Properties): Add overlay-properties.
	(Managing Overlays): Add overlayp.
	(GIF Images): Invalid image number displays a hollow box.

	* buffers.texi (Buffer Modification): Add restore-buffer-modified-p.
	(Killing Buffers): Add buffer-live-p.

2003-12-25  Markus Rost  <rost@mathematik.uni-bielefeld.de>

	* display.texi (Fringes): Fix typo "set-buffer-window".

2003-12-24  Luc Teirlinck  <teirllm@auburn.edu>

	* display.texi, eval.texi, help.texi, internals.texi, loading.texi:
	* nonascii.texi, processes.texi, tips.texi, variables.texi:
	Add or change various xrefs and anchors.

	* commands.texi: Replace all occurrences of @acronym{CAR} with
	@sc{car}, for consistency with the rest of the Elisp manual.
	`car' and `cdr' are historically acronyms, but are no longer
	widely thought of as such.

	* internals.texi (Pure Storage): Mention that `purecopy' does not
	copy text properties.
	(Object Internals): Now 29 bits are used (in most implementations)
	to address Lisp objects.

	* variables.texi (Variables with Restricted Values): New node.

	* objects.texi (Lisp Data Types): Mention that certain variables
	can only take on a restricted set of values and add an xref to
	the new node "Variables with Restricted Values".

	* eval.texi (Function Indirection): Describe the errors that
	`indirect-function' can signal.
	(Eval): Clarify the descriptions of `eval-region' and `values'.
	Describe `eval-buffer' instead of `eval-current-buffer' and
	mention `eval-current-buffer' as an alias for `current-buffer'.
	Correct the description and mention all optional arguments.

	* nonascii.texi: Various small changes in addition to the
	following.
	(Converting Representations): Clarify behavior of
	`string-make-multibyte' and `string-to-multibyte' for unibyte all
	ASCII arguments.
	(Character Sets): Document the variable `charset-list' and adapt
	the definition of the function `charset-list' accordingly.
	(Translation of Characters): Clarify use of generic characters in
	`make-translation-table'.  Clarify and correct the description of
	the use of translation tables in encoding and decoding.
	(User-Chosen Coding Systems): Correct and clarify the description
	of `select-safe-coding-system'.
	(Default Coding Systems): Clarify description of
	`file-coding-system-alist'.

2003-11-30  Luc Teirlinck  <teirllm@auburn.edu>

	* strings.texi (Text Comparison): Correctly describe when two
	strings are `equal'.  Combine and clarify descriptions of
	`assoc-ignore-case' and `assoc-ignore-representation'.

	* objects.texi (Non-ASCII in Strings): Clarify description of
	when a string is unibyte or multibyte.
	(Bool-Vector Type): Update examples.
	(Equality Predicates): Correctly describe when two strings are
	`equal'.

2003-11-29  Luc Teirlinck  <teirllm@auburn.edu>

	* lists.texi (Building Lists): `append' no longer accepts integer
	arguments.  Update the description of `number-sequence' to reflect
	recent changes.
	(Sets And Lists): Describe `member-ignore-case' after `member'.

2003-11-27  Kim F. Storm  <storm@cua.dk>

	* commands.texi (Click Events): Click object may be an images.
	Describe (dx . dy) element of click positions.
	(Accessing Events): Remove duplicate posn-timestamp.
	New functions posn-object and posn-object-x-y.

2003-11-23  Kim F. Storm  <storm@cua.dk>

	* commands.texi (Click Events): Describe enhancements to event
	position lists, including new text-pos and (col . row) items.
	Mention left-fringe and right-fringe area events.
	(Accessing Events): New functions posn-area and
	posn-actual-col-row.  Mention posn-timestamp.  Mention that
	posn-point in non-text area still returns buffer position.
	Clarify posn-col-row.

2003-11-21  Lars Hansen  <larsh@math.ku.dk>

	* files.texi (File Attributes): Describe new parameter ID-FORMAT.
	* anti.texi (File Attributes): Describe removed parameter
	ID-FORMAT.

2003-11-20  Luc Teirlinck  <teirllm@auburn.edu>

	* positions.texi (Positions): Mention that, if a marker is used as
	a position, its buffer is ignored.

	* markers.texi (Overview of Markers): Mention it here too.

2003-11-12  Luc Teirlinck  <teirllm@auburn.edu>

	* numbers.texi (Numeric Conversions): Not just `floor', but also
	`truncate', `ceiling' and `round' accept optional argument DIVISOR.

2003-11-10  Luc Teirlinck  <teirllm@auburn.edu>

	* markers.texi (Creating Markers): Specify insertion type of
	created markers.  Add xref to `Marker Insertion Types'.
	Second argument to `copy-marker' is optional.
	(Marker Insertion Types): Mention that most markers are created
	with insertion type nil.
	(The Mark): Correctly describe when `mark' signals an error.
	(The Region): Correctly describe when `region-beginning' and
	`region-end' signal an error.

2003-11-08  Luc Teirlinck  <teirllm@auburn.edu>

	* hash.texi (Creating Hash): Clarify description of `eql'.
	`makehash' is obsolete.
	(Hash Access): Add Common Lisp notes for `remhash' and `clrhash'.

	* positions.texi (Point): Change description of `buffer-end', so
	that it is also correct for floating point arguments.
	(List Motion): Correct argument lists of `beginning-of-defun' and
	`end-of-defun'.
	(Excursions): Add xref to `Marker Insertion Types'.
	(Narrowing): Argument to `narrow-to-page' is optional.

2003-11-06  Luc Teirlinck  <teirllm@auburn.edu>

	* streams.texi (Output Streams): Clarify behavior of point for
	marker output streams.

2003-11-04  Luc Teirlinck  <teirllm@auburn.edu>

	* variables.texi (Defining Variables): Second argument to
	`defconst' is not optional.
	(Setting Variables): Mention optional argument APPEND to
	`add-to-list'.
	(Creating Buffer-Local): Expand description of
	`make-variable-buffer-local'.
	(Frame-Local Variables): Expand description of
	`make-variable-frame-local'.
	(Variable Aliases): Correct description of optional argument
	DOCSTRING to `defvaralias'.  Mention return value of
	`defvaralias'.
	(File Local Variables): Add xref to `File variables' in Emacs
	Manual.  Correct description of `hack-local-variables'.  Mention
	`safe-local-variable' property.  Mention optional second argument
	to `risky-local-variable-p'.

2003-11-03  Luc Teirlinck  <teirllm@auburn.edu>

	* symbols.texi (Symbol Plists): Mention return value of `setplist'.

2003-11-02  Jesper Harder  <harder@ifa.au.dk>  (tiny change)

	* lispref/anti.texi, lispref/backups.texi, lispref/commands.texi
	lispref/customize.texi, lispref/display.texi, lispref/files.texi,
	lispref/internals.texi, lispref/keymaps.texi, lispref/loading.texi,
	lispref/modes.texi, lispref/nonascii.texi, lispref/numbers.texi,
	lispref/objects.texi, lispref/os.texi, lispref/positions.texi,
	lispref/processes.texi, lispref/searching.texi,
	lispref/sequences.texi, lispref/streams.texi, lispref/strings.texi,
	lispref/syntax.texi, lispref/text.texi: Replace @sc{foo} with
	@acronym{FOO}.

2003-10-27  Luc Teirlinck  <teirllm@auburn.edu>

	* strings.texi (Creating Strings): Argument START to `substring'
	can not be `nil'.  Expand description of
	`substring-no-properties'.  Correct description of `split-string',
	especially with respect to empty matches.  Prevent very bad line
	break in definition of `split-string-default-separators'.
	(Text Comparison): `string=' and `string<' also accept symbols as
	arguments.
	(String Conversion): More completely describe argument BASE in
	`string-to-number'.
	(Formatting Strings): `%s' and `%S" in `format' do require
	corresponding object.  Clarify behavior of numeric prefix after
	`%' in `format'.
	(Case Conversion): The argument to `upcase-initials' can be a
	character.

2003-10-27  Kenichi Handa  <handa@m17n.org>

	* display.texi (Fontsets): Fix texinfo usage.

2003-10-25  Kenichi Handa  <handa@m17n.org>

	* display.texi (Fontsets): Add description of the function
	set-fontset-font.

2003-10-23  Luc Teirlinck  <teirllm@auburn.edu>

	* display.texi (Temporary Displays): Add xref to `Documentation
	Tips'.

	* functions.texi (Function Safety): Use inforef instead of pxref
	for SES.

2003-10-23  Andreas Schwab  <schwab@suse.de>

	* Makefile.in (TEX, texinputdir): Don't define.
	(TEXI2DVI): Define.
	(srcs): Remove $(srcdir)/index.perm and $(srcdir)/index.unperm,
	add $(srcdir)/index.texi.
	($(infodir)/elisp): Remove index.texi dependency.
	(elisp.dvi): Likewise.  Use $(TEXI2DVI).
	(index.texi): Remove target.
	(dist): Don't link $(srcdir)/permute-index.
	(clean): Don't remove index.texi.

	* permute-index, index.perm: Remove.
	* index.texi: Rename from index.unperm.

2003-10-22  Luc Teirlinck  <teirllm@auburn.edu>

	* tips.texi (Documentation Tips): Document new behavior for face
	and variable hyperlinks in Help mode.

2003-10-21  Luc Teirlinck  <teirllm@auburn.edu>

	* objects.texi (Integer Type): Update for extra bit of integer range.
	(Character Type): Ditto.

2003-10-16  Eli Zaretskii  <eliz@elta.co.il>

	* numbers.texi (Integer Basics): Add index entries for reading
	numbers in hex, octal, and binary.

2003-10-16  Lute Kamstra  <lute@gnu.org>

	* modes.texi (Mode Line Format): Mention force-mode-line-update's
	argument.

2003-10-13  Luc Teirlinck  <teirllm@auburn.edu>

	* windows.texi (Choosing Window): Fix typo.
	* edebug.texi (Edebug Execution Modes): Fix typo.

2003-10-13  Richard M. Stallman  <rms@gnu.org>

	* windows.texi (Basic Windows): A window has fringe settings,
	display margins and scroll-bar settings.
	(Splitting Windows): Doc split-window return value.
	Clean up one-window-p.
	(Selecting Windows): Fix typo.
	(Cyclic Window Ordering): Explain frame as ALL-FRAMES in next-window.
	(Buffers and Windows): In set-window-buffer, explain effect
	on fringe settings and scroll bar settings.
	(Displaying Buffers): In pop-to-buffer, explain nil as buffer arg.
	(Choosing Window): Use defopt for pop-up-frame-function.
	For special-display-buffer-names, explain same-window and same-frame.
	Clarify window-dedicated-p return value.
	(Textual Scrolling): scroll-up and scroll-down can get an error.
	(Horizontal Scrolling): Clarify auto-hscroll-mode.
	Clarify set-window-hscroll.
	(Size of Window): Don't mention tool bar in window-height.
	(Coordinates and Windows): Explain what coordinates-in-window-p
	returns for fringes and display margins.
	(Window Configurations): Explain saving fringes, etc.

	* tips.texi (Library Headers): Clean up Documentation.

	* syntax.texi (Parsing Expressions): Clean up forward-comment
	and parse-sexp-lookup-properties.

	* sequences.texi (Sequence Functions): sequencep accepts bool-vectors.

	* os.texi (System Environment): Clean up text for load-average errors.

	* modes.texi (Hooks): Don't explain local hook details at front.
	Clarify run-hooks and run-hook-with-args a little.
	Clean up add-hook and remove-hook.

	* edebug.texi (Edebug Execution Modes): Clarify t.
	Document edebug-sit-for-seconds.
	(Coverage Testing): Document C-x X = and =.
	(Instrumenting Macro Calls): Fix typo.
	(Specification List): Don't index the specification keywords.

2003-10-10  Kim F. Storm  <storm@cua.dk>

	* processes.texi (Network): Introduce make-network-process.

2003-10-09  Luc Teirlinck  <teirllm@auburn.edu>

	* tips.texi (Library Headers): Fix typo.

2003-10-07  Juri Linkov  <juri@jurta.org>

	* modes.texi (Imenu): Mention imenu-create-index-function's
	default value.  Explain submenus better.

2003-10-07  Lute Kamstra  <lute@gnu.org>

	* modes.texi (Faces for Font Lock): Fix typo.
	(Hooks): Explain how buffer-local hook variables can refer to
	global hook variables.
	Various minor clarifications.

2003-10-06  Lute Kamstra  <lute@gnu.org>

	* tips.texi (Coding Conventions): Mention naming conventions for
	hooks.

2003-10-05  Luc Teirlinck  <teirllm@auburn.edu>

	* loading.texi (Library Search): Correct default value of
	load-suffixes.
	(Named Features): Fix typo.

2003-10-05  Richard M. Stallman  <rms@gnu.org>

	* loading.texi (Named Features): In `provide',
	say how to test for subfeatures.
	(Unloading): In unload-feature, use new var name
	unload-feature-special-hooks.

2003-10-03  Lute Kamstra  <lute@gnu.org>

	* modes.texi (Major Mode Conventions): Mention third way to set up
	Imenu.
	(Imenu): A number of small fixes.
	Delete documentation of internal variable imenu--index-alist.
	Document the return value format of imenu-create-index-function
	functions.

2003-09-30  Richard M. Stallman  <rms@gnu.org>

	* processes.texi (Network): Say what stopped datagram connections do.

	* lists.texi (Association Lists): Clarify `assq-delete-all'.

	* display.texi (Overlay Properties): Clarify `evaporate' property.

2003-09-29  Lute Kamstra  <lute@gnu.org>

	* modes.texi (Mode Line Data): Explain when symbols in mode-line
	constructs should be marked as risky.
	Change cons cell into proper list.
	(Mode Line Variables): Change cons cell into proper list.

2003-09-26  Lute Kamstra  <lute@gnu.org>

	* modes.texi (Mode Line Data): Document the :propertize construct.
	(Mode Line Variables): Reorder the descriptions of the variables
	to match their order in the default mode-line-format.
	Describe the new variables mode-line-position and mode-line-modes.
	Update the default values of mode-line-frame-identification,
	minor-mode-alist, and default-mode-line-format.
	(Properties in Mode): Mention the :propertize construct.

2003-09-26  Richard M. Stallman  <rms@gnu.org>

	* buffers.texi, commands.texi, debugging.texi, eval.texi:
	* loading.texi, minibuf.texi, text.texi, variables.texi:
	Avoid @strong{Note:}.

2003-09-26  Richard M. Stallman  <rms@gnu.org>

	* keymaps.texi (Remapping Commands): Fix typo.

2003-09-23  Luc Teirlinck  <teirllm@mail.auburn.edu>

	* processes.texi (Low-Level Network): Fix typo.

2003-09-23  Kim F. Storm  <storm@cua.dk>

	* processes.texi (Network, Network Servers): Fix typos.
	(Low-Level Network): Add timeout value for :server keyword.
	Add new option keywords to make-network-process.
	Add set-network-process-options.
	Explain how to test availability of network options.

2003-09-19  Richard M. Stallman  <rms@gnu.org>

	* text.texi (Motion by Indent): Arg to
	backward-to-indentation and forward-to-indentation is optional.

	* strings.texi (Creating Strings): Add substring-no-properties.

	* processes.texi
	(Process Information): Add list-processes arg QUERY-ONLY.
	Delete process-contact from here.
	Add new status values for process-status.
	Add process-get, process-put, process-plist, set-process-plist.
	(Synchronous Processes): Add call-process-shell-command.
	(Signals to Processes): signal-process allows process objects.
	(Network): Complete rewrite.
	(Network Servers, Datagrams, Low-Level Network): New nodes.

	* positions.texi (Word Motion): forward-word, backward-word
	arg is optional.  Reword.

	* abbrevs.texi (Defining Abbrevs): Index no-self-insert.

	* variables.texi (Creating Buffer-Local):
	Delete duplicate definition of buffer-local-value.
	(File Local Variables): Explain about discarding text props.

2003-09-11  Richard M. Stallman  <rms@gnu.org>

	* minibuf.texi (Intro to Minibuffers): Explain that the minibuffer
	changes variables that record input events.
	(Minibuffer Misc): Add minibuffer-selected-window.

	* lists.texi (Building Lists): Add copy-tree.

	* display.texi (Fontsets): Add char-displayable-p.
	(Scroll Bars): New node.

2003-09-08  Lute Kamstra  <lute@gnu.org>

	* modes.texi (%-Constructs): Document new `%i' and `%I'
	constructs.

2003-09-03  Peter Runestig  <peter@runestig.com>

	* makefile.w32-in: New file.

2003-08-29  Richard M. Stallman  <rms@gnu.org>

	* display.texi (Overlay Properties): Clarify how priorities
	affect use of the properties.

2003-08-19  Luc Teirlinck  <teirllm@mail.auburn.edu>

	* customize.texi (Type Keywords): Correct the description of
	`:help-echo' in the case where `motion-doc' is a function.

2003-08-14  John Paul Wallington  <jpw@gnu.org>

	* modes.texi (Emulating Mode Line): Subsection, not section.

2003-08-13  Richard M. Stallman  <rms@gnu.org>

	* elisp.texi (Top): Update subnode lists in menu.

	* text.texi (Insertion): Add insert-buffer-substring-no-properties.
	(Kill Functions): kill-region has new arg yank-handler.
	(Yanking): New node.
	(Yank Commands): Add yank-undo-function.
	(Low-Level Kill Ring):
	kill-new and kill-append have new arg yank-handler.
	(Changing Properties): Add remove-list-of-text-properties.
	(Atomic Changes): New node.

	* symbols.texi (Other Plists): Add lax-plist-get, lax-plist-put.

	* streams.texi (Output Variables): Add eval-expression-print-length
	and eval-expression-print-level.

	* os.texi (Time Conversion): For encode-time, explain limits on year.

	* objects.texi (Character Type): Define anchor "modifier bits".

	* modes.texi (Emulating Mode Line): New node.
	(Search-based Fontification): Font Lock uses font-lock-face property.
	(Other Font Lock Variables): Likewise.

	* keymaps.texi (Format of Keymaps): Keymaps contain char tables,
	not vectors.
	(Active Keymaps): Add emulation-mode-map-alists.
	(Functions for Key Lookup): key-binding has new arg no-remap.
	(Remapping Commands): New node.
	(Scanning Keymaps): where-is-internal has new arg no-remap.
	(Tool Bar): Add tool-bar-local-item-from-menu.
	Clarify when to use tool-bar-add-item-from-menu.

	* commands.texi (Interactive Call): commandp has new arg.
	(Command Loop Info): Add this-original-command.

2003-08-06  John Paul Wallington  <jpw@gnu.org>

	* compile.texi (Compiler Errors): Say `@end defmac' after `@defmac'.

	* display.texi (Warning Basics): Fix typo.
	(Fringes): Add closing curly bracket and fix typo.

	* elisp.texi (Top): Fix typo.

2003-08-05  Richard M. Stallman  <rms@gnu.org>

	* elisp.texi: Update lists of subnodes.

	* windows.texi (Buffers and Windows): set-window-buffer has new arg.

	* variables.texi (Local Variables): Use lc for example variable names.

	* tips.texi (Library Headers): Explain where to put -*-.

	* strings.texi (Creating Strings): Fix xref for vconcat.

	* sequences.texi (Vector Functions):
	vconcat no longer allows integer args.

	* minibuf.texi (Reading File Names): read-file-name has new
	arg PREDICATE.  New function read-directory-name.

	* macros.texi (Defining Macros): Give definition of `declare'
	(Indenting Macros): New node.

	* frames.texi (Parameter Access): Add modify-all-frames-parameters.
	(Window Frame Parameters): Make separate table of parameters
	that are coupled with specific face attributes.
	(Deleting Frames): delete-frame-hooks renamed to
	delete-frame-functions.

	* files.texi (Magic File Names): Add file-remote-p.
	Clarify file-local-copy.

	* edebug.texi (Instrumenting Macro Calls): Don't define `declare'
	here; instead xref Defining Macros.

	* display.texi (Warnings): New node, and subnodes.
	(Fringes): New node.

	* debugging.texi (Test Coverage): New node.

	* compile.texi (Compiler Errors): Explain with-no-warnings
	and other ways to suppress warnings.

	* commands.texi (Interactive Call): Minor clarification.

	* buffers.texi (Buffer File Name): set-visited-file-name
	renames the buffer too.

	* abbrevs.texi (Abbrev Tables): Add copy-abbrev-table.

2003-07-24  Markus Rost  <rost@math.ohio-state.edu>

	* abbrevs.texi (Abbrev Expansion): Use \s syntax in example.

2003-07-22  Markus Rost  <rost@math.ohio-state.edu>

	* internals.texi (Garbage Collection): Fix previous change.

2003-07-22  Richard M. Stallman  <rms@gnu.org>

	* files.texi (Truenames): Add LIMIT arg to file-chase-links.

	* display.texi (Width): Use \s syntax in example.
	(Font Selection): Add face-font-rescale-alist.

	* modes.texi (Imenu): Add xref to Emacs Manual node on Imenu.
	Remove spurious indent in example.

	* lists.texi (Building Lists): Add number-sequence.

	* internals.texi (Garbage Collection): Add gcs-done, gc-elapsed.

	* functions.texi (Function Documentation): Explain how to
	show calling convention explicitly in the doc string.

	* windows.texi (Selecting Windows): save-selected-window saves
	selected window of each frame.
	(Window Configurations): Minor change.

	* syntax.texi (Syntax Table Functions): Use \s syntax in examples.

	* streams.texi (Output Variables): Add print-continuous-numbering
	and print-number-table.

	* processes.texi (Decoding Output): New node.

	* os.texi (Time Conversion): decode-time arg is optional.

	* objects.texi (Character Type): Don't use space as example for \.
	Make list of char names and \-sequences correspond.
	Explain that \s is not used in strings.  `\ ' needs space after.

	* nonascii.texi (Converting Representations): Add string-to-multibyte.
	(Translation of Characters): Add translation-table-for-input.
	(Default Coding Systems): Add auto-coding-functions.
	(Explicit Encoding): Add decode-coding-inserted-region.
	(Locales): Add locale-info.

	* minibuf.texi (Basic Completion): Describe test-completion.
	Collections can be lists of strings.
	Clean up lazy-completion-table.
	(Programmed Completion): Mention test-completion.
	Clarify why lambda expressions are not accepted.
	(Minibuffer Misc): Describe minibufferp.

2003-07-14  Richard M. Stallman  <rms@gnu.org>

	* buffers.texi (Killing Buffers): kill-buffer-hook is perm local.

	* windows.texi (Selecting Windows): New arg to select-window.
	(Selecting Windows): Add with-selected-window.
	(Size of Window): Add window-inside-edges, etc.

	* internals.texi (Garbage Collection): Add post-gc-hook.

	* processes.texi (Subprocess Creation): Add exec-suffixes.

	* keymaps.texi (Functions for Key Lookup): Add current-active-maps.
	(Scanning Keymaps): Add map-keymaps.
	(Defining Menus): Add keymap-prompt.

	* numbers.texi (Integer Basics): Add most-positive-fixnum,
	most-negative-fixnum.

	* compile.texi (Byte Compilation): Explain no-byte-compile
	(Compiler Errors): New node.

	* os.texi (User Identification): user-uid, user-real-uid
	can return float.

	* modes.texi (Major Mode Conventions): Explain about run-mode-hooks
	and about derived modes.
	(Minor Modes): Add minor-mode-list.
	(Defining Minor Modes): Keyword args for define-minor-mode.
	(Search-based Fontification): Explain managing other properties.
	(Other Font Lock Variables): Add font-lock-extra-managed-props.
	(Faces for Font Lock): Add font-locl-preprocessor-face.
	(Hooks): Add run-mode-hooks and delay-mode-hooks.

	* variables.texi (Creating Buffer-Local): Add buffer-local-value.
	(Variable Aliases): Clarify defvaralias.

	* loading.texi (Library Search): Add load-suffixes.

	* minibuf.texi (Basic Completion): Add lazy-completion-table.
	(Programmed Completion): Add dynamic-completion-table.

	* files.texi (Changing Files): copy-file allows dir as NEWNAME.
	(Magic File Names): Specify precedence order of handlers.
o
	* commands.texi (Command Overview): Emacs server runs pre-command-hook
	and post-command-hook.
	(Waiting): New calling convention for sit-for.

	* text.texi (Special Properties): local-map and keymap properties
	apply based on their stickiness.

2003-07-07  Richard M. Stallman  <rms@gnu.org>

	* modes.texi (Minor Mode Conventions): Specify only some kinds
	of list values as args to minor modes.

	* files.texi (File Name Expansion): Warn about iterative use
	of substitute-in-file-name.

	* advice.texi (Activation of Advice): Clean up previous change.

2003-07-06  Markus Rost  <rost@math.ohio-state.edu>

	* advice.texi (Activation of Advice): Note that ad-start-advice is
	turned on by default.

2003-06-30  Richard M. Stallman  <rms@gnu.org>

	* text.texi (Buffer Contents): Document current-word.
	(Change Hooks): Not called for *Messages*.

	* functions.texi (Defining Functions): Explain about redefining
	primitives.
	(Function Safety): Renamed.  Minor changes.
	Comment out the detailed criteria for what is safe.

2003-06-22  Andreas Schwab  <schwab@suse.de>

	* objects.texi (Symbol Type): Fix description of examples.

2003-06-16  Andreas Schwab  <schwab@suse.de>

	* hash.texi (Creating Hash): Fix description of :weakness.

2003-06-13  Kai Gro\e,A_\e(Bjohann  <kai.grossjohann@gmx.net>

	* files.texi (Changing Files): copy-file copies file modes, too.

2003-05-28  Richard M. Stallman  <rms@gnu.org>

	* strings.texi (Creating Strings): Clarify split-string.

2003-05-22  Stephen J. Turnbull  <stephen@xemacs.org>

	* strings.texi (Creating Strings): Update split-string specification
	and examples.

2003-05-19  Richard M. Stallman  <rms@gnu.org>

	* elisp.texi: Correct invariant section names.

2003-04-20  Richard M. Stallman  <rms@gnu.org>

	* os.texi (Timers): Explain about timers and quitting.

2003-04-19  Richard M. Stallman  <rms@gnu.org>

	* internals.texi (Writing Emacs Primitives): Strings are
	no longer special for GCPROs.  Mention GCPRO5, GCPRO6.
	Explain GCPRO convention for varargs function args.

2003-04-16  Richard M. Stallman  <rms@gnu.org>

	* minibuf.texi (Minibuffer Misc): Document fn minibuffer-message.

2003-04-08  Richard M. Stallman  <rms@gnu.org>

	* files.texi (Kinds of Files): Correct return value of file-symlink-p.

2003-02-13  Kim F. Storm  <storm@cua.dk>

	* objects.texi (Character Type): New \s escape for space.

2003-01-31  Joe Buehler  <jhpb@draco.hekimian.com>

	* os.texi (System Environment): Added cygwin system-type.

2003-01-25  Richard M. Stallman  <rms@gnu.org>

	* keymaps.texi: Document that a symbol can act as a keymap.

2003-01-13  Richard M. Stallman  <rms@gnu.org>

	* text.texi (Changing Properties): Say string indices are origin-0.

	* positions.texi (Screen Lines) <compute-motion>:
	Correct order of elts in return value.

	* keymaps.texi (Changing Key Bindings) <define-key>: Mention
	how to define a default binding.

2002-12-07  Markus Rost  <rost@math.ohio-state.edu>

	* loading.texi (Unloading): Fix recent change for load-history.

	* customize.texi (Simple Types): Clarify description of custom
	type 'number. Describe new custom type 'float.

2002-12-04  Markus Rost  <rost@math.ohio-state.edu>

	* variables.texi (File Local Variables): Fix typo.

2002-10-23  Kai Gro\e,A_\e(Bjohann  <kai.grossjohann@uni-duisburg.de>

	From Michael Albinus <Michael.Albinus@alcatel.de>.

	* README: Target for Info file is `make info'.

	* files.texi (File Name Components): Fixed typos in
	`file-name-sans-extension'.
	(Magic File Names): Complete list of operations for magic file
	name handlers.

2002-09-16  Jonathan Yavner  <jyavner@engineer.com>

	* variables.texi (File Local Variables): New function
	risky-local-variable-p.

2002-09-15  Jonathan Yavner  <jyavner@engineer.com>

	* functions.texi (Function safety): New node about unsafep.

2002-08-05  Per Abrahamsen  <abraham@dina.kvl.dk>

	* customize.texi (Splicing into Lists): Fixed example.
	Reported by Fabrice Bauzac <fabrice.bauzac@wanadoo.fr>

2002-06-17  Juanma Barranquero  <lektu@terra.es>

	* frames.texi (Display Feature Testing): Fix typo.

2002-06-12  Andreas Schwab  <schwab@suse.de>

	* frames.texi (Initial Parameters, Resources): Fix references to
	the Emacs manual.

2002-05-13  Kim F. Storm  <storm@cua.dk>

	* variables.texi (Intro to Buffer-Local): Updated warning and
	example relating to changing buffer inside let.

2002-03-10  Jan Dj\e,Ad\e(Brv  <jan.h.d@swipnet.se>

	* os.texi (Session Management): New node about X Session management.

2002-01-18  Eli Zaretskii  <eliz@is.elta.co.il>

	* elisp.texi (VERSION): Set to 2.9.  Update the version of Emacs
	to which the manual corresponds, and the copyright years.

	* Makefile.in (VERSION): Set to 2.9.

2001-11-29  Eli Zaretskii  <eliz@is.elta.co.il>

	* elisp.texi: Change the category in @dircategory to "Emacs", to
	make it consistent with info/dir.

2001-11-25  Miles Bader  <miles@gnu.org>

	* text.texi (Fields): Describe new `limit' arg in
	field-beginning/field-end.

2001-11-17  Eli Zaretskii  <eliz@is.elta.co.il>

	* permute-index: Don't depend on csh-specific features.  Replace
	the interpreter name with /bin/sh.

	* two-volume-cross-refs.txt: New file.
	* two.el: New file.
	* spellfile: New file.

2001-11-16  Eli Zaretskii  <eliz@is.elta.co.il>

	* permute-index: New file.

	* vol1.texi, vol2.texi: Renamed from elisp-vol1.texi and
	elisp-vol2.texi, respectively, to avoid file-name clashes in DOS
	8+3 restricted namespace.

	* Makefile.in (infodir): Define relative to $(srcdir).
	($(infodir)/elisp): Don't chdir into $(srcdir), but add it to the
	include directories list via -I switch to makeinfo.
	(index.texi): Use cp if both hard and symbolic links fail.

2001-11-10  Eli Zaretskii  <eliz@is.elta.co.il>

	* Makefile.in (distclean): Add.

	The following changes make ELisp manual part of the Emacs
	distribution:

	* Makefile.in: Add Copyright notice.
	(prefix): Remove.
	(infodir): Change value to "../info".
	(VPATH): New variable.
	(MAKE): Don't define.
	(texmacrodir): Don't define.
	(texinputdir): Append the existing value of TEXINPUTS.
	($(infodir)/elisp): Instead of just "elisp".  Reformat the
	command to be compatible with man/Makefile.in, and to put the
	output into ../info.
	(info): Add target.
	(installall): Target removed.

2001-10-31  Pavel Jan\e,Bm\e(Bk  <Pavel@Janik.cz>

	* tips.texi (Coding Conventions): Fix typo.

2001-10-23  Gerd Moellmann  <gerd@gnu.org>

	* Makefile.in (srcs): Add gpl.texi and doclicense.texi.

2001-10-22  Eli Zaretskii  <eliz@is.elta.co.il>

	* files.texi (File Name Components): Update the description of
	file-name-sans-extension and file-name-extension, as they now
	ignore leading dots.

2001-10-20  Gerd Moellmann  <gerd@gnu.org>

	* (Version 21.1 released.)

2001-10-19  Miles Bader  <miles@gnu.org>

	* positions.texi (Text Lines): Describe behavior of
	`beginning-of-line'/`end-of-line' in the presence of field properties.

2001-10-17  Gerd Moellmann  <gerd@gnu.org>

	* Makefile.in (VERSION): Set to 2.8.
	(manual): Use `manual-21'.

	* elisp.texi (VERSION): Add and use it where the version
	number was used.  Set it to 2.8.

	* intro.texi: Likewise.

2001-10-13  Eli Zaretskii  <eliz@is.elta.co.il>

	* files.texi (File Name Completion): Document the significance of
	a trailing slash in elements of completion-ignored-extensions.

2001-10-06  Miles Bader  <miles@gnu.org>

	* variables.texi (Variable Aliases): It's `@defmac', not `@defmacro'.

2001-10-04  Gerd Moellmann  <gerd@gnu.org>

	* variables.texi (Variable Aliases): New node.

2001-10-04  Gerd Moellmann  <gerd@gnu.org>

	* Branch for 21.1.

2001-10-02  Miles Bader  <miles@gnu.org>

	* minibuf.texi (Minibuffer Misc): Add entries for
	`minibuffer-contents', `minibuffer-contents-no-properties', and
	`delete-minibuffer-contents'.
	Correct description for `minibuffer-prompt-end'.

	* text.texi (Property Search): Correct descriptions of
	`next-char-property-change' and `previous-char-property-change'.
	Add entries for `next-single-char-property-change' and
	`previous-single-char-property-change'.
	Make operand names a bit more consistent.

2001-09-30  Eli Zaretskii  <eliz@is.elta.co.il>

	* frames.texi (Finding All Frames): Document that next-frame and
	previous-frame are local to current terminal.

2001-09-26  Eli Zaretskii  <eliz@is.elta.co.il>

	* keymaps.texi (Creating Keymaps): Fix the description of the
	result of make-keymap.

2001-09-23  Eli Zaretskii  <eliz@is.elta.co.il>

	* display.texi (Font Lookup, Attribute Functions)
	(Image Descriptors): Add cross-references to the definition of
	selected frame.

	* buffers.texi (The Buffer List): Add cross-references to the
	definition of selected frame.

	* frames.texi (Input Focus): Clarify which frame is _the_ selected
	frame at any given time.
	(Multiple Displays, Size and Position): Add a cross-reference to
	the definition of the selected frame.

2001-09-08  Eli Zaretskii  <eliz@is.elta.co.il>

	* strings.texi (String Conversion) <string-to-number>: Document
	that a float is returned for integers that are too large.

	* frames.texi (Mouse Position): Document mouse-position-function.
	(Display Feature Testing): Document display-images-p.
	(Window Frame Parameters): Document the cursor-type variable.

	* numbers.texi (Integer Basics): Document CL style read syntax for
	integers in bases other than 10.

	* positions.texi (List Motion): Document
	open-paren-in-column-0-is-defun-start.

	* lists.texi (Sets And Lists): Document member-ignore-case.

	* internals.texi (Garbage Collection): Document the used and free
	strings report.
	(Memory Usage): Document strings-consed.

	* os.texi (Time of Day): Document float-time.
	(Recording Input): Document that clear-this-command-keys clears
	the vector to be returned by recent-keys.

	* keymaps.texi (Scanning Keymaps) <where-is-internal>: The
	argument keymap can be a list.

	* nonascii.texi (User-Chosen Coding Systems)
	<select-safe-coding-system>: Document the new argument
	accept-default-p and the variable
	select-safe-coding-system-accept-default-p.  Tell what happens if
	buffer-file-coding-system is undecided.
	(Default Coding Systems): Document auto-coding-regexp-alist.

	* display.texi (The Echo Area) <message>: Document
	message-truncate-lines.
	(Glyphs): Document that the glyph table is unused on windowed
	displays.

	* help.texi (Describing Characters) <single-key-description>:
	Document the new argument no-angles.
	(Accessing Documentation) <documentation-property>: Document that
	a non-string property is evaluated.
	<documentation>: Document that the function-documentation property
	is looked for.

	* windows.texi (Selecting Windows): Document some-window.

	* text.texi (MD5 Checksum): New node, documents the md5 primitive.

	* hooks.texi (Standard Hooks): Add kbd-macro-termination-hook and
	apropos-mode-hook.

	* commands.texi (Using Interactive): Document interactive-form.
	(Keyboard Macros): Document kbd-macro-termination-hook.
	(Command Loop Info): Document that clear-this-command-keys clears
	the vector to be returned by recent-keys.

2001-09-04  Werner LEMBERG  <wl@gnu.org>

	* Makefile.in (srcdir, texinputdir): New variables.
	(srcs, index.texi, install): Use $(srcdir).
	(.PHONY): Remove elisp.dvi.
	(elisp): Use -I switch for makeinfo.
	(elisp.dvi): Use $(srcdir) and $(texinputdir).
	(installall, dist): Use $(srcdir).
	Fix path to texinfo.tex.
	(maintainer-clean): Add elisp.dvi and elisp.oaux.

2001-08-30  Gerd Moellmann  <gerd@gnu.org>

	* display.texi (Conditional Display): Adjust to API change.

	* configure: New file.

2001-07-30  Gerd Moellmann  <gerd@gnu.org>

	* commands.texi (Repeat Events): Add description of
	double-click-fuzz.

2001-05-08  Stefan Monnier  <monnier@cs.yale.edu>

	* syntax.texi (Syntax Class Table): Add the missing designator for
	comment and string fences.
	(Syntax Properties): Add a xref to syntax table internals.
	(Syntax Table Internals): Document string-to-syntax.

2001-05-07  Gerd Moellmann  <gerd@gnu.org>

	* Makefile.in (install): Use install-info command line options
	like in Emacs' Makefile.in.

2000-12-09  Miles Bader  <miles@gnu.org>

	* windows.texi (Window Start): Update documentation for
	`pos-visible-in-window-p'.

2000-11-12  Stefan Monnier  <monnier@cs.yale.edu>

	* lists.texi (Building Lists): Add footnote to explain how to add
	to the end of a list.

2000-10-25  Gerd Moellmann  <gerd@gnu.org>

	* files.texi (Visiting Functions): Typos.

2000-10-25  Kenichi Handa  <handa@etl.go.jp>

	* files.texi (Visiting Functions): Return value of
	find-file-noselect may be a list of buffers if wildcards are used.

2000-10-24  Miles Bader  <miles@lsi.nec.co.jp>

	* display.texi (Defining Faces): Document `graphic' display type
	in face specs.

2000-10-18  Kai Grossjohann  <Kai.Grossjohann@CS.Uni-Dortmund.DE>

	* hooks.texi (Standard Hooks): Replace obsolete
	`after-make-frame-hook' with `after-make-frame-functions'.

	* frames.texi (Creating Frames): Ditto.

	* variables.texi (Future Local Variables): Ditto.

2000-10-16  Gerd Moellmann  <gerd@gnu.org>

	* display.texi (Other Image Types): Add description of :foreground
	and :background properties of mono PBM images.

2000-08-17  Werner LEMBERG  <wl@gnu.org>

	* .cvsignore: New file.

2000-01-05  Gerd Moellmann  <gerd@gnu.org>

	* tindex.pl: New script.

1999-12-03  Dave Love  <fx@gnu.org>

	* Makefile.in (MAKEINFO): New parameter.

1999-09-17  Richard Stallman  <rms@gnu.org>

	* Makefile.in (srcs): Add hash.texi.
	(VERSION): Update to 20.6.

1999-09-13  Richard Stallman  <rms@gnu.org>

	* Makefile.in (index.texi): If cannot make a symlink, make a hard link.

1998-08-29  Karl Heuer  <kwzh@gnu.org>

	* configure.in: New file.
	* Makefile.in: Renamed from Makefile.
	(prefix, infodir): Use value obtained from configure.
	(emacslibdir): Obsolete variable deleted.
	(dist): Distribute configure.in, configure, Makefile.in.

1998-06-12  Richard Stallman  <rms@psilocin.ai.mit.edu>

	* Makefile (INSTALL_INFO): New variable.
	(install): Run install-info.

1998-05-09  Richard Stallman  <rms@psilocin.ai.mit.edu>

	* Makefile (elisp.dvi): Add missing backslash.

1998-05-02  Richard Stallman  <rms@psilocin.gnu.org>

	* Makefile (elisp.dvi): Don't depend on texindex or on elisp.tps.
	Run texindex without `./'.  Always run texindex on elisp.tp.
	(elisp.tps): Target deleted.

1998-04-05  Richard Stallman  <rms@psilocin.gnu.org>

	* Makefile (srcs): Add nonascii.texi and customize.texi.
	(dist): Start by deleting `temp'.

1998-02-17  Richard Stallman  <rms@psilocin.gnu.org>

	* Makefile (makeinfo, texindex): Targets deleted.
	(makeinfo.o, texindex.o): Targets deleted.
	(clean, dist): Don't do anything with them or with getopt*.

1998-01-30  Richard Stallman  <rms@psilocin.gnu.org>

	* Makefile (SHELL): Defined.

1998-01-27  Richard Stallman  <rms@psilocin.gnu.org>

	* Makefile (elisp.tps): New target.
	(elisp.dvi): Depend on elisp.tps.

Wed Apr  3 15:24:25 1996  Karl Heuer  <kwzh@gnu.ai.mit.edu>

	* README: Update phone number.

	* Makefile (elisp): Make this be the default target.
	Depend on makeinfo.c instead of makeinfo.
	(install): Don't depend on elisp.dvi, since we don't install that.
	Use mkinstalldirs.
	(dist): Add mkinstalldirs.

Mon Jun 19 14:35:26 1995  Richard Stallman  <rms@mole.gnu.ai.mit.edu>

	* Makefile (VERSION): Update version number.
	(maintainer-clean): Renamed from realclean.

Wed Jun  7 17:04:59 1995  Karl Heuer  <kwzh@nutrimat.gnu.ai.mit.edu>

	* Makefile (realclean): New target.
	(elisp): Remove any old elisp-* files first.

Tue Nov 23 19:59:40 1993  Noah Friedman  (friedman@nutrimat.gnu.ai.mit.edu)

	* Makefile (VERSION): New variable.
	(dist): Make packaged directory name `elisp-manual-19-$(VERSION)'.
	Compressed file suffix should be `.gz', not `.z'.

Mon Nov 22 15:06:19 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)

	* Makefile (elisp): Depend on makeinfo.

Fri Nov 19 02:29:33 1993  Noah Friedman  (friedman@gnu.ai.mit.edu)

	* Makefile (srcs): Add anti.texi.

Fri May 28 18:04:53 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)

	* Makefile (infodir, prefix): New vars.
	(install): Use infodir.
	(emacsinfodir): Deleted.

Thu May 27 02:11:25 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)

	* Makefile (srcs): Add calendar.texi.

	* Makefile (dist): Copy texindex.c and makeinfo.c.
	Limit elisp-* files to those with one or two digits.

Sun May 16 17:58:21 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)

	* Makefile (dist): Changed to use Gzip instead of compress.

Fri Apr 23 01:05:23 1993  Eric S. Raymond  (eric@mole.gnu.ai.mit.edu)

	* loading.texi (Unloading): define-function changed back to
	defalias.  It may not stay this way, but at least it's
	consistent with the known-good version of the code patch.

Fri Mar 26 21:14:54 1993  Eric S. Raymond  (eric@geech.gnu.ai.mit.edu)

	* modes.texi (Hooks): Document new optional arg of add-hook.

Wed Mar 17 08:48:24 1993  Eric S. Raymond  (eric@mole.gnu.ai.mit.edu)

	* variables.texi: Document nil initial value of buffer-local variables.

	* tips.texi: Add new section on standard library headers.

Sat Feb 27 18:00:25 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)

	* Makefile (srcs): Add frame.texi to the list of sources.

Tue Feb 23 10:50:25 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)

	* Makefile (dist): Don't bother excluding autosave files; they'll
	never make it into the temp directory anyway, and the hash marks
	in the name are problematic for make and the Bourne shell.
	(srcs):

Fri Feb 12 16:54:38 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)

	* Makefile (dist): Don't include backup files or autosave files in
	the distribution tar file.

Tue Nov 26 21:10:34 1991  Richard Stallman  (rms@mole.gnu.ai.mit.edu)

	* Makefile (srcs): Added index.perm.
	(elisp.dvi): Remove erroneous shell comment.
	Expect output of permute-index in permuted.fns.
	Save old elisp.aux in elisp.oaux.
	(clean): Added index.texi to be deleted.

Sat Aug 11 17:39:10 1990  Richard Stallman  (rms@sugar-bombs.ai.mit.edu)

	* Makefile (elisp.dvi, index.texi): Use shell if instead of ifdef.

Tue Jun 26 09:57:26 1990  David Lawrence  (tale@geech)

	* files.texi:  Noted that completion-ignored-extensions is ignored
	when making *Completions*.

Fri Jun  8 16:44:44 EDT 1990 Jay Fenlason (hack@ai.mit.edu)

	* Makefile  make dist now depends on elisp.dvi, since it tries
	to include it in the dist file.

Wed Mar 28 22:57:35 1990  Jim Kingdon  (kingdon@mole.ai.mit.edu)

	* functions.texinfo (Mapping Functions): Add missing quote

Mon Jun 19 18:09:24 1989  Richard Stallman  (rms@sugar-bombs.ai.mit.edu)

	* texinfo.tex (frenchspacing): Use decimal codes for char to be set.
	(defunargs): Turn off \hyphenchar of \sl font temporarily.

Wed May 10 18:01:17 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)

	* @result{}, @expansion{}, @print{}, @quiv{}, @point{},
	and @error{} are the terms now being used.  The files in the
	directory have been changed to reflect this.

	* All instances of @indentedresultt{} have been changed to
	`     @result{}', using 5 spaces at the begining of the line.

Mon Apr 24 21:02:55 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)

	* @result{}, @expandsto{}, @prints{}, @quiv{}, @error{}, and the
	experimental @indentedresult{}, @indentedexpandsto{} are part of
	the texinfo.tex in this directory.  These TeX macros are not
	stable yet.

Mon Apr 17 18:56:50 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)

	* texinfo.tex:  temporarily added
		\let\result=\dblarrow
		\def\error{{\it ERROR} \longdblarrow}
	We need to do this better soon.

Tue Apr 11 12:23:28 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)

	* Applied Karl Berry's patches to *.texinfo files, but not to
	texinfo.tex; those diffs are in `berry-texinfo-tex-diffs'. (Karl's
	new title page format is also not applied, since it requires
	texinfo.tex changes.)

	* Cleaned up `Makefile' and defined the `emacslibdir' directory
	for the Project GNU development environment.

;; Local Variables:
;; coding: iso-2022-7bit
;; End:

    Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
  Copying and distribution of this file, with or without modification,
  are permitted provided the copyright notice and this notice are preserved.

;;; arch-tag: 985ae0ce-df29-475b-b3f8-4bbcbf6f7fda