1. 23 Feb, 2012 1 commit
  2. 21 Feb, 2012 1 commit
    • Chong Yidong's avatar
      Update Files chapter in Lisp manual. · a59225b1
      Chong Yidong authored
      * doc/lispref/files.texi (Files): Mention magic file names as arguments.
      (Reading from Files): Copyedits.
      (File Attributes): Mention how to change file modes.
      (Changing Files): Use standard "file permissions" terminology.
      Add xref to File Attributes node.
      (Locating Files): Document locate-user-emacs-file.
      (Unique File Names): Recommend against using make-temp-name.
      
      * src/buffer.c (Fget_file_buffer): Protect against invalid file
      handler return value.
      
      * src/fileio.c (Vfile_name_handler_alist): Doc fix.
      a59225b1
  3. 19 Feb, 2012 1 commit
    • Chong Yidong's avatar
      Updates to Documentation chapter of Lisp manual. · 8376d7c2
      Chong Yidong authored
      * doc/lispref/help.texi (Documentation, Documentation Basics, Help Functions):
      Minor clarifications.
      (Accessing Documentation): Clarify what documentation-property is
      for.  Add xref to Keys in Documentation.
      
      * doc/lispref/macros.texi (Defining Macros):
      * doc/lispref/modes.texi (Derived Modes): Say "documentation string" instead
      of docstring.
      
      * doc/lispref/tips.texi (Documentation Tips): Don't recommend using * in
      docstrings.
      8376d7c2
  4. 18 Feb, 2012 1 commit
  5. 17 Feb, 2012 2 commits
    • Chong Yidong's avatar
      Clarify doc of scan-lists. · 7b926f3f
      Chong Yidong authored
      * doc/lispref/syntax.texi (Motion via Parsing): Doc fix for scan-lists.
      
      * src/syntax.c (Fscan_lists): Doc fix.
      
      Fixes: debbugs:10833
      7b926f3f
    • Glenn Morris's avatar
      Fix cross-references between different manuals · 0fd2c9a3
      Glenn Morris authored
      * emacs/maintaining.texi (Old Revisions): Fix cross-refs to Ediff manual.
      
      * lispintro/emacs-lisp-intro.texi (Design @value{COUNT-WORDS}, Syntax)
      (count-words-in-defun): Fix cross-refs to Emacs manual.
      
      * lispref/hooks.texi (Standard Hooks): Fix cross-ref to Emacs manual.
      
      * misc/gnus.texi (Posting Styles):
      * misc/remember.texi (Org): Fix cross-refs to other manuals.
      0fd2c9a3
  6. 16 Feb, 2012 2 commits
    • Chong Yidong's avatar
      Update Syntax chapter of Lisp manual. · 4230351b
      Chong Yidong authored
      * doc/lispref/syntax.texi (Syntax Tables, Syntax Descriptors)
      (Syntax Table Functions): Copyedits.
      (Syntax Basics): Don't repeat the material in the preceding node.
      (Syntax Class Table): Use a table.
      (Syntax Properties): Document syntax-propertize-function and
      syntax-propertize-extend-region-functions.
      (Motion via Parsing): Fix indentation.
      (Parser State): Update for the new "c" comment style.  Fix
      description of item 7 (comment style).
      
      * doc/lispref/modes.texi (Syntactic Font Lock): Add xref to Syntactic Font Lock node.
      4230351b
    • Chong Yidong's avatar
      Updates to Font Lock docs in Lisp manual. · f700caa3
      Chong Yidong authored
      * doc/lispref/modes.texi (Minor Modes): Update how mode commands should treat
      arguments now.
      (Mode Line Basics): Clarify force-mode-line-update.
      (Mode Line Top): Note that the example is not realistic.
      (Mode Line Variables, Mode Line Data, %-Constructs, Header Lines)
      (Emulating Mode Line): Use "mode line" instead of "mode-line", and
      "mode line construct" instead of "mode line specification".
      (Syntactic Font Lock): Remove mention of obsolete variable
      font-lock-syntactic-keywords.
      (Setting Syntax Properties): Node deleted.
      (Font Lock Mode): Note that Font Lock mode is a minor mode.
      (Font Lock Basics): Note that syntactic fontification falls back
      on `syntax-table'.
      (Search-based Fontification): Emphasize that font-lock-keywords
      should not be set directly.
      (Faces for Font Lock): Avoid some confusing terminology.
      (Syntactic Font Lock): Minor clarifications.
      f700caa3
  7. 15 Feb, 2012 2 commits
    • Chong Yidong's avatar
      Docstring and manual updates for completion-at-point-functions. · 60236b0d
      Chong Yidong authored
      * doc/lispref/minibuf.texi (Basic Completion): Define "completion table".
      Move completion-in-region to Completion in Buffers node.
      (Completion Commands): Use "completion table" terminology.
      (Completion in Buffers): New node.
      
      * doc/lispref/modes.texi (Hooks): add-hook can be used for abnormal hooks too.
      (Setting Hooks): Update minor mode usage example.
      (Major Mode Conventions): Note that completion-at-point-functions
      should be altered locally.  Add xref to Completion in Buffers.
      
      * lisp/minibuffer.el (completion-at-point-functions): Doc fix.
      60236b0d
    • Glenn Morris's avatar
      * lispref/processes.texi (Network): Document open-network-stream :parameters. · d7dbb11a
      Glenn Morris authored
      * etc/NEWS: Related markup.
      d7dbb11a
  8. 14 Feb, 2012 1 commit
    • Chong Yidong's avatar
      Update Keymaps chapter of Lisp manual. · 3d8badf4
      Chong Yidong authored
      * doc/emacs/keymaps.texi (Format of Keymaps): The CACHE component of keymaps
      was removed on 2009-09-10.  Update lisp-mode-map example.
      (Inheritance and Keymaps): Minor clarification.
      (Searching Keymaps): Remove out-of-place enumeration.
      (Key Lookup): Remove unnecessary example (one was already given in
      Format of Keymaps).
      (Changing Key Bindings): Update suppress-keymap example.
      (Menu Bar, Tool Bar): Copyedits.
      (Tool Bar): Update tool-bar-map example.
      3d8badf4
  9. 12 Feb, 2012 1 commit
  10. 11 Feb, 2012 3 commits
    • Chong Yidong's avatar
      Improve fringe documentation in Lisp manual. · d860baa0
      Chong Yidong authored
      * doc/lispref/display.texi (Fringe Indicators): Add xref to Fringe Bitmaps.
      Move the list of standard bitmaps there.
      (Fringe Cursors): Rewrite for clarity.
      (Fringe Bitmaps): Consolidate the list of standard bitmaps here.
      d860baa0
    • Chong Yidong's avatar
      Update Command Loop chapter of Lisp manual. · 34106abe
      Chong Yidong authored
      * doc/emacs/commands.texi (Command Overview): Mention read-key.
      (Using Interactive, Interactive Call): Minor clarifications.
      (Function Keys, Click Events): Avoid "input stream" terminology.
      (Click Events): Add xref to Window Sizes and Accessing Mouse.
      Clarify column and row components.
      (Accessing Mouse): Add xref to Click Events.  Minor fixes.
      (Special Events): Copyedits.
      
      * doc/emacs/streams.texi (Input Streams): De-document get-file-char.
      (Output Variables): Don't refer to old backquote syntax.
      34106abe
    • Chong Yidong's avatar
      Update Debugging chapter of Lisp manual. · 355cabc6
      Chong Yidong authored
      * doc/emacs/debugging.texi (Debugging): Copyedits.  Describe testcover, ERT.
      (Error Debugging): Note that debug-ignored-errors overrides list
      values of debug-on-error too.  Add xref to Signaling Errors.  Note
      that debug-on-signal is not customizable.  Mention
      condition-case-unless-debug.
      (Compilation Errors): Node deleted.
      
      * doc/emacs/compile.texi (Compiler Errors): Move a paragraph here from
      deleted node Compilation Errors.
      355cabc6
  11. 10 Feb, 2012 6 commits
    • Leo Liu's avatar
      1be3ca5a
    • Chong Yidong's avatar
      Update Compilation and Advice chapters in Lisp manual. · 25dec365
      Chong Yidong authored
      * doc/lispref/advice.texi (Defining Advice): Clarify ad-unadvise.
      (Activation of Advice): Specifying the ACTIVATE flag in defadvice
      is not abnormal.
      (Advising Primitives): Node deleted; ad-define-subr-args has been
      removed.
      
      * doc/lispref/compile.texi (Speed of Byte-Code): Use float-time in example.
      (Compilation Functions): Note that the log uses Compilation mode.
      Don't discuss the contents of byte-code function object here.
      (Compilation Functions): De-document internal function byte-code.
      (Docs and Compilation): Minor clarifications.
      
      * doc/lispref/objects.texi (Byte-Code Type): Add xref to Byte-Code Function
      Objects.
      
      * lisp/emacs-lisp/advice.el: Update commentary to reflect deletion of
      ad-define-subr-args
      25dec365
    • Glenn Morris's avatar
      Document secure-hash · 5f5e4ea1
      Glenn Morris authored
      * doc/lispref/text.texi (Checksum/Hash): Rename node from MD5 Checksum.
      Mention secure-hash.
      * doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
      Update menu entry.
      * etc/NEWS: Related markup.
      5f5e4ea1
    • Glenn Morris's avatar
      Doc fixes for remote-file-name-inhibit-cache · b011fbfe
      Glenn Morris authored
      * doc/lispref/files.texi (Magic File Names):
      Tweak remote-file-name-inhibit-cache entry.
      * lisp/files.el (remote-file-name-inhibit-cache): Doc fixes.
      * etc/NEWS: Edits.
      b011fbfe
    • Chong Yidong's avatar
      Update Loading chapter of Emacs manual. · 6c1e4b46
      Chong Yidong authored
      * doc/emacs/loading.texi (Loading): Don't emphasize "library" terminology.
      (Library Search): load-path is not a user option.  Mention role of
      -L option and packages.  Improve examples.
      (Loading Non-ASCII): Don't mention unibyte Emacs, which is
      obsolete.
      (Autoload): Minor clarifications.
      6c1e4b46
    • Glenn Morris's avatar
      * doc/lispref/modes.texi (Basic Major Modes): Mention tabulated-list-mode. · 72ca698c
      Glenn Morris authored
      * etc/NEWS: Related markup.
      72ca698c
  12. 08 Feb, 2012 1 commit
  13. 07 Feb, 2012 4 commits
    • Glenn Morris's avatar
      Doc updates for define-minor-mode argument behavior · 60d47423
      Glenn Morris authored
      * doc/lispref/modes.texi (Defining Minor Modes):
      Expand on args of defined minor modes.
      * lisp/emacs-lisp/easy-mmode.el (define-minor-mode):
      Doc fixes for the macro and the mode it defines.
      60d47423
    • Chong Yidong's avatar
      Fix and doc-fix for `buffer-local-variables'. · 0992bd9c
      Chong Yidong authored
      * src/buffer.c (Fbuffer_local_variables)
      (buffer_lisp_local_variables): Handle unbound vars correctly;
      don't let Qunbound leak into Lisp.
      
      * doc/lispref/variables.texi (Creating Buffer-Local): Minor clarification
      to buffer-local-variables doc.
      
      Fixes: debbugs:10715
      0992bd9c
    • Glenn Morris's avatar
    • Glenn Morris's avatar
      imagemagick-render-type fixes · af008560
      Glenn Morris authored
      * src/image.c (imagemagick-render-type): Change it from a lisp object
      to an integer.  Move the doc here from the lisp manual.
      Treat all values not equal to 0 the same.
      
      * doc/lispref/display.texi (ImageMagick Images):
      Move most details of imagemagick-render-type to the variable's doc.
      
      * lisp/cus-start.el (imagemagick-render-type): Add it.
      af008560
  14. 06 Feb, 2012 4 commits
  15. 05 Feb, 2012 3 commits
    • Chong Yidong's avatar
      Update Customization chapter of Lisp manual. · e1161b06
      Chong Yidong authored
      * doc/lispref/customize.texi (Common Keywords): Minor clarifications.
      Document custom-unlispify-remove-prefixes.
      (Variable Definitions): Backquotes in defcustom seem to work fine
      now.  Various other copyedits.
      (Simple Types): Copyedits.  Document color selector.
      (Composite Types): Copyedits.
      (Splicing into Lists): Clarifications.
      e1161b06
    • Chong Yidong's avatar
      Updates to Macros and Customization chapters of Lisp manual. · 03988c98
      Chong Yidong authored
      * doc/lispref/customize.texi (Common Keywords): Minor clarifications.
      Document custom-unlispify-remove-prefixes.
      (Variable Definitions): Backquotes in defcustom seem to work fine
      now.  Various other copyedits.
      
      * doc/lispref/macros.texi (Expansion): Minor clarification.
      (Backquote): Move node to eval.texi.
      (Defining Macros): Move an example from Backquote node.
      (Argument Evaluation): No need to mention Pascal.
      (Indenting Macros): Add xref to Defining Macros.
      
      * doc/lispref/eval.texi (Backquote): Move from macros.texi.
      
      * lisp/custom.el (defcustom): Doc fix.
      03988c98
    • Glenn Morris's avatar
      More doc for debug-on-event. · 649f602c
      Glenn Morris authored
      * emacs/trouble.texi (Checklist): Mention debug-on-event.
      
      * lispref/debugging.texi (Error Debugging): Mention debug-on-event default.
      649f602c
  16. 04 Feb, 2012 6 commits
    • Glenn Morris's avatar
      Document revert-buffer-in-progress-p · 8f05da42
      Glenn Morris authored
      * doc/lispref/backups.texi (Reverting): Mention revert-buffer-in-progress-p.
      * lisp/files.el (revert-buffer): Doc fix (mention revert-buffer-in-progress-p).
      * etc/NEWS: Related markup.
      8f05da42
    • Glenn Morris's avatar
      Document debug-on-event · 7aa5aad8
      Glenn Morris authored
      * doc/lispref/debugging.texi (Error Debugging): Mention debug-on-event.
      * doc/lispref/commands.texi (Misc Events): Mention sigusr1,2 and debugging.
      * etc/NEWS: Related edit.
      7aa5aad8
    • Glenn Morris's avatar
      with-wrapper-hook doc clarifications · c7291ad9
      Glenn Morris authored
      * doc/lispref/modes.texi (Running Hooks): Try to clarify with-wrapper-hook.
      * lisp/subr.el (with-wrapper-hook): Doc fixes.
      c7291ad9
    • Glenn Morris's avatar
      Try to document filter-buffer-substring changes · 34c99998
      Glenn Morris authored
      * doc/lispref/text.texi (Buffer Contents):
      Update filter-buffer-substring description.
      
      * lisp/simple.el (filter-buffer-substring-functions)
      (buffer-substring-filters, filter-buffer-substring): Doc fixes.
      
      * etc/NEWS: Related edits.
      34c99998
    • Chong Yidong's avatar
      Update Functions chapter of Lisp manual; document closures. · 735cc5ca
      Chong Yidong authored
      * doc/emacs/functions.texi (What Is a Function): Add closures.  Mention
      "return value" terminology.  Add xref for command-execute.  Remove
      unused "keystroke command" terminology.
      (Lambda Expressions): Give a different example than in the
      following subsection.  Add xref to Anonymous Functions.
      (Function Documentation): Remove gratuitous markup.
      (Function Names): Move introductory text to `What Is a Function'.
      (Defining Functions): Fix defun argument spec.
      (Anonymous Functions): Document lambda macro explicitly.  Mention
      effects on lexical binding.
      (Function Cells): Downplay direct usage of fset.
      (Closures): New node.
      (Inline Functions): Remove "open-code" terminology.
      (Declaring Functions): Minor tweak; .m is not C code.
      
      * doc/emacs/variables.texi (Variables): Don't refer to "global value".
      (Local Variables, Void Variables): Copyedits.
      (Lexical Binding): Minor clarification of example.
      (File Local Variables): Mention :safe and :risky defcustom args.
      (Lexical Binding): Add xref to Closures node.
      735cc5ca
    • Glenn Morris's avatar
      * doc/lispref/minibuf.texi (High-Level Completion): Updates for read-color. · 94bc7984
      Glenn Morris authored
      * etc/NEWS: Likewise.
      94bc7984
  17. 03 Feb, 2012 1 commit
    • Glenn Morris's avatar
      Document animated image API · eea14f31
      Glenn Morris authored
      * doc/lispref/display.texi (GIF Images): Mention animation.
      Remove commented-out old example of animation.
      (Animated Images): New subsection.
      * doc/lispref/elisp.texi (Top):
      * doc/lispref/vol1.texi (Top):
      * doc/lispref/vol2.texi (Top): Add Animated Images menu entry.
      
      * lisp/image-mode.el (image-animate-loop, image-toggle-animation): Doc fixes.
      
      * lisp/image.el (image-animated-p): Doc fix.  Use image-animated-types.
      (image-animate-timeout): Doc fix.
      
      * etc/NEWS: Markup.
      eea14f31