diff options
| author | Karl Berry | 2008-10-05 00:14:59 +0000 |
|---|---|---|
| committer | Karl Berry | 2008-10-05 00:14:59 +0000 |
| commit | a9097c6dda772fc560a1837713efe15d8e19c9dd (patch) | |
| tree | a12a75b8b0371a69d90f997f4cec679e3e8c5bf4 /doc | |
| parent | 11b4001c8ffddf9cdde106409287f2387fd2cd83 (diff) | |
| download | emacs-a9097c6dda772fc560a1837713efe15d8e19c9dd.tar.gz emacs-a9097c6dda772fc560a1837713efe15d8e19c9dd.zip | |
formatting fixes for new printed edition
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/lispintro/ChangeLog | 9 | ||||
| -rw-r--r-- | doc/lispintro/emacs-lisp-intro.texi | 83 |
2 files changed, 58 insertions, 34 deletions
diff --git a/doc/lispintro/ChangeLog b/doc/lispintro/ChangeLog index 2f054028a21..62abed9af10 100644 --- a/doc/lispintro/ChangeLog +++ b/doc/lispintro/ChangeLog | |||
| @@ -1,3 +1,12 @@ | |||
| 1 | 2008-10-04 Karl Berry <karl@gnu.org> | ||
| 2 | |||
| 3 | * emacs-lisp-intro.texi: Apply similar formatting changes as for | ||
| 4 | the emacs and lispref manuals, to save pages. A couple minor | ||
| 5 | rewordings and reformatting of code to avoid overfull and | ||
| 6 | underfull lines. | ||
| 7 | (edition-number): bump to 3.08. | ||
| 8 | (update-date): bump to 4 October 2008. | ||
| 9 | |||
| 1 | 2008-06-20 Eli Zaretskii <eliz@gnu.org> | 10 | 2008-06-20 Eli Zaretskii <eliz@gnu.org> |
| 2 | 11 | ||
| 3 | * makefile.w32-in (distclean): Remove makefile. | 12 | * makefile.w32-in (distclean): Remove makefile. |
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index bcc685552f5..6d0bcb5a4c2 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi | |||
| @@ -6,15 +6,17 @@ | |||
| 6 | @settitle Programming in Emacs Lisp | 6 | @settitle Programming in Emacs Lisp |
| 7 | @syncodeindex vr cp | 7 | @syncodeindex vr cp |
| 8 | @syncodeindex fn cp | 8 | @syncodeindex fn cp |
| 9 | @setchapternewpage odd | ||
| 10 | @finalout | 9 | @finalout |
| 11 | 10 | ||
| 12 | @c --------- | 11 | @c --------- |
| 13 | @c <<<< For hard copy printing, this file is now | 12 | @c <<<< For hard copy printing, this file is now |
| 14 | @c set for smallbook, which works for all sizes | 13 | @c set for smallbook, which works for all sizes |
| 15 | @c of paper, and with Postscript figures >>>> | 14 | @c of paper, and with Postscript figures >>>> |
| 15 | @set smallbook | ||
| 16 | @ifset smallbook | ||
| 16 | @smallbook | 17 | @smallbook |
| 17 | @clear largebook | 18 | @clear largebook |
| 19 | @end ifset | ||
| 18 | @set print-postscript-figures | 20 | @set print-postscript-figures |
| 19 | @c set largebook | 21 | @c set largebook |
| 20 | @c clear print-postscript-figures | 22 | @c clear print-postscript-figures |
| @@ -22,8 +24,20 @@ | |||
| 22 | 24 | ||
| 23 | @comment %**end of header | 25 | @comment %**end of header |
| 24 | 26 | ||
| 27 | @c per rms and peterb, use 10pt fonts for the main text, mostly to | ||
| 28 | @c save on paper cost. | ||
| 29 | @c Do this inside @tex for now, so current makeinfo does not complain. | ||
| 30 | @tex | ||
| 31 | @ifset smallbook | ||
| 32 | @fonttextsize 10 | ||
| 33 | \global\let\urlcolor=\Black % don't print links in grayscale | ||
| 34 | \global\let\linkcolor=\Black | ||
| 35 | @end ifset | ||
| 36 | \global\hbadness=6666 % don't worry about not-too-underfull boxes | ||
| 37 | @end tex | ||
| 38 | |||
| 25 | @set edition-number 3.08 | 39 | @set edition-number 3.08 |
| 26 | @set update-date 12 September 2007 | 40 | @set update-date 4 October 2008 |
| 27 | @ignore | 41 | @ignore |
| 28 | ## Summary of shell commands to create various output formats: | 42 | ## Summary of shell commands to create various output formats: |
| 29 | 43 | ||
| @@ -317,9 +331,9 @@ every node in every chapter. | |||
| 317 | @c right handed page after the Table of Contents; hence the following | 331 | @c right handed page after the Table of Contents; hence the following |
| 318 | @c setting must be for an odd negative number. | 332 | @c setting must be for an odd negative number. |
| 319 | 333 | ||
| 320 | @iftex | 334 | @c iftex |
| 321 | @global@pageno = -11 | 335 | @c global@pageno = -11 |
| 322 | @end iftex | 336 | @c end iftex |
| 323 | 337 | ||
| 324 | @menu | 338 | @menu |
| 325 | * Preface:: What to look for. | 339 | * Preface:: What to look for. |
| @@ -2715,7 +2729,7 @@ When I do this in Info, the value returned by evaluating | |||
| 2715 | @code{(buffer-name)} is @file{"*info*"}, and the value returned by | 2729 | @code{(buffer-name)} is @file{"*info*"}, and the value returned by |
| 2716 | evaluating @code{(buffer-file-name)} is @file{nil}. | 2730 | evaluating @code{(buffer-file-name)} is @file{nil}. |
| 2717 | 2731 | ||
| 2718 | On the other hand, while I am writing this Introduction, the value | 2732 | On the other hand, while I am writing this document, the value |
| 2719 | returned by evaluating @code{(buffer-name)} is | 2733 | returned by evaluating @code{(buffer-name)} is |
| 2720 | @file{"introduction.texinfo"}, and the value returned by evaluating | 2734 | @file{"introduction.texinfo"}, and the value returned by evaluating |
| 2721 | @code{(buffer-file-name)} is | 2735 | @code{(buffer-file-name)} is |
| @@ -6461,7 +6475,8 @@ and avoids clobbering the mark." | |||
| 6461 | ;; Avoid overflow for large buffer sizes! | 6475 | ;; Avoid overflow for large buffer sizes! |
| 6462 | (* (prefix-numeric-value arg) | 6476 | (* (prefix-numeric-value arg) |
| 6463 | (/ size 10)) | 6477 | (/ size 10)) |
| 6464 | (/ (+ 10 (* size (prefix-numeric-value arg))) 10))) | 6478 | (/ (+ 10 (* size (prefix-numeric-value arg))) |
| 6479 | 10))) | ||
| 6465 | (point-min)))) | 6480 | (point-min)))) |
| 6466 | (if arg (forward-line 1))) | 6481 | (if arg (forward-line 1))) |
| 6467 | @end group | 6482 | @end group |
| @@ -7771,7 +7786,8 @@ Goes backward if ARG is negative; error if CHAR not found." | |||
| 7771 | (if (char-table-p translation-table-for-input) | 7786 | (if (char-table-p translation-table-for-input) |
| 7772 | (setq char (or (aref translation-table-for-input char) char))) | 7787 | (setq char (or (aref translation-table-for-input char) char))) |
| 7773 | (kill-region (point) (progn | 7788 | (kill-region (point) (progn |
| 7774 | (search-forward (char-to-string char) nil nil arg) | 7789 | (search-forward (char-to-string char) |
| 7790 | nil nil arg) | ||
| 7775 | (point)))) | 7791 | (point)))) |
| 7776 | @end group | 7792 | @end group |
| 7777 | @end smallexample | 7793 | @end smallexample |
| @@ -11551,8 +11567,8 @@ tests the value of @code{list}. Since the value of @code{list} is | |||
| 11551 | not evaluated. The function as a whole then returns @code{nil}. | 11567 | not evaluated. The function as a whole then returns @code{nil}. |
| 11552 | 11568 | ||
| 11553 | @need 1200 | 11569 | @need 1200 |
| 11554 | When you evaluate @code{(print-elements-recursively animals)} in the | 11570 | When you evaluate the expression @code{(print-elements-recursively |
| 11555 | @file{*scratch*} buffer, you see this result: | 11571 | animals)} in the @file{*scratch*} buffer, you see this result: |
| 11556 | 11572 | ||
| 11557 | @smallexample | 11573 | @smallexample |
| 11558 | @group | 11574 | @group |
| @@ -11694,7 +11710,7 @@ The innermost expression of the else-part is evaluated, which decrements | |||
| 11694 | 11710 | ||
| 11695 | The number 2 is passed to the @code{triangle-recursively} function. | 11711 | The number 2 is passed to the @code{triangle-recursively} function. |
| 11696 | 11712 | ||
| 11697 | We know what happens when Emacs evaluates @code{triangle-recursively} with | 11713 | We already know what happens when Emacs evaluates @code{triangle-recursively} with |
| 11698 | an argument of 2. After going through the sequence of actions described | 11714 | an argument of 2. After going through the sequence of actions described |
| 11699 | earlier, it returns a value of 3. So that is what will happen here. | 11715 | earlier, it returns a value of 3. So that is what will happen here. |
| 11700 | 11716 | ||
| @@ -17844,9 +17860,9 @@ which is a standard part of the distribution.) | |||
| 17844 | @noindent | 17860 | @noindent |
| 17845 | This expression autoloads the @code{html-helper-mode} function. It | 17861 | This expression autoloads the @code{html-helper-mode} function. It |
| 17846 | takes it from the @file{html-helper-mode.el} file (or from the byte | 17862 | takes it from the @file{html-helper-mode.el} file (or from the byte |
| 17847 | compiled file @file{html-helper-mode.elc}, if it exists.) The file | 17863 | compiled version @file{html-helper-mode.elc}, if that exists.) The |
| 17848 | must be located in a directory specified by @code{load-path}. The | 17864 | file must be located in a directory specified by @code{load-path}. |
| 17849 | documentation says that this is a mode to help you edit documents | 17865 | The documentation says that this is a mode to help you edit documents |
| 17850 | written in the HyperText Markup Language. You can call this mode | 17866 | written in the HyperText Markup Language. You can call this mode |
| 17851 | interactively by typing @kbd{M-x html-helper-mode}. (You need to | 17867 | interactively by typing @kbd{M-x html-helper-mode}. (You need to |
| 17852 | duplicate the function's regular documentation in the autoload | 17868 | duplicate the function's regular documentation in the autoload |
| @@ -22659,22 +22675,21 @@ MENU ENTRY: NODE NAME. | |||
| 22659 | @c Place biographical information on right-hand (verso) page | 22675 | @c Place biographical information on right-hand (verso) page |
| 22660 | 22676 | ||
| 22661 | @tex | 22677 | @tex |
| 22678 | \par\vfill\supereject | ||
| 22662 | \ifodd\pageno | 22679 | \ifodd\pageno |
| 22663 | \par\vfill\supereject | ||
| 22664 | \global\evenheadline={\hfil} \global\evenfootline={\hfil} | 22680 | \global\evenheadline={\hfil} \global\evenfootline={\hfil} |
| 22665 | \global\oddheadline={\hfil} \global\oddfootline={\hfil} | 22681 | \global\oddheadline={\hfil} \global\oddfootline={\hfil} |
| 22666 | \page\hbox{}\page | 22682 | %\page\hbox{}\page |
| 22667 | \else | 22683 | \else |
| 22668 | \par\vfill\supereject | 22684 | % \par\vfill\supereject |
| 22669 | \par\vfill\supereject | ||
| 22670 | \global\evenheadline={\hfil} \global\evenfootline={\hfil} | 22685 | \global\evenheadline={\hfil} \global\evenfootline={\hfil} |
| 22671 | \global\oddheadline={\hfil} \global\oddfootline={\hfil} | 22686 | \global\oddheadline={\hfil} \global\oddfootline={\hfil} |
| 22672 | \page\hbox{}\page | 22687 | %\page\hbox{}%\page |
| 22673 | \page\hbox{}\page | 22688 | %\page\hbox{}%\page |
| 22674 | \fi | 22689 | \fi |
| 22675 | @end tex | 22690 | @end tex |
| 22676 | 22691 | ||
| 22677 | @page | 22692 | @c page |
| 22678 | @w{ } | 22693 | @w{ } |
| 22679 | 22694 | ||
| 22680 | @c ================ Biographical information ================ | 22695 | @c ================ Biographical information ================ |
| @@ -22701,19 +22716,19 @@ abiding interest in social and economic history and flies his own | |||
| 22701 | airplane. | 22716 | airplane. |
| 22702 | @end quotation | 22717 | @end quotation |
| 22703 | 22718 | ||
| 22704 | @page | 22719 | @c @page |
| 22705 | @w{ } | 22720 | @c @w{ } |
| 22706 | 22721 | @c | |
| 22707 | @c Prevent page number on blank verso, so eject it first. | 22722 | @c @c Prevent page number on blank verso, so eject it first. |
| 22708 | @tex | 22723 | @c @tex |
| 22709 | \par\vfill\supereject | 22724 | @c \par\vfill\supereject |
| 22710 | @end tex | 22725 | @c @end tex |
| 22711 | 22726 | ||
| 22712 | @iftex | 22727 | @c @iftex |
| 22713 | @headings off | 22728 | @c @headings off |
| 22714 | @evenheading @thispage @| @| @thistitle | 22729 | @c @evenheading @thispage @| @| @thistitle |
| 22715 | @oddheading @| @| @thispage | 22730 | @c @oddheading @| @| @thispage |
| 22716 | @end iftex | 22731 | @c @end iftex |
| 22717 | 22732 | ||
| 22718 | @bye | 22733 | @bye |
| 22719 | 22734 | ||