diff options
| author | Joakim Verona | 2011-11-22 15:39:42 +0100 |
|---|---|---|
| committer | Joakim Verona | 2011-11-22 15:39:42 +0100 |
| commit | 40bb789236e486a3f36eefb2840c293369ce2af3 (patch) | |
| tree | 8e81d3aa5f232ec7f2c5187c683cb0998d2dc4e2 /doc/lispintro | |
| parent | 62318aed495a48e24ff73fe79e420dd801df3189 (diff) | |
| parent | a8e1496d750ab0f571b3412ff61aaa4da640a036 (diff) | |
| download | emacs-40bb789236e486a3f36eefb2840c293369ce2af3.tar.gz emacs-40bb789236e486a3f36eefb2840c293369ce2af3.zip | |
upstream
Diffstat (limited to 'doc/lispintro')
| -rw-r--r-- | doc/lispintro/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/lispintro/emacs-lisp-intro.texi | 53 |
2 files changed, 30 insertions, 27 deletions
diff --git a/doc/lispintro/ChangeLog b/doc/lispintro/ChangeLog index 9d3894c38fc..bdcd9e9aea8 100644 --- a/doc/lispintro/ChangeLog +++ b/doc/lispintro/ChangeLog | |||
| @@ -1,3 +1,7 @@ | |||
| 1 | 2011-11-16 Juanma Barranquero <lekktu@gmail.com> | ||
| 2 | |||
| 3 | * emacs-lisp-intro.texi (etags): Fix typo. | ||
| 4 | |||
| 1 | 2011-03-07 Chong Yidong <cyd@stupidchicken.com> | 5 | 2011-03-07 Chong Yidong <cyd@stupidchicken.com> |
| 2 | 6 | ||
| 3 | * Version 23.3 released. | 7 | * Version 23.3 released. |
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index 11ceea19eef..ef04626e95f 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi | |||
| @@ -11,7 +11,7 @@ | |||
| 11 | @c --------- | 11 | @c --------- |
| 12 | @c <<<< For hard copy printing, this file is now | 12 | @c <<<< For hard copy printing, this file is now |
| 13 | @c set for smallbook, which works for all sizes | 13 | @c set for smallbook, which works for all sizes |
| 14 | @c of paper, and with Postscript figures >>>> | 14 | @c of paper, and with PostScript figures >>>> |
| 15 | @set smallbook | 15 | @set smallbook |
| 16 | @ifset smallbook | 16 | @ifset smallbook |
| 17 | @smallbook | 17 | @smallbook |
| @@ -357,7 +357,7 @@ every node in every chapter. | |||
| 357 | * Conclusion:: Now you have the basics. | 357 | * Conclusion:: Now you have the basics. |
| 358 | * the-the:: An appendix: how to find reduplicated words. | 358 | * the-the:: An appendix: how to find reduplicated words. |
| 359 | * Kill Ring:: An appendix: how the kill ring works. | 359 | * Kill Ring:: An appendix: how the kill ring works. |
| 360 | * Full Graph:: How to create a graph with labelled axes. | 360 | * Full Graph:: How to create a graph with labeled axes. |
| 361 | * Free Software and Free Manuals:: | 361 | * Free Software and Free Manuals:: |
| 362 | * GNU Free Documentation License:: | 362 | * GNU Free Documentation License:: |
| 363 | * Index:: | 363 | * Index:: |
| @@ -793,9 +793,9 @@ The @code{current-kill} Function | |||
| 793 | * Digression concerning error:: How to mislead humans, but not computers. | 793 | * Digression concerning error:: How to mislead humans, but not computers. |
| 794 | * Determining the Element:: | 794 | * Determining the Element:: |
| 795 | 795 | ||
| 796 | A Graph with Labelled Axes | 796 | A Graph with Labeled Axes |
| 797 | 797 | ||
| 798 | * Labelled Example:: | 798 | * Labeled Example:: |
| 799 | * print-graph Varlist:: @code{let} expression in @code{print-graph}. | 799 | * print-graph Varlist:: @code{let} expression in @code{print-graph}. |
| 800 | * print-Y-axis:: Print a label for the vertical axis. | 800 | * print-Y-axis:: Print a label for the vertical axis. |
| 801 | * print-X-axis:: Print a horizontal label. | 801 | * print-X-axis:: Print a horizontal label. |
| @@ -1023,7 +1023,7 @@ the command in parentheses, like this: @kbd{M-C-\} | |||
| 1023 | invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, , | 1023 | invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, , |
| 1024 | Keymaps}.) The abbreviation @kbd{M-C-\} means that you type your | 1024 | Keymaps}.) The abbreviation @kbd{M-C-\} means that you type your |
| 1025 | @key{META} key, @key{CTRL} key and @key{\} key all at the same time. | 1025 | @key{META} key, @key{CTRL} key and @key{\} key all at the same time. |
| 1026 | (On many modern keyboards the @key{META} key is labelled | 1026 | (On many modern keyboards the @key{META} key is labeled |
| 1027 | @key{ALT}.) | 1027 | @key{ALT}.) |
| 1028 | Sometimes a combination like this is called a keychord, since it is | 1028 | Sometimes a combination like this is called a keychord, since it is |
| 1029 | similar to the way you play a chord on a piano. If your keyboard does | 1029 | similar to the way you play a chord on a piano. If your keyboard does |
| @@ -1031,7 +1031,7 @@ not have a @key{META} key, the @key{ESC} key prefix is used in place | |||
| 1031 | of it. In this case, @kbd{M-C-\} means that you press and release your | 1031 | of it. In this case, @kbd{M-C-\} means that you press and release your |
| 1032 | @key{ESC} key and then type the @key{CTRL} key and the @key{\} key at | 1032 | @key{ESC} key and then type the @key{CTRL} key and the @key{\} key at |
| 1033 | the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key | 1033 | the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key |
| 1034 | along with the key that is labelled @key{ALT} and, at the same time, | 1034 | along with the key that is labeled @key{ALT} and, at the same time, |
| 1035 | press the @key{\} key. | 1035 | press the @key{\} key. |
| 1036 | 1036 | ||
| 1037 | In addition to typing a lone keychord, you can prefix what you type | 1037 | In addition to typing a lone keychord, you can prefix what you type |
| @@ -4749,7 +4749,7 @@ type in the name of the function whose source code you want to see, | |||
| 4749 | such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will | 4749 | such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will |
| 4750 | switch buffers and display the source code for the function on your | 4750 | switch buffers and display the source code for the function on your |
| 4751 | screen. To switch back to your current buffer, type @kbd{C-x b | 4751 | screen. To switch back to your current buffer, type @kbd{C-x b |
| 4752 | @key{RET}}. (On some keyboards, the @key{META} key is labelled | 4752 | @key{RET}}. (On some keyboards, the @key{META} key is labeled |
| 4753 | @key{ALT}.) | 4753 | @key{ALT}.) |
| 4754 | 4754 | ||
| 4755 | @c !!! 22.1.1 tags table location in this paragraph | 4755 | @c !!! 22.1.1 tags table location in this paragraph |
| @@ -8200,7 +8200,7 @@ The command \\[yank] can retrieve it from there. @dots{} " | |||
| 8200 | ;; it will be set in an error | 8200 | ;; it will be set in an error |
| 8201 | (setq this-command 'kill-region) | 8201 | (setq this-command 'kill-region) |
| 8202 | ;; Finally, in the then-part, send a message if you may copy | 8202 | ;; Finally, in the then-part, send a message if you may copy |
| 8203 | ;; the text to the kill ring without signally an error, but | 8203 | ;; the text to the kill ring without signaling an error, but |
| 8204 | ;; don't if you may not. | 8204 | ;; don't if you may not. |
| 8205 | @end group | 8205 | @end group |
| 8206 | @group | 8206 | @group |
| @@ -13656,7 +13656,7 @@ list of supported languages. | |||
| 13656 | 13656 | ||
| 13657 | The @code{etags} program handles more than 20 languages, including | 13657 | The @code{etags} program handles more than 20 languages, including |
| 13658 | Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, | 13658 | Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, |
| 13659 | LaTeX, Pascal, Perl, Postscript, Python, TeX, Texinfo, makefiles, and | 13659 | LaTeX, Pascal, Perl, PostScript, Python, TeX, Texinfo, makefiles, and |
| 13660 | most assemblers. The program has no switches for specifying the | 13660 | most assemblers. The program has no switches for specifying the |
| 13661 | language; it recognizes the language in an input file according to its | 13661 | language; it recognizes the language in an input file according to its |
| 13662 | file name and contents. | 13662 | file name and contents. |
| @@ -16962,7 +16962,7 @@ For this reason, I have written enhancements to the basic | |||
| 16962 | @code{print-graph-body} function that automatically print labels for | 16962 | @code{print-graph-body} function that automatically print labels for |
| 16963 | the horizontal and vertical axes. Since the label printing functions | 16963 | the horizontal and vertical axes. Since the label printing functions |
| 16964 | do not contain much new material, I have placed their description in | 16964 | do not contain much new material, I have placed their description in |
| 16965 | an appendix. @xref{Full Graph, , A Graph with Labelled Axes}. | 16965 | an appendix. @xref{Full Graph, , A Graph with Labeled Axes}. |
| 16966 | 16966 | ||
| 16967 | @node Line Graph Exercise, , Printed Axes, Readying a Graph | 16967 | @node Line Graph Exercise, , Printed Axes, Readying a Graph |
| 16968 | @section Exercise | 16968 | @section Exercise |
| @@ -19447,7 +19447,7 @@ whether the kill ring is full or empty. This is an act of | |||
| 19447 | exploration. | 19447 | exploration. |
| 19448 | 19448 | ||
| 19449 | From the human point of view, the act of exploration and discovery is | 19449 | From the human point of view, the act of exploration and discovery is |
| 19450 | not necessarily an error, and therefore should not be labelled as one, | 19450 | not necessarily an error, and therefore should not be labeled as one, |
| 19451 | even in the bowels of a computer. As it is, the code in Emacs implies | 19451 | even in the bowels of a computer. As it is, the code in Emacs implies |
| 19452 | that a human who is acting virtuously, by exploring his or her | 19452 | that a human who is acting virtuously, by exploring his or her |
| 19453 | environment, is making an error. This is bad. Even though the computer | 19453 | environment, is making an error. This is bad. Even though the computer |
| @@ -19760,25 +19760,25 @@ as @code{kill-ring-yank-pointer} do not use this library, possibly | |||
| 19760 | because they were written earlier. | 19760 | because they were written earlier. |
| 19761 | 19761 | ||
| 19762 | @node Full Graph, Free Software and Free Manuals, Kill Ring, Top | 19762 | @node Full Graph, Free Software and Free Manuals, Kill Ring, Top |
| 19763 | @appendix A Graph with Labelled Axes | 19763 | @appendix A Graph with Labeled Axes |
| 19764 | 19764 | ||
| 19765 | Printed axes help you understand a graph. They convey scale. In an | 19765 | Printed axes help you understand a graph. They convey scale. In an |
| 19766 | earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we | 19766 | earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we |
| 19767 | wrote the code to print the body of a graph. Here we write the code | 19767 | wrote the code to print the body of a graph. Here we write the code |
| 19768 | for printing and labelling vertical and horizontal axes, along with the | 19768 | for printing and labeling vertical and horizontal axes, along with the |
| 19769 | body itself. | 19769 | body itself. |
| 19770 | 19770 | ||
| 19771 | @menu | 19771 | @menu |
| 19772 | * Labelled Example:: | 19772 | * Labeled Example:: |
| 19773 | * print-graph Varlist:: @code{let} expression in @code{print-graph}. | 19773 | * print-graph Varlist:: @code{let} expression in @code{print-graph}. |
| 19774 | * print-Y-axis:: Print a label for the vertical axis. | 19774 | * print-Y-axis:: Print a label for the vertical axis. |
| 19775 | * print-X-axis:: Print a horizontal label. | 19775 | * print-X-axis:: Print a horizontal label. |
| 19776 | * Print Whole Graph:: The function to print a complete graph. | 19776 | * Print Whole Graph:: The function to print a complete graph. |
| 19777 | @end menu | 19777 | @end menu |
| 19778 | 19778 | ||
| 19779 | @node Labelled Example, print-graph Varlist, Full Graph, Full Graph | 19779 | @node Labeled Example, print-graph Varlist, Full Graph, Full Graph |
| 19780 | @ifnottex | 19780 | @ifnottex |
| 19781 | @unnumberedsec Labelled Example Graph | 19781 | @unnumberedsec Labeled Example Graph |
| 19782 | @end ifnottex | 19782 | @end ifnottex |
| 19783 | 19783 | ||
| 19784 | Since insertions fill a buffer to the right and below point, the new | 19784 | Since insertions fill a buffer to the right and below point, the new |
| @@ -19821,9 +19821,9 @@ Here is an example of how a finished graph should look: | |||
| 19821 | @end smallexample | 19821 | @end smallexample |
| 19822 | 19822 | ||
| 19823 | @noindent | 19823 | @noindent |
| 19824 | In this graph, both the vertical and the horizontal axes are labelled | 19824 | In this graph, both the vertical and the horizontal axes are labeled |
| 19825 | with numbers. However, in some graphs, the horizontal axis is time | 19825 | with numbers. However, in some graphs, the horizontal axis is time |
| 19826 | and would be better labelled with months, like this: | 19826 | and would be better labeled with months, like this: |
| 19827 | 19827 | ||
| 19828 | @smallexample | 19828 | @smallexample |
| 19829 | @group | 19829 | @group |
| @@ -19838,9 +19838,9 @@ and would be better labelled with months, like this: | |||
| 19838 | @end smallexample | 19838 | @end smallexample |
| 19839 | 19839 | ||
| 19840 | Indeed, with a little thought, we can easily come up with a variety of | 19840 | Indeed, with a little thought, we can easily come up with a variety of |
| 19841 | vertical and horizontal labelling schemes. Our task could become | 19841 | vertical and horizontal labeling schemes. Our task could become |
| 19842 | complicated. But complications breed confusion. Rather than permit | 19842 | complicated. But complications breed confusion. Rather than permit |
| 19843 | this, it is better choose a simple labelling scheme for our first | 19843 | this, it is better choose a simple labeling scheme for our first |
| 19844 | effort, and to modify or replace it later. | 19844 | effort, and to modify or replace it later. |
| 19845 | 19845 | ||
| 19846 | @need 1200 | 19846 | @need 1200 |
| @@ -19864,7 +19864,7 @@ These considerations suggest the following outline for the | |||
| 19864 | We can work on each part of the @code{print-graph} function definition | 19864 | We can work on each part of the @code{print-graph} function definition |
| 19865 | in turn. | 19865 | in turn. |
| 19866 | 19866 | ||
| 19867 | @node print-graph Varlist, print-Y-axis, Labelled Example, Full Graph | 19867 | @node print-graph Varlist, print-Y-axis, Labeled Example, Full Graph |
| 19868 | @comment node-name, next, previous, up | 19868 | @comment node-name, next, previous, up |
| 19869 | @appendixsec The @code{print-graph} Varlist | 19869 | @appendixsec The @code{print-graph} Varlist |
| 19870 | @cindex @code{print-graph} varlist | 19870 | @cindex @code{print-graph} varlist |
| @@ -20391,7 +20391,7 @@ blank spaces and also separated according to the value of the variable | |||
| 20391 | The value of the variable @code{X-axis-label-spacing} should itself be | 20391 | The value of the variable @code{X-axis-label-spacing} should itself be |
| 20392 | measured in units of @code{symbol-width}, since you may want to change | 20392 | measured in units of @code{symbol-width}, since you may want to change |
| 20393 | the width of the symbols that you are using to print the body of the | 20393 | the width of the symbols that you are using to print the body of the |
| 20394 | graph without changing the ways the graph is labelled. | 20394 | graph without changing the ways the graph is labeled. |
| 20395 | 20395 | ||
| 20396 | @menu | 20396 | @menu |
| 20397 | * Similarities differences:: Much like @code{print-Y-axis}, but not exactly. | 20397 | * Similarities differences:: Much like @code{print-Y-axis}, but not exactly. |
| @@ -20722,7 +20722,7 @@ Emacs will print the horizontal axis like this: | |||
| 20722 | Now we are nearly ready to print the whole graph. | 20722 | Now we are nearly ready to print the whole graph. |
| 20723 | 20723 | ||
| 20724 | The function to print the graph with the proper labels follows the | 20724 | The function to print the graph with the proper labels follows the |
| 20725 | outline we created earlier (@pxref{Full Graph, , A Graph with Labelled | 20725 | outline we created earlier (@pxref{Full Graph, , A Graph with Labeled |
| 20726 | Axes}), but with additions. | 20726 | Axes}), but with additions. |
| 20727 | 20727 | ||
| 20728 | @need 1250 | 20728 | @need 1250 |
| @@ -20857,7 +20857,7 @@ Finally, the code for the @code{print-graph} function: | |||
| 20857 | ;;; @r{Final version.} | 20857 | ;;; @r{Final version.} |
| 20858 | (defun print-graph | 20858 | (defun print-graph |
| 20859 | (numbers-list &optional vertical-step) | 20859 | (numbers-list &optional vertical-step) |
| 20860 | "Print labelled bar graph of the NUMBERS-LIST. | 20860 | "Print labeled bar graph of the NUMBERS-LIST. |
| 20861 | The numbers-list consists of the Y-axis values. | 20861 | The numbers-list consists of the Y-axis values. |
| 20862 | @end group | 20862 | @end group |
| 20863 | 20863 | ||
| @@ -21478,7 +21478,7 @@ each column." | |||
| 21478 | @group | 21478 | @group |
| 21479 | (defun print-graph | 21479 | (defun print-graph |
| 21480 | (numbers-list &optional vertical-step horizontal-step) | 21480 | (numbers-list &optional vertical-step horizontal-step) |
| 21481 | "Print labelled bar graph of the NUMBERS-LIST. | 21481 | "Print labeled bar graph of the NUMBERS-LIST. |
| 21482 | The numbers-list consists of the Y-axis values. | 21482 | The numbers-list consists of the Y-axis values. |
| 21483 | @end group | 21483 | @end group |
| 21484 | 21484 | ||
| @@ -21979,7 +21979,7 @@ each column." | |||
| 21979 | @group | 21979 | @group |
| 21980 | (defun print-graph | 21980 | (defun print-graph |
| 21981 | (numbers-list &optional vertical-step horizontal-step) | 21981 | (numbers-list &optional vertical-step horizontal-step) |
| 21982 | "Print labelled bar graph of the NUMBERS-LIST. | 21982 | "Print labeled bar graph of the NUMBERS-LIST. |
| 21983 | The numbers-list consists of the Y-axis values. | 21983 | The numbers-list consists of the Y-axis values. |
| 21984 | @end group | 21984 | @end group |
| 21985 | 21985 | ||
| @@ -22275,4 +22275,3 @@ airplane. | |||
| 22275 | @c @end iftex | 22275 | @c @end iftex |
| 22276 | 22276 | ||
| 22277 | @bye | 22277 | @bye |
| 22278 | |||