doc/lispref/vol1.texi

   1 \input texinfo  @c -*-texinfo-*-
   2 @c This file is used for printing the GNU Emacs Lisp Reference Manual
   3 @c in two volumes.  It is a modified version of elisp.texi.
   4 @c Copyright (C) 1990-1995, 1998-1999, 2001-2012
   5 @c   Free Software Foundation, Inc.
   6 @c %**start of header
   7 @setfilename elisp
   8 @settitle GNU Emacs Lisp Reference Manual: Volume 1
   9 @c %**end of header
  10
  11 @c See two-volume-cross-refs.txt.
  12 @tex
  13 \message{Formatting for two volume edition...Volume 1...}
  14 %
  15 % Read special toc file, set up in two-volume.make.
  16 \gdef\tocreadfilename{elisp1-toc-ready.toc}
  17 %
  18 % Don't make outlines, they're not needed and \readdatafile can't pay
  19 % attention to the special definition above.
  20 \global\let\pdfmakeoutlines=\relax
  21 %
  22 % Start volume 1 chapter numbering at 1; this must be listed as chapno0.
  23 \global\chapno=0
  24 @end tex
  25
  26 @c Version of the manual and of Emacs.
  27 @set VERSION  3.1
  28 @include emacsver.texi
  29 @set DATE May 2012
  30
  31 @dircategory Emacs
  32 @direntry
  33 * Elisp: (elisp).       The Emacs Lisp Reference Manual.
  34 @end direntry
  35
  36 @c in general, keep the following line commented out, unless doing a
  37 @c copy of this manual that will be published.  the manual should go
  38 @c onto the distribution in the full, 8.5 x 11" size.
  39 @set smallbook
  40
  41 @ifset smallbook
  42 @smallbook
  43 @end ifset
  44
  45 @c per rms and peterb, use 10pt fonts for the main text, mostly to
  46 @c save on paper cost.
  47 @c Do this inside @tex for now, so current makeinfo does not complain.
  48 @tex
  49 @ifset smallbook
  50 @fonttextsize 10
  51 \global\let\urlcolor=\Black % don't print links in grayscale
  52 \global\let\linkcolor=\Black
  53 @end ifset
  54 \global\hbadness=6666 % don't worry about not-too-underfull boxes
  55 @end tex
  56
  57 @c Combine indices.
  58 @synindex cp fn
  59 @syncodeindex vr fn
  60 @syncodeindex ky fn
  61 @syncodeindex pg fn
  62 @c We use the "type index" to index new functions and variables.
  63 @c @syncodeindex tp fn
  64
  65 @copying
  66 This is edition @value{VERSION} of the GNU Emacs Lisp Reference Manual,@*
  67 corresponding to Emacs version @value{EMACSVER}.
  68
  69 Copyright @copyright{} 1990-1996, 1998-2012 Free Software Foundation, Inc.
  70
  71 @quotation
  72 Permission is granted to copy, distribute and/or modify this document
  73 under the terms of the GNU Free Documentation License, Version 1.3 or
  74 any later version published by the Free Software Foundation; with the
  75 Invariant Sections being ``GNU General Public License,'' with the
  76 Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover
  77 Texts as in (a) below.  A copy of the license is included in the
  78 section entitled ``GNU Free Documentation License.''
  79
  80 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
  81 modify this GNU manual.  Buying copies from the FSF supports it in
  82 developing GNU and promoting software freedom.''
  83 @end quotation
  84 @end copying
  85
  86 @titlepage
  87 @title GNU Emacs Lisp Reference Manual
  88 @subtitle Volume 1
  89 @subtitle For Emacs Version @value{EMACSVER}
  90 @subtitle Revision @value{VERSION}, @value{DATE}
  91
  92 @author by Bil Lewis, Dan LaLiberte, Richard Stallman,
  93 @author the GNU Manual Group, et al.
  94 @page
  95 @vskip 0pt plus 1filll
  96 @insertcopying
  97
  98 @sp 2
  99
 100 Published by the Free Software Foundation @*
 101 51 Franklin St, Fifth Floor @*
 102 Boston, MA 02110-1301 @*
 103 USA @*
 104 ISBN 1-882114-74-4
 105
 106 @sp 2
 107 Cover art by Etienne Suvasa.
 108 @end titlepage
 109
 110
 111 @c Print the tables of contents
 112 @summarycontents
 113 @contents
 114
 115
 116 @ifnottex
 117 @node Top
 118 @top Emacs Lisp
 119
 120 This Info file contains edition @value{VERSION} of the GNU Emacs Lisp
 121 Reference Manual, corresponding to GNU Emacs version @value{EMACSVER}.
 122 @end ifnottex
 123
 124 @menu
 125 * Not used::                This file is only used with tex, which
 126                               generates its own menu.
 127
 128 @detailmenu
 129  --- The Detailed Node Listing ---
 130  ---------------------------------
 131
 132 Here are other nodes that are subnodes of those already listed,
 133 mentioned here so you can get to them in one step:
 134
 135 Not used
 136
 137 * Not used::                This file is only used with TeX, which
 138                               generates its own menu.
 139 @end detailmenu
 140 @end menu
 141
 142 @include intro.texi
 143 @include objects.texi
 144 @include numbers.texi
 145 @include strings.texi
 146
 147 @include lists.texi
 148 @include sequences.texi
 149 @include hash.texi
 150 @include symbols.texi
 151 @include eval.texi
 152
 153 @include control.texi
 154 @include variables.texi
 155 @include functions.texi
 156 @include macros.texi
 157
 158 @include customize.texi
 159 @include loading.texi
 160 @include compile.texi
 161 @include advice.texi
 162
 163 @c This includes edebug.texi.
 164 @include debugging.texi
 165 @include streams.texi
 166 @include minibuf.texi
 167 @include commands.texi
 168
 169 @include keymaps.texi
 170 @include modes.texi
 171 @include help.texi
 172 @include files.texi
 173
 174 @include backups.texi
 175
 176 @c ================ Beginning of Volume 2 ================
 177 @c include buffers.texi
 178 @c include windows.texi
 179 @c include frames.texi
 180
 181 @c include positions.texi
 182 @c include markers.texi
 183 @c include text.texi
 184 @c include nonascii.texi
 185
 186 @c include searching.texi
 187 @c include syntax.texi
 188 @c include abbrevs.texi
 189 @c include processes.texi
 190
 191 @c include display.texi
 192 @c include os.texi
 193
 194 @c appendices
 195
 196 @c include anti.texi
 197 @c include doclicense.texi
 198 @c include gpl.texi
 199 @c include tips.texi
 200 @c include internals.texi
 201 @c include errors.texi
 202 @c include maps.texi
 203 @c include hooks.texi
 204
 205 @include index.texi
 206
 207 @ignore
 208 @node New Symbols, , Index, Top
 209 @unnumbered New Symbols Since the Previous Edition
 210
 211 @printindex tp
 212 @end ignore
 213
 214 @bye
 215
 216 \f
 217 These words prevent "local variables" above from confusing Emacs.