(Foverlay_buffer): Doc fix.
[bpt/emacs.git] / lispref / ChangeLog
index b6819c9..96f87a1 100644 (file)
@@ -1,3 +1,592 @@
+2005-02-22  Kim F. Storm  <storm@cua.dk>
+
+       * minibuf.texi (Basic Completion): Allow symbols in addition to
+       strings in try-completion and all-completions.
+
+2005-02-14  Lute Kamstra  <lute@gnu.org>
+
+       * elisp.texi (Top): Remove reference to deleted node.
+
+       * lists.texi (Lists): Remove reference to deleted node.
+       (Cons Cells): Fix typo.
+
+       * loading.texi (Where Defined): Fix typo.
+
+2005-02-14  Richard M. Stallman  <rms@gnu.org>
+
+       * variables.texi (Creating Buffer-Local): change-major-mode-hook
+       is useful for discarding some minor modes.
+
+       * symbols.texi (Symbol Components): Reorder examples.
+
+       * streams.texi (Input Functions): State standard-input default.
+       (Output Variables): State standard-output default.
+
+       * objects.texi (Printed Representation): Clarify read syntax vs print.
+       (Floating Point Type): Explain meaning better.
+       (Symbol Type): Explain uniqueness better.
+       (Cons Cell Type): Explain empty list sooner.  CAR and CDR later.
+       List examples sooner.
+       (Box Diagrams): New subnode broken out.
+       Some examples moved from old Lists as Boxes node.
+       (Dotted Pair Notation): Clarify intro.
+       (Array Type): Clarify.
+       (Type Predicates): Add hash-table-p.
+
+       * numbers.texi (Integer Basics): Clarify radix explanation.
+       (Predicates on Numbers): Minor clarification.
+       (Comparison of Numbers): Minor clarification.  Clarify eql.
+       Typos in min, max.
+       (Math Functions): Clarify overflow in expt.
+
+       * minibuf.texi (Text from Minibuffer): Minor clarification.
+       Mention arrow keys.
+
+       * loading.texi (Autoload): defun's doc string overrides autoload's
+       doc string.
+       (Repeated Loading): Modernize "add to list" examples.
+       (Where Defined): Finish updating table of load-history elts.
+
+       * lists.texi (List-related Predicates): Minor wording improvement.
+       (Lists as Boxes): Node deleted.
+       (Building Lists): Explain trivial cases of number-sequence.
+
+       * hash.texi (Hash Tables): Add desc to menu items.
+       (Creating Hash): Expain "full" means "make larger",
+       (Hash Access): Any object can be a key.
+       State value of maphash.
+
+       * functions.texi (What Is a Function): Wording cleanup.
+       (Function Documentation): Minor cleanup.
+       Explain purpose of calling convention at end of doc string.
+       (Function Names): Wording cleanup.
+       (Calling Functions): Wording cleanup.
+       Explain better how funcall calls the function.
+       (Function Cells): Delete example of saving and redefining function.
+
+       * control.texi (Combining Conditions): Wording cleanup.
+       (Iteration): dolist and dotimes bind VAR locally.
+       (Cleanups): Xref to Atomic Changes.
+
+       * compile.texi (Byte Compilation): Delete 19.29 info.
+       (Compilation Functions): Macros' difficulties don't affect defsubst.
+       (Docs and Compilation): Delete 19.29 info.
+
+2005-02-10  Richard M. Stallman  <rms@gnu.org>
+
+       * objects.texi (Symbol Type): Minor correction.
+
+2005-02-06  Lute Kamstra  <lute@gnu.org>
+
+       * modes.texi (Example Major Modes): Fix typos.
+
+2005-02-06  Richard M. Stallman  <rms@gnu.org>
+
+       * text.texi (Margins): fill-nobreak-predicate can be one function.
+
+       * strings.texi (Modifying Strings): clear-string can make unibyte.
+       (Formatting Strings): format gives error if values missing.
+
+       * positions.texi (Character Motion): Mention default arg
+       for forward-char.  backward-char refers to forward-char.
+       (Word Motion): Mention default arg for forward-word.
+       (Buffer End Motion): Mention default arg for beginning-of-buffer.
+       Simplify end-of-buffer.
+       (Text Lines): Mention default arg for forward-line.
+       (List Motion): Mention default arg for beginning/end-of-defun.
+       (Skipping Characters): Minor fixes in explaining character-set.
+
+       * modes.texi (Major Mode Conventions): Mention "system abbrevs".
+       Mode inheritance applies only when default-major-mode is nil.
+       Clarifications.
+       (Example Major Modes): Update Text mode and Lisp mode examples.
+       (Minor Mode Conventions): Mention define-minor-mode at top.
+       (Defining Minor Modes): In Hungry example, don't define C-M-DEL.
+       (Mode Line Format): Update mode line face display info.
+       (Properties in Mode): Mention effect of risky vars.
+       (Imenu): Define imenu-add-to-menubar.
+       (Font Lock Mode): Add descriptions to menu lines.
+       (Faces for Font Lock): Add font-lock-doc-face.
+
+2005-02-05  Lute Kamstra  <lute@gnu.org>
+
+       * text.texi (Maintaining Undo): Remove obsolete function.
+
+2005-02-05  Eli Zaretskii  <eliz@gnu.org>
+
+       * frames.texi (Color Names): Add pointer to the X docs about RGB
+       color specifications.  Improve indexing
+       (Text Terminal Colors): Replace the description of RGB values by
+       an xref to "Color Names".
+
+2005-02-03  Richard M. Stallman  <rms@gnu.org>
+
+       * windows.texi (Basic Windows): Add cursor-in-non-selected-windows.
+       Clarify.
+       (Selecting Windows): Clarify save-selected-window.
+       (Cyclic Window Ordering): Clarify walk-windows.
+       (Window Point): Clarify.
+       (Window Start): Add comment to example.
+       (Resizing Windows): Add `interactive' specs in examples.
+       Document fit-window-to-buffer.
+
+       * text.texi (User-Level Deletion): just-one-space takes numeric arg.
+       (Undo, Maintaining Undo): Clarify last change.
+       (Sorting): In sort-numeric-fields, explain about octal and hex.
+       Mention sort-numeric-base.
+       (Format Properties): Add xref for hard newlines.
+
+       * frames.texi (Window Frame Parameters): Explain pixel=char on tty.
+       (Pop-Up Menus): Fix typo.
+       (Color Names): Explain all types of color names.
+       Explain color-values on B&W terminal.
+       (Text Terminal Colors): Explain "rgb values" are lists.  Fix arg names.
+
+       * files.texi (File Locks): Not supported on MS systems.
+       (Testing Accessibility): Clarify.
+
+       * edebug.texi (Printing in Edebug): Fix edebug-print-circle.
+       (Coverage Testing): Fix typo.
+
+       * commands.texi (Misc Events): Remove stray space.
+
+       * buffers.texi (Buffer Names): Clarify generate-new-buffer-name.
+       (Modification Time): Clarify when visited-file-modtime returns 0.
+       (The Buffer List): Clarify bury-buffer.
+       (Killing Buffers): Clarify.
+       (Indirect Buffers): Add clone-indirect-buffer.
+
+2005-02-02  Matt Hodges  <MPHodges@member.fsf.org>
+
+       * edebug.texi (Printing in Edebug): Fix default value of
+       edebug-print-circle.
+       (Coverage Testing): Fix displayed frequency count data.
+
+2005-02-02  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * text.texi (Maintaining Undo): Add `undo-outer-limit'.
+
+2005-02-02  Kim F. Storm  <storm@cua.dk>
+
+       * text.texi (Undo) <buffer-undo-list>: Describe `apply' elements.
+
+2005-01-29  Eli Zaretskii  <eliz@gnu.org>
+
+       * commands.texi (Misc Events): Describe the help-echo event.
+
+       * text.texi (Special Properties) <help-echo>: Use `pos'
+       consistently in description of the help-echo property.  Use
+       @code{nil} instead of @var{nil}.
+
+       * display.texi (Overlay Properties): Fix the index entry for
+       help-echo overlay property.
+
+       * customize.texi (Type Keywords): Uncomment the xref to the
+       help-echo property documentation.
+
+2005-01-23  Kim F. Storm  <storm@cua.dk>
+
+       * windows.texi (Window Start): Fix `pos-visible-in-window-p'
+       return value.  Third element FULLY replaced by PARTIAL which
+       specifies number of invisible pixels if row is only partially visible.
+       (Textual Scrolling): Mention auto-window-vscroll.
+       (Vertical Scrolling): New defvar auto-window-vscroll.
+
+2005-01-16  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * keymaps.texi (Changing Key Bindings): `suppress-keymap' now uses
+       command remapping.
+
+2005-01-15  Richard M. Stallman  <rms@gnu.org>
+
+       * display.texi (Defining Images): Mention DATA-P arg of create-image.
+
+2005-01-14  Kim F. Storm  <storm@cua.dk>
+
+       * commands.texi (Accessing Events): Add WHOLE arg to posn-at-x-y.
+
+       * text.texi (Links and Mouse-1): Fix string and vector item.
+
+2005-01-13  Richard M. Stallman  <rms@gnu.org>
+
+       * keymaps.texi (Active Keymaps): Rewrite the text, and update the
+       descriptions of overriding-local-map and overriding-terminal-local-map.
+
+       * text.texi (Links and Mouse-1): Clarify text.
+
+2005-01-13  Kim F. Storm  <storm@cua.dk>
+
+       * modes.texi (Emulating Mode Line): Update format-mode-line entry.
+
+2005-01-13  Francis Litterio  <franl@world.std.com>  (tiny change)
+
+       * keymaps.texi (Active Keymaps): Fix overriding-local-map description.
+
+2005-01-12  Kim F. Storm  <storm@cua.dk>
+
+       * text.texi (Links and Mouse-1): Rename section from Enabling
+       Mouse-1 to Following Links.  Change xrefs.
+       Add examples for define-button-type and define-widget.
+
+       * display.texi (Button Properties, Button Buffer Commands):
+       Clarify mouse-1 and follow-link functionality.
+
+2005-01-12  Richard M. Stallman  <rms@gnu.org>
+
+       * text.texi (Enabling Mouse-1 to Follow Links): Redo prev. change.
+
+       * display.texi (Beeping): Fix Texinfo usage.
+
+       * modes.texi (Emulating Mode Line): Doc FACE arg in format-header-line.
+
+2005-01-11  Kim F. Storm  <storm@cua.dk>
+
+       * display.texi (Button Properties, Button Buffer Commands):
+       Mention mouse-1 binding.  Add follow-link keyword.
+
+       * text.texi (Text Properties): Add "Enable Mouse-1" to submenu.
+       (Enabling Mouse-1 to Follow Links): New subsection.
+
+2005-01-06  Richard M. Stallman  <rms@gnu.org>
+
+       * text.texi (Special Properties): Minor change.
+
+       * os.texi (Timers): Clarify previous change.
+
+       * modes.texi (Emulating Mode Line): format-mode-line requires 1 arg.
+
+2005-01-01  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * display.texi (Face Attributes): Correct xref to renamed node.
+
+2005-01-01  Richard M. Stallman  <rms@gnu.org>
+
+       * display.texi (Face Attributes): Describe hex color specs.
+
+2004-12-31  Richard M. Stallman  <rms@gnu.org>
+
+       * os.texi (Timers): Update previous change.
+
+2004-12-30  Kim F. Storm  <storm@cua.dk>
+
+       * display.texi (Line Height): Total line-height is now specified
+       in line-height property of form (HEIGHT TOTAL).  Swap (FACE . RATIO)
+       in cons cells.  (nil . RATIO) is relative to actual line height.
+       Use line-height `t' instead of `0' to get minimum height.
+
+2004-12-29  Richard M. Stallman  <rms@gnu.org>
+
+       * os.texi (Timers): Discuss timers vs editing the buffer and undo.
+
+2004-12-28  Richard M. Stallman  <rms@gnu.org>
+
+       * commands.texi (Quitting): Clarify value of with-local-quit.
+
+       * elisp.texi (Top): Fix previous change.
+
+       * loading.texi (Loading): Fix previous change.
+
+2004-12-27  Richard M. Stallman  <rms@gnu.org>
+
+       * Makefile.in (MAKEINFO): Specify --force.
+
+       * buffers.texi (Killing Buffers): Add buffer-save-without-query.
+
+       * modes.texi (Emulating Mode Line): Document format's BUFFER arg.
+
+       * display.texi (Line Height): Further clarify.
+
+       * elisp.texi (Top): Update Loading submenu.
+
+       * loading.texi (Where Defined): New node.
+       (Unloading): load-history moved to Where Defined.
+
+2004-12-21  Richard M. Stallman  <rms@gnu.org>
+
+       * commands.texi (Event Input Misc): Add while-no-input.
+
+2004-12-11  Richard M. Stallman  <rms@gnu.org>
+
+       * display.texi (Line Height): Rewrite text for clarity.
+
+2004-12-11  Kim F. Storm  <storm@cua.dk>
+
+       * display.texi (Display): Add node "Line Height" to menu.
+       (Line Height): New node.  Move full description of line-spacing
+       and line-height text properties here from text.texi.
+       (Scroll Bars): Add vertical-scroll-bar variable.
+
+       * frames.texi (Window Frame Parameters): Remove line-height defvar.
+
+       * locals.texi (Standard Buffer-Local Variables): Fix xref for
+       line-spacing and vertical-scroll-bar.
+
+       * text.texi (Special Properties): Just mention line-spacing and
+       line-height here, add xref to new "Line Height" node.
+
+2004-12-09  Thien-Thi Nguyen  <ttn@gnu.org>
+
+       * frames.texi (Window Frame Parameters): New @defvar for `line-spacing'.
+
+       * locals.texi (Standard Buffer-Local Variables):
+       Add @xref for `line-spacing'.
+
+2004-12-05  Richard M. Stallman  <rms@gnu.org>
+
+       * Makefile.in (maintainer-clean): Remove the info files
+       in $(infodir) where they are created.
+
+2004-12-03  Richard M. Stallman  <rms@gnu.org>
+
+       * windows.texi (Selecting Windows): get-lru-window and
+       get-largest-window don't consider dedicated windows.
+
+       * text.texi (Undo): Document undo-in-progress.
+
+2004-11-26  Richard M. Stallman  <rms@gnu.org>
+
+       * locals.texi (Standard Buffer-Local Variables): Undo prev change.
+       Remove a few vars that are not always buffer-local.
+
+2004-11-24  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * locals.texi (Standard Buffer-Local Variables): Comment out
+       xref's to non-existent node `Yet to be written'.
+
+2004-11-24  Richard M. Stallman  <rms@gnu.org>
+
+       * processes.texi (Synchronous Processes): Grammar fix.
+
+       * numbers.texi (Comparison of Numbers): Add eql.
+
+       * locals.texi (Standard Buffer-Local Variables): Add many vars.
+
+       * intro.texi (Printing Notation): Fix previous change.
+
+       * display.texi (Customizing Bitmaps): Move indicate-buffer-boundaries
+       and default-indicate-buffer-boundaries from here.
+       (Usual Display): To here.
+       (Scroll Bars): Add scroll-bar-mode and scroll-bar-width.
+       (Usual Display): Move tab-width up.
+
+       * customize.texi (Variable Definitions): Replace
+       show-paren-mode example with tooltip-mode.
+       (Simple Types, Composite Types, Defining New Types):
+       Minor cleanups.
+
+2004-11-21  Jesper Harder  <harder@ifa.au.dk>
+
+       * processes.texi (Synchronous Processes, Output from Processes):
+       Markup fix.
+
+2004-11-20  Richard M. Stallman  <rms@gnu.org>
+
+       * positions.texi (Skipping Characters): skip-chars-forward
+       now handles char classes.
+
+       * intro.texi (Printing Notation): Avoid confusion of `print'
+       when explaining @print.
+
+       * macros.texi (Argument Evaluation): Fix 1st `for' expansion example.
+
+       * display.texi (Display Table Format): Minor fix.
+
+       * streams.texi (Output Functions): Fix print example.
+
+       * Makefile.in (elisp): New target.
+       (dist): Depend on $(infodir)/elisp, not elisp.
+       Copy the info files from $(infodir).
+
+       * minibuf.texi (Text from Minibuffer): Document KEEP-ALL arg in
+       read-from-minibuffer.
+
+       * searching.texi (Regexp Search): Rename that to search-spaces-regexp.
+
+2004-11-19  Richard M. Stallman  <rms@gnu.org>
+
+       * searching.texi (Regexp Search): Add search-whitespace-regexp.
+
+2004-11-19  CHENG Gao  <chenggao@gmail.com>  (tiny change)
+
+       * tips.texi (Coding Conventions): Fix typo.
+
+2004-11-16  Richard M. Stallman  <rms@gnu.org>
+
+       * tips.texi (Coding Conventions): Separate defvar and require
+       methods to avoid warnings.  Use require only when there are many
+       functions and variables from that package.
+
+       * minibuf.texi (Minibuffer Completion): When ignoring case,
+       predicate must not be case-sensitive.
+
+       * debugging.texi (Function Debugging, Explicit Debug): Clarified.
+       (Test Coverage): Don't talk about "splotches".  Clarified.
+
+2004-11-16  Thien-Thi Nguyen  <ttn@gnu.org>
+
+       * frames.texi (Window Frame Parameters): Fix typo.
+
+2004-11-15  Kim F. Storm  <storm@cua.dk>
+
+       * symbols.texi (Other Plists): Note that plist-get may signal error.
+       Add safe-plist-get.
+
+2004-11-15  Thien-Thi Nguyen  <ttn@gnu.org>
+
+       * modes.texi (Font Lock Basics): Fix typo.
+
+2004-11-08  Richard M. Stallman  <rms@gnu.org>
+
+       * syntax.texi (Syntax Table Functions): Add syntax-after.
+
+2004-11-06  Lars Brinkhoff  <lars@nocrew.org>
+
+       * os.texi (Processor Run Time): New section documenting
+       get-internal-run-time.
+
+2004-11-06  Eli Zaretskii  <eliz@gnu.org>
+
+       * Makefile.in (install, maintainer-clean): Don't use "elisp-*" as
+       it nukes elisp-cover.texi.
+       (dist): Change elisp-[0-9] to elisp-[1-9], as there could be no
+       elisp-0 etc.
+
+2004-11-05  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * commands.texi (Keyboard Macros): Document `append' return value
+       of `defining-kbd-macro'.
+
+2004-11-01  Richard M. Stallman  <rms@gnu.org>
+
+       * commands.texi (Interactive Call): Add called-interactively-p.
+
+2004-10-29  Simon Josefsson  <jas@extundo.com>
+
+       * minibuf.texi (Reading a Password): Revert.
+
+2004-10-28  Richard M. Stallman  <rms@gnu.org>
+
+       * frames.texi (Display Feature Testing): Explain about "vendor".
+
+2004-10-27  Richard M. Stallman  <rms@gnu.org>
+
+       * commands.texi (Interactive Codes): `N' uses numeric prefix,
+       not raw.  Clarify `n'.
+       (Interactive Call): Rewrite interactive-p, focusing on when
+       and how to use it.
+       (Misc Events): Clarify previous change.
+
+       * advice.texi (Simple Advice): Clarify what job the example does.
+       (Around-Advice): Clarify ad-do-it.
+       (Activation of Advice): An option of ad-default-compilation-action
+       is `never', not `nil'.
+
+2004-10-26  Kim F. Storm  <storm@cua.dk>
+
+       * commands.texi (Interactive Codes): Add U code letter.
+
+2004-10-25  Simon Josefsson  <jas@extundo.com>
+
+       * minibuf.texi (Reading a Password): Add.
+
+2004-10-24  Jason Rumney  <jasonr@gnu.org>
+
+       * commands.texi (Misc Events): Remove mouse-wheel. Add wheel-up
+       and wheel-down.
+
+2004-10-24  Kai Grossjohann  <kai.grossjohann@gmx.net>
+
+       * processes.texi (Synchronous Processes): Document process-file.
+
+2004-10-22  Kenichi Handa  <handa@m17n.org>
+
+       * text.texi (translate-region): Document that it accepts also a
+       char-table.
+
+2004-10-22  David Ponce  <david@dponce.com>
+
+       * windows.texi (Resizing Windows): Document the `preserve-before'
+       argument of the functions `enlarge-window' and `shrink-window'.
+
+2004-10-19  Jason Rumney  <jasonr@gnu.org>
+
+       * makefile.w32-in (elisp): Change order of arguments to makeinfo.
+
+2004-10-09  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * text.texi (Filling): Add anchor for definition of
+       `sentence-end-double-space'.
+
+       * searching.texi (Regexp Example): Update description of how
+       Emacs currently recognizes the end of a sentence.
+       (Standard Regexps): Update definition of the variable
+       `sentence-end'.  Add definition of the function `sentence-end'.
+
+2004-10-08  Paul Pogonyshev  <pogonyshev@gmx.net>
+
+       * display.texi (Progress): New node.
+
+2004-10-05  Kim F. Storm  <storm@cua.dk>
+
+       * display.texi (Fringe Bitmaps): Update fringe-bitmaps-at-pos.
+
+2004-09-29  Kim F. Storm  <storm@cua.dk>
+
+       * display.texi (Fringe Bitmaps): Use symbols rather than numbers
+       to identify bitmaps.  Remove -fringe-bitmap suffix for standard
+       fringe bitmap symbols, as they now have their own namespace.
+       (Customizing Bitmaps) <define-fringe-bitmap>: Clarify bit ordering
+       vs. pixels.  Signal error if no free bitmap slots.
+       (Pixel Specification): Change IMAGE to @var{image}.
+
+2004-09-28  Richard M. Stallman  <rms@gnu.org>
+
+       * text.texi (Special Properties): Clarify line-spacing and line-height.
+
+       * searching.texi (Regexp Search): Add looking-back.
+
+2004-09-25  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * display.texi: Correct typos.
+       (Image Descriptors): Correct xref's.
+
+2004-09-25  Richard M. Stallman  <rms@gnu.org>
+
+       * text.texi (Special Properties): Cleanups in `cursor'.
+       Rewrites in `line-height' and `line-spacing'; exchange them.
+
+       * display.texi (Fringes): Rewrite previous change.
+       (Fringe Bitmaps): Merge text from Display Fringe Bitmaps.  Rewrite.
+       (Display Fringe Bitmaps): Node deleted, text moved.
+       (Customizing Bitmaps): Split off from Fringe Bitmaps.  Rewrite.
+       (Scroll Bars): Clarify set-window-scroll-bars.
+       (Pointer Shape): Rewrite.
+       (Specified Space): Clarify :align-to, etc.
+       (Pixel Specification): Use @var.  Clarify new text.
+       (Other Display Specs): Clarify `slice'.
+       (Image Descriptors): Cleanups.
+       (Showing Images): Cleanups.
+
+2004-09-24  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * hooks.texi (Standard Hooks): Add `after-change-major-mode-hook'.
+
+       * modes.texi: Various minor changes in addition to:
+       (Major Mode Conventions): Final call to `run-mode-hooks' should
+       not be inside the `delay-mode-hooks' form.
+       (Mode Hooks): New node.
+       (Hooks): Delete obsolete example.
+       Move definitions of `run-mode-hooks' and `delay-mode-hooks' to new
+       node "Mode Hooks".
+
+2004-09-22  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * display.texi: Correct various typos.
+       (Display): Rename node "Pointer Shapes" to "Pointer
+       Shape".  (There is already a node called "Pointer Shapes" in
+       frames.texi.)
+       (Images): Remove non-existent node "Image Slices" from menu.
+
 2004-09-23  Kim F. Storm  <storm@cua.dk>
 
        * text.texi (Special Properties): Add `cursor', `pointer',