book.html

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3           "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
   5   <head>
   6     <title></title>
   7     <!-- 2013-03-18 Mon 19:40 -->
   8     <meta name="generator" content="Org-mode"/>
   9     <meta name="author" content="Jambunathan K"/>
  10     <style type="text/css">
  11       <!--/*--><![CDATA[/*><!--*/
  12   .title  { text-align: center; }
  13   .todo   { font-family: monospace; color: red; }
  14   .done   { color: green; }
  15   .tag    { background-color: #eee; font-family: monospace;
  16             padding: 2px; font-size: 80%; font-weight: normal; }
  17   .timestamp { color: #bebebe; }
  18   .timestamp-kwd { color: #5f9ea0; }
  19   .right  { margin-left: auto; margin-right: 0px;  text-align: right; }
  20   .left   { margin-left: 0px;  margin-right: auto; text-align: left; }
  21   .center { margin-left: auto; margin-right: auto; text-align: center; }
  22   .underline { text-decoration: underline; }
  23   #postamble p, #preamble p { font-size: 90%; margin: .2em; }
  24   p.verse { margin-left: 3%; }
  25   pre {
  26     border: 1px solid #ccc;
  27     box-shadow: 3px 3px 3px #eee;
  28     padding: 8pt;
  29     font-family: monospace;
  30     overflow: auto;
  31     margin: 1.2em;
  32   }
  33   pre.src {
  34     position: relative;
  35     overflow: visible;
  36     padding-top: 1.2em;
  37   }
  38   pre.src:before {
  39     display: none;
  40     position: absolute;
  41     background-color: white;
  42     top: -10px;
  43     right: 10px;
  44     padding: 3px;
  45     border: 1px solid black;
  46   }
  47   pre.src:hover:before { display: inline;}
  48   pre.src-sh:before    { content: 'sh'; }
  49   pre.src-bash:before  { content: 'sh'; }
  50   pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
  51   pre.src-R:before     { content: 'R'; }
  52   pre.src-perl:before  { content: 'Perl'; }
  53   pre.src-java:before  { content: 'Java'; }
  54   pre.src-sql:before   { content: 'SQL'; }
  55
  56   table { border-collapse:collapse; width : 30%; table-layout: fixed;}
  57   td, th { vertical-align:top;  }
  58   th.right  { text-align: center;  }
  59   th.left   { text-align: center;   }
  60   th.center { text-align: center; }
  61   td.right  { text-align: right;  }
  62   td.left   { text-align: left;   }
  63   td.center { text-align: center; }
  64   dt { font-weight: bold; }
  65   .footpara:nth-child(2) { display: inline; }
  66   .footpara { display: block; }
  67   .footdef  { margin-bottom: 1em; }
  68   .figure { padding: 1em; }
  69   .figure p { text-align: center; }
  70   .inlinetask {
  71     padding: 10px;
  72     border: 2px solid gray;
  73     margin: 10px;
  74     background: #ffffcc;
  75   }
  76   #org-div-home-and-up
  77    { text-align: right; font-size: 70%; white-space: nowrap; }
  78   textarea { overflow-x: auto; }
  79   .linenr { font-size: smaller }
  80   .code-highlighted { background-color: #ffff00; }
  81   .org-info-js_info-navigation { border-style: none; }
  82   #org-info-js_console-label
  83     { font-size: 10px; font-weight: bold; white-space: nowrap; }
  84   .org-info-js_search-highlight
  85     { background-color: #ffff00; color: #000000; font-weight: bold; }
  86   /*]]>*/-->
  87     </style>
  88   </head>
  89   <body>
  90     <div id="content">
  91       <h1 class="title"></h1>
  92       <div id="table-of-contents">
  93         <h2>Table of Contents</h2>
  94         <div id="text-table-of-contents">
  95           <ul>
  96             <li><a href="#sec-1">1. Goals and non-Goals</a></li>
  97             <li><a href="#sec-2">2. Audience</a></li>
  98             <li><a href="#sec-3">3. Prerequisites</a></li>
  99             <li><a href="#sec-4">4. Installing Emacs</a></li>
 100             <li><a href="#sec-5">5. Self help</a></li>
 101             <li><a href="#sec-6">6. Basic customization</a></li>
 102             <li><a href="#sec-7">7. Text editing</a>
 103               <ul>
 104                 <li><a href="#sec-7-1">7.1. Statistics</a></li>
 105                 <li><a href="#sec-7-2">7.2. Spellchecking</a></li>
 106                 <li><a href="#sec-7-3">7.3. Dictionary and Thesaurus</a></li>
 107               </ul>
 108             </li>
 109             <li><a href="#sec-8">8. Install additional packages</a></li>
 110             <li><a href="#sec-9">9. Games</a></li>
 111             <li><a href="#sec-10">10. Reporting bugs</a></li>
 112             <li><a href="#sec-11">11. Emacs Community</a></li>
 113             <li><a href="#sec-12">12. Contributing to Emacs</a></li>
 114             <li><a href="#sec-13">13. Building Emacs from sources</a></li>
 115           </ul>
 116         </div>
 117       </div>
 118       <div id="outline-container-1" class="outline-2">
 119         <h2 id="sec-1"><span class="section-number-2">1</span> Goals and non-Goals</h2>
 120         <div class="outline-text-2" id="text-1">
 121           <p>
 122             This book will teach you
 123           </p>
 124
 125           <ol class="org-ol">
 126             <li>To use Emacs.
 127             </li>
 128             <li>To customize Emacs to your specific needs.
 129             </li>
 130             <li>Place Emacs in a modern context.
 131             </li>
 132           </ol>
 133
 134           <p>
 135             This book will <b>not</b>
 136           </p>
 137
 138           <ol class="org-ol">
 139             <li>Teach you to program in Emacs lisp
 140             </li>
 141             <li>Document third-party libraries which don't ship with Emacs or GNU
 142               ELPA.
 143             </li>
 144           </ol>
 145         </div>
 146       </div>
 147       <div id="outline-container-2" class="outline-2">
 148         <h2 id="sec-2"><span class="section-number-2">2</span> Audience</h2>
 149         <div class="outline-text-2" id="text-2">
 150           <p>
 151             If you are new to Emacs then this book is for you.  You don't have to
 152             be a programmer to benefit from this book.
 153           </p>
 154         </div>
 155       </div>
 156       <div id="outline-container-3" class="outline-2">
 157         <h2 id="sec-3"><span class="section-number-2">3</span> Prerequisites</h2>
 158         <div class="outline-text-2" id="text-3">
 159           <p>
 160             You need to be a touch typist to use Emacs efficiently.
 161           </p>
 162         </div>
 163       </div>
 164       <div id="outline-container-4" class="outline-2">
 165         <h2 id="sec-4"><span class="section-number-2">4</span> Installing Emacs</h2>
 166         <div class="outline-text-2" id="text-4">
 167           <p>
 168             The latest stable release of Emacs as on the day of writing is Emacs
 169             24.3.
 170           </p>
 171
 172           <p>
 173             You can download the pre-build binaries from <a href="http://ftp.gnu.org/gnu/emacs/">GNU FTP Archives</a>.  If you
 174             are on Windows, you can download the binaries from <a href="http://ftp.gnu.org/gnu/emacs/windows/">Windows
 175               subdirectory</a>.
 176           </p>
 177         </div>
 178       </div>
 179       <div id="outline-container-5" class="outline-2">
 180         <h2 id="sec-5"><span class="section-number-2">5</span> Self help</h2>
 181       </div>
 182
 183       <div id="outline-container-6" class="outline-2">
 184         <h2 id="sec-6"><span class="section-number-2">6</span> Basic customization</h2>
 185       </div>
 186
 187       <div id="outline-container-7" class="outline-2">
 188         <h2 id="sec-7"><span class="section-number-2">7</span> Text editing</h2>
 189         <div class="outline-text-2" id="text-7">
 190           <p>
 191             You can goto specific line with
 192           </p>
 193
 194           <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 195
 196
 197             <colgroup>
 198               <col class="left"/>
 199
 200               <col class="left"/>
 201             </colgroup>
 202             <thead>
 203               <tr>
 204                 <th scope="col" class="left">Action</th>
 205                 <th scope="col" class="left">Keys</th>
 206               </tr>
 207             </thead>
 208             <tbody>
 209               <tr>
 210                 <td class="left">Goto a line</td>
 211                 <td class="left">M-g M-g</td>
 212               </tr>
 213             </tbody>
 214           </table>
 215
 216
 217           <p>
 218             You can move around your buffer very quickly using the following key
 219             bindings.
 220           </p>
 221
 222           <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 223
 224
 225             <colgroup>
 226               <col class="left"/>
 227
 228               <col class="left"/>
 229             </colgroup>
 230             <thead>
 231               <tr>
 232                 <th scope="col" class="left">Action</th>
 233                 <th scope="col" class="left">Keys</th>
 234               </tr>
 235             </thead>
 236             <tbody>
 237               <tr>
 238                 <td class="left">Line beginning</td>
 239                 <td class="left">C-a</td>
 240               </tr>
 241
 242               <tr>
 243                 <td class="left">Line end</td>
 244                 <td class="left">C-e</td>
 245               </tr>
 246             </tbody>
 247             <tbody>
 248               <tr>
 249                 <td class="left">Next line</td>
 250                 <td class="left">C-n</td>
 251               </tr>
 252
 253               <tr>
 254                 <td class="left">Prev line</td>
 255                 <td class="left">C-p</td>
 256               </tr>
 257             </tbody>
 258             <tbody>
 259               <tr>
 260                 <td class="left">Scroll forward</td>
 261                 <td class="left">C-v</td>
 262               </tr>
 263
 264               <tr>
 265                 <td class="left">Scroll back</td>
 266                 <td class="left">M-v</td>
 267               </tr>
 268             </tbody>
 269           </table>
 270
 271           <p>
 272             You can move around your buffer very quickly using the following key
 273             bindings.
 274           </p>
 275
 276           <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 277
 278
 279             <colgroup>
 280               <col class="left"/>
 281
 282               <col class="left"/>
 283             </colgroup>
 284             <thead>
 285               <tr>
 286                 <th scope="col" class="left">Action</th>
 287                 <th scope="col" class="left">Keys</th>
 288               </tr>
 289             </thead>
 290             <tbody>
 291               <tr>
 292                 <td class="left">Next word</td>
 293                 <td class="left">M-f</td>
 294               </tr>
 295
 296               <tr>
 297                 <td class="left">Previous word</td>
 298                 <td class="left">M-b</td>
 299               </tr>
 300             </tbody>
 301             <tbody>
 302               <tr>
 303                 <td class="left">Sentence beginning</td>
 304                 <td class="left">M-a</td>
 305               </tr>
 306
 307               <tr>
 308                 <td class="left">Sentence end</td>
 309                 <td class="left">M-e</td>
 310               </tr>
 311             </tbody>
 312             <tbody>
 313               <tr>
 314                 <td class="left">Next paragraph</td>
 315                 <td class="left">M-}</td>
 316               </tr>
 317
 318               <tr>
 319                 <td class="left">Prev paragraph</td>
 320                 <td class="left">M-{</td>
 321               </tr>
 322             </tbody>
 323             <tbody>
 324               <tr>
 325                 <td class="left">Next page</td>
 326                 <td class="left">C-x ]</td>
 327               </tr>
 328
 329               <tr>
 330                 <td class="left">Prev page</td>
 331                 <td class="left">C-x [</td>
 332               </tr>
 333             </tbody>
 334             <tbody>
 335               <tr>
 336                 <td class="left">Buffer beginning</td>
 337                 <td class="left">M-&lt;</td>
 338               </tr>
 339
 340               <tr>
 341                 <td class="left">Buffer end</td>
 342                 <td class="left">M-&gt;</td>
 343               </tr>
 344             </tbody>
 345           </table>
 346         </div>
 347
 348         <div id="outline-container-7-1" class="outline-3">
 349           <h3 id="sec-7-1"><span class="section-number-3">7.1</span> Statistics</h3>
 350           <div class="outline-text-3" id="text-7-1">
 351             <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 352
 353
 354               <colgroup>
 355                 <col class="left"/>
 356
 357                 <col class="left"/>
 358               </colgroup>
 359               <thead>
 360                 <tr>
 361                   <th scope="col" class="left">Action</th>
 362                   <th scope="col" class="left">Keys</th>
 363                 </tr>
 364               </thead>
 365               <tbody>
 366                 <tr>
 367                   <td class="left">Counting words</td>
 368                   <td class="left">M-=</td>
 369                 </tr>
 370               </tbody>
 371             </table>
 372           </div>
 373         </div>
 374         <div id="outline-container-7-2" class="outline-3">
 375           <h3 id="sec-7-2"><span class="section-number-3">7.2</span> Spellchecking</h3>
 376         </div>
 377
 378         <div id="outline-container-7-3" class="outline-3">
 379           <h3 id="sec-7-3"><span class="section-number-3">7.3</span> Dictionary and Thesaurus</h3>
 380         </div>
 381       </div>
 382       <div id="outline-container-8" class="outline-2">
 383         <h2 id="sec-8"><span class="section-number-2">8</span> Install additional packages</h2>
 384       </div>
 385
 386       <div id="outline-container-9" class="outline-2">
 387         <h2 id="sec-9"><span class="section-number-2">9</span> Games</h2>
 388       </div>
 389
 390       <div id="outline-container-10" class="outline-2">
 391         <h2 id="sec-10"><span class="section-number-2">10</span> Reporting bugs</h2>
 392         <div class="outline-text-2" id="text-10">
 393           <p>
 394             You can submit a bug report with
 395           </p>
 396
 397           <pre class="example">
 398             M-x report-emacs-bug RET
 399           </pre>
 400         </div>
 401       </div>
 402       <div id="outline-container-11" class="outline-2">
 403         <h2 id="sec-11"><span class="section-number-2">11</span> Emacs Community</h2>
 404         <div class="outline-text-2" id="text-11">
 405           <p>
 406             The Emacs project has many <a href="https://savannah.gnu.org/mail/?group=emacs">mailing lists</a>.
 407           </p>
 408
 409           <p>
 410             You can browse the archives online
 411           </p>
 412
 413           <ol class="org-ol">
 414             <li><a href="http://lists.gnu.org/archive/html/info-gnu-emacs">Emacs news archive</a>
 415             </li>
 416             <li><a href="http://lists.gnu.org/archive/html/help-gnu-emacs">Emacs users archive</a>
 417             </li>
 418             <li><a href="http://lists.gnu.org/archive/html/emacs-devel">Emacs developers archive</a>
 419             </li>
 420             <li><a href="http://lists.gnu.org/archive/html/bug-gnu-emacs">Emacs bugs archive</a>
 421             </li>
 422             <li><a href="http://lists.gnu.org/archive/html/gnu-emacs-sources">Emacs sources archive</a>
 423             </li>
 424           </ol>
 425
 426           <p>
 427             You may wish to subscribe to one or more of these mailing lists.
 428           </p>
 429
 430           <ol class="org-ol">
 431             <li><a href="http://lists.gnu.org/mailman/listinfo/info-gnu-emacs">Emacs news</a>
 432             </li>
 433             <li><a href="http://lists.gnu.org/mailman/listinfo/help-gnu-emacs">Emacs users</a>
 434             </li>
 435             <li><a href="http://lists.gnu.org/mailman/listinfo/emacs-devel">Emacs developers</a>
 436             </li>
 437             <li><a href="http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs">Emacs bugs</a>
 438             </li>
 439             <li><a href="http://lists.gnu.org/mailman/listinfo/gnu-emacs-sources">Emacs sources</a>
 440             </li>
 441           </ol>
 442
 443
 444
 445           <p>
 446             See <a href="http://www.gnu.org/software/emacs/">Emacs project page</a> for more information.
 447           </p>
 448
 449           <p>
 450             <a href="http://www.emacswiki.org/">Emacswiki</a>
 451           </p>
 452
 453           <p>
 454             IRC: #emacs @ irc.freenode.net
 455           </p>
 456         </div>
 457       </div>
 458       <div id="outline-container-12" class="outline-2">
 459         <h2 id="sec-12"><span class="section-number-2">12</span> Contributing to Emacs</h2>
 460         <div class="outline-text-2" id="text-12">
 461           <p>
 462             Emacs sources are maintained using Bazaar version control system.  You
 463             can obtain the version controlled source tree with
 464           </p>
 465
 466           <pre class="example">
 467             bzr branch bzr://bzr.savannah.gnu.org/emacs/trunk
 468           </pre>
 469
 470           <p>
 471             You can also browse the source repository for one-off purposes using
 472             the following URLs: <a href="http://bzr.savannah.gnu.org/lh/emacs/trunk/files">Bzr Loggerhead</a> or <a href="http://git.savannah.gnu.org/cgit/emacs.git/log/">Cgit web interface</a>.
 473           </p>
 474
 475           <p>
 476             If you are a Git user, you can checkout the source tree using git as
 477             follows
 478           </p>
 479
 480           <pre class="example">
 481             git clone git://git.savannah.gnu.org/emacs.git
 482           </pre>
 483
 484           <p>
 485             See <a href="http://savannah.gnu.org/maintenance/UsingGit">for more information on using git</a>.
 486           </p>
 487         </div>
 488       </div>
 489       <div id="outline-container-13" class="outline-2">
 490         <h2 id="sec-13"><span class="section-number-2">13</span> Building Emacs from sources</h2>
 491         <div class="outline-text-2" id="text-13">
 492           <p>
 493             If you are a developer or a user who is interested in testing out
 494             Emacs trunk see <a href="http://www.emacswiki.org/emacs/BzrForEmacsDevs">instructions at Emacswiki</a>.
 495           </p>
 496
 497           <pre class="example">
 498             apt-get install build-essential
 499             apt-get build-dep emacs
 500           </pre>
 501         </div>
 502       </div>
 503     </div>
 504     <div id="postamble" class="status">
 505       <p class="author">Author: Jambunathan K</p>
 506       <p class="date">Created: 2013-03-18 Mon 19:40</p>
 507       <p class="creator">Generated by <a href="http://orgmode.org">Org</a> mode 8.0-pre in <a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.3.50.9.</p>
 508       <p class="xhtml-validation"><a href="http://validator.w3.org/check?uri=referer">Validate XHTML 1.0</a></p>
 509     </div>
 510   </body>
 511 </html>