aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref
diff options
context:
space:
mode:
authorTom Tromey2013-01-05 19:36:45 -0700
committerTom Tromey2013-01-05 19:36:45 -0700
commite078a23febca14bc919c5806670479c395e3253e (patch)
treee9e4ed91feef744d525264c31974c3ed00146bcd /doc/lispref
parent63d535c829a930207b64fe733228f15a554644b1 (diff)
parent7a2657fa3bedbd977f4e11fe030cb4a210c04ab4 (diff)
downloademacs-e078a23febca14bc919c5806670479c395e3253e.tar.gz
emacs-e078a23febca14bc919c5806670479c395e3253e.zip
merge from trunk
Diffstat (limited to 'doc/lispref')
-rw-r--r--doc/lispref/ChangeLog94
-rw-r--r--doc/lispref/Makefile.in2
-rw-r--r--doc/lispref/README2
-rw-r--r--doc/lispref/abbrevs.texi3
-rw-r--r--doc/lispref/advice.texi2
-rw-r--r--doc/lispref/anti.texi2
-rw-r--r--doc/lispref/back.texi2
-rw-r--r--doc/lispref/backups.texi3
-rw-r--r--doc/lispref/buffers.texi6
-rw-r--r--doc/lispref/commands.texi5
-rw-r--r--doc/lispref/compile.texi2
-rw-r--r--doc/lispref/control.texi3
-rw-r--r--doc/lispref/customize.texi14
-rw-r--r--doc/lispref/debugging.texi3
-rw-r--r--doc/lispref/display.texi10
-rw-r--r--doc/lispref/edebug.texi3
-rw-r--r--doc/lispref/elisp.texi4
-rw-r--r--doc/lispref/errors.texi3
-rw-r--r--doc/lispref/eval.texi3
-rw-r--r--doc/lispref/files.texi78
-rw-r--r--doc/lispref/frames.texi3
-rw-r--r--doc/lispref/functions.texi6
-rw-r--r--doc/lispref/hash.texi4
-rw-r--r--doc/lispref/help.texi4
-rw-r--r--doc/lispref/hooks.texi5
-rw-r--r--doc/lispref/internals.texi3
-rw-r--r--doc/lispref/intro.texi4
-rw-r--r--doc/lispref/keymaps.texi5
-rw-r--r--doc/lispref/lay-flat.texi2
-rw-r--r--doc/lispref/lists.texi3
-rw-r--r--doc/lispref/loading.texi4
-rw-r--r--doc/lispref/macros.texi3
-rw-r--r--doc/lispref/makefile.w32-in2
-rw-r--r--doc/lispref/maps.texi3
-rw-r--r--doc/lispref/markers.texi3
-rw-r--r--doc/lispref/minibuf.texi4
-rw-r--r--doc/lispref/modes.texi5
-rw-r--r--doc/lispref/nonascii.texi2
-rw-r--r--doc/lispref/numbers.texi6
-rw-r--r--doc/lispref/objects.texi6
-rw-r--r--doc/lispref/os.texi30
-rw-r--r--doc/lispref/package.texi2
-rw-r--r--doc/lispref/positions.texi2
-rw-r--r--doc/lispref/processes.texi12
-rw-r--r--doc/lispref/searching.texi6
-rw-r--r--doc/lispref/sequences.texi4
-rw-r--r--doc/lispref/streams.texi3
-rw-r--r--doc/lispref/strings.texi38
-rw-r--r--doc/lispref/symbols.texi3
-rw-r--r--doc/lispref/syntax.texi20
-rw-r--r--doc/lispref/text.texi2
-rw-r--r--doc/lispref/tips.texi14
-rw-r--r--doc/lispref/two-volume-cross-refs.txt2
-rw-r--r--doc/lispref/two-volume.make2
-rw-r--r--doc/lispref/variables.texi4
-rw-r--r--doc/lispref/windows.texi28
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 @@
12013-01-05 Glenn Morris <rgm@gnu.org>
2
3 * display.texi (Overlay Properties): Mention field. (Bug#13364)
4
52013-01-05 Eli Zaretskii <eliz@gnu.org>
6
7 * hooks.texi (Standard Hooks): Use @item, not @itemx, as the first
8 directive in a group of items.
9
102013-01-05 Chong Yidong <cyd@gnu.org>
11
12 * keymaps.texi (Key Sequences): Remove obsolete sentence
13 (Bug#13356).
14
152013-01-04 Ari Roponen <ari.roponen@gmail.com> (tiny change)
16
17 * hash.texi (Defining Hash): Fix typo. (Bug#13345)
18
192013-01-04 Stefan Monnier <monnier@iro.umontreal.ca>
20
21 * files.texi (File Attributes): Undocument return format of file-acl.
22
232013-01-03 Glenn Morris <rgm@gnu.org>
24
25 * processes.texi (System Processes):
26 * syntax.texi (Syntax Table Functions): Tweak some line breaks.
27
28 * searching.texi (Replacing Match): Fix xref.
29
30 * elisp.texi (DATE): Bump to Jan 2013.
31
322013-01-02 Glenn Morris <rgm@gnu.org>
33
34 * customize.texi (Common Keywords, Type Keywords):
35 Replace "active field" with "button". (Bug#13310)
36
37 * customize.texi (Common Keywords): Add xref. (Bug#13311)
38 * tips.texi (Library Headers): Add cindex.
39
402012-12-30 Wolfgang Jenkner <wjenkner@inode.at>
41
42 * functions.texi (Declare Form):
43 * intro.texi (A Sample Function Description):
44 * syntax.texi (Syntax Table Internals, Syntax Table Functions):
45 * variables.texi (Using Lexical Binding): Don't use @var or CAPS
46 in @def.. commands. (Bug#13292)
47
482012-12-29 Eli Zaretskii <eliz@gnu.org>
49
50 * files.texi (Changing Files): Document the return values of
51 set-file-selinux-context and set-file-acl.
52
532012-12-27 Glenn Morris <rgm@gnu.org>
54
55 * files.texi (File Names): Mention Cygwin conversion functions.
56
572012-12-22 Martin Rudalics <rudalics@gmx.at>
58
59 * windows.texi (Selecting Windows): Reword description of
60 select-window (Bug#13248).
61
622012-12-22 Eli Zaretskii <eliz@gnu.org>
63
64 * files.texi (File Attributes, Changing Files): Remove the details
65 about the text returned by file-acl. Instead, just document that
66 it is an opaque string meant to be used by set-file-acl.
67
682012-12-21 Chong Yidong <cyd@gnu.org>
69
70 * modes.texi (Auto Major Mode): Fix typo (Bug#13230).
71
72 * customize.texi (Simple Types): Document key-sequence type
73 (Bug#13048).
74
75 * strings.texi (Text Comparison): Doc fix for compare-strings.
76
772012-12-19 Michael Albinus <michael.albinus@gmx.de>
78
79 * files.texi (Magic File Names): Add `file-acl',
80 `file-selinux-context', `set-file-acl' and
81 `set-file-selinux-context'. Make the list consistent.
82
832012-12-19 Jonas Bernoulli <jonas@bernoul.li>
84
85 * tips.texi (Library Headers): New header keyword `Homepage'.
86 Make continuation lines syntax more precise.
87
882012-12-17 Eli Zaretskii <eliz@gnu.org>
89
90 * files.texi (File Attributes, Changing Files): Update to include
91 MS-Windows support for ACLs.
92
12012-12-16 Romain Francoise <romain@orebokech.com> 932012-12-16 Romain Francoise <romain@orebokech.com>
2 94
3 * files.texi (File Attributes): Document ACL support and new 95 * files.texi (File Attributes): Document ACL support and new
@@ -11865,7 +11957,7 @@
11865;; coding: utf-8 11957;; coding: utf-8
11866;; End: 11958;; End:
11867 11959
11868 Copyright (C) 1998-2012 Free Software Foundation, Inc. 11960 Copyright (C) 1998-2013 Free Software Foundation, Inc.
11869 11961
11870 This file is part of GNU Emacs. 11962 This file is part of GNU Emacs.
11871 11963
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 @@
1# Makefile for the GNU Emacs Lisp Reference Manual. 1# Makefile for the GNU Emacs Lisp Reference Manual.
2 2
3# Copyright (C) 1990-1996, 1998-2012 Free Software Foundation, Inc. 3# Copyright (C) 1990-1996, 1998-2013 Free Software Foundation, Inc.
4 4
5# This file is part of GNU Emacs. 5# This file is part of GNU Emacs.
6 6
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 @@
1Copyright (C) 2001-2012 Free Software Foundation, Inc. -*- outline -*- 1Copyright (C) 2001-2013 Free Software Foundation, Inc. -*- outline -*-
2See the end of the file for license conditions. 2See the end of the file for license conditions.
3 3
4 4
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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 1999, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Abbrevs 6@node Abbrevs
6@chapter Abbrevs and Abbrev Expansion 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1998-1999, 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Advising Functions 5@node Advising Functions
6@chapter Advising Emacs Lisp Functions 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1999, 2002-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1999, 2002-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5 5
6@c This node must have no pointers. 6@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 @@
1\input texinfo @c -*-texinfo-*- 1\input texinfo @c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@c 5@c
6@c %**start of header 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1999, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Backups and Auto-Saving 6@node Backups and Auto-Saving
6@chapter Backups and Auto-Saving 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Buffers 6@node Buffers
7@chapter Buffers 7@chapter Buffers
@@ -650,7 +650,7 @@ the last modification time of that directory, as recorded by Dired.
650For a new buffer visiting a not yet existing file, @var{high} is 650For a new buffer visiting a not yet existing file, @var{high} is
651@minus{}1 and @var{low} is 65535, that is, 651@minus{}1 and @var{low} is 65535, that is,
652@ifnottex 652@ifnottex
653@w{2**16 - 1.} 653@w{2**16 @minus{} 1.}
654@end ifnottex 654@end ifnottex
655@tex 655@tex
656@math{2^{16}-1}. 656@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Command Loop 6@node Command Loop
6@chapter Command Loop 7@chapter Command Loop
@@ -2660,7 +2661,7 @@ The command @code{quoted-insert} uses this function.
2660@cindex control characters, reading 2661@cindex control characters, reading
2661@cindex nonprinting characters, reading 2662@cindex nonprinting characters, reading
2662This function is like @code{read-char}, except that if the first 2663This function is like @code{read-char}, except that if the first
2663character read is an octal digit (0-7), it reads any number of octal 2664character read is an octal digit (0--7), it reads any number of octal
2664digits (but stopping if a non-octal digit is found), and returns the 2665digits (but stopping if a non-octal digit is found), and returns the
2665character represented by that numeric character code. If the 2666character represented by that numeric character code. If the
2666character that terminates the sequence of octal digits is @key{RET}, 2667character 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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Byte Compilation 5@node Byte Compilation
6@chapter Byte Compilation 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Control Structures 6@node Control Structures
6@chapter Control Structures 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1997-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1997-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Customization 5@node Customization
6@chapter Customization Settings 6@chapter Customization Settings
@@ -77,7 +77,7 @@ item. Please don't overdo this, since the result would be annoying.
77@item :link @var{link-data} 77@item :link @var{link-data}
78@kindex link@r{, customization keyword} 78@kindex link@r{, customization keyword}
79Include an external link after the documentation string for this item. 79Include an external link after the documentation string for this item.
80This is a sentence containing an active field which references some 80This is a sentence containing a button that references some
81other documentation. 81other documentation.
82 82
83There are several alternatives you can use for @var{link-data}: 83There 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
101 101
102@item (emacs-commentary-link @var{library}) 102@item (emacs-commentary-link @var{library})
103Link to the commentary section of a library; @var{library} is a string 103Link to the commentary section of a library; @var{library} is a string
104which specifies the library name. 104which specifies the library name. @xref{Library Headers}.
105 105
106@item (emacs-library-link @var{library}) 106@item (emacs-library-link @var{library})
107Link to an Emacs Lisp library file; @var{library} is a string which 107Link 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
620specify the text to describe each value in a way that fits the specific 620specify the text to describe each value in a way that fits the specific
621meaning of the alternative. 621meaning of the alternative.
622 622
623@item key-sequence
624The value is a key sequence. The customization buffer shows the key
625sequence using the same syntax as the @kbd{kbd} function. @xref{Key
626Sequences}.
627
623@item coding-system 628@item coding-system
624The value must be a coding-system name, and you can do completion with 629The value must be a coding-system name, and you can do completion with
625@kbd{M-@key{TAB}}. 630@kbd{M-@key{TAB}}.
@@ -1077,8 +1082,7 @@ Substitute the item's documentation string.
1077 1082
1078@item %h 1083@item %h
1079Like @samp{%d}, but if the documentation string is more than one line, 1084Like @samp{%d}, but if the documentation string is more than one line,
1080add an active field to control whether to show all of it or just the 1085add a button to control whether to show all of it or just the first line.
1081first line.
1082 1086
1083@item %t 1087@item %t
1084Substitute the tag here. You specify the tag with the @code{:tag} 1088Substitute 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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Debugging 6@node Debugging
6@chapter Debugging Lisp Programs 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Display 5@node Display
6@chapter Emacs Display 6@chapter Emacs Display
@@ -1559,6 +1559,14 @@ mouse onto the text in the overlay, Emacs displays a help string in the
1559echo area, or in the tooltip window. For details see @ref{Text 1559echo area, or in the tooltip window. For details see @ref{Text
1560help-echo}. 1560help-echo}.
1561 1561
1562@item field
1563@kindex field @r{(overlay property)}
1564@c Copied from Special Properties.
1565Consecutive characters with the same @code{field} property constitute a
1566@emph{field}. Some motion functions including @code{forward-word} and
1567@code{beginning-of-line} stop moving at a field boundary.
1568@xref{Fields}.
1569
1562@item modification-hooks 1570@item modification-hooks
1563@kindex modification-hooks @r{(overlay property)} 1571@kindex modification-hooks @r{(overlay property)}
1564This property's value is a list of functions to be called if any 1572This 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 @@
1@comment -*-texinfo-*- 1@comment -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1992-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1992-1994, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5 6
6@c This file can also be used by an independent Edebug User 7@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 @@
56@c (See comments for EDITION in emacs.texi) 56@c (See comments for EDITION in emacs.texi)
57@set VERSION 3.1 57@set VERSION 3.1
58@include emacsver.texi 58@include emacsver.texi
59@set DATE May 2012 59@set DATE January 2013
60 60
61@c in general, keep the following line commented out, unless doing a 61@c in general, keep the following line commented out, unless doing a
62@c copy of this manual that will be published. The manual should go 62@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}
98@end ifnottex 98@end ifnottex
99corresponding to Emacs version @value{EMACSVER}. 99corresponding to Emacs version @value{EMACSVER}.
100 100
101Copyright @copyright{} 1990-1996, 1998-2012 Free Software Foundation, Inc. 101Copyright @copyright{} 1990--1996, 1998--2013 Free Software Foundation, Inc.
102 102
103@quotation 103@quotation
104Permission is granted to copy, distribute and/or modify this document 104Permission 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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1993, 1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1993, 1999, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Standard Errors 6@node Standard Errors
6@appendix Standard Errors 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 1998, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 1998, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Evaluation 6@node Evaluation
6@chapter Evaluation 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Files 6@node Files
7@chapter Files 7@chapter Files
@@ -1356,24 +1356,17 @@ support, then the return value is @code{(nil nil nil nil)}.
1356@cindex ACL entries 1356@cindex ACL entries
1357 If Emacs has been compiled with @dfn{ACL} (access control list) 1357 If Emacs has been compiled with @dfn{ACL} (access control list)
1358support, you can use the function @code{file-acl} to retrieve a file's 1358support, you can use the function @code{file-acl} to retrieve a file's
1359ACL entries. The format is platform-specific; on GNU/Linux and BSD, 1359ACL entries. The interface implementation is platform-specific; on
1360Emacs uses the POSIX ACL interface. For the function 1360GNU/Linux and BSD, Emacs uses the POSIX ACL interface, while on
1361@code{set-file-acl}, see @ref{Changing Files}. 1361MS-Windows Emacs emulates the POSIX ACL interface with native file
1362security APIs.
1362 1363
1363@defun file-acl filename 1364@defun file-acl filename
1364This function returns the ACL entries of the file @var{filename}. 1365This function returns the ACL entries of the file @var{filename}. The
1365The return value is a string containing the textual representation of 1366return value is a platform-dependent object containing some
1366the ACL entries, like the following: 1367representation of the ACL entries. Don't use it for anything except
1367 1368passing it to the @code{set-file-acl} function (@pxref{Changing Files,
1368@example 1369set-file-acl}).
1369@group
1370user::rw-
1371group::r--
1372group:gnu:rwx
1373mask::rwx
1374other::r--
1375@end group
1376@end example
1377 1370
1378If the file does not exist or is inaccessible, or if Emacs was unable to 1371If the file does not exist or is inaccessible, or if Emacs was unable to
1379determine the ACL entries, then the return value is @code{nil}. The 1372determine 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
1710@var{filename} to @var{context}. @xref{File Attributes}, for a brief 1703@var{filename} to @var{context}. @xref{File Attributes}, for a brief
1711description of SELinux contexts. The @var{context} argument should be 1704description of SELinux contexts. The @var{context} argument should be
1712a list @code{(@var{user} @var{role} @var{type} @var{range})}, like the 1705a list @code{(@var{user} @var{role} @var{type} @var{range})}, like the
1713return value of @code{file-selinux-context}. The function does 1706return value of @code{file-selinux-context}. The function returns
1714nothing if SELinux is disabled, or if Emacs was compiled without 1707@code{t} if it succeeds to set the SELinux security context of
1715SELinux support. 1708@var{filename}, @code{nil} otherwise. The function does nothing and
1709returns @code{nil} if SELinux is disabled, or if Emacs was compiled
1710without SELinux support.
1716@end defun 1711@end defun
1717 1712
1718@defun set-file-acl filename acl-string 1713@defun set-file-acl filename acl-string
1719This function sets the ACL entries of the file @var{filename} to 1714This function sets the ACL entries of the file @var{filename} to
1720@var{acl-string}. @xref{File Attributes}, for a brief description of 1715@var{acl-string}. @xref{File Attributes}, for a brief description of
1721ACLs. The @var{acl-string} argument should be a string containing the 1716ACLs. The @var{acl-string} argument should be a string containing the
1722textual representation of the desired ACL entries. 1717textual representation of the desired ACL entries as returned by
1718@code{file-acl} (@pxref{File Attributes, file-acl}). The function
1719returns @code{t} if it succeeds to set the ACL entries of
1720@var{filename}, @code{nil} otherwise.
1723@end defun 1721@end defun
1724 1722
1725@node File Names 1723@node File Names
@@ -1739,12 +1737,20 @@ how to manipulate file names.
1739can operate on file names that do not refer to an existing file or 1737can operate on file names that do not refer to an existing file or
1740directory. 1738directory.
1741 1739
1740@findex cygwin-convert-file-name-from-windows
1741@findex cygwin-convert-file-name-to-windows
1742@cindex MS-Windows file-name syntax
1743@cindex converting file names from/to MS-Windows syntax
1742 On MS-DOS and MS-Windows, these functions (like the function that 1744 On MS-DOS and MS-Windows, these functions (like the function that
1743actually operate on files) accept MS-DOS or MS-Windows file-name syntax, 1745actually operate on files) accept MS-DOS or MS-Windows file-name syntax,
1744where backslashes separate the components, as well as Unix syntax; but 1746where backslashes separate the components, as well as Unix syntax; but
1745they always return Unix syntax. This enables Lisp programs to specify 1747they always return Unix syntax. This enables Lisp programs to specify
1746file names in Unix syntax and work properly on all systems without 1748file names in Unix syntax and work properly on all systems without
1747change. 1749change.@footnote{In MS-Windows versions of Emacs compiled for the Cygwin
1750environment, you can use the functions
1751@code{cygwin-convert-file-name-to-windows} and
1752@code{cygwin-convert-file-name-from-windows} to convert between the
1753two file-name syntaxes.}
1748 1754
1749@menu 1755@menu
1750* File Name Components:: The directory part of a file name, and the rest. 1756* 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.
2756@code{dired-compress-file}, @code{dired-uncache},@* 2762@code{dired-compress-file}, @code{dired-uncache},@*
2757@code{expand-file-name}, 2763@code{expand-file-name},
2758@code{file-accessible-directory-p}, 2764@code{file-accessible-directory-p},
2765@code{file-acl},
2759@code{file-attributes}, 2766@code{file-attributes},
2760@code{file-directory-p}, 2767@code{file-directory-p},
2768@code{file-equal-p},
2761@code{file-executable-p}, @code{file-exists-p}, 2769@code{file-executable-p}, @code{file-exists-p},
2770@code{file-in-directory-p},
2762@code{file-local-copy}, @code{file-remote-p}, 2771@code{file-local-copy}, @code{file-remote-p},
2763@code{file-modes}, @code{file-name-all-completions}, 2772@code{file-modes}, @code{file-name-all-completions},
2764@code{file-name-as-directory}, 2773@code{file-name-as-directory},
@@ -2767,9 +2776,10 @@ first, before handlers for jobs such as remote file access.
2767@code{file-name-nondirectory}, 2776@code{file-name-nondirectory},
2768@code{file-name-sans-versions}, @code{file-newer-than-file-p}, 2777@code{file-name-sans-versions}, @code{file-newer-than-file-p},
2769@code{file-ownership-preserved-p}, 2778@code{file-ownership-preserved-p},
2770@code{file-readable-p}, @code{file-regular-p}, @code{file-in-directory-p}, 2779@code{file-readable-p}, @code{file-regular-p},
2780@code{file-selinux-context},
2771@code{file-symlink-p}, @code{file-truename}, @code{file-writable-p}, 2781@code{file-symlink-p}, @code{file-truename}, @code{file-writable-p},
2772@code{file-equal-p}, @code{find-backup-file-name}, 2782@code{find-backup-file-name},
2773@c Not sure why it was here: @code{find-file-noselect},@* 2783@c Not sure why it was here: @code{find-file-noselect},@*
2774@code{get-file-buffer}, 2784@code{get-file-buffer},
2775@code{insert-directory}, 2785@code{insert-directory},
@@ -2780,7 +2790,8 @@ first, before handlers for jobs such as remote file access.
2780@code{make-directory-internal}, 2790@code{make-directory-internal},
2781@code{make-symbolic-link},@* 2791@code{make-symbolic-link},@*
2782@code{process-file}, 2792@code{process-file},
2783@code{rename-file}, @code{set-file-modes}, @code{set-file-times}, 2793@code{rename-file}, @code{set-file-acl}, @code{set-file-modes},
2794@code{set-file-selinux-context}, @code{set-file-times},
2784@code{set-visited-file-modtime}, @code{shell-command}, 2795@code{set-visited-file-modtime}, @code{shell-command},
2785@code{start-file-process}, 2796@code{start-file-process},
2786@code{substitute-in-file-name},@* 2797@code{substitute-in-file-name},@*
@@ -2803,9 +2814,12 @@ first, before handlers for jobs such as remote file access.
2803@code{dired-compress-file}, @code{dired-uncache}, 2814@code{dired-compress-file}, @code{dired-uncache},
2804@code{expand-file-name}, 2815@code{expand-file-name},
2805@code{file-accessible-direc@discretionary{}{}{}tory-p}, 2816@code{file-accessible-direc@discretionary{}{}{}tory-p},
2817@code{file-acl},
2806@code{file-attributes}, 2818@code{file-attributes},
2807@code{file-direct@discretionary{}{}{}ory-p}, 2819@code{file-direct@discretionary{}{}{}ory-p},
2820@code{file-equal-p},
2808@code{file-executable-p}, @code{file-exists-p}, 2821@code{file-executable-p}, @code{file-exists-p},
2822@code{file-in-directory-p},
2809@code{file-local-copy}, @code{file-remote-p}, 2823@code{file-local-copy}, @code{file-remote-p},
2810@code{file-modes}, @code{file-name-all-completions}, 2824@code{file-modes}, @code{file-name-all-completions},
2811@code{file-name-as-directory}, 2825@code{file-name-as-directory},
@@ -2814,18 +2828,22 @@ first, before handlers for jobs such as remote file access.
2814@code{file-name-nondirec@discretionary{}{}{}tory}, 2828@code{file-name-nondirec@discretionary{}{}{}tory},
2815@code{file-name-sans-versions}, @code{file-newer-than-file-p}, 2829@code{file-name-sans-versions}, @code{file-newer-than-file-p},
2816@code{file-ownership-pre@discretionary{}{}{}served-p}, 2830@code{file-ownership-pre@discretionary{}{}{}served-p},
2817@code{file-readable-p}, @code{file-regular-p}, @code{file-symlink-p}, 2831@code{file-readable-p}, @code{file-regular-p},
2818@code{file-truename}, @code{file-writable-p}, 2832@code{file-selinux-context},
2833@code{file-symlink-p}, @code{file-truename}, @code{file-writable-p},
2819@code{find-backup-file-name}, 2834@code{find-backup-file-name},
2820@c Not sure why it was here: @code{find-file-noselect}, 2835@c Not sure why it was here: @code{find-file-noselect},
2821@code{get-file-buffer}, 2836@code{get-file-buffer},
2822@code{insert-directory}, 2837@code{insert-directory},
2823@code{insert-file-contents}, 2838@code{insert-file-contents},
2824@code{load}, @code{make-direc@discretionary{}{}{}tory}, 2839@code{load},
2840@code{make-auto-save-file-name},
2841@code{make-direc@discretionary{}{}{}tory},
2825@code{make-direc@discretionary{}{}{}tory-internal}, 2842@code{make-direc@discretionary{}{}{}tory-internal},
2826@code{make-symbolic-link}, 2843@code{make-symbolic-link},
2827@code{process-file}, 2844@code{process-file},
2828@code{rename-file}, @code{set-file-modes}, 2845@code{rename-file}, @code{set-file-acl}, @code{set-file-modes},
2846@code{set-file-selinux-context}, @code{set-file-times},
2829@code{set-visited-file-modtime}, @code{shell-command}, 2847@code{set-visited-file-modtime}, @code{shell-command},
2830@code{start-file-process}, 2848@code{start-file-process},
2831@code{substitute-in-file-name}, 2849@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Frames 6@node Frames
6@chapter Frames 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Functions 6@node Functions
7@chapter Functions 7@chapter Functions
@@ -1266,7 +1266,7 @@ obsolete, or giving its forms a special @key{TAB} indentation
1266convention in Emacs Lisp mode. 1266convention in Emacs Lisp mode.
1267 1267
1268@anchor{Definition of declare} 1268@anchor{Definition of declare}
1269@defmac declare @var{specs}@dots{} 1269@defmac declare specs@dots{}
1270This macro ignores its arguments and evaluates to @code{nil}; it has 1270This macro ignores its arguments and evaluates to @code{nil}; it has
1271no run-time effect. However, when a @code{declare} form occurs in the 1271no run-time effect. However, when a @code{declare} form occurs in the
1272@var{declare} argument of a @code{defun} or @code{defsubst} function 1272@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1999, 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Hash Tables 5@node Hash Tables
6@chapter Hash Tables 6@chapter Hash Tables
@@ -293,7 +293,7 @@ compared case-insensitively.
293 293
294@example 294@example
295(defun case-fold-string= (a b) 295(defun case-fold-string= (a b)
296 (compare-strings a nil nil b nil nil t)) 296 (eq t (compare-strings a nil nil b nil nil t)))
297(defun case-fold-string-hash (a) 297(defun case-fold-string-hash (a)
298 (sxhash (upcase a))) 298 (sxhash (upcase a)))
299 299
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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Documentation 6@node Documentation
7@chapter Documentation 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1993, 1998, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1993, 1998, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Standard Hooks 6@node Standard Hooks
6@appendix Standard Hooks 7@appendix Standard Hooks
@@ -120,7 +121,7 @@ The command loop runs this soon after @code{post-command-hook} (q.v.).
120@item delete-terminal-functions 121@item delete-terminal-functions
121@xref{Multiple Terminals}. 122@xref{Multiple Terminals}.
122 123
123@itemx pop-up-frame-function 124@item pop-up-frame-function
124@itemx split-window-preferred-function 125@itemx split-window-preferred-function
125@xref{Choosing Window Options}. 126@xref{Choosing Window Options}.
126 127
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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1993, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1993, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node GNU Emacs Internals 6@node GNU Emacs Internals
6@appendix GNU Emacs Internals 7@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 @@
1@c -*-coding: iso-latin-1-*- 1@c -*-coding: iso-latin-1-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5 5
6@node Introduction 6@node Introduction
@@ -408,7 +408,7 @@ stands for zero or more arguments. Parentheses are used when several
408arguments are grouped into additional levels of list structure. Here 408arguments are grouped into additional levels of list structure. Here
409is an example: 409is an example:
410 410
411@defspec count-loop (@var{var} [@var{from} @var{to} [@var{inc}]]) @var{body}@dots{} 411@defspec count-loop (var [from to [inc]]) body@dots{}
412This imaginary special form implements a loop that executes the 412This imaginary special form implements a loop that executes the
413@var{body} forms and then increments the variable @var{var} on each 413@var{body} forms and then increments the variable @var{var} on each
414iteration. On the first iteration, the variable has the value 414iteration. 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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 1998-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 1998-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Keymaps 5@node Keymaps
6@chapter Keymaps 6@chapter Keymaps
@@ -94,9 +94,6 @@ Manual}.
94(kbd "<f1> SPC") @result{} [f1 32] 94(kbd "<f1> SPC") @result{} [f1 32]
95(kbd "C-M-<down>") @result{} [C-M-down] 95(kbd "C-M-<down>") @result{} [C-M-down]
96@end example 96@end example
97
98This macro is not meant for use with arguments that vary---only
99with string constants.
100@end defun 97@end defun
101 98
102@node Keymap Basics 99@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 @@
1\input texinfo @c -*-texinfo-*- 1\input texinfo @c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@c 5@c
6@comment %**start of header 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Lists 6@node Lists
6@chapter Lists 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Loading 6@node Loading
7@chapter Loading 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Macros 6@node Macros
6@chapter Macros 7@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 @@
1# -*- Makefile -*- for the GNU Emacs Lisp Reference Manual. 1# -*- Makefile -*- for the GNU Emacs Lisp Reference Manual.
2 2
3# Copyright (C) 2003-2012 Free Software Foundation, Inc. 3# Copyright (C) 2003-2013 Free Software Foundation, Inc.
4 4
5# This file is part of GNU Emacs. 5# This file is part of GNU Emacs.
6 6
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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1993, 1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1993, 1999, 2001-2013 Free Software Foundation,
4@c Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Standard Keymaps 6@node Standard Keymaps
6@appendix Standard Keymaps 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Markers 6@node Markers
6@chapter Markers 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Minibuffers 6@node Minibuffers
7@chapter Minibuffers 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Modes 6@node Modes
6@chapter Major and Minor Modes 7@chapter Major and Minor Modes
@@ -612,7 +613,7 @@ variables section specifying a mode for that particular file. This
612should not be applied to the containing tar file. Similarly, a tiff 613should not be applied to the containing tar file. Similarly, a tiff
613image file might just happen to contain a first line that seems to 614image file might just happen to contain a first line that seems to
614match the @w{@samp{-*-}} pattern. For these reasons, both these file 615match the @w{@samp{-*-}} pattern. For these reasons, both these file
615extensions are members of the list @var{inhibit-local-variables-regexps}. 616extensions are members of the list @code{inhibit-local-variables-regexps}.
616Add patterns to this list to prevent Emacs searching them for local 617Add patterns to this list to prevent Emacs searching them for local
617variables of any kind (not just mode specifiers). 618variables of any kind (not just mode specifiers).
618 619
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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1998-1999, 2001-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Non-ASCII Characters 5@node Non-ASCII Characters
6@chapter Non-@acronym{ASCII} Characters 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Numbers 6@node Numbers
7@chapter Numbers 7@chapter Numbers
@@ -43,7 +43,7 @@ minimum range is @minus{}536870912 to 536870911 (30 bits; i.e.,
43@end tex 43@end tex
44to 44to
45@ifnottex 45@ifnottex
462**29 - 1), 462**29 @minus{} 1),
47@end ifnottex 47@end ifnottex
48@tex 48@tex
49@math{2^{29}-1}), 49@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Lisp Data Types 6@node Lisp Data Types
7@chapter Lisp Data Types 7@chapter Lisp Data Types
@@ -171,7 +171,7 @@ latter are unique to Emacs Lisp.
171@end tex 171@end tex
172to 172to
173@ifnottex 173@ifnottex
1742**29 - 1) 1742**29 @minus{} 1)
175@end ifnottex 175@end ifnottex
176@tex 176@tex
177@math{2^{29}-1}) 177@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node System Interface 6@node System Interface
7@chapter Operating System Interface 7@chapter Operating System Interface
@@ -1421,23 +1421,23 @@ This stands for the day of month, blank-padded.
1421@item %h 1421@item %h
1422This is a synonym for @samp{%b}. 1422This is a synonym for @samp{%b}.
1423@item %H 1423@item %H
1424This stands for the hour (00-23). 1424This stands for the hour (00--23).
1425@item %I 1425@item %I
1426This stands for the hour (01-12). 1426This stands for the hour (01--12).
1427@item %j 1427@item %j
1428This stands for the day of the year (001-366). 1428This stands for the day of the year (001--366).
1429@item %k 1429@item %k
1430This stands for the hour (0-23), blank padded. 1430This stands for the hour (0--23), blank padded.
1431@item %l 1431@item %l
1432This stands for the hour (1-12), blank padded. 1432This stands for the hour (1--12), blank padded.
1433@item %m 1433@item %m
1434This stands for the month (01-12). 1434This stands for the month (01--12).
1435@item %M 1435@item %M
1436This stands for the minute (00-59). 1436This stands for the minute (00--59).
1437@item %n 1437@item %n
1438This stands for a newline. 1438This stands for a newline.
1439@item %N 1439@item %N
1440This stands for the nanoseconds (000000000-999999999). To ask for 1440This stands for the nanoseconds (000000000--999999999). To ask for
1441fewer digits, use @samp{%3N} for milliseconds, @samp{%6N} for 1441fewer digits, use @samp{%3N} for milliseconds, @samp{%6N} for
1442microseconds, etc. Any excess digits are discarded, without rounding. 1442microseconds, etc. Any excess digits are discarded, without rounding.
1443@item %p 1443@item %p
@@ -1447,18 +1447,18 @@ This is a synonym for @samp{%I:%M:%S %p}.
1447@item %R 1447@item %R
1448This is a synonym for @samp{%H:%M}. 1448This is a synonym for @samp{%H:%M}.
1449@item %S 1449@item %S
1450This stands for the seconds (00-59). 1450This stands for the seconds (00--59).
1451@item %t 1451@item %t
1452This stands for a tab character. 1452This stands for a tab character.
1453@item %T 1453@item %T
1454This is a synonym for @samp{%H:%M:%S}. 1454This is a synonym for @samp{%H:%M:%S}.
1455@item %U 1455@item %U
1456This stands for the week of the year (01-52), assuming that weeks 1456This stands for the week of the year (01--52), assuming that weeks
1457start on Sunday. 1457start on Sunday.
1458@item %w 1458@item %w
1459This stands for the numeric day of week (0-6). Sunday is day 0. 1459This stands for the numeric day of week (0--6). Sunday is day 0.
1460@item %W 1460@item %W
1461This stands for the week of the year (01-52), assuming that weeks 1461This stands for the week of the year (01--52), assuming that weeks
1462start on Monday. 1462start on Monday.
1463@item %x 1463@item %x
1464This has a locale-specific meaning. In the default locale (named 1464This 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
1467This has a locale-specific meaning. In the default locale (named 1467This has a locale-specific meaning. In the default locale (named
1468@samp{C}), it is equivalent to @samp{%T}. 1468@samp{C}), it is equivalent to @samp{%T}.
1469@item %y 1469@item %y
1470This stands for the year without century (00-99). 1470This stands for the year without century (00--99).
1471@item %Y 1471@item %Y
1472This stands for the year with century. 1472This stands for the year with century.
1473@item %Z 1473@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 2010-2012 Free Software Foundation, Inc. 3@c Copyright (C) 2010-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Packaging 5@node Packaging
6@chapter Preparing Lisp code for distribution 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Positions 5@node Positions
6@chapter Positions 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Processes 6@node Processes
7@chapter Processes 7@chapter Processes
@@ -1834,12 +1834,12 @@ The number of threads in the process.
1834 1834
1835@item start 1835@item start
1836The time when the process was started, in the same 1836The time when the process was started, in the same
1837@w{@code{(@var{high} @var{low} @var{microsec} @var{picosec})}} format used by 1837@code{(@var{high} @var{low} @var{microsec} @var{picosec})} format used by
1838@code{current-time} and by @code{file-attributes}. 1838@code{file-attributes} and @code{current-time}.
1839 1839
1840@item etime 1840@item etime
1841The time elapsed since the process started, in the @w{@code{(@var{high} 1841The time elapsed since the process started, in the format @code{(@var{high}
1842@var{low} @var{microsec} @var{picosec})}} format. 1842@var{low} @var{microsec} @var{picosec})}.
1843 1843
1844@item vsize 1844@item vsize
1845The virtual memory size of the process, measured in kilobytes. 1845The 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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Searching and Matching 6@node Searching and Matching
7@chapter Searching and Matching 7@chapter Searching and Matching
@@ -1325,7 +1325,7 @@ This stands for a single @samp{\} in the replacement text.
1325 1325
1326@item @samp{\?} 1326@item @samp{\?}
1327This stands for itself (for compatibility with @code{replace-regexp} 1327This stands for itself (for compatibility with @code{replace-regexp}
1328and related commands; @pxref{Regexp Replacement,,, emacs, The GNU 1328and related commands; @pxref{Regexp Replace,,, emacs, The GNU
1329Emacs Manual}). 1329Emacs Manual}).
1330@end table 1330@end table
1331 1331
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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Sequences Arrays Vectors 6@node Sequences Arrays Vectors
7@chapter Sequences, Arrays, and Vectors 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Read and Print 6@node Read and Print
6@chapter Reading and Printing Lisp Objects 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Strings and Characters 6@node Strings and Characters
7@chapter Strings and Characters 7@chapter Strings and Characters
@@ -517,25 +517,29 @@ comparison ignores case differences.
517@end defun 517@end defun
518 518
519@defun compare-strings string1 start1 end1 string2 start2 end2 &optional ignore-case 519@defun compare-strings string1 start1 end1 string2 start2 end2 &optional ignore-case
520This function compares the specified part of @var{string1} with the 520This function compares a specified part of @var{string1} with a
521specified part of @var{string2}. The specified part of @var{string1} 521specified part of @var{string2}. The specified part of @var{string1}
522runs from index @var{start1} up to index @var{end1} (@code{nil} means 522runs from index @var{start1} (inclusive) up to index @var{end1}
523the end of the string). The specified part of @var{string2} runs from 523(exclusive); @code{nil} for @var{start1} means the start of the
524index @var{start2} up to index @var{end2} (@code{nil} means the end of 524string, while @code{nil} for @var{end1} means the length of the
525the string). 525string. Likewise, the specified part of @var{string2} runs from index
526 526@var{start2} up to index @var{end2}.
527The strings are both converted to multibyte for the comparison 527
528(@pxref{Text Representations}) so that a unibyte string and its 528The strings are compared by the numeric values of their characters.
529conversion to multibyte are always regarded as equal. If 529For instance, @var{str1} is considered ``smaller than'' @var{str2} if
530@var{ignore-case} is non-@code{nil}, then case is ignored, so that 530its first differing character has a smaller numeric value. If
531upper case letters can be equal to lower case letters. 531@var{ignore-case} is non-@code{nil}, characters are converted to
532lower-case before comparing them. Unibyte strings are converted to
533multibyte for comparison (@pxref{Text Representations}), so that a
534unibyte string and its conversion to multibyte are always regarded as
535equal.
532 536
533If the specified portions of the two strings match, the value is 537If the specified portions of the two strings match, the value is
534@code{t}. Otherwise, the value is an integer which indicates how many 538@code{t}. Otherwise, the value is an integer which indicates how many
535leading characters agree, and which string is less. Its absolute value 539leading characters agree, and which string is less. Its absolute
536is one plus the number of characters that agree at the beginning of the 540value is one plus the number of characters that agree at the beginning
537two strings. The sign is negative if @var{string1} (or its specified 541of the two strings. The sign is negative if @var{string1} (or its
538portion) is less. 542specified portion) is less.
539@end defun 543@end defun
540 544
541@defun assoc-string key alist &optional case-fold 545@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
5@node Symbols 6@node Symbols
6@chapter Symbols 7@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Syntax Tables 6@node Syntax Tables
7@chapter Syntax Tables 7@chapter Syntax Tables
@@ -478,17 +478,17 @@ it easier to see the character returned by @code{char-syntax}.)
478@end group 478@end group
479 479
480@group 480@group
481;; Forward slash characters have punctuation syntax. Note that this 481;; Forward slash characters have punctuation syntax.
482;; @code{char-syntax} call does not reveal that it is also part of 482;; Note that this @code{char-syntax} call does not reveal
483;; comment-start and -end sequences. 483;; that it is also part of comment-start and -end sequences.
484(string (char-syntax ?/)) 484(string (char-syntax ?/))
485 @result{} "." 485 @result{} "."
486@end group 486@end group
487 487
488@group 488@group
489;; Open parenthesis characters have open parenthesis syntax. Note 489;; Open parenthesis characters have open parenthesis syntax.
490;; that this @code{char-syntax} call does not reveal that it has a 490;; Note that this @code{char-syntax} call does not reveal that
491;; matching character, @samp{)}. 491;; it has a matching character, @samp{)}.
492(string (char-syntax ?\()) 492(string (char-syntax ?\())
493 @result{} "(" 493 @result{} "("
494@end group 494@end group
@@ -506,7 +506,7 @@ This function returns the current syntax table, which is the table for
506the current buffer. 506the current buffer.
507@end defun 507@end defun
508 508
509@defmac with-syntax-table @var{table} @var{body}@dots{} 509@defmac with-syntax-table table body@dots{}
510This macro executes @var{body} using @var{table} as the current syntax 510This macro executes @var{body} using @var{table} as the current syntax
511table. It returns the value of the last form in @var{body}, after 511table. It returns the value of the last form in @var{body}, after
512restoring the old current syntax table. 512restoring the old current syntax table.
@@ -998,7 +998,7 @@ corresponds to each syntax flag.
998@samp{4} @tab @code{(lsh 1 19)} 998@samp{4} @tab @code{(lsh 1 19)}
999@end multitable 999@end multitable
1000 1000
1001@defun string-to-syntax @var{desc} 1001@defun string-to-syntax desc
1002Given a syntax descriptor @var{desc} (a string), this function returns 1002Given a syntax descriptor @var{desc} (a string), this function returns
1003the corresponding raw syntax descriptor. 1003the corresponding raw syntax descriptor.
1004@end defun 1004@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Text 5@node Text
6@chapter Text 6@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1993, 1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1993, 1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Tips 6@node Tips
7@appendix Tips and Conventions 7@appendix Tips and Conventions
@@ -934,7 +934,7 @@ explains these conventions, starting with an example:
934@group 934@group
935;;; foo.el --- Support for the Foo programming language 935;;; foo.el --- Support for the Foo programming language
936 936
937;; Copyright (C) 2010-2012 Your Name 937;; Copyright (C) 2010-2013 Your Name
938@end group 938@end group
939 939
940;; Author: Your Name <yourname@@example.com> 940;; Author: Your Name <yourname@@example.com>
@@ -942,6 +942,7 @@ explains these conventions, starting with an example:
942;; Created: 14 Jul 2010 942;; Created: 14 Jul 2010
943@group 943@group
944;; Keywords: languages 944;; Keywords: languages
945;; Homepage: http://example.com/foo
945 946
946;; This file is not part of GNU Emacs. 947;; This file is not part of GNU Emacs.
947 948
@@ -980,8 +981,7 @@ the conventional possibilities for @var{header-name}:
980@item Author 981@item Author
981This line states the name and email address of at least the principal 982This line states the name and email address of at least the principal
982author of the library. If there are multiple authors, list them on 983author of the library. If there are multiple authors, list them on
983continuation lines led by @code{;;} and whitespace (this is easier 984continuation lines led by @code{;;} and a tab or at least two spaces.
984for tools to parse than having more than one author on one line).
985We recommend including a contact email address, of the form 985We recommend including a contact email address, of the form
986@samp{<@dots{}>}. For example: 986@samp{<@dots{}>}. For example:
987 987
@@ -1028,6 +1028,9 @@ The name of this field is unfortunate, since people often assume it is
1028the place to write arbitrary keywords that describe their package, 1028the place to write arbitrary keywords that describe their package,
1029rather than just the relevant Finder keywords. 1029rather than just the relevant Finder keywords.
1030 1030
1031@item Homepage
1032This line states the homepage of the library.
1033
1031@item Package-Version 1034@item Package-Version
1032If @samp{Version} is not suitable for use by the package manager, then 1035If @samp{Version} is not suitable for use by the package manager, then
1033a package can define @samp{Package-Version}; it will be used instead. 1036a 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.
1063library file. These should be separated from anything else by blank 1066library file. These should be separated from anything else by blank
1064lines. Here is a table of them: 1067lines. Here is a table of them:
1065 1068
1069@cindex commentary, in a Lisp library
1066@table @samp 1070@table @samp
1067@item ;;; Commentary: 1071@item ;;; Commentary:
1068This begins introductory comments that explain how the library works. 1072This 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 @@
1Copyright (C) 2001-2012 Free Software Foundation, Inc. 1Copyright (C) 2001-2013 Free Software Foundation, Inc.
2See end for copying conditions. 2See end for copying conditions.
3 3
4Two Volume Cross References 4Two 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 @@
1# Copyright (C) 2007-2012 Free Software Foundation, Inc. 1# Copyright (C) 2007-2013 Free Software Foundation, Inc.
2# See end for copying conditions. 2# See end for copying conditions.
3 3
4# although it would be nice to use tex rather than pdftex to avoid 4# 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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1995, 1998-2013 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@node Variables 5@node Variables
6@chapter Variables 6@chapter Variables
@@ -1057,7 +1057,7 @@ variables}. Every variable that has been defined with @code{defvar},
1057(@pxref{Defining Variables}). All other variables are subject to 1057(@pxref{Defining Variables}). All other variables are subject to
1058lexical binding. 1058lexical binding.
1059 1059
1060@defun special-variable-p SYMBOL 1060@defun special-variable-p symbol
1061This function returns non-@code{nil} if @var{symbol} is a special 1061This function returns non-@code{nil} if @var{symbol} is a special
1062variable (i.e., it has a @code{defvar}, @code{defcustom}, or 1062variable (i.e., it has a @code{defvar}, @code{defcustom}, or
1063@code{defconst} variable definition). Otherwise, the return value is 1063@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 @@
1@c -*-texinfo-*- 1@c -*-texinfo-*-
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 3@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software
4@c Free Software Foundation, Inc. 4@c Foundation, Inc.
5@c See the file elisp.texi for copying conditions. 5@c See the file elisp.texi for copying conditions.
6@node Windows 6@node Windows
7@chapter Windows 7@chapter Windows
@@ -1296,10 +1296,12 @@ windows.
1296@cindex selecting a window 1296@cindex selecting a window
1297 1297
1298@defun select-window window &optional norecord 1298@defun select-window window &optional norecord
1299This function makes @var{window} the selected window, as well as the 1299This function makes @var{window} the selected window and the window
1300window selected within its frame (@pxref{Basic Windows}). @var{window} 1300selected within its frame (@pxref{Basic Windows}) and selects that
1301must be a live window. This function makes also @var{window}'s buffer 1301frame. @var{window} must be a live window. This function also makes
1302current (@pxref{Buffers and Windows}). The return value is 1302@var{window}'s buffer (@pxref{Buffers and Windows}) current and sets
1303that buffer's value of @code{point} to the value of @code{window-point}
1304(@pxref{Window Point}) in @var{window}. The return value is
1303@var{window}. 1305@var{window}.
1304 1306
1305By default, this function also moves @var{window}'s buffer to the front 1307By 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)}.
1865@defopt display-buffer-alist 1867@defopt display-buffer-alist
1866The value of this option is an alist mapping conditions to display 1868The value of this option is an alist mapping conditions to display
1867actions. Each condition may be either a regular expression matching a 1869actions. Each condition may be either a regular expression matching a
1868buffer name or a function that takes two arguments - a buffer name and 1870buffer name or a function that takes two arguments: a buffer name and
1869the @var{action} argument passed to @code{display-buffer}. If the name 1871the @var{action} argument passed to @code{display-buffer}. If the name
1870of the buffer passed to @code{display-buffer} either matches a regular 1872of the buffer passed to @code{display-buffer} either matches a regular
1871expression in this alist or the function specified by a condition 1873expression in this alist or the function specified by a condition
@@ -1966,7 +1968,7 @@ height of the frame's root window.
1966 1968
1967@item 1969@item
1968If the @sc{cdr} specifies a function, that function is called with one 1970If the @sc{cdr} specifies a function, that function is called with one
1969argument - the new window. The function is supposed to adjust the 1971argument: the new window. The function is supposed to adjust the
1970height of the window; its return value is ignored. Suitable functions 1972height of the window; its return value is ignored. Suitable functions
1971are @code{shrink-window-if-larger-than-buffer} and 1973are @code{shrink-window-if-larger-than-buffer} and
1972@code{fit-window-to-buffer}, see @ref{Resizing Windows}. 1974@code{fit-window-to-buffer}, see @ref{Resizing Windows}.
@@ -1987,7 +1989,7 @@ width of the frame's root window.
1987 1989
1988@item 1990@item
1989If the @sc{cdr} specifies a function, that function is called with one 1991If the @sc{cdr} specifies a function, that function is called with one
1990argument - the new window. The function is supposed to adjust the width 1992argument: the new window. The function is supposed to adjust the width
1991of the window; its return value is ignored. 1993of the window; its return value is ignored.
1992@end itemize 1994@end itemize
1993 1995
@@ -3616,10 +3618,10 @@ This parameter is installed by the buffer display functions
3616(@pxref{Choosing Window}) and consulted by @code{quit-restore-window} 3618(@pxref{Choosing Window}) and consulted by @code{quit-restore-window}
3617(@pxref{Quitting Windows}). It contains four elements: 3619(@pxref{Quitting Windows}). It contains four elements:
3618 3620
3619The first element is one of the symbols @code{window} - meaning that the 3621The first element is one of the symbols @code{window}, meaning that the
3620window has been specially created by @code{display-buffer}, @code{frame} 3622window has been specially created by @code{display-buffer}; @code{frame},
3621- a separate frame has been created, @code{same} - the window has 3623a separate frame has been created; @code{same}, the window has
3622displayed the same buffer before, or @code{other} - the window showed 3624displayed the same buffer before; or @code{other}, the window showed
3623another buffer before. 3625another buffer before.
3624 3626
3625The second element is either one of the symbols @code{window} or 3627The second element is either one of the symbols @code{window} or