diff options
Diffstat (limited to 'doc/lispref')
56 files changed, 320 insertions, 173 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 922147844bd..31c81e62ac1 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,95 @@ +2013-01-05 Glenn Morris <rgm@gnu.org> + + * display.texi (Overlay Properties): Mention field. (Bug#13364) + +2013-01-05 Eli Zaretskii <eliz@gnu.org> + + * hooks.texi (Standard Hooks): Use @item, not @itemx, as the first + directive in a group of items. + +2013-01-05 Chong Yidong <cyd@gnu.org> + + * keymaps.texi (Key Sequences): Remove obsolete sentence + (Bug#13356). + +2013-01-04 Ari Roponen <ari.roponen@gmail.com> (tiny change) + + * hash.texi (Defining Hash): Fix typo. (Bug#13345) + +2013-01-04 Stefan Monnier <monnier@iro.umontreal.ca> + + * files.texi (File Attributes): Undocument return format of file-acl. + +2013-01-03 Glenn Morris <rgm@gnu.org> + + * processes.texi (System Processes): + * syntax.texi (Syntax Table Functions): Tweak some line breaks. + + * searching.texi (Replacing Match): Fix xref. + + * elisp.texi (DATE): Bump to Jan 2013. + +2013-01-02 Glenn Morris <rgm@gnu.org> + + * customize.texi (Common Keywords, Type Keywords): + Replace "active field" with "button". (Bug#13310) + + * customize.texi (Common Keywords): Add xref. (Bug#13311) + * tips.texi (Library Headers): Add cindex. + +2012-12-30 Wolfgang Jenkner <wjenkner@inode.at> + + * functions.texi (Declare Form): + * intro.texi (A Sample Function Description): + * syntax.texi (Syntax Table Internals, Syntax Table Functions): + * variables.texi (Using Lexical Binding): Don't use @var or CAPS + in @def.. commands. (Bug#13292) + +2012-12-29 Eli Zaretskii <eliz@gnu.org> + + * files.texi (Changing Files): Document the return values of + set-file-selinux-context and set-file-acl. + +2012-12-27 Glenn Morris <rgm@gnu.org> + + * files.texi (File Names): Mention Cygwin conversion functions. + +2012-12-22 Martin Rudalics <rudalics@gmx.at> + + * windows.texi (Selecting Windows): Reword description of + select-window (Bug#13248). + +2012-12-22 Eli Zaretskii <eliz@gnu.org> + + * files.texi (File Attributes, Changing Files): Remove the details + about the text returned by file-acl. Instead, just document that + it is an opaque string meant to be used by set-file-acl. + +2012-12-21 Chong Yidong <cyd@gnu.org> + + * modes.texi (Auto Major Mode): Fix typo (Bug#13230). + + * customize.texi (Simple Types): Document key-sequence type + (Bug#13048). + + * strings.texi (Text Comparison): Doc fix for compare-strings. + +2012-12-19 Michael Albinus <michael.albinus@gmx.de> + + * files.texi (Magic File Names): Add `file-acl', + `file-selinux-context', `set-file-acl' and + `set-file-selinux-context'. Make the list consistent. + +2012-12-19 Jonas Bernoulli <jonas@bernoul.li> + + * tips.texi (Library Headers): New header keyword `Homepage'. + Make continuation lines syntax more precise. + +2012-12-17 Eli Zaretskii <eliz@gnu.org> + + * files.texi (File Attributes, Changing Files): Update to include + MS-Windows support for ACLs. + 2012-12-16 Romain Francoise <romain@orebokech.com> * files.texi (File Attributes): Document ACL support and new @@ -11865,7 +11957,7 @@ ;; coding: utf-8 ;; End: - Copyright (C) 1998-2012 Free Software Foundation, Inc. + Copyright (C) 1998-2013 Free Software Foundation, Inc. This file is part of GNU Emacs. diff --git a/doc/lispref/Makefile.in b/doc/lispref/Makefile.in index 626efc5b0e2..006c09d780c 100644 --- a/doc/lispref/Makefile.in +++ b/doc/lispref/Makefile.in @@ -1,6 +1,6 @@ # Makefile for the GNU Emacs Lisp Reference Manual. -# Copyright (C) 1990-1996, 1998-2012 Free Software Foundation, Inc. +# Copyright (C) 1990-1996, 1998-2013 Free Software Foundation, Inc. # This file is part of GNU Emacs. diff --git a/doc/lispref/README b/doc/lispref/README index 0230f4718c8..b94bd10789c 100644 --- a/doc/lispref/README +++ b/doc/lispref/README @@ -1,4 +1,4 @@ -Copyright (C) 2001-2012 Free Software Foundation, Inc. -*- outline -*- +Copyright (C) 2001-2013 Free Software Foundation, Inc. -*- outline -*- See the end of the file for license conditions. diff --git a/doc/lispref/abbrevs.texi b/doc/lispref/abbrevs.texi index 8a6dd05ded2..7cc558f9391 100644 --- a/doc/lispref/abbrevs.texi +++ b/doc/lispref/abbrevs.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 1999, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Abbrevs @chapter Abbrevs and Abbrev Expansion diff --git a/doc/lispref/advice.texi b/doc/lispref/advice.texi index 7b18852b1a1..e8d1bd3cdbc 100644 --- a/doc/lispref/advice.texi +++ b/doc/lispref/advice.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1998-1999, 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Advising Functions @chapter Advising Emacs Lisp Functions diff --git a/doc/lispref/anti.texi b/doc/lispref/anti.texi index 6ece2149733..577411ba9df 100644 --- a/doc/lispref/anti.texi +++ b/doc/lispref/anti.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1999, 2002-2012 Free Software Foundation, Inc. +@c Copyright (C) 1999, 2002-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @c This node must have no pointers. diff --git a/doc/lispref/back.texi b/doc/lispref/back.texi index 75c244ae1dd..ef20f8b79e0 100644 --- a/doc/lispref/back.texi +++ b/doc/lispref/back.texi @@ -1,6 +1,6 @@ \input texinfo @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @c @c %**start of header diff --git a/doc/lispref/backups.texi b/doc/lispref/backups.texi index be9563a7b4f..f2599c773ea 100644 --- a/doc/lispref/backups.texi +++ b/doc/lispref/backups.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1999, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Backups and Auto-Saving @chapter Backups and Auto-Saving diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi index 6462788b34e..7ed1876e4b1 100644 --- a/doc/lispref/buffers.texi +++ b/doc/lispref/buffers.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Buffers @chapter Buffers @@ -650,7 +650,7 @@ the last modification time of that directory, as recorded by Dired. For a new buffer visiting a not yet existing file, @var{high} is @minus{}1 and @var{low} is 65535, that is, @ifnottex -@w{2**16 - 1.} +@w{2**16 @minus{} 1.} @end ifnottex @tex @math{2^{16}-1}. diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi index f3b216e9353..f3589fc2edd 100644 --- a/doc/lispref/commands.texi +++ b/doc/lispref/commands.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Command Loop @chapter Command Loop @@ -2660,7 +2661,7 @@ The command @code{quoted-insert} uses this function. @cindex control characters, reading @cindex nonprinting characters, reading This function is like @code{read-char}, except that if the first -character read is an octal digit (0-7), it reads any number of octal +character read is an octal digit (0--7), it reads any number of octal digits (but stopping if a non-octal digit is found), and returns the character represented by that numeric character code. If the character that terminates the sequence of octal digits is @key{RET}, diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 7d5f3fcf7c5..d60ffebae70 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Byte Compilation @chapter Byte Compilation diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi index a6d3081c6ba..76a2f464792 100644 --- a/doc/lispref/control.texi +++ b/doc/lispref/control.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Control Structures @chapter Control Structures diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi index 56e091eabf2..e9260309057 100644 --- a/doc/lispref/customize.texi +++ b/doc/lispref/customize.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1997-2012 Free Software Foundation, Inc. +@c Copyright (C) 1997-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Customization @chapter Customization Settings @@ -77,7 +77,7 @@ item. Please don't overdo this, since the result would be annoying. @item :link @var{link-data} @kindex link@r{, customization keyword} Include an external link after the documentation string for this item. -This is a sentence containing an active field which references some +This is a sentence containing a button that references some other documentation. There are several alternatives you can use for @var{link-data}: @@ -101,7 +101,7 @@ Link to a web page; @var{url} is a string which specifies the @item (emacs-commentary-link @var{library}) Link to the commentary section of a library; @var{library} is a string -which specifies the library name. +which specifies the library name. @xref{Library Headers}. @item (emacs-library-link @var{library}) Link to an Emacs Lisp library file; @var{library} is a string which @@ -620,6 +620,11 @@ you can specify that the value must be @code{nil} or @code{t}, but also specify the text to describe each value in a way that fits the specific meaning of the alternative. +@item key-sequence +The value is a key sequence. The customization buffer shows the key +sequence using the same syntax as the @kbd{kbd} function. @xref{Key +Sequences}. + @item coding-system The value must be a coding-system name, and you can do completion with @kbd{M-@key{TAB}}. @@ -1077,8 +1082,7 @@ Substitute the item's documentation string. @item %h Like @samp{%d}, but if the documentation string is more than one line, -add an active field to control whether to show all of it or just the -first line. +add a button to control whether to show all of it or just the first line. @item %t Substitute the tag here. You specify the tag with the @code{:tag} diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi index 6e4f6628637..24629465525 100644 --- a/doc/lispref/debugging.texi +++ b/doc/lispref/debugging.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Debugging @chapter Debugging Lisp Programs diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 2063e2d2e49..cc6e980dadc 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Display @chapter Emacs Display @@ -1559,6 +1559,14 @@ mouse onto the text in the overlay, Emacs displays a help string in the echo area, or in the tooltip window. For details see @ref{Text help-echo}. +@item field +@kindex field @r{(overlay property)} +@c Copied from Special Properties. +Consecutive characters with the same @code{field} property constitute a +@emph{field}. Some motion functions including @code{forward-word} and +@code{beginning-of-line} stop moving at a field boundary. +@xref{Fields}. + @item modification-hooks @kindex modification-hooks @r{(overlay property)} This property's value is a list of functions to be called if any diff --git a/doc/lispref/edebug.texi b/doc/lispref/edebug.texi index 2e4eae2de42..8e394b5d92d 100644 --- a/doc/lispref/edebug.texi +++ b/doc/lispref/edebug.texi @@ -1,6 +1,7 @@ @comment -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1992-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1992-1994, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @c This file can also be used by an independent Edebug User diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index c56e5732dca..7ce0c01f3e5 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -56,7 +56,7 @@ @c (See comments for EDITION in emacs.texi) @set VERSION 3.1 @include emacsver.texi -@set DATE May 2012 +@set DATE January 2013 @c in general, keep the following line commented out, unless doing a @c copy of this manual that will be published. The manual should go @@ -98,7 +98,7 @@ This is the @cite{GNU Emacs Lisp Reference Manual} @end ifnottex corresponding to Emacs version @value{EMACSVER}. -Copyright @copyright{} 1990-1996, 1998-2012 Free Software Foundation, Inc. +Copyright @copyright{} 1990--1996, 1998--2013 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document diff --git a/doc/lispref/errors.texi b/doc/lispref/errors.texi index 04c8273cb77..3f3984e40d2 100644 --- a/doc/lispref/errors.texi +++ b/doc/lispref/errors.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1993, 1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1993, 1999, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Standard Errors @appendix Standard Errors diff --git a/doc/lispref/eval.texi b/doc/lispref/eval.texi index 670b293bea6..4b5ef187383 100644 --- a/doc/lispref/eval.texi +++ b/doc/lispref/eval.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 1998, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 1998, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Evaluation @chapter Evaluation diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 93bee961929..114eb1f38ea 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Files @chapter Files @@ -1356,24 +1356,17 @@ support, then the return value is @code{(nil nil nil nil)}. @cindex ACL entries If Emacs has been compiled with @dfn{ACL} (access control list) support, you can use the function @code{file-acl} to retrieve a file's -ACL entries. The format is platform-specific; on GNU/Linux and BSD, -Emacs uses the POSIX ACL interface. For the function -@code{set-file-acl}, see @ref{Changing Files}. +ACL entries. The interface implementation is platform-specific; on +GNU/Linux and BSD, Emacs uses the POSIX ACL interface, while on +MS-Windows Emacs emulates the POSIX ACL interface with native file +security APIs. @defun file-acl filename -This function returns the ACL entries of the file @var{filename}. -The return value is a string containing the textual representation of -the ACL entries, like the following: - -@example -@group -user::rw- -group::r-- -group:gnu:rwx -mask::rwx -other::r-- -@end group -@end example +This function returns the ACL entries of the file @var{filename}. The +return value is a platform-dependent object containing some +representation of the ACL entries. Don't use it for anything except +passing it to the @code{set-file-acl} function (@pxref{Changing Files, +set-file-acl}). If the file does not exist or is inaccessible, or if Emacs was unable to determine the ACL entries, then the return value is @code{nil}. The @@ -1710,16 +1703,21 @@ This function sets the SELinux security context of the file @var{filename} to @var{context}. @xref{File Attributes}, for a brief description of SELinux contexts. The @var{context} argument should be a list @code{(@var{user} @var{role} @var{type} @var{range})}, like the -return value of @code{file-selinux-context}. The function does -nothing if SELinux is disabled, or if Emacs was compiled without -SELinux support. +return value of @code{file-selinux-context}. The function returns +@code{t} if it succeeds to set the SELinux security context of +@var{filename}, @code{nil} otherwise. The function does nothing and +returns @code{nil} if SELinux is disabled, or if Emacs was compiled +without SELinux support. @end defun @defun set-file-acl filename acl-string This function sets the ACL entries of the file @var{filename} to @var{acl-string}. @xref{File Attributes}, for a brief description of ACLs. The @var{acl-string} argument should be a string containing the -textual representation of the desired ACL entries. +textual representation of the desired ACL entries as returned by +@code{file-acl} (@pxref{File Attributes, file-acl}). The function +returns @code{t} if it succeeds to set the ACL entries of +@var{filename}, @code{nil} otherwise. @end defun @node File Names @@ -1739,12 +1737,20 @@ how to manipulate file names. can operate on file names that do not refer to an existing file or directory. +@findex cygwin-convert-file-name-from-windows +@findex cygwin-convert-file-name-to-windows +@cindex MS-Windows file-name syntax +@cindex converting file names from/to MS-Windows syntax On MS-DOS and MS-Windows, these functions (like the function that actually operate on files) accept MS-DOS or MS-Windows file-name syntax, where backslashes separate the components, as well as Unix syntax; but they always return Unix syntax. This enables Lisp programs to specify file names in Unix syntax and work properly on all systems without -change. +change.@footnote{In MS-Windows versions of Emacs compiled for the Cygwin +environment, you can use the functions +@code{cygwin-convert-file-name-to-windows} and +@code{cygwin-convert-file-name-from-windows} to convert between the +two file-name syntaxes.} @menu * File Name Components:: The directory part of a file name, and the rest. @@ -2756,9 +2762,12 @@ first, before handlers for jobs such as remote file access. @code{dired-compress-file}, @code{dired-uncache},@* @code{expand-file-name}, @code{file-accessible-directory-p}, +@code{file-acl}, @code{file-attributes}, @code{file-directory-p}, +@code{file-equal-p}, @code{file-executable-p}, @code{file-exists-p}, +@code{file-in-directory-p}, @code{file-local-copy}, @code{file-remote-p}, @code{file-modes}, @code{file-name-all-completions}, @code{file-name-as-directory}, @@ -2767,9 +2776,10 @@ first, before handlers for jobs such as remote file access. @code{file-name-nondirectory}, @code{file-name-sans-versions}, @code{file-newer-than-file-p}, @code{file-ownership-preserved-p}, -@code{file-readable-p}, @code{file-regular-p}, @code{file-in-directory-p}, +@code{file-readable-p}, @code{file-regular-p}, +@code{file-selinux-context}, @code{file-symlink-p}, @code{file-truename}, @code{file-writable-p}, -@code{file-equal-p}, @code{find-backup-file-name}, +@code{find-backup-file-name}, @c Not sure why it was here: @code{find-file-noselect},@* @code{get-file-buffer}, @code{insert-directory}, @@ -2780,7 +2790,8 @@ first, before handlers for jobs such as remote file access. @code{make-directory-internal}, @code{make-symbolic-link},@* @code{process-file}, -@code{rename-file}, @code{set-file-modes}, @code{set-file-times}, +@code{rename-file}, @code{set-file-acl}, @code{set-file-modes}, +@code{set-file-selinux-context}, @code{set-file-times}, @code{set-visited-file-modtime}, @code{shell-command}, @code{start-file-process}, @code{substitute-in-file-name},@* @@ -2803,9 +2814,12 @@ first, before handlers for jobs such as remote file access. @code{dired-compress-file}, @code{dired-uncache}, @code{expand-file-name}, @code{file-accessible-direc@discretionary{}{}{}tory-p}, +@code{file-acl}, @code{file-attributes}, @code{file-direct@discretionary{}{}{}ory-p}, +@code{file-equal-p}, @code{file-executable-p}, @code{file-exists-p}, +@code{file-in-directory-p}, @code{file-local-copy}, @code{file-remote-p}, @code{file-modes}, @code{file-name-all-completions}, @code{file-name-as-directory}, @@ -2814,18 +2828,22 @@ first, before handlers for jobs such as remote file access. @code{file-name-nondirec@discretionary{}{}{}tory}, @code{file-name-sans-versions}, @code{file-newer-than-file-p}, @code{file-ownership-pre@discretionary{}{}{}served-p}, -@code{file-readable-p}, @code{file-regular-p}, @code{file-symlink-p}, -@code{file-truename}, @code{file-writable-p}, +@code{file-readable-p}, @code{file-regular-p}, +@code{file-selinux-context}, +@code{file-symlink-p}, @code{file-truename}, @code{file-writable-p}, @code{find-backup-file-name}, @c Not sure why it was here: @code{find-file-noselect}, @code{get-file-buffer}, @code{insert-directory}, @code{insert-file-contents}, -@code{load}, @code{make-direc@discretionary{}{}{}tory}, +@code{load}, +@code{make-auto-save-file-name}, +@code{make-direc@discretionary{}{}{}tory}, @code{make-direc@discretionary{}{}{}tory-internal}, @code{make-symbolic-link}, @code{process-file}, -@code{rename-file}, @code{set-file-modes}, +@code{rename-file}, @code{set-file-acl}, @code{set-file-modes}, +@code{set-file-selinux-context}, @code{set-file-times}, @code{set-visited-file-modtime}, @code{shell-command}, @code{start-file-process}, @code{substitute-in-file-name}, diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 504d1fb14df..7d56d38ffad 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Frames @chapter Frames diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index 531172031dc..999923f5b84 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Functions @chapter Functions @@ -1266,7 +1266,7 @@ obsolete, or giving its forms a special @key{TAB} indentation convention in Emacs Lisp mode. @anchor{Definition of declare} -@defmac declare @var{specs}@dots{} +@defmac declare specs@dots{} This macro ignores its arguments and evaluates to @code{nil}; it has no run-time effect. However, when a @code{declare} form occurs in the @var{declare} argument of a @code{defun} or @code{defsubst} function diff --git a/doc/lispref/hash.texi b/doc/lispref/hash.texi index bb7a60e2e2d..655f31ab114 100644 --- a/doc/lispref/hash.texi +++ b/doc/lispref/hash.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1999, 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Hash Tables @chapter Hash Tables @@ -293,7 +293,7 @@ compared case-insensitively. @example (defun case-fold-string= (a b) - (compare-strings a nil nil b nil nil t)) + (eq t (compare-strings a nil nil b nil nil t))) (defun case-fold-string-hash (a) (sxhash (upcase a))) diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi index 25c150290bd..9fe069b84d0 100644 --- a/doc/lispref/help.texi +++ b/doc/lispref/help.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Documentation @chapter Documentation diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi index a6ac2c70e84..745393f8166 100644 --- a/doc/lispref/hooks.texi +++ b/doc/lispref/hooks.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1993, 1998, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1993, 1998, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Standard Hooks @appendix Standard Hooks @@ -120,7 +121,7 @@ The command loop runs this soon after @code{post-command-hook} (q.v.). @item delete-terminal-functions @xref{Multiple Terminals}. -@itemx pop-up-frame-function +@item pop-up-frame-function @itemx split-window-preferred-function @xref{Choosing Window Options}. diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi index 025042a6869..3269776b626 100644 --- a/doc/lispref/internals.texi +++ b/doc/lispref/internals.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1993, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1993, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node GNU Emacs Internals @appendix GNU Emacs Internals diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 12463dac09c..948f00d7e5f 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -1,6 +1,6 @@ @c -*-coding: iso-latin-1-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Introduction @@ -408,7 +408,7 @@ stands for zero or more arguments. Parentheses are used when several arguments are grouped into additional levels of list structure. Here is an example: -@defspec count-loop (@var{var} [@var{from} @var{to} [@var{inc}]]) @var{body}@dots{} +@defspec count-loop (var [from to [inc]]) body@dots{} This imaginary special form implements a loop that executes the @var{body} forms and then increments the variable @var{var} on each iteration. On the first iteration, the variable has the value diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index 44ab0f30a0e..cb6c785905c 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 1998-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 1998-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Keymaps @chapter Keymaps @@ -94,9 +94,6 @@ Manual}. (kbd "<f1> SPC") @result{} [f1 32] (kbd "C-M-<down>") @result{} [C-M-down] @end example - -This macro is not meant for use with arguments that vary---only -with string constants. @end defun @node Keymap Basics diff --git a/doc/lispref/lay-flat.texi b/doc/lispref/lay-flat.texi index 73e2adbc03a..f12e724d6a9 100644 --- a/doc/lispref/lay-flat.texi +++ b/doc/lispref/lay-flat.texi @@ -1,6 +1,6 @@ \input texinfo @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @c @comment %**start of header diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index d2eea67da40..14601de1814 100644 --- a/doc/lispref/lists.texi +++ b/doc/lispref/lists.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Lists @chapter Lists diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index 73c1ccb3d3e..51a060bc6c6 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Loading @chapter Loading diff --git a/doc/lispref/macros.texi b/doc/lispref/macros.texi index 2e1d5302861..9ad00ca0260 100644 --- a/doc/lispref/macros.texi +++ b/doc/lispref/macros.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Macros @chapter Macros diff --git a/doc/lispref/makefile.w32-in b/doc/lispref/makefile.w32-in index 2914852dc8a..00b938dbf68 100644 --- a/doc/lispref/makefile.w32-in +++ b/doc/lispref/makefile.w32-in @@ -1,6 +1,6 @@ # -*- Makefile -*- for the GNU Emacs Lisp Reference Manual. -# Copyright (C) 2003-2012 Free Software Foundation, Inc. +# Copyright (C) 2003-2013 Free Software Foundation, Inc. # This file is part of GNU Emacs. diff --git a/doc/lispref/maps.texi b/doc/lispref/maps.texi index 1937b4930d7..d92f6a89f0a 100644 --- a/doc/lispref/maps.texi +++ b/doc/lispref/maps.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1993, 1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1993, 1999, 2001-2013 Free Software Foundation, +@c Inc. @c See the file elisp.texi for copying conditions. @node Standard Keymaps @appendix Standard Keymaps diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi index fa884269b36..cae14ab9a78 100644 --- a/doc/lispref/markers.texi +++ b/doc/lispref/markers.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Markers @chapter Markers diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index 5dfe8402d26..9a1ec477b9f 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Minibuffers @chapter Minibuffers diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi index 7057503e4c3..29aba877ba2 100644 --- a/doc/lispref/modes.texi +++ b/doc/lispref/modes.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Modes @chapter Major and Minor Modes @@ -612,7 +613,7 @@ variables section specifying a mode for that particular file. This should not be applied to the containing tar file. Similarly, a tiff image file might just happen to contain a first line that seems to match the @w{@samp{-*-}} pattern. For these reasons, both these file -extensions are members of the list @var{inhibit-local-variables-regexps}. +extensions are members of the list @code{inhibit-local-variables-regexps}. Add patterns to this list to prevent Emacs searching them for local variables of any kind (not just mode specifiers). diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi index 5aba3e6e5d3..9ad68be60cb 100644 --- a/doc/lispref/nonascii.texi +++ b/doc/lispref/nonascii.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1998-1999, 2001-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Non-ASCII Characters @chapter Non-@acronym{ASCII} Characters diff --git a/doc/lispref/numbers.texi b/doc/lispref/numbers.texi index 66b1f081df4..eeebac6bf72 100644 --- a/doc/lispref/numbers.texi +++ b/doc/lispref/numbers.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Numbers @chapter Numbers @@ -43,7 +43,7 @@ minimum range is @minus{}536870912 to 536870911 (30 bits; i.e., @end tex to @ifnottex -2**29 - 1), +2**29 @minus{} 1), @end ifnottex @tex @math{2^{29}-1}), diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi index e8460ed334b..afd63d69808 100644 --- a/doc/lispref/objects.texi +++ b/doc/lispref/objects.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Lisp Data Types @chapter Lisp Data Types @@ -171,7 +171,7 @@ latter are unique to Emacs Lisp. @end tex to @ifnottex -2**29 - 1) +2**29 @minus{} 1) @end ifnottex @tex @math{2^{29}-1}) diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 4b9cdfaae9e..b481c330f9f 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node System Interface @chapter Operating System Interface @@ -1421,23 +1421,23 @@ This stands for the day of month, blank-padded. @item %h This is a synonym for @samp{%b}. @item %H -This stands for the hour (00-23). +This stands for the hour (00--23). @item %I -This stands for the hour (01-12). +This stands for the hour (01--12). @item %j -This stands for the day of the year (001-366). +This stands for the day of the year (001--366). @item %k -This stands for the hour (0-23), blank padded. +This stands for the hour (0--23), blank padded. @item %l -This stands for the hour (1-12), blank padded. +This stands for the hour (1--12), blank padded. @item %m -This stands for the month (01-12). +This stands for the month (01--12). @item %M -This stands for the minute (00-59). +This stands for the minute (00--59). @item %n This stands for a newline. @item %N -This stands for the nanoseconds (000000000-999999999). To ask for +This stands for the nanoseconds (000000000--999999999). To ask for fewer digits, use @samp{%3N} for milliseconds, @samp{%6N} for microseconds, etc. Any excess digits are discarded, without rounding. @item %p @@ -1447,18 +1447,18 @@ This is a synonym for @samp{%I:%M:%S %p}. @item %R This is a synonym for @samp{%H:%M}. @item %S -This stands for the seconds (00-59). +This stands for the seconds (00--59). @item %t This stands for a tab character. @item %T This is a synonym for @samp{%H:%M:%S}. @item %U -This stands for the week of the year (01-52), assuming that weeks +This stands for the week of the year (01--52), assuming that weeks start on Sunday. @item %w -This stands for the numeric day of week (0-6). Sunday is day 0. +This stands for the numeric day of week (0--6). Sunday is day 0. @item %W -This stands for the week of the year (01-52), assuming that weeks +This stands for the week of the year (01--52), assuming that weeks start on Monday. @item %x This has a locale-specific meaning. In the default locale (named @@ -1467,7 +1467,7 @@ This has a locale-specific meaning. In the default locale (named This has a locale-specific meaning. In the default locale (named @samp{C}), it is equivalent to @samp{%T}. @item %y -This stands for the year without century (00-99). +This stands for the year without century (00--99). @item %Y This stands for the year with century. @item %Z diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi index 172c1feb019..ad9f4fc1aea 100644 --- a/doc/lispref/package.texi +++ b/doc/lispref/package.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 2010-2012 Free Software Foundation, Inc. +@c Copyright (C) 2010-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Packaging @chapter Preparing Lisp code for distribution diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi index 430c9af73e1..e8b6166f63c 100644 --- a/doc/lispref/positions.texi +++ b/doc/lispref/positions.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Positions @chapter Positions diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index ec720174de4..d163f921f9a 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Processes @chapter Processes @@ -1834,12 +1834,12 @@ The number of threads in the process. @item start The time when the process was started, in the same -@w{@code{(@var{high} @var{low} @var{microsec} @var{picosec})}} format used by -@code{current-time} and by @code{file-attributes}. +@code{(@var{high} @var{low} @var{microsec} @var{picosec})} format used by +@code{file-attributes} and @code{current-time}. @item etime -The time elapsed since the process started, in the @w{@code{(@var{high} -@var{low} @var{microsec} @var{picosec})}} format. +The time elapsed since the process started, in the format @code{(@var{high} +@var{low} @var{microsec} @var{picosec})}. @item vsize The virtual memory size of the process, measured in kilobytes. diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index 6c9b09d29bf..87d4051d6f0 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Searching and Matching @chapter Searching and Matching @@ -1325,7 +1325,7 @@ This stands for a single @samp{\} in the replacement text. @item @samp{\?} This stands for itself (for compatibility with @code{replace-regexp} -and related commands; @pxref{Regexp Replacement,,, emacs, The GNU +and related commands; @pxref{Regexp Replace,,, emacs, The GNU Emacs Manual}). @end table diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi index 8bb1e9e5abf..00384de7ec8 100644 --- a/doc/lispref/sequences.texi +++ b/doc/lispref/sequences.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Sequences Arrays Vectors @chapter Sequences, Arrays, and Vectors diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi index f9fe787dfa9..5b7e833b235 100644 --- a/doc/lispref/streams.texi +++ b/doc/lispref/streams.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Read and Print @chapter Reading and Printing Lisp Objects diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi index 865435c91b3..340115062f9 100644 --- a/doc/lispref/strings.texi +++ b/doc/lispref/strings.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Strings and Characters @chapter Strings and Characters @@ -517,25 +517,29 @@ comparison ignores case differences. @end defun @defun compare-strings string1 start1 end1 string2 start2 end2 &optional ignore-case -This function compares the specified part of @var{string1} with the +This function compares a specified part of @var{string1} with a specified part of @var{string2}. The specified part of @var{string1} -runs from index @var{start1} up to index @var{end1} (@code{nil} means -the end of the string). The specified part of @var{string2} runs from -index @var{start2} up to index @var{end2} (@code{nil} means the end of -the string). - -The strings are both converted to multibyte for the comparison -(@pxref{Text Representations}) so that a unibyte string and its -conversion to multibyte are always regarded as equal. If -@var{ignore-case} is non-@code{nil}, then case is ignored, so that -upper case letters can be equal to lower case letters. +runs from index @var{start1} (inclusive) up to index @var{end1} +(exclusive); @code{nil} for @var{start1} means the start of the +string, while @code{nil} for @var{end1} means the length of the +string. Likewise, the specified part of @var{string2} runs from index +@var{start2} up to index @var{end2}. + +The strings are compared by the numeric values of their characters. +For instance, @var{str1} is considered ``smaller than'' @var{str2} if +its first differing character has a smaller numeric value. If +@var{ignore-case} is non-@code{nil}, characters are converted to +lower-case before comparing them. Unibyte strings are converted to +multibyte for comparison (@pxref{Text Representations}), so that a +unibyte string and its conversion to multibyte are always regarded as +equal. If the specified portions of the two strings match, the value is @code{t}. Otherwise, the value is an integer which indicates how many -leading characters agree, and which string is less. Its absolute value -is one plus the number of characters that agree at the beginning of the -two strings. The sign is negative if @var{string1} (or its specified -portion) is less. +leading characters agree, and which string is less. Its absolute +value is one plus the number of characters that agree at the beginning +of the two strings. The sign is negative if @var{string1} (or its +specified portion) is less. @end defun @defun assoc-string key alist &optional case-fold diff --git a/doc/lispref/symbols.texi b/doc/lispref/symbols.texi index 02cb83451c1..9f916549902 100644 --- a/doc/lispref/symbols.texi +++ b/doc/lispref/symbols.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Symbols @chapter Symbols diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi index c773ca74d96..dfa121103bc 100644 --- a/doc/lispref/syntax.texi +++ b/doc/lispref/syntax.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Syntax Tables @chapter Syntax Tables @@ -478,17 +478,17 @@ it easier to see the character returned by @code{char-syntax}.) @end group @group -;; Forward slash characters have punctuation syntax. Note that this -;; @code{char-syntax} call does not reveal that it is also part of -;; comment-start and -end sequences. +;; Forward slash characters have punctuation syntax. +;; Note that this @code{char-syntax} call does not reveal +;; that it is also part of comment-start and -end sequences. (string (char-syntax ?/)) @result{} "." @end group @group -;; Open parenthesis characters have open parenthesis syntax. Note -;; that this @code{char-syntax} call does not reveal that it has a -;; matching character, @samp{)}. +;; Open parenthesis characters have open parenthesis syntax. +;; Note that this @code{char-syntax} call does not reveal that +;; it has a matching character, @samp{)}. (string (char-syntax ?\()) @result{} "(" @end group @@ -506,7 +506,7 @@ This function returns the current syntax table, which is the table for the current buffer. @end defun -@defmac with-syntax-table @var{table} @var{body}@dots{} +@defmac with-syntax-table table body@dots{} This macro executes @var{body} using @var{table} as the current syntax table. It returns the value of the last form in @var{body}, after restoring the old current syntax table. @@ -998,7 +998,7 @@ corresponds to each syntax flag. @samp{4} @tab @code{(lsh 1 19)} @end multitable -@defun string-to-syntax @var{desc} +@defun string-to-syntax desc Given a syntax descriptor @var{desc} (a string), this function returns the corresponding raw syntax descriptor. @end defun diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index b1ee2e699fe..00ec62ec49d 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Text @chapter Text diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi index d54d91b238a..4c443da3af8 100644 --- a/doc/lispref/tips.texi +++ b/doc/lispref/tips.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1993, 1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1993, 1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Tips @appendix Tips and Conventions @@ -934,7 +934,7 @@ explains these conventions, starting with an example: @group ;;; foo.el --- Support for the Foo programming language -;; Copyright (C) 2010-2012 Your Name +;; Copyright (C) 2010-2013 Your Name @end group ;; Author: Your Name <yourname@@example.com> @@ -942,6 +942,7 @@ explains these conventions, starting with an example: ;; Created: 14 Jul 2010 @group ;; Keywords: languages +;; Homepage: http://example.com/foo ;; This file is not part of GNU Emacs. @@ -980,8 +981,7 @@ the conventional possibilities for @var{header-name}: @item Author This line states the name and email address of at least the principal author of the library. If there are multiple authors, list them on -continuation lines led by @code{;;} and whitespace (this is easier -for tools to parse than having more than one author on one line). +continuation lines led by @code{;;} and a tab or at least two spaces. We recommend including a contact email address, of the form @samp{<@dots{}>}. For example: @@ -1028,6 +1028,9 @@ The name of this field is unfortunate, since people often assume it is the place to write arbitrary keywords that describe their package, rather than just the relevant Finder keywords. +@item Homepage +This line states the homepage of the library. + @item Package-Version If @samp{Version} is not suitable for use by the package manager, then a package can define @samp{Package-Version}; it will be used instead. @@ -1063,6 +1066,7 @@ names---they have no standard meanings, so they can't do any harm. library file. These should be separated from anything else by blank lines. Here is a table of them: +@cindex commentary, in a Lisp library @table @samp @item ;;; Commentary: This begins introductory comments that explain how the library works. diff --git a/doc/lispref/two-volume-cross-refs.txt b/doc/lispref/two-volume-cross-refs.txt index 67b5dbf89a3..a134b8c4783 100644 --- a/doc/lispref/two-volume-cross-refs.txt +++ b/doc/lispref/two-volume-cross-refs.txt @@ -1,4 +1,4 @@ -Copyright (C) 2001-2012 Free Software Foundation, Inc. +Copyright (C) 2001-2013 Free Software Foundation, Inc. See end for copying conditions. Two Volume Cross References diff --git a/doc/lispref/two-volume.make b/doc/lispref/two-volume.make index eb5c0e0193d..9ae4a33df44 100644 --- a/doc/lispref/two-volume.make +++ b/doc/lispref/two-volume.make @@ -1,4 +1,4 @@ -# Copyright (C) 2007-2012 Free Software Foundation, Inc. +# Copyright (C) 2007-2013 Free Software Foundation, Inc. # See end for copying conditions. # although it would be nice to use tex rather than pdftex to avoid diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 4103c30f663..3f4edebfb8b 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Variables @chapter Variables @@ -1057,7 +1057,7 @@ variables}. Every variable that has been defined with @code{defvar}, (@pxref{Defining Variables}). All other variables are subject to lexical binding. -@defun special-variable-p SYMBOL +@defun special-variable-p symbol This function returns non-@code{nil} if @var{symbol} is a special variable (i.e., it has a @code{defvar}, @code{defcustom}, or @code{defconst} variable definition). Otherwise, the return value is diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi index 7a705353a1e..b3c143496dd 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Windows @chapter Windows @@ -1296,10 +1296,12 @@ windows. @cindex selecting a window @defun select-window window &optional norecord -This function makes @var{window} the selected window, as well as the -window selected within its frame (@pxref{Basic Windows}). @var{window} -must be a live window. This function makes also @var{window}'s buffer -current (@pxref{Buffers and Windows}). The return value is +This function makes @var{window} the selected window and the window +selected within its frame (@pxref{Basic Windows}) and selects that +frame. @var{window} must be a live window. This function also makes +@var{window}'s buffer (@pxref{Buffers and Windows}) current and sets +that buffer's value of @code{point} to the value of @code{window-point} +(@pxref{Window Point}) in @var{window}. The return value is @var{window}. By default, this function also moves @var{window}'s buffer to the front @@ -1865,7 +1867,7 @@ default value is empty, i.e., @code{(nil . nil)}. @defopt display-buffer-alist The value of this option is an alist mapping conditions to display actions. Each condition may be either a regular expression matching a -buffer name or a function that takes two arguments - a buffer name and +buffer name or a function that takes two arguments: a buffer name and the @var{action} argument passed to @code{display-buffer}. If the name of the buffer passed to @code{display-buffer} either matches a regular expression in this alist or the function specified by a condition @@ -1966,7 +1968,7 @@ height of the frame's root window. @item If the @sc{cdr} specifies a function, that function is called with one -argument - the new window. The function is supposed to adjust the +argument: the new window. The function is supposed to adjust the height of the window; its return value is ignored. Suitable functions are @code{shrink-window-if-larger-than-buffer} and @code{fit-window-to-buffer}, see @ref{Resizing Windows}. @@ -1987,7 +1989,7 @@ width of the frame's root window. @item If the @sc{cdr} specifies a function, that function is called with one -argument - the new window. The function is supposed to adjust the width +argument: the new window. The function is supposed to adjust the width of the window; its return value is ignored. @end itemize @@ -3616,10 +3618,10 @@ This parameter is installed by the buffer display functions (@pxref{Choosing Window}) and consulted by @code{quit-restore-window} (@pxref{Quitting Windows}). It contains four elements: -The first element is one of the symbols @code{window} - meaning that the -window has been specially created by @code{display-buffer}, @code{frame} -- a separate frame has been created, @code{same} - the window has -displayed the same buffer before, or @code{other} - the window showed +The first element is one of the symbols @code{window}, meaning that the +window has been specially created by @code{display-buffer}; @code{frame}, +a separate frame has been created; @code{same}, the window has +displayed the same buffer before; or @code{other}, the window showed another buffer before. The second element is either one of the symbols @code{window} or |