summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'app-doc/elisp-manual/files')
-rw-r--r--app-doc/elisp-manual/files/elisp-manual-18.1.03-direntry.patch18
-rw-r--r--app-doc/elisp-manual/files/elisp-manual-18.1.03-fix-texinfo.patch301
-rw-r--r--app-doc/elisp-manual/files/elisp-manual-21.2.8-direntry.patch18
-rw-r--r--app-doc/elisp-manual/files/elisp-manual-21.2.8-fix-texinfo.patch83
4 files changed, 420 insertions, 0 deletions
diff --git a/app-doc/elisp-manual/files/elisp-manual-18.1.03-direntry.patch b/app-doc/elisp-manual/files/elisp-manual-18.1.03-direntry.patch
new file mode 100644
index 0000000..53c70bf
--- /dev/null
+++ b/app-doc/elisp-manual/files/elisp-manual-18.1.03-direntry.patch
@@ -0,0 +1,18 @@
+--- elisp-orig/elisp.texi 2008-11-25 18:52:22.000000000 +0100
++++ elisp/elisp.texi 2008-11-25 18:56:42.000000000 +0100
+@@ -1,9 +1,14 @@
+ \input texinfo @c -*-texinfo-*-
+ @c %**start of header
+-@setfilename elisp
++@setfilename elisp18.info
+ @settitle GNU Emacs Lisp Reference Manual
+ @c %**end of header
+
++@dircategory Emacs
++@direntry
++* Elisp 18: (elisp18). The Emacs Lisp Reference Manual for Emacs 18.
++@end direntry
++
+ @c ================================================================
+ @c THIS file has the new style title page commands.
+ @c Also, it uses `@@include' files instead of `@@input' files.
diff --git a/app-doc/elisp-manual/files/elisp-manual-18.1.03-fix-texinfo.patch b/app-doc/elisp-manual/files/elisp-manual-18.1.03-fix-texinfo.patch
new file mode 100644
index 0000000..01c3252
--- /dev/null
+++ b/app-doc/elisp-manual/files/elisp-manual-18.1.03-fix-texinfo.patch
@@ -0,0 +1,301 @@
+--- elisp-orig/commands.texi 1990-11-29 23:03:21.000000000 +0000
++++ elisp/commands.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -533,5 +533,5 @@
+
+ @noindent
+-The value is 5 because that is the @sc{ASCII} code for @kbd{C-e}.
++The value is 5 because that is the @sc{ascii} code for @kbd{C-e}.
+ @end defvar
+
+@@ -569,5 +569,5 @@
+ cursor does not move. @xref{The Echo Area}.
+
+-In the first example, the user types @kbd{1} (which is @sc{ASCII} code
++In the first example, the user types @kbd{1} (which is @sc{ascii} code
+ 49). The second example shows a keyboard macro definition that calls
+ @code{read-char} from the minibuffer. @code{read-char} reads the
+@@ -685,5 +685,5 @@
+
+ In the example below, a character is read (the character @kbd{1},
+-@sc{ASCII} code 49). It becomes the value of @code{last-input-char},
++@sc{ascii} code 49). It becomes the value of @code{last-input-char},
+ while @kbd{C-e} (from the @kbd{C-x C-e} command used to evaluate this
+ expression) remains the value of @code{last-command-char}.
+--- elisp-orig/display.texi 1990-10-11 00:14:05.000000000 +0000
++++ elisp/display.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -484,5 +484,5 @@
+
+ @quotation
+-@strong{Note:} in version 18, this function is named
++@strong{Please note:} in version 18, this function is named
+ @code{blink-paren-hook}, but since it is not called with the standard
+ convention for hooks, it is being renamed to @code{blink-paren-function}
+--- elisp-orig/elisp.texi 1990-12-05 20:49:07.000000000 +0000
++++ elisp/elisp.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -112,5 +112,5 @@
+ @page
+
+-@node Top, Introduction, (dir), (dir)
++@node Top, License, (dir), (dir)
+
+ @ifinfo
+--- elisp-orig/files.texi 1990-06-26 13:54:44.000000000 +0000
++++ elisp/files.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -189,6 +189,6 @@
+ appended to get an unused name. See also @ref{Creating Buffers}.
+
+-@strong{Note:} @code{create-file-buffer} does @emph{not} associate the
+-new buffer with a file and does not make it the current buffer.
++@strong{Please note:} @code{create-file-buffer} does @emph{not} associate
++the new buffer with a file and does not make it the current buffer.
+
+ @example
+--- elisp-orig/functions.texi 1991-01-16 00:03:56.000000000 +0000
++++ elisp/functions.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -613,5 +613,5 @@
+ Return the list of results."
+ (if (not (memq 'nil args)) ; @r{If no list is exhausted,}
+- (cons (apply f (mapcar 'car args)) ; @r{Apply function to @sc{CAR}s.}
++ (cons (apply f (mapcar 'car args)) ; @r{Apply function to @sc{car}s.}
+ (apply 'mapcar* f ; @r{Recurse for rest of elements.}
+ (mapcar 'cdr args)))))
+--- elisp-orig/help.texi 1990-05-31 18:50:37.000000000 +0000
++++ elisp/help.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -252,6 +252,6 @@
+ @end table
+
+-@strong{Note:} each @samp{\} must be doubled when written in a string in
+-Emacs Lisp.
++@strong{Please note:} each @samp{\} must be doubled when written in a
++string in Emacs Lisp.
+
+ Here are examples of the special substrings:
+--- elisp-orig/hooks.texi 1990-05-16 15:39:45.000000000 +0000
++++ elisp/hooks.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -12,5 +12,5 @@
+
+ @quotation
+-@strong{Note:} in version 19, @code{blink-paren-hook} and
++@strong{Please note:} in version 19, @code{blink-paren-hook} and
+ @code{auto-fill-hook} are renamed to @code{blink-paren-function} and
+ @code{auto-fill-function} respectively, since they are not called by the
+--- elisp-orig/keymaps.texi 1990-05-16 15:40:19.000000000 +0000
++++ elisp/keymaps.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -357,5 +357,5 @@
+ looked up in a keymap. For useful results, the value should be a prefix
+ character (@pxref{Prefix Keys}). The default value is 27, which is the
+-@sc{ASCII} code for @key{ESC}.
++@sc{ascii} code for @key{ESC}.
+
+ As long as the value of @code{meta-prefix-char} remains 27, key
+@@ -538,5 +538,5 @@
+ if it has none. In the following example, the keymap for the
+ @samp{*scratch*} buffer (using Lisp Interaction mode) is a sparse keymap
+-in which the entry for @key{ESC}, @sc{ASCII} code 27, is another sparse
++in which the entry for @key{ESC}, @sc{ascii} code 27, is another sparse
+ keymap.
+
+@@ -912,8 +912,8 @@
+ When several consecutive characters have the same definition, they are
+ shown together, as @samp{@var{firstchar}..@var{lastchar}}. In this
+-instance, you need to know the @sc{ASCII} codes to understand which
++instance, you need to know the @sc{ascii} codes to understand which
+ characters this means. For example, in the default global map, the
+ characters @samp{@key{SPC} ..@: ~} are described by a single line.
+-@key{SPC} is @sc{ASCII} 32, @kbd{~} is @sc{ASCII} 126, and the
++@key{SPC} is @sc{ascii} 32, @kbd{~} is @sc{ascii} 126, and the
+ characters between them include all the normal printing characters,
+ (e.g., letters, digits, punctuation, etc.@:); all these characters are
+--- elisp-orig/markers.texi 1990-05-31 19:10:17.000000000 +0000
++++ elisp/markers.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -364,6 +364,6 @@
+ The old value of the mark is @emph{not} pushed onto the mark ring.
+
+- @strong{Note:} use this function only if you want the user to see that
+-the mark has moved, and you want the previous mark position to be lost.
++ @strong{Please note:} use this function only if you want the user to see
++that the mark has moved, and you want the previous mark position to be lost.
+ Normally, when a new mark is set, the old one should go on the
+ @code{mark-ring}, which is why most applications should use
+--- elisp-orig/objects.texi 1990-08-25 20:46:08.000000000 +0000
++++ elisp/objects.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -261,5 +261,5 @@
+
+ A @dfn{character} in Emacs Lisp is nothing more than an integer. In
+-other words, characters are represented by their eight-bit @sc{ASCII}
++other words, characters are represented by their eight-bit @sc{ascii}
+ values. For example, the character @kbd{A} is represented as the
+ @w{integer 65}. If an arbitrary integer is used as a character, only
+@@ -387,10 +387,10 @@
+ @cindex escape sequence
+ Finally, the most general read syntax consists of a question mark
+-followed by a backslash and the @sc{ASCII} code for the character in
++followed by a backslash and the @sc{ascii} code for the character in
+ octal (up to three octal digits); thus, @samp{?\101} for the character
+ @kbd{A}, @samp{?\001} for the character @kbd{C-a}, and @code{?\002} for
+ the character @kbd{C-b}. Although this syntax can represent any
+ character, it is preferred only when the precise octal value is more
+-important than the @sc{ASCII} representation. (These sequences which
++important than the @sc{ascii} representation. (These sequences which
+ start with backslash are also known as @dfn{escape sequences}, because
+ backslash plays the role of an escape character, but they have nothing
+--- elisp-orig/os.texi 1990-11-29 23:02:02.000000000 +0000
++++ elisp/os.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -90,5 +90,5 @@
+ @end defopt
+
+-@node Init File, Terminal-Specific, Start-Up Summary, Starting Up
++@node Init File, Terminal-Specific, Start-up Summary, Starting Up
+ @subsection The Init File: @file{.emacs}
+ @cindex init file
+@@ -688,5 +688,5 @@
+ are swapped and the characters @kbd{C-q} and @kbd{C-^} are swapped.
+ After executing this function, typing @kbd{C-\} has all the usual
+-effects of typing @kbd{C-s}, and vice versa. (@xref{Flow Control} for
++effects of typing @kbd{C-s}, and vice versa. (@xref{Flow Control}, for
+ more information on this subject.)
+
+@@ -743,6 +743,6 @@
+ you will have to start Emacs afresh to make this take effect.
+
+-@strong{Note:} In version 19, @code{baud-rate} is a variable so that you
+-can change it conveniently within Emacs.
++@strong{Please note:} In version 19, @code{baud-rate} is a variable so
++that you can change it conveniently within Emacs.
+ @end defun
+
+@@ -797,5 +797,5 @@
+ that the choice of @kbd{C-s} and @kbd{C-q} as command characters was
+ reasonable. Emacs, for economy of keystrokes and portability, chose to
+-use the control characters in the @sc{ASCII} character set, and tried to
++use the control characters in the @sc{ascii} character set, and tried to
+ make the assignments mnemonic (thus, @kbd{C-s} for search and @kbd{C-q}
+ for quote).
+--- elisp-orig/positions.texi 1990-05-31 19:07:46.000000000 +0000
++++ elisp/positions.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -75,5 +75,5 @@
+ current buffer. This is @code{(1+ (buffer-size))}, unless narrowing is
+ in effect, in which case it is the position of the end of the region
+-that you narrowed to. (@xref{Narrowing}).
++that you narrowed to. (@xref{Narrowing}.)
+ @end defun
+
+@@ -745,5 +745,5 @@
+ last of @var{forms}, or @code{nil} if no forms were given.
+
+-@strong{Note:} it is easy to make a mistake when using
++@strong{Caution:} it is easy to make a mistake when using
+ @code{save-restriction}. Read the entire description here before you
+ try it.
+--- elisp-orig/processes.texi 1990-12-01 21:17:14.000000000 +0000
++++ elisp/processes.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -90,8 +90,8 @@
+ supplied to @var{program} as separate command line arguments. Wildcard
+ characters and other shell constructs are not allowed in these strings,
+-since they are passed directly to the specified program. @strong{Note:}
+-the argument @var{program} contains only the name of the program; it may
+-not contain any command-line arguments. Such arguments must be provided
+-via @var{args}.
++since they are passed directly to the specified program.
++@strong{Please note:} the argument @var{program} contains only the name
++of the program; it may not contain any command-line arguments. Such
++arguments must be provided via @var{args}.
+
+ The subprocess gets its current directory from the value of
+--- elisp-orig/searching.texi 1990-08-29 03:21:46.000000000 +0000
++++ elisp/searching.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -292,10 +292,10 @@
+ @end table
+
+-@strong{Note:} for historical compatibility, special characters are treated as
+-ordinary ones if they are in contexts where their special meanings make no
+-sense. For example, @samp{*foo} treats @samp{*} as ordinary since there is
+-no preceding expression on which the @samp{*} can act. It is poor practice
+-to depend on this behavior; better to quote the special character anyway,
+-regardless of where it appears.@refill
++@strong{Please note:} for historical compatibility, special characters
++are treated as ordinary ones if they are in contexts where their special
++meanings make no sense. For example, @samp{*foo} treats @samp{*} as
++ordinary since there is no preceding expression on which the @samp{*}
++can act. It is poor practice to depend on this behavior; better to quote
++the special character anyway, regardless of where it appears.@refill
+
+ For the most part, @samp{\} followed by any character matches only
+--- elisp-orig/sequences.texi 1990-06-07 00:17:50.000000000 +0000
++++ elisp/sequences.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -235,5 +235,5 @@
+
+ (aref "abcdefg" 1)
+- @result{} 98 ; @r{@samp{b} is @sc{ASCII} code 98.}
++ @result{} 98 ; @r{@samp{b} is @sc{ascii} code 98.}
+ @end example
+
+--- elisp-orig/strings.texi 1990-06-07 00:12:23.000000000 +0000
++++ elisp/strings.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -37,6 +37,6 @@
+ the string contents, and cannot be altered. Strings in Lisp are
+ @emph{not} terminated by a distinguished character code. (By contrast,
+-strings in C are terminated by a character with @sc{ASCII} code 0.)
+-This means that any character, including the null character (@sc{ASCII}
++strings in C are terminated by a character with @sc{ascii} code 0.)
++This means that any character, including the null character (@sc{ascii}
+ code 0), is a valid element of a string.@refill
+
+@@ -261,7 +261,7 @@
+ @code{nil}. If the two strings match entirely, the value is @code{nil}.
+
+- Pairs of characters are compared by their @sc{ASCII} codes. Keep in
++ Pairs of characters are compared by their @sc{ascii} codes. Keep in
+ mind that lower case letters have higher numeric values in the
+-@sc{ASCII} character set than their upper case counterparts; numbers and
++@sc{ascii} character set than their upper case counterparts; numbers and
+ many punctuation characters have a lower numeric value than upper case
+ letters.
+@@ -345,5 +345,5 @@
+ This function returns the first character in @var{string}. If the
+ string is empty, the function returns 0. The value is also 0 when the
+-first character of @var{string} is the null character, @sc{ASCII} code
++first character of @var{string} is the null character, @sc{ascii} code
+ 0.
+
+@@ -567,5 +567,5 @@
+
+ The examples below use the characters @samp{X} and @samp{x} which have
+-@sc{ASCII} codes 88 and 120 respectively.
++@sc{ascii} codes 88 and 120 respectively.
+
+ @defun downcase string-or-char
+@@ -621,5 +621,5 @@
+ The definition of a word is any sequence of consecutive characters
+ that are assigned to the word constituent category in the current syntax
+-table (@xref{Syntax Class Table}).
++table (@pxref{Syntax Class Table}).
+
+ When the argument to @code{capitalize} is a character, @code{capitalize}
+--- elisp-orig/syntax.texi 1990-05-16 15:43:55.000000000 +0000
++++ elisp/syntax.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -19,5 +19,5 @@
+
+ A syntax table is a vector of 256 elements; it contains one entry for
+-each of the 256 @sc{ASCII} characters of an 8-bit byte. Each element is
++each of the 256 @sc{ascii} characters of an 8-bit byte. Each element is
+ an integer that encodes the syntax of the character in question.
+
+--- elisp-orig/text.texi 1990-05-31 19:17:44.000000000 +0000
++++ elisp/text.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -1016,5 +1016,5 @@
+ unequal; the sort key whose character is less at the point of first
+ mismatch is the lesser sort key. The individual characters are compared
+-according to their numerical values. Since Emacs uses the @sc{ASCII}
++according to their numerical values. Since Emacs uses the @sc{ascii}
+ character set, the ordering in that set determines alphabetical order.
+ @c version 19 change
+--- elisp-orig/variables.texi 1990-12-02 18:51:32.000000000 +0000
++++ elisp/variables.texi 2008-11-25 23:01:58.000000000 +0000
+@@ -425,5 +425,5 @@
+ of @var{symbol} to the result, provided @var{value} is given.
+
+-@strong{Note:} don't use @code{defconst} for user option variables in
++Don't use @code{defconst} for user option variables in
+ libraries that are not normally loaded. The user should be able to
+ specify a value for such a variable in the @file{.emacs} file, so that
diff --git a/app-doc/elisp-manual/files/elisp-manual-21.2.8-direntry.patch b/app-doc/elisp-manual/files/elisp-manual-21.2.8-direntry.patch
new file mode 100644
index 0000000..3899b28
--- /dev/null
+++ b/app-doc/elisp-manual/files/elisp-manual-21.2.8-direntry.patch
@@ -0,0 +1,18 @@
+--- elisp-manual-21-2.8-orig/elisp.texi 2002-01-17 10:02:47.000000000 +0100
++++ elisp-manual-21-2.8/elisp.texi 2008-11-25 11:37:35.000000000 +0100
+@@ -1,12 +1,12 @@
+ \input texinfo @c -*-texinfo-*-
+ @c %**start of header
+-@setfilename elisp
++@setfilename elisp21.info
+ @settitle GNU Emacs Lisp Reference Manual
+ @c %**end of header
+
+-@dircategory Editors
++@dircategory Emacs
+ @direntry
+-* Elisp: (elisp). The Emacs Lisp Reference Manual.
++* Elisp 21: (elisp21). The Emacs Lisp Reference Manual for Emacs 21.
+ @end direntry
+
+ @smallbook
diff --git a/app-doc/elisp-manual/files/elisp-manual-21.2.8-fix-texinfo.patch b/app-doc/elisp-manual/files/elisp-manual-21.2.8-fix-texinfo.patch
new file mode 100644
index 0000000..a42d344
--- /dev/null
+++ b/app-doc/elisp-manual/files/elisp-manual-21.2.8-fix-texinfo.patch
@@ -0,0 +1,83 @@
+Change all occurences of @strong{Note:} to avoid makeinfo warnings and
+spurious cross references. This is a backport of the following change:
+
+2003-09-26 Richard M. Stallman <rms@gnu.org>
+
+ * buffers.texi, commands.texi, debugging.texi, eval.texi:
+ * loading.texi, minibuf.texi, text.texi, variables.texi:
+ Avoid @strong{Note:}.
+
+--- elisp-orig/buffers.texi 2001-09-23 18:52:16.000000000 +0000
++++ elisp/buffers.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -107,5 +107,5 @@
+ that, you must use the functions described in @ref{Displaying Buffers}.
+
+- @strong{Note:} Lisp functions that change to a different current buffer
++ @strong{Warning:} Lisp functions that change to a different current buffer
+ should not depend on the command loop to set it back afterwards.
+ Editing commands written in Emacs Lisp can be called from other programs
+--- elisp-orig/commands.texi 2001-09-10 05:06:03.000000000 +0000
++++ elisp/commands.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -2018,5 +2018,5 @@
+ function.
+
+-@strong{Note:} Don't bind this variable with @code{let}. It is often
++@strong{Warning:} Don't bind this variable with @code{let}. It is often
+ buffer-local, and if you bind it around reading input (which is exactly
+ when you @emph{would} bind it), switching buffers asynchronously while
+--- elisp-orig/debugging.texi 2000-12-04 16:15:18.000000000 +0000
++++ elisp/debugging.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -216,5 +216,5 @@
+ @code{debug-on-entry} always returns @var{function-name}.
+
+-@strong{Note:} if you redefine a function after using
++@strong{Warning:} if you redefine a function after using
+ @code{debug-on-entry} on it, the code to enter the debugger is discarded
+ by the redefinition. In effect, redefining the function cancels
+--- elisp-orig/eval.texi 2000-01-05 15:17:53.000000000 +0000
++++ elisp/eval.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -589,5 +589,5 @@
+ values. Loading a file also does evaluation (@pxref{Loading}).
+
+- @strong{Note:} it is generally cleaner and more flexible to store a
++ It is generally cleaner and more flexible to store a
+ function in a data structure, and call it with @code{funcall} or
+ @code{apply}, than to store an expression in the data structure and
+--- elisp-orig/loading.texi 2001-09-06 19:49:45.000000000 +0000
++++ elisp/loading.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -149,5 +149,5 @@
+ functions should use @code{read}.
+
+-@strong{Note:} Instead of using this variable, it is cleaner to use
++Instead of using this variable, it is cleaner to use
+ another, newer feature: to pass the function as the @var{read-function}
+ argument to @code{eval-region}. @xref{Eval}.
+--- elisp-orig/minibuf.texi 2001-10-02 02:34:48.000000000 +0000
++++ elisp/minibuf.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -1064,6 +1064,6 @@
+ case, point goes at the beginning of @var{initial}. The default for
+ @var{initial} is @code{nil}---don't insert any file name. To see what
+-@var{initial} does, try the command @kbd{C-x C-v}. @strong{Note:} we
+-recommend using @var{default} rather than @var{initial} in most cases.
++@var{initial} does, try the command @kbd{C-x C-v}. @strong{Please note:}
++we recommend using @var{default} rather than @var{initial} in most cases.
+
+ Here is an example:
+--- elisp-orig/text.texi 2001-10-02 02:21:59.000000000 +0000
++++ elisp/text.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -3694,5 +3694,5 @@
+ the body of a @code{combine-after-change-calls} form.
+
+-@strong{Note:} If the changes you combine occur in widely scattered
++@strong{Warning:} If the changes you combine occur in widely scattered
+ parts of the buffer, this will still work, but it is not advisable,
+ because it may lead to inefficient behavior for some change hook
+--- elisp-orig/variables.texi 2001-09-06 19:43:44.000000000 +0000
++++ elisp/variables.texi 2008-11-25 22:20:16.000000000 +0000
+@@ -1290,5 +1290,5 @@
+ Displays}.
+
+-@strong{Note:} Do not use @code{make-local-variable} for a hook
++@strong{Warning:} Do not use @code{make-local-variable} for a hook
+ variable. Instead, use @code{make-local-hook}. @xref{Hooks}.
+ @end deffn