diff options
| author | Paul Eggert | 2016-01-31 17:31:23 -0800 |
|---|---|---|
| committer | Paul Eggert | 2016-01-31 17:31:53 -0800 |
| commit | 43cb9f8ff378100ec31cb576faf347a87a05ba5d (patch) | |
| tree | 504b8ffdd59493c0baac87929a8169cb07439aef | |
| parent | 2fbd1dabebf01029ef449389b9f4cb0b43aa62d9 (diff) | |
| download | emacs-43cb9f8ff378100ec31cb576faf347a87a05ba5d.tar.gz emacs-43cb9f8ff378100ec31cb576faf347a87a05ba5d.zip | |
Omit unnecessary history from Lisp intro
* doc/lispintro/emacs-lisp-intro.texi (Review, Digression into C)
(Conclusion): Reword so as not to talk about earlier versions
of Emacs in what should be an intro.
| -rw-r--r-- | doc/lispintro/emacs-lisp-intro.texi | 44 |
1 files changed, 10 insertions, 34 deletions
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index 6c4f305d86d..78c1865703e 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi | |||
| @@ -4309,38 +4309,18 @@ documentation, an optional interactive declaration, and the body of | |||
| 4309 | the definition. | 4309 | the definition. |
| 4310 | 4310 | ||
| 4311 | @need 1250 | 4311 | @need 1250 |
| 4312 | For example, in an early version of Emacs, the function definition was | 4312 | For example, in Emacs the function definition of |
| 4313 | as follows. (It is slightly more complex now that it seeks the first | 4313 | @code{dired-unmark-all-marks} is as follows. |
| 4314 | non-whitespace character rather than the first visible character.) | ||
| 4315 | 4314 | ||
| 4316 | @smallexample | 4315 | @smallexample |
| 4317 | @group | 4316 | @group |
| 4318 | (defun back-to-indentation () | 4317 | (defun dired-unmark-all-marks () |
| 4319 | "Move point to first visible character on line." | 4318 | "Remove all marks from all files in the Dired buffer." |
| 4320 | (interactive) | 4319 | (interactive) |
| 4321 | (beginning-of-line 1) | 4320 | (dired-unmark-all-files ?\r)) |
| 4322 | (skip-chars-forward " \t")) | ||
| 4323 | @end group | 4321 | @end group |
| 4324 | @end smallexample | 4322 | @end smallexample |
| 4325 | 4323 | ||
| 4326 | @ignore | ||
| 4327 | In GNU Emacs 22, | ||
| 4328 | |||
| 4329 | (defun backward-to-indentation (&optional arg) | ||
| 4330 | "Move backward ARG lines and position at first nonblank character." | ||
| 4331 | (interactive "p") | ||
| 4332 | (forward-line (- (or arg 1))) | ||
| 4333 | (skip-chars-forward " \t")) | ||
| 4334 | |||
| 4335 | (defun back-to-indentation () | ||
| 4336 | "Move point to the first non-whitespace character on this line." | ||
| 4337 | (interactive) | ||
| 4338 | (beginning-of-line 1) | ||
| 4339 | (skip-syntax-forward " " (line-end-position)) | ||
| 4340 | ;; Move back over chars that have whitespace syntax but have the p flag. | ||
| 4341 | (backward-prefix-chars)) | ||
| 4342 | @end ignore | ||
| 4343 | |||
| 4344 | @item interactive | 4324 | @item interactive |
| 4345 | Declare to the interpreter that the function can be used | 4325 | Declare to the interpreter that the function can be used |
| 4346 | interactively. This special form may be followed by a string with one | 4326 | interactively. This special form may be followed by a string with one |
| @@ -9123,13 +9103,12 @@ deleted@footnote{More precisely, and requiring more expert knowledge | |||
| 9123 | to understand, the two integers are of type @code{Lisp_Object}, which can | 9103 | to understand, the two integers are of type @code{Lisp_Object}, which can |
| 9124 | also be a C union instead of an integer type.}. | 9104 | also be a C union instead of an integer type.}. |
| 9125 | 9105 | ||
| 9126 | In early versions of Emacs, these two numbers were thirty-two bits | 9106 | Integer widths depend on the machine, and are typically 32 or 64 bits. |
| 9127 | long, but the code is slowly being generalized to handle other | 9107 | A few of the bits are used to specify the type of information; the |
| 9128 | lengths. Three of the available bits are used to specify the type of | 9108 | remaining bits are used as content. |
| 9129 | information; the remaining bits are used as content. | ||
| 9130 | 9109 | ||
| 9131 | @samp{XINT} is a C macro that extracts the relevant number from the | 9110 | @samp{XINT} is a C macro that extracts the relevant number from the |
| 9132 | longer collection of bits; the three other bits are discarded. | 9111 | longer collection of bits; the type bits are discarded. |
| 9133 | 9112 | ||
| 9134 | @need 800 | 9113 | @need 800 |
| 9135 | The command in @code{delete-and-extract-region} looks like this: | 9114 | The command in @code{delete-and-extract-region} looks like this: |
| @@ -18724,10 +18703,7 @@ Even though it is short, @code{split-line} contains expressions | |||
| 18724 | we have not studied: @code{skip-chars-forward}, @code{indent-to}, | 18703 | we have not studied: @code{skip-chars-forward}, @code{indent-to}, |
| 18725 | @code{current-column} and @code{insert-and-inherit}. | 18704 | @code{current-column} and @code{insert-and-inherit}. |
| 18726 | 18705 | ||
| 18727 | Consider the @code{skip-chars-forward} function. (It is part of the | 18706 | Consider the @code{skip-chars-forward} function. |
| 18728 | function definition for @code{back-to-indentation}, which is shown in | ||
| 18729 | @ref{Review, , Review}.) | ||
| 18730 | |||
| 18731 | In GNU Emacs, you can find out more about @code{skip-chars-forward} by | 18707 | In GNU Emacs, you can find out more about @code{skip-chars-forward} by |
| 18732 | typing @kbd{C-h f} (@code{describe-function}) and the name of the | 18708 | typing @kbd{C-h f} (@code{describe-function}) and the name of the |
| 18733 | function. This gives you the function documentation. | 18709 | function. This gives you the function documentation. |