lispref/ChangeLog

   1 2003-11-08  Luc Teirlinck  <teirllm@auburn.edu>
   2
   3         * hash.texi (Creating Hash): Clarify description of `eql'.
   4         `makehash' is obsolete.
   5         (Hash Access): Add Common Lisp notes for `remhash' and `clrhash'.
   6
   7         * positions.texi (Point): Change description of `buffer-end', so
   8         that it is also correct for floating point arguments.
   9         (List Motion): Correct argument lists of `beginning-of-defun' and
  10         `end-of-defun'.
  11         (Excursions): Add xref to `Marker Insertion Types'.
  12         (Narrowing): Argument to `narrow-to-page' is optional.
  13
  14 2003-11-06  Luc Teirlinck  <teirllm@auburn.edu>
  15
  16         * streams.texi (Output Streams): Clarify behavior of point for
  17         marker output streams.
  18
  19 2003-11-04  Luc Teirlinck  <teirllm@auburn.edu>
  20
  21         * variables.texi (Defining Variables): Second argument to
  22         `defconst' is not optional.
  23         (Setting Variables): Mention optional argument APPEND to
  24         `add-to-list'.
  25         (Creating Buffer-Local): Expand description of
  26         `make-variable-buffer-local'.
  27         (Frame-Local Variables): Expand description of
  28         `make-variable-frame-local'.
  29         (Variable Aliases): Correct description of optional argument
  30         DOCSTRING to `defvaralias'.  Mention return value of
  31         `defvaralias'.
  32         (File Local Variables): Add xref to `File variables' in Emacs
  33         Manual.  Correct description of `hack-local-variables'.  Mention
  34         `safe-local-variable' property.  Mention optional second argument
  35         to `risky-local-variable-p'.
  36
  37 2003-11-03  Luc Teirlinck  <teirllm@auburn.edu>
  38
  39         * symbols.texi (Symbol Plists): Mention return value of `setplist'.
  40
  41 2003-11-02  Jesper Harder  <harder@ifa.au.dk>  (tiny change)
  42
  43         * lispref/anti.texi, lispref/backups.texi, lispref/commands.texi
  44         lispref/customize.texi, lispref/display.texi, lispref/files.texi,
  45         lispref/internals.texi, lispref/keymaps.texi, lispref/loading.texi,
  46         lispref/modes.texi, lispref/nonascii.texi, lispref/numbers.texi,
  47         lispref/objects.texi, lispref/os.texi, lispref/positions.texi,
  48         lispref/processes.texi, lispref/searching.texi,
  49         lispref/sequences.texi, lispref/streams.texi, lispref/strings.texi,
  50         lispref/syntax.texi, lispref/text.texi: Replace @sc{foo} with
  51         @acronym{FOO}.
  52
  53 2003-10-27  Luc Teirlinck  <teirllm@auburn.edu>
  54
  55         * strings.texi (Creating Strings): Argument START to `substring'
  56         can not be `nil'.  Expand description of
  57         `substring-no-properties'.  Correct description of `split-string',
  58         especially with respect to empty matches.  Prevent very bad line
  59         break in definition of `split-string-default-separators'.
  60         (Text Comparison): `string=' and `string<' also accept symbols as
  61         arguments.
  62         (String Conversion): More completely describe argument BASE in
  63         `string-to-number'.
  64         (Formatting Strings): `%s' and `%S" in `format' do require
  65         corresponding object.  Clarify behavior of numeric prefix after
  66         `%' in `format'.
  67         (Case Conversion): The argument to `upcase-initials' can be a
  68         character.
  69
  70 2003-10-27  Kenichi Handa  <handa@m17n.org>
  71
  72         * display.texi (Fontsets): Fix texinfo usage.
  73
  74 2003-10-25  Kenichi Handa  <handa@m17n.org>
  75
  76         * display.texi (Fontsets): Add description of the function
  77         set-fontset-font.
  78
  79 2003-10-23  Luc Teirlinck  <teirllm@auburn.edu>
  80
  81         * display.texi (Temporary Displays): Add xref to `Documentation
  82         Tips'.
  83
  84         * functions.texi (Function Safety): Use inforef instead of pxref
  85         for SES.
  86
  87 2003-10-23  Andreas Schwab  <schwab@suse.de>
  88
  89         * Makefile.in (TEX, texinputdir): Don't define.
  90         (TEXI2DVI): Define.
  91         (srcs): Remove $(srcdir)/index.perm and $(srcdir)/index.unperm,
  92         add $(srcdir)/index.texi.
  93         ($(infodir)/elisp): Remove index.texi dependency.
  94         (elisp.dvi): Likewise.  Use $(TEXI2DVI).
  95         (index.texi): Remove target.
  96         (dist): Don't link $(srcdir)/permute-index.
  97         (clean): Don't remove index.texi.
  98
  99         * permute-index, index.perm: Remove.
 100         * index.texi: Rename from index.unperm.
 101
 102 2003-10-22  Luc Teirlinck  <teirllm@auburn.edu>
 103
 104         * tips.texi (Documentation Tips): Document new behavior for face
 105         and variable hyperlinks in Help mode.
 106
 107 2003-10-21  Luc Teirlinck  <teirllm@auburn.edu>
 108
 109         * objects.texi (Integer Type): Update for extra bit of integer range.
 110         (Character Type): Ditto.
 111
 112 2003-10-16  Eli Zaretskii  <eliz@elta.co.il>
 113
 114         * numbers.texi (Integer Basics): Add index entries for reading
 115         numbers in hex, octal, and binary.
 116
 117 2003-10-16  Lute Kamstra  <lute@gnu.org>
 118
 119         * modes.texi (Mode Line Format): Mention force-mode-line-update's
 120         argument.
 121
 122 2003-10-13  Luc Teirlinck  <teirllm@auburn.edu>
 123
 124         * windows.texi (Choosing Window): Fix typo.
 125         * edebug.texi (Edebug Execution Modes): Fix typo.
 126
 127 2003-10-13  Richard M. Stallman  <rms@gnu.org>
 128
 129         * windows.texi (Basic Windows): A window has fringe settings,
 130         display margins and scroll-bar settings.
 131         (Splitting Windows): Doc split-window return value.
 132         Clean up one-window-p.
 133         (Selecting Windows): Fix typo.
 134         (Cyclic Window Ordering): Explain frame as ALL-FRAMES in next-window.
 135         (Buffers and Windows): In set-window-buffer, explain effect
 136         on fringe settings and scroll bar settings.
 137         (Displaying Buffers): In pop-to-buffer, explain nil as buffer arg.
 138         (Choosing Window): Use defopt for pop-up-frame-function.
 139         For special-display-buffer-names, explain same-window and same-frame.
 140         Clarify window-dedicated-p return value.
 141         (Textual Scrolling): scroll-up and scroll-down can get an error.
 142         (Horizontal Scrolling): Clarify auto-hscroll-mode.
 143         Clarify set-window-hscroll.
 144         (Size of Window): Don't mention tool bar in window-height.
 145         (Coordinates and Windows): Explain what coordinates-in-window-p
 146         returns for fringes and display margins.
 147         (Window Configurations): Explain saving fringes, etc.
 148
 149         * tips.texi (Library Headers): Clean up Documentation.
 150
 151         * syntax.texi (Parsing Expressions): Clean up forward-comment
 152         and parse-sexp-lookup-properties.
 153
 154         * sequences.texi (Sequence Functions): sequencep accepts bool-vectors.
 155
 156         * os.texi (System Environment): Clean up text for load-average errors.
 157
 158         * modes.texi (Hooks): Don't explain local hook details at front.
 159         Clarify run-hooks and run-hook-with-args a little.
 160         Clean up add-hook and remove-hook.
 161
 162         * edebug.texi (Edebug Execution Modes): Clarify t.
 163         Document edebug-sit-for-seconds.
 164         (Coverage Testing): Document C-x X = and =.
 165         (Instrumenting Macro Calls): Fix typo.
 166         (Specification List): Don't index the specification keywords.
 167
 168 2003-10-10  Kim F. Storm  <storm@cua.dk>
 169
 170         * processes.texi (Network): Introduce make-network-process.
 171
 172 2003-10-09  Luc Teirlinck  <teirllm@auburn.edu>
 173
 174         * tips.texi (Library Headers): Fix typo.
 175
 176 2003-10-07  Juri Linkov  <juri@jurta.org>
 177
 178         * modes.texi (Imenu): Mention imenu-create-index-function's
 179         default value.  Explain submenus better.
 180
 181 2003-10-07  Lute Kamstra  <lute@gnu.org>
 182
 183         * modes.texi (Faces for Font Lock): Fix typo.
 184         (Hooks): Explain how buffer-local hook variables can refer to
 185         global hook variables.
 186         Various minor clarifications.
 187
 188 2003-10-06  Lute Kamstra  <lute@gnu.org>
 189
 190         * tips.texi (Coding Conventions): Mention naming conventions for
 191         hooks.
 192
 193 2003-10-05  Luc Teirlinck  <teirllm@auburn.edu>
 194
 195         * loading.texi (Library Search): Correct default value of
 196         load-suffixes.
 197         (Named Features): Fix typo.
 198
 199 2003-10-05  Richard M. Stallman  <rms@gnu.org>
 200
 201         * loading.texi (Named Features): In `provide',
 202         say how to test for subfeatures.
 203         (Unloading): In unload-feature, use new var name
 204         unload-feature-special-hooks.
 205
 206 2003-10-03  Lute Kamstra  <lute@gnu.org>
 207
 208         * modes.texi (Major Mode Conventions): Mention third way to set up
 209         Imenu.
 210         (Imenu): A number of small fixes.
 211         Delete documentation of internal variable imenu--index-alist.
 212         Document the return value format of imenu-create-index-function
 213         functions.
 214
 215 2003-09-30  Richard M. Stallman  <rms@gnu.org>
 216
 217         * processes.texi (Network): Say what stopped datagram connections do.
 218
 219         * lists.texi (Association Lists): Clarify `assq-delete-all'.
 220
 221         * display.texi (Overlay Properties): Clarify `evaporate' property.
 222
 223 2003-09-29  Lute Kamstra  <lute@gnu.org>
 224
 225         * modes.texi (Mode Line Data): Explain when symbols in mode-line
 226         constructs should be marked as risky.
 227         Change cons cell into proper list.
 228         (Mode Line Variables): Change cons cell into proper list.
 229
 230 2003-09-26  Lute Kamstra  <lute@gnu.org>
 231
 232         * modes.texi (Mode Line Data): Document the :propertize construct.
 233         (Mode Line Variables): Reorder the descriptions of the variables
 234         to match their order in the default mode-line-format.
 235         Describe the new variables mode-line-position and mode-line-modes.
 236         Update the default values of mode-line-frame-identification,
 237         minor-mode-alist, and default-mode-line-format.
 238         (Properties in Mode): Mention the :propertize construct.
 239
 240 2003-09-26  Richard M. Stallman  <rms@gnu.org>
 241
 242         * buffers.texi, commands.texi, debugging.texi, eval.texi:
 243         * loading.texi, minibuf.texi, text.texi, variables.texi:
 244         Avoid @strong{Note:}.
 245
 246 2003-09-26  Richard M. Stallman  <rms@gnu.org>
 247
 248         * keymaps.texi (Remapping Commands): Fix typo.
 249
 250 2003-09-23  Luc Teirlinck  <teirllm@mail.auburn.edu>
 251
 252         * processes.texi (Low-Level Network): Fix typo.
 253
 254 2003-09-23  Kim F. Storm  <storm@cua.dk>
 255
 256         * processes.texi (Network, Network Servers): Fix typos.
 257         (Low-Level Network): Add timeout value for :server keyword.
 258         Add new option keywords to make-network-process.
 259         Add set-network-process-options.
 260         Explain how to test availability of network options.
 261
 262 2003-09-19  Richard M. Stallman  <rms@gnu.org>
 263
 264         * text.texi (Motion by Indent): Arg to
 265         backward-to-indentation and forward-to-indentation is optional.
 266
 267         * strings.texi (Creating Strings): Add substring-no-properties.
 268
 269         * processes.texi
 270         (Process Information): Add list-processes arg QUERY-ONLY.
 271         Delete process-contact from here.
 272         Add new status values for process-status.
 273         Add process-get, process-put, process-plist, set-process-plist.
 274         (Synchronous Processes): Add call-process-shell-command.
 275         (Signals to Processes): signal-process allows process objects.
 276         (Network): Complete rewrite.
 277         (Network Servers, Datagrams, Low-Level Network): New nodes.
 278
 279         * positions.texi (Word Motion): forward-word, backward-word
 280         arg is optional.  Reword.
 281
 282         * abbrevs.texi (Defining Abbrevs): Index no-self-insert.
 283
 284         * variables.texi (Creating Buffer-Local):
 285         Delete duplicate definition of buffer-local-value.
 286         (File Local Variables): Explain about discarding text props.
 287
 288 2003-09-11  Richard M. Stallman  <rms@gnu.org>
 289
 290         * minibuf.texi (Intro to Minibuffers): Explain that the minibuffer
 291         changes variables that record input events.
 292         (Minibuffer Misc): Add minibuffer-selected-window.
 293
 294         * lists.texi (Building Lists): Add copy-tree.
 295
 296         * display.texi (Fontsets): Add char-displayable-p.
 297         (Scroll Bars): New node.
 298
 299 2003-09-08  Lute Kamstra  <lute@gnu.org>
 300
 301         * modes.texi (%-Constructs): Document new `%i' and `%I'
 302         constructs.
 303
 304 2003-09-03  Peter Runestig  <peter@runestig.com>
 305
 306         * makefile.w32-in: New file.
 307
 308 2003-08-29  Richard M. Stallman  <rms@gnu.org>
 309
 310         * display.texi (Overlay Properties): Clarify how priorities
 311         affect use of the properties.
 312
 313 2003-08-19  Luc Teirlinck  <teirllm@mail.auburn.edu>
 314
 315         * customize.texi (Type Keywords): Correct the description of
 316         `:help-echo' in the case where `motion-doc' is a function.
 317
 318 2003-08-14  John Paul Wallington  <jpw@gnu.org>
 319
 320         * modes.texi (Emulating Mode Line): Subsection, not section.
 321
 322 2003-08-13  Richard M. Stallman  <rms@gnu.org>
 323
 324         * elisp.texi (Top): Update subnode lists in menu.
 325
 326         * text.texi (Insertion): Add insert-buffer-substring-no-properties.
 327         (Kill Functions): kill-region has new arg yank-handler.
 328         (Yanking): New node.
 329         (Yank Commands): Add yank-undo-function.
 330         (Low-Level Kill Ring):
 331         kill-new and kill-append have new arg yank-handler.
 332         (Changing Properties): Add remove-list-of-text-properties.
 333         (Atomic Changes): New node.
 334
 335         * symbols.texi (Other Plists): Add lax-plist-get, lax-plist-put.
 336
 337         * streams.texi (Output Variables): Add eval-expression-print-length
 338         and eval-expression-print-level.
 339
 340         * os.texi (Time Conversion): For encode-time, explain limits on year.
 341
 342         * objects.texi (Character Type): Define anchor "modifier bits".
 343
 344         * modes.texi (Emulating Mode Line): New node.
 345         (Search-based Fontification): Font Lock uses font-lock-face property.
 346         (Other Font Lock Variables): Likewise.
 347
 348         * keymaps.texi (Format of Keymaps): Keymaps contain char tables,
 349         not vectors.
 350         (Active Keymaps): Add emulation-mode-map-alists.
 351         (Functions for Key Lookup): key-binding has new arg no-remap.
 352         (Remapping Commands): New node.
 353         (Scanning Keymaps): where-is-internal has new arg no-remap.
 354         (Tool Bar): Add tool-bar-local-item-from-menu.
 355         Clarify when to use tool-bar-add-item-from-menu.
 356
 357         * commands.texi (Interactive Call): commandp has new arg.
 358         (Command Loop Info): Add this-original-command.
 359
 360 2003-08-06  John Paul Wallington  <jpw@gnu.org>
 361
 362         * compile.texi (Compiler Errors): Say `@end defmac' after `@defmac'.
 363
 364         * display.texi (Warning Basics): Fix typo.
 365         (Fringes): Add closing curly bracket and fix typo.
 366
 367         * elisp.texi (Top): Fix typo.
 368
 369 2003-08-05  Richard M. Stallman  <rms@gnu.org>
 370
 371         * elisp.texi: Update lists of subnodes.
 372
 373         * windows.texi (Buffers and Windows): set-window-buffer has new arg.
 374
 375         * variables.texi (Local Variables): Use lc for example variable names.
 376
 377         * tips.texi (Library Headers): Explain where to put -*-.
 378
 379         * strings.texi (Creating Strings): Fix xref for vconcat.
 380
 381         * sequences.texi (Vector Functions):
 382         vconcat no longer allows integer args.
 383
 384         * minibuf.texi (Reading File Names): read-file-name has new
 385         arg PREDICATE.  New function read-directory-name.
 386
 387         * macros.texi (Defining Macros): Give definition of `declare'
 388         (Indenting Macros): New node.
 389
 390         * frames.texi (Parameter Access): Add modify-all-frames-parameters.
 391         (Window Frame Parameters): Make separate table of parameters
 392         that are coupled with specific face attributes.
 393         (Deleting Frames): delete-frame-hooks renamed to
 394         delete-frame-functions.
 395
 396         * files.texi (Magic File Names): Add file-remote-p.
 397         Clarify file-local-copy.
 398
 399         * edebug.texi (Instrumenting Macro Calls): Don't define `declare'
 400         here; instead xref Defining Macros.
 401
 402         * display.texi (Warnings): New node, and subnodes.
 403         (Fringes): New node.
 404
 405         * debugging.texi (Test Coverage): New node.
 406
 407         * compile.texi (Compiler Errors): Explain with-no-warnings
 408         and other ways to suppress warnings.
 409
 410         * commands.texi (Interactive Call): Minor clarification.
 411
 412         * buffers.texi (Buffer File Name): set-visited-file-name
 413         renames the buffer too.
 414
 415         * abbrevs.texi (Abbrev Tables): Add copy-abbrev-table.
 416
 417 2003-07-24  Markus Rost  <rost@math.ohio-state.edu>
 418
 419         * abbrevs.texi (Abbrev Expansion): Use \s syntax in example.
 420
 421 2003-07-22  Markus Rost  <rost@math.ohio-state.edu>
 422
 423         * internals.texi (Garbage Collection): Fix previous change.
 424
 425 2003-07-22  Richard M. Stallman  <rms@gnu.org>
 426
 427         * files.texi (Truenames): Add LIMIT arg to file-chase-links.
 428
 429         * display.texi (Width): Use \s syntax in example.
 430         (Font Selection): Add face-font-rescale-alist.
 431
 432         * modes.texi (Imenu): Add xref to Emacs Manual node on Imenu.
 433         Remove spurious indent in example.
 434
 435         * lists.texi (Building Lists): Add number-sequence.
 436
 437         * internals.texi (Garbage Collection): Add gcs-done, gc-elapsed.
 438
 439         * functions.texi (Function Documentation): Explain how to
 440         show calling convention explicitly in the doc string.
 441
 442         * windows.texi (Selecting Windows): save-selected-window saves
 443         selected window of each frame.
 444         (Window Configurations): Minor change.
 445
 446         * syntax.texi (Syntax Table Functions): Use \s syntax in examples.
 447
 448         * streams.texi (Output Variables): Add print-continuous-numbering
 449         and print-number-table.
 450
 451         * processes.texi (Decoding Output): New node.
 452
 453         * os.texi (Time Conversion): decode-time arg is optional.
 454
 455         * objects.texi (Character Type): Don't use space as example for \.
 456         Make list of char names and \-sequences correspond.
 457         Explain that \s is not used in strings.  `\ ' needs space after.
 458
 459         * nonascii.texi (Converting Representations): Add string-to-multibyte.
 460         (Translation of Characters): Add translation-table-for-input.
 461         (Default Coding Systems): Add auto-coding-functions.
 462         (Explicit Encoding): Add decode-coding-inserted-region.
 463         (Locales): Add locale-info.
 464
 465         * minibuf.texi (Basic Completion): Describe test-completion.
 466         Collections can be lists of strings.
 467         Clean up lazy-completion-table.
 468         (Programmed Completion): Mention test-completion.
 469         Clarify why lambda expressions are not accepted.
 470         (Minibuffer Misc): Describe minibufferp.
 471
 472 2003-07-14  Richard M. Stallman  <rms@gnu.org>
 473
 474         * buffers.texi (Killing Buffers): kill-buffer-hook is perm local.
 475
 476         * windows.texi (Selecting Windows): New arg to select-window.
 477         (Selecting Windows): Add with-selected-window.
 478         (Size of Window): Add window-inside-edges, etc.
 479
 480         * internals.texi (Garbage Collection): Add post-gc-hook.
 481
 482         * processes.texi (Subprocess Creation): Add exec-suffixes.
 483
 484         * keymaps.texi (Functions for Key Lookup): Add current-active-maps.
 485         (Scanning Keymaps): Add map-keymaps.
 486         (Defining Menus): Add keymap-prompt.
 487
 488         * numbers.texi (Integer Basics): Add most-positive-fixnum,
 489         most-negative-fixnum.
 490
 491         * compile.texi (Byte Compilation): Explain no-byte-compile
 492         (Compiler Errors): New node.
 493
 494         * os.texi (User Identification): user-uid, user-real-uid
 495         can return float.
 496
 497         * modes.texi (Major Mode Conventions): Explain about run-mode-hooks
 498         and about derived modes.
 499         (Minor Modes): Add minor-mode-list.
 500         (Defining Minor Modes): Keyword args for define-minor-mode.
 501         (Search-based Fontification): Explain managing other properties.
 502         (Other Font Lock Variables): Add font-lock-extra-managed-props.
 503         (Faces for Font Lock): Add font-locl-preprocessor-face.
 504         (Hooks): Add run-mode-hooks and delay-mode-hooks.
 505
 506         * variables.texi (Creating Buffer-Local): Add buffer-local-value.
 507         (Variable Aliases): Clarify defvralias.
 508
 509         * loading.texi (Library Search): Add load-suffixes.
 510
 511         * minibuf.texi (Basic Completion): Add lazy-completion-table.
 512         (Programmed Completion): Add dynamic-completion-table.
 513
 514         * files.texi (Changing Files): copy-file allows dir as NEWNAME.
 515         (Magic File Names): Specify precedence order of handlers.
 516 o
 517         * commands.texi (Command Overview): Emacs server runs pre-command-hook
 518         and post-command-hook.
 519         (Waiting): New calling convention for sit-for.
 520
 521         * text.texi (Special Properties): local-map and keymap properties
 522         apply based on their stickiness.
 523
 524 2003-07-07  Richard M. Stallman  <rms@gnu.org>
 525
 526         * modes.texi (Minor Mode Conventions): Specify only some kinds
 527         of list values as args to minor modes.
 528
 529         * files.texi (File Name Expansion): Warn about iterative use
 530         of substitute-in-file-name.
 531
 532         * advice.texi (Activation of Advice): Clean up previous change.
 533
 534 2003-07-06  Markus Rost  <rost@math.ohio-state.edu>
 535
 536         * advice.texi (Activation of Advice): Note that ad-start-advice is
 537         turned on by default.
 538
 539 2003-06-30  Richard M. Stallman  <rms@gnu.org>
 540
 541         * text.texi (Buffer Contents): Document current-word.
 542         (Change Hooks): Not called for *Messages*.
 543
 544         * functions.texi (Defining Functions): Explain about redefining
 545         primitives.
 546         (Function Safety): Renamed.  Minor changes.
 547         Comment out the detailed criteria for what is safe.
 548
 549 2003-06-22  Andreas Schwab  <schwab@suse.de>
 550
 551         * objects.texi (Symbol Type): Fix description of examples.
 552
 553 2003-06-16  Andreas Schwab  <schwab@suse.de>
 554
 555         * hash.texi (Creating Hash): Fix description of :weakness.
 556
 557 2003-06-13  Kai Gro\e,A_\e(Bjohann  <kai.grossjohann@gmx.net>
 558
 559         * files.texi (Changing Files): copy-file copies file modes, too.
 560
 561 2003-05-28  Richard M. Stallman  <rms@gnu.org>
 562
 563         * strings.texi (Creating Strings): Clarify split-string.
 564
 565 2003-05-22  Stephen J. Turnbull  <stephen@xemacs.org>
 566
 567         * strings.texi (Creating Strings): Update split-string specification
 568         and examples.
 569
 570 2003-05-19  Richard M. Stallman  <rms@gnu.org>
 571
 572         * elisp.texi: Correct invariant section names.
 573
 574 2003-04-20  Richard M. Stallman  <rms@gnu.org>
 575
 576         * os.texi (Timers): Explain about timers and quitting.
 577
 578 2003-04-19  Richard M. Stallman  <rms@gnu.org>
 579
 580         * internals.texi (Writing Emacs Primitives): Strings are
 581         no longer special for GCPROs.  Mention GCPRO5, GCPRO6.
 582         Explain GCPRO convention for varargs function args.
 583
 584 2003-04-16  Richard M. Stallman  <rms@gnu.org>
 585
 586         * minibuf.texi (Minibuffer Misc): Document fn minibuffer-message.
 587
 588 2003-04-08  Richard M. Stallman  <rms@gnu.org>
 589
 590         * files.texi (Kinds of Files): Correct return value of file-symlink-p.
 591
 592 2003-02-13  Kim F. Storm  <storm@cua.dk>
 593
 594         * objects.texi (Character Type): New \s escape for space.
 595
 596 2003-01-31  Joe Buehler  <jhpb@draco.hekimian.com>
 597
 598         * os.texi (System Environment): Added cygwin system-type.
 599
 600 2003-01-25  Richard M. Stallman  <rms@gnu.org>
 601
 602         * keymaps.texi: Document that a symbol can act as a keymap.
 603
 604 2003-01-13  Richard M. Stallman  <rms@gnu.org>
 605
 606         * text.texi (Changing Properties): Say string indices are origin-0.
 607
 608         * positions.texi (Screen Lines) <compute-motion>:
 609         Correct order of elts in return value.
 610
 611         * keymaps.texi (Changing Key Bindings) <define-key>: Mention
 612         how to define a default binding.
 613
 614 2002-12-07  Markus Rost  <rost@math.ohio-state.edu>
 615
 616         * loading.texi (Unloading): Fix recent change for load-history.
 617
 618         * customize.texi (Simple Types): Clarify description of custom
 619         type 'number. Describe new custom type 'float.
 620
 621 2002-12-04  Markus Rost  <rost@math.ohio-state.edu>
 622
 623         * variables.texi (File Local Variables): Fix typo.
 624
 625 2002-10-23  Kai Gro\e,A_\e(Bjohann  <kai.grossjohann@uni-duisburg.de>
 626
 627         From Michael Albinus <Michael.Albinus@alcatel.de>.
 628
 629         * README: Target for Info file is `make info'.
 630
 631         * files.texi (File Name Components): Fixed typos in
 632         `file-name-sans-extension'.
 633         (Magic File Names): Complete list of operations for magic file
 634         name handlers.
 635
 636 2002-09-16  Jonathan Yavner  <jyavner@engineer.com>
 637
 638         * variables.texi (File Local Variables): New function
 639         risky-local-variable-p.
 640
 641 2002-09-15  Jonathan Yavner  <jyavner@engineer.com>
 642
 643         * functions.texi (Function safety): New node about unsafep.
 644
 645 2002-08-05  Per Abrahamsen  <abraham@dina.kvl.dk>
 646
 647         * customize.texi (Splicing into Lists): Fixed example.
 648         Reported by Fabrice Bauzac <fabrice.bauzac@wanadoo.fr>
 649
 650 2002-06-17  Juanma Barranquero  <lektu@terra.es>
 651
 652         * frames.texi (Display Feature Testing): Fix typo.
 653
 654 2002-06-12  Andreas Schwab  <schwab@suse.de>
 655
 656         * frames.texi (Initial Parameters, Resources): Fix references to
 657         the Emacs manual.
 658
 659 2002-05-13  Kim F. Storm  <storm@cua.dk>
 660
 661         * variables.texi (Intro to Buffer-Local): Updated warning and
 662         example relating to changing buffer inside let.
 663
 664 2002-03-10  Jan Dj\e,Ad\e(Brv  <jan.h.d@swipnet.se>
 665
 666         * os.texi (Session Management): New node about X Session management.
 667
 668 2002-01-18  Eli Zaretskii  <eliz@is.elta.co.il>
 669
 670         * elisp.texi (VERSION): Set to 2.9.  Update the version of Emacs
 671         to which the manual corresponds, and the copyright years.
 672
 673         * Makefile.in (VERSION): Set to 2.9.
 674
 675 2001-11-29  Eli Zaretskii  <eliz@is.elta.co.il>
 676
 677         * elisp.texi: Change the category in @dircategory to "Emacs", to
 678         make it consistent with info/dir.
 679
 680 2001-11-25  Miles Bader  <miles@gnu.org>
 681
 682         * text.texi (Fields): Describe new `limit' arg in
 683         field-beginning/field-end.
 684
 685 2001-11-17  Eli Zaretskii  <eliz@is.elta.co.il>
 686
 687         * permute-index: Don't depend on csh-specific features.  Replace
 688         the interpreter name with /bin/sh.
 689
 690         * two-volume-cross-refs.txt: New file.
 691         * two.el: New file.
 692         * spellfile: New file.
 693
 694 2001-11-16  Eli Zaretskii  <eliz@is.elta.co.il>
 695
 696         * permute-index: New file.
 697
 698         * vol1.texi, vol2.texi: Renamed from elisp-vol1.texi and
 699         elisp-vol2.texi, respectively, to avoid file-name clashes in DOS
 700         8+3 restricted namespace.
 701
 702         * Makefile.in (infodir): Define relative to $(srcdir).
 703         ($(infodir)/elisp): Don't chdir into $(srcdir), but add it to the
 704         include directories list via -I switch to makeinfo.
 705         (index.texi): Use cp if both hard and symbolic links fail.
 706
 707 2001-11-10  Eli Zaretskii  <eliz@is.elta.co.il>
 708
 709         * Makefile.in (distclean): Add.
 710
 711         The following changes make ELisp manual part of the Emacs
 712         distribution:
 713
 714         * Makefile.in: Add Copyright notice.
 715         (prefix): Remove.
 716         (infodir): Change value to "../info".
 717         (VPATH): New variable.
 718         (MAKE): Don't define.
 719         (texmacrodir): Don't define.
 720         (texinputdir): Append the existing value of TEXINPUTS.
 721         ($(infodir)/elisp): Instead of just "elisp".  Reformat the
 722         command to be compatible with man/Makefile.in, and to put the
 723         output into ../info.
 724         (info): Add target.
 725         (installall): Target removed.
 726
 727 2001-10-31  Pavel Jan\e,Bm\e(Bk  <Pavel@Janik.cz>
 728
 729         * tips.texi (Coding Conventions): Fix typo.
 730
 731 2001-10-23  Gerd Moellmann  <gerd@gnu.org>
 732
 733         * Makefile.in (srcs): Add gpl.texi and doclicense.texi.
 734
 735 2001-10-22  Eli Zaretskii  <eliz@is.elta.co.il>
 736
 737         * files.texi (File Name Components): Update the description of
 738         file-name-sans-extension and file-name-extension, as they now
 739         ignore leading dots.
 740
 741 2001-10-20  Gerd Moellmann  <gerd@gnu.org>
 742
 743         * (Version 21.1 released.)
 744
 745 2001-10-19  Miles Bader  <miles@gnu.org>
 746
 747         * positions.texi (Text Lines): Describe behavior of
 748         `beginning-of-line'/`end-of-line' in the presence of field properties.
 749
 750 2001-10-17  Gerd Moellmann  <gerd@gnu.org>
 751
 752         * Makefile.in (VERSION): Set to 2.8.
 753         (manual): Use `manual-21'.
 754
 755         * elisp.texi (VERSION): Add and use it where the version
 756         number was used.  Set it to 2.8.
 757
 758         * intro.texi: Likewise.
 759
 760 2001-10-13  Eli Zaretskii  <eliz@is.elta.co.il>
 761
 762         * files.texi (File Name Completion): Document the significance of
 763         a trailing slash in elements of completion-ignored-extensions.
 764
 765 2001-10-06  Miles Bader  <miles@gnu.org>
 766
 767         * variables.texi (Variable Aliases): It's `@defmac', not `@defmacro'.
 768
 769 2001-10-04  Gerd Moellmann  <gerd@gnu.org>
 770
 771         * variables.texi (Variable Aliases): New node.
 772
 773 2001-10-04  Gerd Moellmann  <gerd@gnu.org>
 774
 775         * Branch for 21.1.
 776
 777 2001-10-02  Miles Bader  <miles@gnu.org>
 778
 779         * minibuf.texi (Minibuffer Misc): Add entries for
 780         `minibuffer-contents', `minibuffer-contents-no-properties', and
 781         `delete-minibuffer-contents'.
 782         Correct description for `minibuffer-prompt-end'.
 783
 784         * text.texi (Property Search): Correct descriptions of
 785         `next-char-property-change' and `previous-char-property-change'.
 786         Add entries for `next-single-char-property-change' and
 787         `previous-single-char-property-change'.
 788         Make operand names a bit more consistent.
 789
 790 2001-09-30  Eli Zaretskii  <eliz@is.elta.co.il>
 791
 792         * frames.texi (Finding All Frames): Document that next-frame and
 793         previous-frame are local to current terminal.
 794
 795 2001-09-26  Eli Zaretskii  <eliz@is.elta.co.il>
 796
 797         * keymaps.texi (Creating Keymaps): Fix the description of the
 798         result of make-keymap.
 799
 800 2001-09-23  Eli Zaretskii  <eliz@is.elta.co.il>
 801
 802         * display.texi (Font Lookup, Attribute Functions)
 803         (Image Descriptors): Add cross-references to the definition of
 804         selected frame.
 805
 806         * buffers.texi (The Buffer List): Add cross-references to the
 807         definition of selected frame.
 808
 809         * frames.texi (Input Focus): Clarify which frame is _the_ selected
 810         frame at any given time.
 811         (Multiple Displays, Size and Position): Add a cross-reference to
 812         the definition of the selected frame.
 813
 814 2001-09-08  Eli Zaretskii  <eliz@is.elta.co.il>
 815
 816         * strings.texi (String Conversion) <string-to-number>: Document
 817         that a float is returned for integers that are too large.
 818
 819         * frames.texi (Mouse Position): Document mouse-position-function.
 820         (Display Feature Testing): Document display-images-p.
 821         (Window Frame Parameters): Document the cursor-type variable.
 822
 823         * numbers.texi (Integer Basics): Document CL style read syntax for
 824         integers in bases other than 10.
 825
 826         * positions.texi (List Motion): Document
 827         open-paren-in-column-0-is-defun-start.
 828
 829         * lists.texi (Sets And Lists): Document member-ignore-case.
 830
 831         * internals.texi (Garbage Collection): Document the used and free
 832         strings report.
 833         (Memory Usage): Document strings-consed.
 834
 835         * os.texi (Time of Day): Document float-time.
 836         (Recording Input): Document that clear-this-command-keys clears
 837         the vector to be returned by recent-keys.
 838
 839         * keymaps.texi (Scanning Keymaps) <where-is-internal>: The
 840         argument keymap can be a list.
 841
 842         * nonascii.texi (User-Chosen Coding Systems)
 843         <select-safe-coding-system>: Document the new argument
 844         accept-default-p and the variable
 845         select-safe-coding-system-accept-default-p.  Tell what happens if
 846         buffer-file-coding-system is undecided.
 847         (Default Coding Systems): Document auto-coding-regexp-alist.
 848
 849         * display.texi (The Echo Area) <message>: Document
 850         message-truncate-lines.
 851         (Glyphs): Document that the glyph table is unused on windowed
 852         displays.
 853
 854         * help.texi (Describing Characters) <single-key-description>:
 855         Document the new argument no-angles.
 856         (Accessing Documentation) <documentation-property>: Document that
 857         a non-string property is evaluated.
 858         <documentation>: Document that the function-documentation property
 859         is looked for.
 860
 861         * windows.texi (Selecting Windows): Document some-window.
 862
 863         * text.texi (MD5 Checksum): New node, documents the md5 primitive.
 864
 865         * hooks.texi (Standard Hooks): Add kbd-macro-termination-hook and
 866         apropos-mode-hook.
 867
 868         * commands.texi (Using Interactive): Document interactive-form.
 869         (Keyboard Macros): Document kbd-macro-termination-hook.
 870         (Command Loop Info): Document that clear-this-command-keys clears
 871         the vector to be returned by recent-keys.
 872
 873 2001-09-04  Werner LEMBERG  <wl@gnu.org>
 874
 875         * Makefile.in (srcdir, texinputdir): New variables.
 876         (srcs, index.texi, install): Use $(srcdir).
 877         (.PHONY): Remove elisp.dvi.
 878         (elisp): Use -I switch for makeinfo.
 879         (elisp.dvi): Use $(srcdir) and $(texinputdir).
 880         (installall, dist): Use $(srcdir).
 881         Fix path to texinfo.tex.
 882         (maintainer-clean): Add elisp.dvi and elisp.oaux.
 883
 884 2001-08-30  Gerd Moellmann  <gerd@gnu.org>
 885
 886         * display.texi (Conditional Display): Adjust to API change.
 887
 888         * configure: New file.
 889
 890 2001-07-30  Gerd Moellmann  <gerd@gnu.org>
 891
 892         * commands.texi (Repeat Events): Add description of
 893         double-click-fuzz.
 894
 895 2001-05-08  Stefan Monnier  <monnier@cs.yale.edu>
 896
 897         * syntax.texi (Syntax Class Table): Add the missing designator for
 898         comment and string fences.
 899         (Syntax Properties): Add a xref to syntax table internals.
 900         (Syntax Table Internals): Document string-to-syntax.
 901
 902 2001-05-07  Gerd Moellmann  <gerd@gnu.org>
 903
 904         * Makefile.in (install): Use install-info command line options
 905         like in Emacs' Makefile.in.
 906
 907 2000-12-09  Miles Bader  <miles@gnu.org>
 908
 909         * windows.texi (Window Start): Update documentation for
 910         `pos-visible-in-window-p'.
 911
 912 2000-11-12  Stefan Monnier  <monnier@cs.yale.edu>
 913
 914         * lists.texi (Building Lists): Add footnote to explain how to add
 915         to the end of a list.
 916
 917 2000-10-25  Gerd Moellmann  <gerd@gnu.org>
 918
 919         * files.texi (Visiting Functions): Typos.
 920
 921 2000-10-25  Kenichi Handa  <handa@etl.go.jp>
 922
 923         * files.texi (Visiting Functions): Return value of
 924         find-file-noselect may be a list of buffers if wildcards are used.
 925
 926 2000-10-24  Miles Bader  <miles@lsi.nec.co.jp>
 927
 928         * display.texi (Defining Faces): Document `graphic' display type
 929         in face specs.
 930
 931 2000-10-18  Kai Grossjohann  <Kai.Grossjohann@CS.Uni-Dortmund.DE>
 932
 933         * hooks.texi (Standard Hooks): Replace obsolete
 934         `after-make-frame-hook' with `after-make-frame-functions'.
 935
 936         * frames.texi (Creating Frames): Ditto.
 937
 938         * variables.texi (Future Local Variables): Ditto.
 939
 940 2000-10-16  Gerd Moellmann  <gerd@gnu.org>
 941
 942         * display.texi (Other Image Types): Add description of :foreground
 943         and :background properties of mono PBM images.
 944
 945 2000-08-17  Werner LEMBERG  <wl@gnu.org>
 946
 947         * .cvsignore: New file.
 948
 949 2000-01-05  Gerd Moellmann  <gerd@gnu.org>
 950
 951         * tindex.pl: New script.
 952
 953 1999-12-03  Dave Love  <fx@gnu.org>
 954
 955         * Makefile.in (MAKEINFO): New parameter.
 956
 957 1999-09-17  Richard Stallman  <rms@gnu.org>
 958
 959         * Makefile.in (srcs): Add hash.texi.
 960         (VERSION): Update to 20.6.
 961
 962 1999-09-13  Richard Stallman  <rms@gnu.org>
 963
 964         * Makefile.in (index.texi): If cannot make a symlink, make a hard link.
 965
 966 1998-08-29  Karl Heuer  <kwzh@gnu.org>
 967
 968         * configure.in: New file.
 969         * Makefile.in: Renamed from Makefile.
 970         (prefix, infodir): Use value obtained from configure.
 971         (emacslibdir): Obsolete variable deleted.
 972         (dist): Distribute configure.in, configure, Makefile.in.
 973
 974 1998-06-12  Richard Stallman  <rms@psilocin.ai.mit.edu>
 975
 976         * Makefile (INSTALL_INFO): New variable.
 977         (install): Run install-info.
 978
 979 1998-05-09  Richard Stallman  <rms@psilocin.ai.mit.edu>
 980
 981         * Makefile (elisp.dvi): Add missing backslash.
 982
 983 1998-05-02  Richard Stallman  <rms@psilocin.gnu.org>
 984
 985         * Makefile (elisp.dvi): Don't depend on texindex or on elisp.tps.
 986         Run texindex without `./'.  Always run texindex on elisp.tp.
 987         (elisp.tps): Target deleted.
 988
 989 1998-04-05  Richard Stallman  <rms@psilocin.gnu.org>
 990
 991         * Makefile (srcs): Add nonascii.texi and customize.texi.
 992         (dist): Start by deleting `temp'.
 993
 994 1998-02-17  Richard Stallman  <rms@psilocin.gnu.org>
 995
 996         * Makefile (makeinfo, texindex): Targets deleted.
 997         (makeinfo.o, texindex.o): Targets deleted.
 998         (clean, dist): Don't do anything with them or with getopt*.
 999
1000 1998-01-30  Richard Stallman  <rms@psilocin.gnu.org>
1001
1002         * Makefile (SHELL): Defined.
1003
1004 1998-01-27  Richard Stallman  <rms@psilocin.gnu.org>
1005
1006         * Makefile (elisp.tps): New target.
1007         (elisp.dvi): Depend on elisp.tps.
1008
1009 Wed Apr  3 15:24:25 1996  Karl Heuer  <kwzh@gnu.ai.mit.edu>
1010
1011         * README: Update phone number.
1012
1013         * Makefile (elisp): Make this be the default target.
1014         Depend on makeinfo.c instead of makeinfo.
1015         (install): Don't depend on elisp.dvi, since we don't install that.
1016         Use mkinstalldirs.
1017         (dist): Add mkinstalldirs.
1018
1019 Mon Jun 19 14:35:26 1995  Richard Stallman  <rms@mole.gnu.ai.mit.edu>
1020
1021         * Makefile (VERSION): Update version number.
1022         (maintainer-clean): Renamed from realclean.
1023
1024 Wed Jun  7 17:04:59 1995  Karl Heuer  <kwzh@nutrimat.gnu.ai.mit.edu>
1025
1026         * Makefile (realclean): New target.
1027         (elisp): Remove any old elisp-* files first.
1028
1029 Tue Nov 23 19:59:40 1993  Noah Friedman  (friedman@nutrimat.gnu.ai.mit.edu)
1030
1031         * Makefile (VERSION): New variable.
1032         (dist): Make packaged directory name `elisp-manual-19-$(VERSION)'.
1033         Compressed file suffix should be `.gz', not `.z'.
1034
1035 Mon Nov 22 15:06:19 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
1036
1037         * Makefile (elisp): Depend on makeinfo.
1038
1039 Fri Nov 19 02:29:33 1993  Noah Friedman  (friedman@gnu.ai.mit.edu)
1040
1041         * Makefile (srcs): Add anti.texi.
1042
1043 Fri May 28 18:04:53 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
1044
1045         * Makefile (infodir, prefix): New vars.
1046         (install): Use infodir.
1047         (emacsinfodir): Deleted.
1048
1049 Thu May 27 02:11:25 1993  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
1050
1051         * Makefile (srcs): Add calendar.texi.
1052
1053         * Makefile (dist): Copy texindex.c and makeinfo.c.
1054         Limit elisp-* files to those with one or two digits.
1055
1056 Sun May 16 17:58:21 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)
1057
1058         * Makefile (dist): Changed to use Gzip instead of compress.
1059
1060 Fri Apr 23 01:05:23 1993  Eric S. Raymond  (eric@mole.gnu.ai.mit.edu)
1061
1062         * loading.texi (Unloading): define-function changed back to
1063         defalias.  It may not stay this way, but at least it's
1064         consistent with the known-good version of the code patch.
1065
1066 Fri Mar 26 21:14:54 1993  Eric S. Raymond  (eric@geech.gnu.ai.mit.edu)
1067
1068         * modes.texi (Hooks): Document new optional arg of add-hook.
1069
1070 Wed Mar 17 08:48:24 1993  Eric S. Raymond  (eric@mole.gnu.ai.mit.edu)
1071
1072         * variables.texi: Document nil initial value of buffer-local variables.
1073
1074         * tips.texi: Add new section on standard library headers.
1075
1076 Sat Feb 27 18:00:25 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)
1077
1078         * Makefile (srcs): Add frame.texi to the list of sources.
1079
1080 Tue Feb 23 10:50:25 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)
1081
1082         * Makefile (dist): Don't bother excluding autosave files; they'll
1083         never make it into the temp directory anyway, and the hash marks
1084         in the name are problematic for make and the Bourne shell.
1085         (srcs):
1086
1087 Fri Feb 12 16:54:38 1993  Jim Blandy  (jimb@wookumz.gnu.ai.mit.edu)
1088
1089         * Makefile (dist): Don't include backup files or autosave files in
1090         the distribution tar file.
1091
1092 Tue Nov 26 21:10:34 1991  Richard Stallman  (rms@mole.gnu.ai.mit.edu)
1093
1094         * Makefile (srcs): Added index.perm.
1095         (elisp.dvi): Remove erroneous shell comment.
1096         Expect output of permute-index in permuted.fns.
1097         Save old elisp.aux in elisp.oaux.
1098         (clean): Added index.texi to be deleted.
1099
1100 Sat Aug 11 17:39:10 1990  Richard Stallman  (rms@sugar-bombs.ai.mit.edu)
1101
1102         * Makefile (elisp.dvi, index.texi): Use shell if instead of ifdef.
1103
1104 Tue Jun 26 09:57:26 1990  David Lawrence  (tale@geech)
1105
1106         * files.texi:  Noted that completion-ignored-extensions is ignored
1107         when making *Completions*.
1108
1109 Fri Jun  8 16:44:44 EDT 1990 Jay Fenlason (hack@ai.mit.edu)
1110
1111         * Makefile  make dist now depends on elisp.dvi, since it tries
1112         to include it in the dist file.
1113
1114 Wed Mar 28 22:57:35 1990  Jim Kingdon  (kingdon@mole.ai.mit.edu)
1115
1116         * functions.texinfo (Mapping Functions): Add missing quote
1117
1118 Mon Jun 19 18:09:24 1989  Richard Stallman  (rms@sugar-bombs.ai.mit.edu)
1119
1120         * texinfo.tex (frenchspacing): Use decimal codes for char to be set.
1121         (defunargs): Turn off \hyphenchar of \sl font temporarily.
1122
1123 Wed May 10 18:01:17 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)
1124
1125         * @result{}, @expansion{}, @print{}, @quiv{}, @point{},
1126         and @error{} are the terms now being used.  The files in the
1127         directory have been changed to reflect this.
1128
1129         * All instances of @indentedresultt{} have been changed to
1130         `     @result{}', using 5 spaces at the begining of the line.
1131
1132 Mon Apr 24 21:02:55 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)
1133
1134         * @result{}, @expandsto{}, @prints{}, @quiv{}, @error{}, and the
1135         experimental @indentedresult{}, @indentedexpandsto{} are part of
1136         the texinfo.tex in this directory.  These TeX macros are not
1137         stable yet.
1138
1139 Mon Apr 17 18:56:50 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)
1140
1141         * texinfo.tex:  temporarily added
1142                 \let\result=\dblarrow
1143                 \def\error{{\it ERROR} \longdblarrow}
1144         We need to do this better soon.
1145
1146 Tue Apr 11 12:23:28 1989  Robert J. Chassell  (bob@rice-chex.ai.mit.edu)
1147
1148         * Applied Karl Berry's patches to *.texinfo files, but not to
1149         texinfo.tex; those diffs are in `berry-texinfo-tex-diffs'. (Karl's
1150         new title page format is also not applied, since it requires
1151         texinfo.tex changes.)
1152
1153         * Cleaned up `Makefile' and defined the `emacslibdir' directory
1154         for the Project GNU development environment.
1155
1156 ;; Local Variables:
1157 ;; coding: iso-2022-7bit
1158 ;; End:
1159
1160     Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
1161   Copying and distribution of this file, with or without modification,
1162   are permitted provided the copyright notice and this notice are preserved.
1163
1164 ;;; arch-tag: 985ae0ce-df29-475b-b3f8-4bbcbf6f7fda