aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispintro
diff options
context:
space:
mode:
authorJoakim Verona2011-11-22 15:39:42 +0100
committerJoakim Verona2011-11-22 15:39:42 +0100
commit40bb789236e486a3f36eefb2840c293369ce2af3 (patch)
tree8e81d3aa5f232ec7f2c5187c683cb0998d2dc4e2 /doc/lispintro
parent62318aed495a48e24ff73fe79e420dd801df3189 (diff)
parenta8e1496d750ab0f571b3412ff61aaa4da640a036 (diff)
downloademacs-40bb789236e486a3f36eefb2840c293369ce2af3.tar.gz
emacs-40bb789236e486a3f36eefb2840c293369ce2af3.zip
upstream
Diffstat (limited to 'doc/lispintro')
-rw-r--r--doc/lispintro/ChangeLog4
-rw-r--r--doc/lispintro/emacs-lisp-intro.texi53
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 @@
12011-11-16 Juanma Barranquero <lekktu@gmail.com>
2
3 * emacs-lisp-intro.texi (etags): Fix typo.
4
12011-03-07 Chong Yidong <cyd@stupidchicken.com> 52011-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
796A Graph with Labelled Axes 796A 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-\}
1023invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, , 1023invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, ,
1024Keymaps}.) The abbreviation @kbd{M-C-\} means that you type your 1024Keymaps}.) 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}.)
1028Sometimes a combination like this is called a keychord, since it is 1028Sometimes a combination like this is called a keychord, since it is
1029similar to the way you play a chord on a piano. If your keyboard does 1029similar 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
1031of it. In this case, @kbd{M-C-\} means that you press and release your 1031of 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
1033the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key 1033the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key
1034along with the key that is labelled @key{ALT} and, at the same time, 1034along with the key that is labeled @key{ALT} and, at the same time,
1035press the @key{\} key. 1035press the @key{\} key.
1036 1036
1037In addition to typing a lone keychord, you can prefix what you type 1037In 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,
4749such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will 4749such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will
4750switch buffers and display the source code for the function on your 4750switch buffers and display the source code for the function on your
4751screen. To switch back to your current buffer, type @kbd{C-x b 4751screen. 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
13657The @code{etags} program handles more than 20 languages, including 13657The @code{etags} program handles more than 20 languages, including
13658Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, 13658Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java,
13659LaTeX, Pascal, Perl, Postscript, Python, TeX, Texinfo, makefiles, and 13659LaTeX, Pascal, Perl, PostScript, Python, TeX, Texinfo, makefiles, and
13660most assemblers. The program has no switches for specifying the 13660most assemblers. The program has no switches for specifying the
13661language; it recognizes the language in an input file according to its 13661language; it recognizes the language in an input file according to its
13662file name and contents. 13662file 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
16963the horizontal and vertical axes. Since the label printing functions 16963the horizontal and vertical axes. Since the label printing functions
16964do not contain much new material, I have placed their description in 16964do not contain much new material, I have placed their description in
16965an appendix. @xref{Full Graph, , A Graph with Labelled Axes}. 16965an 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
19447exploration. 19447exploration.
19448 19448
19449From the human point of view, the act of exploration and discovery is 19449From the human point of view, the act of exploration and discovery is
19450not necessarily an error, and therefore should not be labelled as one, 19450not necessarily an error, and therefore should not be labeled as one,
19451even in the bowels of a computer. As it is, the code in Emacs implies 19451even in the bowels of a computer. As it is, the code in Emacs implies
19452that a human who is acting virtuously, by exploring his or her 19452that a human who is acting virtuously, by exploring his or her
19453environment, is making an error. This is bad. Even though the computer 19453environment, 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
19760because they were written earlier. 19760because 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
19765Printed axes help you understand a graph. They convey scale. In an 19765Printed axes help you understand a graph. They convey scale. In an
19766earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we 19766earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we
19767wrote the code to print the body of a graph. Here we write the code 19767wrote the code to print the body of a graph. Here we write the code
19768for printing and labelling vertical and horizontal axes, along with the 19768for printing and labeling vertical and horizontal axes, along with the
19769body itself. 19769body 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
19784Since insertions fill a buffer to the right and below point, the new 19784Since 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
19824In this graph, both the vertical and the horizontal axes are labelled 19824In this graph, both the vertical and the horizontal axes are labeled
19825with numbers. However, in some graphs, the horizontal axis is time 19825with numbers. However, in some graphs, the horizontal axis is time
19826and would be better labelled with months, like this: 19826and 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
19840Indeed, with a little thought, we can easily come up with a variety of 19840Indeed, with a little thought, we can easily come up with a variety of
19841vertical and horizontal labelling schemes. Our task could become 19841vertical and horizontal labeling schemes. Our task could become
19842complicated. But complications breed confusion. Rather than permit 19842complicated. But complications breed confusion. Rather than permit
19843this, it is better choose a simple labelling scheme for our first 19843this, it is better choose a simple labeling scheme for our first
19844effort, and to modify or replace it later. 19844effort, 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
19864We can work on each part of the @code{print-graph} function definition 19864We can work on each part of the @code{print-graph} function definition
19865in turn. 19865in 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
20391The value of the variable @code{X-axis-label-spacing} should itself be 20391The value of the variable @code{X-axis-label-spacing} should itself be
20392measured in units of @code{symbol-width}, since you may want to change 20392measured in units of @code{symbol-width}, since you may want to change
20393the width of the symbols that you are using to print the body of the 20393the width of the symbols that you are using to print the body of the
20394graph without changing the ways the graph is labelled. 20394graph 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:
20722Now we are nearly ready to print the whole graph. 20722Now we are nearly ready to print the whole graph.
20723 20723
20724The function to print the graph with the proper labels follows the 20724The function to print the graph with the proper labels follows the
20725outline we created earlier (@pxref{Full Graph, , A Graph with Labelled 20725outline we created earlier (@pxref{Full Graph, , A Graph with Labeled
20726Axes}), but with additions. 20726Axes}), 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.
20861The numbers-list consists of the Y-axis values. 20861The 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.
21482The numbers-list consists of the Y-axis values. 21482The 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.
21983The numbers-list consists of the Y-axis values. 21983The 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