diff options
| author | Miles Bader | 2007-11-21 04:55:58 +0000 |
|---|---|---|
| committer | Miles Bader | 2007-11-21 04:55:58 +0000 |
| commit | d4aa48db8ed36b1fc7e7b0e6bd35049353f7f96e (patch) | |
| tree | 4a8c1381059835b73876f59183e228a2fb740d59 /doc | |
| parent | 3d9bd2bc2806ecaf85f4474060a7fadfd00e61fd (diff) | |
| parent | 33127d1a78f2a37d68ffa09642df2f38d78e95b1 (diff) | |
| download | emacs-d4aa48db8ed36b1fc7e7b0e6bd35049353f7f96e.tar.gz emacs-d4aa48db8ed36b1fc7e7b0e6bd35049353f7f96e.zip | |
Merge from emacs--rel--22
Revision: emacs@sv.gnu.org/emacs--devo--0--patch-937
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/ChangeLog | 16 | ||||
| -rw-r--r-- | doc/emacs/mule.texi | 9 | ||||
| -rw-r--r-- | doc/misc/cl.texi | 63 | ||||
| -rw-r--r-- | doc/misc/flymake.texi | 9 |
4 files changed, 39 insertions, 58 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index cb40f082307..02d9e85ac50 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog | |||
| @@ -1,3 +1,8 @@ | |||
| 1 | 2007-11-18 Richard Stallman <rms@gnu.org> | ||
| 2 | |||
| 3 | * flymake.texi (Example -- Configuring a tool called directly): | ||
| 4 | Update example. | ||
| 5 | |||
| 1 | 2007-11-17 Eli Zaretskii <eliz@gnu.org> | 6 | 2007-11-17 Eli Zaretskii <eliz@gnu.org> |
| 2 | 7 | ||
| 3 | * mule.texi (Communication Coding): Fix wording of last change. | 8 | * mule.texi (Communication Coding): Fix wording of last change. |
| @@ -7,9 +12,18 @@ | |||
| 7 | * custom.texi (Specifying File Variables), major.texi (Choosing | 12 | * custom.texi (Specifying File Variables), major.texi (Choosing |
| 8 | Modes): Mention '\" in man pages. | 13 | Modes): Mention '\" in man pages. |
| 9 | 14 | ||
| 15 | 2007-11-15 Richard Stallman <rms@gnu.org> | ||
| 16 | |||
| 17 | * cl.texi (Equality Predicates): Delete `eql'. | ||
| 18 | (Predicates, Naming Conventions, Top): Delete `eql'. | ||
| 19 | (Common Lisp Compatibility): Delete `eql'. | ||
| 20 | (Porting Common Lisp): Delete obsolete backquote info. | ||
| 21 | Minor clarification about character constants. | ||
| 22 | (Sequence Basics): Minor clarification. | ||
| 23 | |||
| 10 | 2007-11-16 Kenichi Handa <handa@ni.aist.go.jp> | 24 | 2007-11-16 Kenichi Handa <handa@ni.aist.go.jp> |
| 11 | 25 | ||
| 12 | * mule.texi (Communication Coding): Mention x-select-request-type. | 26 | * mule.texi (Communication Coding): Document x-select-request-type. |
| 13 | 27 | ||
| 14 | * frames.texi (Cut/Paste Other App): Mention x-select-request-type. | 28 | * frames.texi (Cut/Paste Other App): Mention x-select-request-type. |
| 15 | 29 | ||
diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index 27b3284082f..d7dd364b6d0 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi | |||
| @@ -1129,6 +1129,15 @@ specified by one of the environment variables @env{LC_ALL}, | |||
| 1129 | specified above, whose value is nonempty is the one that determines | 1129 | specified above, whose value is nonempty is the one that determines |
| 1130 | the text representation.) | 1130 | the text representation.) |
| 1131 | 1131 | ||
| 1132 | @vindex x-select-request-type | ||
| 1133 | The variable @code{x-select-request-type} specifies a selection data | ||
| 1134 | type of selection to request from the X server. The default value is | ||
| 1135 | @code{nil}, which means Emacs tries @code{COMPOUND_TEXT} and | ||
| 1136 | @code{UTF8_STRING}, and uses whichever result seems more appropriate. | ||
| 1137 | You can explicitly specify the data type by setting the variable to | ||
| 1138 | one of the symbols @code{COMPOUND_TEXT}, @code{UTF8_STRING}, | ||
| 1139 | @code{STRING} and @code{TEXT}. | ||
| 1140 | |||
| 1132 | @node File Name Coding | 1141 | @node File Name Coding |
| 1133 | @section Coding Systems for File Names | 1142 | @section Coding Systems for File Names |
| 1134 | 1143 | ||
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index c27021cb325..ea485ef84f8 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi | |||
| @@ -62,14 +62,14 @@ does assume a basic familiarity with Emacs Lisp. | |||
| 62 | @menu | 62 | @menu |
| 63 | * Overview:: Installation, usage, etc. | 63 | * Overview:: Installation, usage, etc. |
| 64 | * Program Structure:: Arglists, `eval-when', `defalias' | 64 | * Program Structure:: Arglists, `eval-when', `defalias' |
| 65 | * Predicates:: `typep', `eql', and `equalp' | 65 | * Predicates:: `typep' and `equalp' |
| 66 | * Control Structure:: `setf', `do', `loop', etc. | 66 | * Control Structure:: `setf', `do', `loop', etc. |
| 67 | * Macros:: Destructuring, `define-compiler-macro' | 67 | * Macros:: Destructuring, `define-compiler-macro' |
| 68 | * Declarations:: `proclaim', `declare', etc. | 68 | * Declarations:: `proclaim', `declare', etc. |
| 69 | * Symbols:: Property lists, `gensym' | 69 | * Symbols:: Property lists, `gensym' |
| 70 | * Numbers:: Predicates, functions, random numbers | 70 | * Numbers:: Predicates, functions, random numbers |
| 71 | * Sequences:: Mapping, functions, searching, sorting | 71 | * Sequences:: Mapping, functions, searching, sorting |
| 72 | * Lists:: `cadr', `sublis', `member*', `assoc*', etc. | 72 | * Lists:: `caddr', `sublis', `member*', `assoc*', etc. |
| 73 | * Structures:: `defstruct' | 73 | * Structures:: `defstruct' |
| 74 | * Assertions:: `check-type', `assert', `ignore-errors'. | 74 | * Assertions:: `check-type', `assert', `ignore-errors'. |
| 75 | 75 | ||
| @@ -287,7 +287,7 @@ The following simple functions and macros are defined in @file{cl.el}; | |||
| 287 | they do not cause other components like @file{cl-extra} to be loaded. | 287 | they do not cause other components like @file{cl-extra} to be loaded. |
| 288 | 288 | ||
| 289 | @example | 289 | @example |
| 290 | eql floatp-safe endp | 290 | floatp-safe endp |
| 291 | evenp oddp plusp minusp | 291 | evenp oddp plusp minusp |
| 292 | caaar .. cddddr | 292 | caaar .. cddddr |
| 293 | list* ldiff rest first .. tenth | 293 | list* ldiff rest first .. tenth |
| @@ -700,7 +700,7 @@ facts are true or false. | |||
| 700 | 700 | ||
| 701 | @menu | 701 | @menu |
| 702 | * Type Predicates:: `typep', `deftype', and `coerce' | 702 | * Type Predicates:: `typep', `deftype', and `coerce' |
| 703 | * Equality Predicates:: `eql' and `equalp' | 703 | * Equality Predicates:: `equalp' |
| 704 | @end menu | 704 | @end menu |
| 705 | 705 | ||
| 706 | @node Type Predicates, Equality Predicates, Predicates, Predicates | 706 | @node Type Predicates, Equality Predicates, Predicates, Predicates |
| @@ -840,40 +840,7 @@ arguments to specify the type of sequence to return. @xref{Sequences}. | |||
| 840 | @section Equality Predicates | 840 | @section Equality Predicates |
| 841 | 841 | ||
| 842 | @noindent | 842 | @noindent |
| 843 | This package defines two Common Lisp predicates, @code{eql} and | 843 | This package defines the Common Lisp predicate @code{equalp}. |
| 844 | @code{equalp}. | ||
| 845 | |||
| 846 | @defun eql a b | ||
| 847 | This function is almost the same as @code{eq}, except that if @var{a} | ||
| 848 | and @var{b} are numbers of the same type, it compares them for numeric | ||
| 849 | equality (as if by @code{equal} instead of @code{eq}). This makes a | ||
| 850 | difference only for versions of Emacs that are compiled with | ||
| 851 | floating-point support. Emacs floats are allocated | ||
| 852 | objects just like cons cells, which means that @code{(eq 3.0 3.0)} | ||
| 853 | will not necessarily be true---if the two @code{3.0}s were allocated | ||
| 854 | separately, the pointers will be different even though the numbers are | ||
| 855 | the same. But @code{(eql 3.0 3.0)} will always be true. | ||
| 856 | |||
| 857 | The types of the arguments must match, so @code{(eql 3 3.0)} is | ||
| 858 | still false. | ||
| 859 | |||
| 860 | Note that Emacs integers are ``direct'' rather than allocated, which | ||
| 861 | basically means @code{(eq 3 3)} will always be true. Thus @code{eq} | ||
| 862 | and @code{eql} behave differently only if floating-point numbers are | ||
| 863 | involved, and are indistinguishable on Emacs versions that don't | ||
| 864 | support floats. | ||
| 865 | |||
| 866 | There is a slight inconsistency with Common Lisp in the treatment of | ||
| 867 | positive and negative zeros. Some machines, notably those with IEEE | ||
| 868 | standard arithmetic, represent @code{+0} and @code{-0} as distinct | ||
| 869 | values. Normally this doesn't matter because the standard specifies | ||
| 870 | that @code{(= 0.0 -0.0)} should always be true, and this is indeed | ||
| 871 | what Emacs Lisp and Common Lisp do. But the Common Lisp standard | ||
| 872 | states that @code{(eql 0.0 -0.0)} and @code{(equal 0.0 -0.0)} should | ||
| 873 | be false on IEEE-like machines; Emacs Lisp does not do this, and in | ||
| 874 | fact the only known way to distinguish between the two zeros in Emacs | ||
| 875 | Lisp is to @code{format} them and check for a minus sign. | ||
| 876 | @end defun | ||
| 877 | 844 | ||
| 878 | @defun equalp a b | 845 | @defun equalp a b |
| 879 | This function is a more flexible version of @code{equal}. In | 846 | This function is a more flexible version of @code{equal}. In |
| @@ -3685,7 +3652,7 @@ the same sequence, in the same order as they appear in that sequence.) | |||
| 3685 | The @code{:test} argument specifies a function which must return | 3652 | The @code{:test} argument specifies a function which must return |
| 3686 | true (non-@code{nil}) to indicate a match; instead, you may use | 3653 | true (non-@code{nil}) to indicate a match; instead, you may use |
| 3687 | @code{:test-not} to give a function which returns @emph{false} to | 3654 | @code{:test-not} to give a function which returns @emph{false} to |
| 3688 | indicate a match. The default test function is @code{:test 'eql}. | 3655 | indicate a match. The default test function is @code{eql}. |
| 3689 | 3656 | ||
| 3690 | Many functions which take @var{item} and @code{:test} or @code{:test-not} | 3657 | Many functions which take @var{item} and @code{:test} or @code{:test-not} |
| 3691 | arguments also come in @code{-if} and @code{-if-not} varieties, | 3658 | arguments also come in @code{-if} and @code{-if-not} varieties, |
| @@ -4998,7 +4965,7 @@ which understand full-featured argument lists. The @code{&whole} | |||
| 4998 | keyword does not work in @code{defmacro} argument lists (except | 4965 | keyword does not work in @code{defmacro} argument lists (except |
| 4999 | inside recursive argument lists). | 4966 | inside recursive argument lists). |
| 5000 | 4967 | ||
| 5001 | The @code{eql} and @code{equal} predicates do not distinguish | 4968 | The @code{equal} predicate does not distinguish |
| 5002 | between IEEE floating-point plus and minus zero. The @code{equalp} | 4969 | between IEEE floating-point plus and minus zero. The @code{equalp} |
| 5003 | predicate has several differences with Common Lisp; @pxref{Predicates}. | 4970 | predicate has several differences with Common Lisp; @pxref{Predicates}. |
| 5004 | 4971 | ||
| @@ -5218,12 +5185,6 @@ whereas Emacs Lisp's parser just treats quote as a special case. | |||
| 5218 | Some Lisp packages use reader macros to create special syntaxes | 5185 | Some Lisp packages use reader macros to create special syntaxes |
| 5219 | for themselves, which the Emacs parser is incapable of reading. | 5186 | for themselves, which the Emacs parser is incapable of reading. |
| 5220 | 5187 | ||
| 5221 | The lack of reader macros, incidentally, is the reason behind | ||
| 5222 | Emacs Lisp's unusual backquote syntax. Since backquotes are | ||
| 5223 | implemented as a Lisp package and not built-in to the Emacs | ||
| 5224 | parser, they are forced to use a regular macro named @code{`} | ||
| 5225 | which is used with the standard function/macro call notation. | ||
| 5226 | |||
| 5227 | @item | 5188 | @item |
| 5228 | Other syntactic features. Common Lisp provides a number of | 5189 | Other syntactic features. Common Lisp provides a number of |
| 5229 | notations beginning with @code{#} that the Emacs Lisp parser | 5190 | notations beginning with @code{#} that the Emacs Lisp parser |
| @@ -5287,11 +5248,11 @@ matters, Emacs has its own @code{#(} notation for | |||
| 5287 | something entirely different---strings with properties. | 5248 | something entirely different---strings with properties. |
| 5288 | 5249 | ||
| 5289 | @item | 5250 | @item |
| 5290 | Characters are distinct from integers in Common Lisp. The | 5251 | Characters are distinct from integers in Common Lisp. The notation |
| 5291 | notation for character constants is also different: @code{#\A} | 5252 | for character constants is also different: @code{#\A} in Common Lisp |
| 5292 | instead of @code{?A}. Also, @code{string=} and @code{string-equal} | 5253 | where Emacs Lisp uses @code{?A}. Also, @code{string=} and |
| 5293 | are synonyms in Emacs Lisp whereas the latter is case-insensitive | 5254 | @code{string-equal} are synonyms in Emacs Lisp, whereas the latter is |
| 5294 | in Common Lisp. | 5255 | case-insensitive in Common Lisp. |
| 5295 | 5256 | ||
| 5296 | @item | 5257 | @item |
| 5297 | Data types. Some Common Lisp data types do not exist in Emacs | 5258 | Data types. Some Common Lisp data types do not exist in Emacs |
diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi index 491ee631fe7..6ab4c199de6 100644 --- a/doc/misc/flymake.texi +++ b/doc/misc/flymake.texi | |||
| @@ -413,12 +413,9 @@ First, we write the @code{init-function}: | |||
| 413 | (defun flymake-perl-init () | 413 | (defun flymake-perl-init () |
| 414 | (let* ((temp-file (flymake-init-create-temp-buffer-copy | 414 | (let* ((temp-file (flymake-init-create-temp-buffer-copy |
| 415 | 'flymake-create-temp-inplace)) | 415 | 'flymake-create-temp-inplace)) |
| 416 | (local-file (concat (flymake-build-relative-filename | 416 | (local-file (file-relative-name |
| 417 | (file-name-directory | 417 | temp-file |
| 418 | (buffer-file-name | 418 | (file-name-directory buffer-file-name)))) |
| 419 | (current-buffer))) | ||
| 420 | (file-name-directory temp-file)) | ||
| 421 | (file-name-nondirectory temp-file)))) | ||
| 422 | (list "perl" (list "-wc " local-file)))) | 419 | (list "perl" (list "-wc " local-file)))) |
| 423 | @end lisp | 420 | @end lisp |
| 424 | 421 | ||