diff options
| author | Grégoire Jadi | 2013-06-12 17:06:09 +0200 |
|---|---|---|
| committer | Grégoire Jadi | 2013-06-12 17:06:09 +0200 |
| commit | 32a590b04a10f6bbe92bc1519b9e5ba2d32cfabc (patch) | |
| tree | 578be4eb2757a0716f252a269adc49fa9406556d /doc/lispref | |
| parent | 5c77269b59c8d8d88fa91ec2c949294db1bb2131 (diff) | |
| parent | e6fa6da6899bf1b4877b96c450eae3934085d560 (diff) | |
| download | emacs-32a590b04a10f6bbe92bc1519b9e5ba2d32cfabc.tar.gz emacs-32a590b04a10f6bbe92bc1519b9e5ba2d32cfabc.zip | |
Merge branch 'jave-xwidget' into xwidget
Diffstat (limited to 'doc/lispref')
| -rw-r--r-- | doc/lispref/ChangeLog | 24 | ||||
| -rw-r--r-- | doc/lispref/compile.texi | 12 | ||||
| -rw-r--r-- | doc/lispref/files.texi | 53 | ||||
| -rw-r--r-- | doc/lispref/functions.texi | 5 |
4 files changed, 60 insertions, 34 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 249a2f21ccb..259bf9a78a6 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog | |||
| @@ -1,3 +1,27 @@ | |||
| 1 | 2013-06-11 Xue Fuqiao <xfq.free@gmail.com> | ||
| 2 | |||
| 3 | * files.texi (File Name Expansion): Make the example more | ||
| 4 | intuitive. | ||
| 5 | |||
| 6 | 2013-06-10 Paul Eggert <eggert@cs.ucla.edu> | ||
| 7 | |||
| 8 | Documentation fix for 'ls' and hard links. | ||
| 9 | * compile.texi (Compilation Functions): | ||
| 10 | * files.texi (File Attributes, Changing Files): | ||
| 11 | Use current format for GNU 'ls' output. | ||
| 12 | (File Attributes): Fix problem introduced in previous change: | ||
| 13 | the link count is the number of hard links, not the number | ||
| 14 | of hard links + 1. | ||
| 15 | |||
| 16 | 2013-06-10 Xue Fuqiao <xfq.free@gmail.com> | ||
| 17 | |||
| 18 | * files.texi (File Attributes): Fix typo. | ||
| 19 | |||
| 20 | 2013-05-29 Stefan Monnier <monnier@iro.umontreal.ca> | ||
| 21 | |||
| 22 | * functions.texi (Lambda Expressions): Lambda expressions don't | ||
| 23 | evaluate to themselves in general (bug#11782). | ||
| 24 | |||
| 1 | 2013-05-15 Stefan Monnier <monnier@iro.umontreal.ca> | 25 | 2013-05-15 Stefan Monnier <monnier@iro.umontreal.ca> |
| 2 | 26 | ||
| 3 | * loading.texi (Autoload): | 27 | * loading.texi (Autoload): |
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 522a88da61e..95f7341c19c 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi | |||
| @@ -181,8 +181,8 @@ after compiling it. Interactively, @var{load} is the prefix argument. | |||
| 181 | 181 | ||
| 182 | @example | 182 | @example |
| 183 | @group | 183 | @group |
| 184 | % ls -l push* | 184 | $ ls -l push* |
| 185 | -rw-r--r-- 1 lewis 791 Oct 5 20:31 push.el | 185 | -rw-r--r-- 1 lewis lewis 791 Oct 5 20:31 push.el |
| 186 | @end group | 186 | @end group |
| 187 | 187 | ||
| 188 | @group | 188 | @group |
| @@ -191,9 +191,9 @@ after compiling it. Interactively, @var{load} is the prefix argument. | |||
| 191 | @end group | 191 | @end group |
| 192 | 192 | ||
| 193 | @group | 193 | @group |
| 194 | % ls -l push* | 194 | $ ls -l push* |
| 195 | -rw-r--r-- 1 lewis 791 Oct 5 20:31 push.el | 195 | -rw-r--r-- 1 lewis lewis 791 Oct 5 20:31 push.el |
| 196 | -rw-rw-rw- 1 lewis 638 Oct 8 20:25 push.elc | 196 | -rw-rw-rw- 1 lewis lewis 638 Oct 8 20:25 push.elc |
| 197 | @end group | 197 | @end group |
| 198 | @end example | 198 | @end example |
| 199 | @end deffn | 199 | @end deffn |
| @@ -232,7 +232,7 @@ If @var{noforce} is non-@code{nil}, this function does not recompile | |||
| 232 | files that have an up-to-date @samp{.elc} file. | 232 | files that have an up-to-date @samp{.elc} file. |
| 233 | 233 | ||
| 234 | @example | 234 | @example |
| 235 | % emacs -batch -f batch-byte-compile *.el | 235 | $ emacs -batch -f batch-byte-compile *.el |
| 236 | @end example | 236 | @end example |
| 237 | @end defun | 237 | @end defun |
| 238 | 238 | ||
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 971e38f20b7..704ecfb6446 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi | |||
| @@ -1139,8 +1139,8 @@ both others and group, and that the sticky bit is set. | |||
| 1139 | @end group | 1139 | @end group |
| 1140 | 1140 | ||
| 1141 | @group | 1141 | @group |
| 1142 | % ls -l diffs | 1142 | $ ls -l diffs |
| 1143 | -rw-rw-rw- 1 lewis 0 3063 Oct 30 16:00 diffs | 1143 | -rw-rw-rw- 1 lewis lewis 3063 Oct 30 16:00 diffs |
| 1144 | @end group | 1144 | @end group |
| 1145 | @end example | 1145 | @end example |
| 1146 | 1146 | ||
| @@ -1166,17 +1166,17 @@ target. However, they both recursively follow symbolic links at all | |||
| 1166 | levels of parent directories. | 1166 | levels of parent directories. |
| 1167 | 1167 | ||
| 1168 | @defun file-nlinks filename | 1168 | @defun file-nlinks filename |
| 1169 | This functions returns the number of names (i.e., hard links) that | 1169 | This function returns the number of names (i.e., hard links) that |
| 1170 | file @var{filename} has. If the file does not exist, then this function | 1170 | file @var{filename} has. If the file does not exist, this function |
| 1171 | returns @code{nil}. Note that symbolic links have no effect on this | 1171 | returns @code{nil}. Note that symbolic links have no effect on this |
| 1172 | function, because they are not considered to be names of the files they | 1172 | function, because they are not considered to be names of the files |
| 1173 | link to. | 1173 | they link to. |
| 1174 | 1174 | ||
| 1175 | @example | 1175 | @example |
| 1176 | @group | 1176 | @group |
| 1177 | % ls -l foo* | 1177 | $ ls -l foo* |
| 1178 | -rw-rw-rw- 2 rms 4 Aug 19 01:27 foo | 1178 | -rw-rw-rw- 2 rms rms 4 Aug 19 01:27 foo |
| 1179 | -rw-rw-rw- 2 rms 4 Aug 19 01:27 foo1 | 1179 | -rw-rw-rw- 2 rms rms 4 Aug 19 01:27 foo1 |
| 1180 | @end group | 1180 | @end group |
| 1181 | 1181 | ||
| 1182 | @group | 1182 | @group |
| @@ -1477,9 +1477,9 @@ In the first part of the following example, we list two files, | |||
| 1477 | 1477 | ||
| 1478 | @example | 1478 | @example |
| 1479 | @group | 1479 | @group |
| 1480 | % ls -li fo* | 1480 | $ ls -li fo* |
| 1481 | 81908 -rw-rw-rw- 1 rms 29 Aug 18 20:32 foo | 1481 | 81908 -rw-rw-rw- 1 rms rms 29 Aug 18 20:32 foo |
| 1482 | 84302 -rw-rw-rw- 1 rms 24 Aug 18 20:31 foo3 | 1482 | 84302 -rw-rw-rw- 1 rms rms 24 Aug 18 20:31 foo3 |
| 1483 | @end group | 1483 | @end group |
| 1484 | @end example | 1484 | @end example |
| 1485 | 1485 | ||
| @@ -1494,10 +1494,10 @@ the files again. This shows two names for one file, @file{foo} and | |||
| 1494 | @end group | 1494 | @end group |
| 1495 | 1495 | ||
| 1496 | @group | 1496 | @group |
| 1497 | % ls -li fo* | 1497 | $ ls -li fo* |
| 1498 | 81908 -rw-rw-rw- 2 rms 29 Aug 18 20:32 foo | 1498 | 81908 -rw-rw-rw- 2 rms rms 29 Aug 18 20:32 foo |
| 1499 | 81908 -rw-rw-rw- 2 rms 29 Aug 18 20:32 foo2 | 1499 | 81908 -rw-rw-rw- 2 rms rms 29 Aug 18 20:32 foo2 |
| 1500 | 84302 -rw-rw-rw- 1 rms 24 Aug 18 20:31 foo3 | 1500 | 84302 -rw-rw-rw- 1 rms rms 24 Aug 18 20:31 foo3 |
| 1501 | @end group | 1501 | @end group |
| 1502 | @end example | 1502 | @end example |
| 1503 | 1503 | ||
| @@ -1519,10 +1519,10 @@ contents of @file{foo3} are lost. | |||
| 1519 | @end group | 1519 | @end group |
| 1520 | 1520 | ||
| 1521 | @group | 1521 | @group |
| 1522 | % ls -li fo* | 1522 | $ ls -li fo* |
| 1523 | 81908 -rw-rw-rw- 3 rms 29 Aug 18 20:32 foo | 1523 | 81908 -rw-rw-rw- 3 rms rms 29 Aug 18 20:32 foo |
| 1524 | 81908 -rw-rw-rw- 3 rms 29 Aug 18 20:32 foo2 | 1524 | 81908 -rw-rw-rw- 3 rms rms 29 Aug 18 20:32 foo2 |
| 1525 | 81908 -rw-rw-rw- 3 rms 29 Aug 18 20:32 foo3 | 1525 | 81908 -rw-rw-rw- 3 rms rms 29 Aug 18 20:32 foo3 |
| 1526 | @end group | 1526 | @end group |
| 1527 | @end example | 1527 | @end example |
| 1528 | 1528 | ||
| @@ -2105,10 +2105,6 @@ start with @samp{~}.) Otherwise, the current buffer's value of | |||
| 2105 | (expand-file-name "foo" "/usr/spool/") | 2105 | (expand-file-name "foo" "/usr/spool/") |
| 2106 | @result{} "/usr/spool/foo" | 2106 | @result{} "/usr/spool/foo" |
| 2107 | @end group | 2107 | @end group |
| 2108 | @group | ||
| 2109 | (expand-file-name "$HOME/foo") | ||
| 2110 | @result{} "/xcssun/users/rms/lewis/$HOME/foo" | ||
| 2111 | @end group | ||
| 2112 | @end example | 2108 | @end example |
| 2113 | 2109 | ||
| 2114 | If the part of the combined file name before the first slash is | 2110 | If the part of the combined file name before the first slash is |
| @@ -2142,7 +2138,14 @@ This is for the sake of filesystems that have the concept of a | |||
| 2142 | @file{/../} is interpreted exactly the same as @file{/}. | 2138 | @file{/../} is interpreted exactly the same as @file{/}. |
| 2143 | 2139 | ||
| 2144 | Note that @code{expand-file-name} does @emph{not} expand environment | 2140 | Note that @code{expand-file-name} does @emph{not} expand environment |
| 2145 | variables; only @code{substitute-in-file-name} does that. | 2141 | variables; only @code{substitute-in-file-name} does that: |
| 2142 | |||
| 2143 | @example | ||
| 2144 | @group | ||
| 2145 | (expand-file-name "$HOME/foo") | ||
| 2146 | @result{} "/xcssun/users/rms/lewis/$HOME/foo" | ||
| 2147 | @end group | ||
| 2148 | @end example | ||
| 2146 | 2149 | ||
| 2147 | Note also that @code{expand-file-name} does not follow symbolic links | 2150 | Note also that @code{expand-file-name} does not follow symbolic links |
| 2148 | at any level. This results in a difference between the way | 2151 | at any level. This results in a difference between the way |
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index 999923f5b84..7768c147827 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi | |||
| @@ -196,9 +196,8 @@ an example: | |||
| 196 | @end example | 196 | @end example |
| 197 | 197 | ||
| 198 | @noindent | 198 | @noindent |
| 199 | In Emacs Lisp, such a list is valid as an expression---it evaluates to | 199 | In Emacs Lisp, such a list is a valid expression which evaluates to |
| 200 | itself. But its main use is not to be evaluated as an expression, but | 200 | a function object. |
| 201 | to be called as a function. | ||
| 202 | 201 | ||
| 203 | A lambda expression, by itself, has no name; it is an @dfn{anonymous | 202 | A lambda expression, by itself, has no name; it is an @dfn{anonymous |
| 204 | function}. Although lambda expressions can be used this way | 203 | function}. Although lambda expressions can be used this way |