Initial commit
[emacsbook.git] / book.html
blob17d9192ac66c0edcc126fc33833784d7557664c9
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-17 Sun 20:39 -->
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;
33 pre.src {
34 position: relative;
35 overflow: visible;
36 padding-top: 1.2em;
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;
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'; }
56 table { border-collapse:collapse; }
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;
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. Installing Emacs</a></li>
99 <li><a href="#sec-4">4. Text editing</a></li>
100 <li><a href="#sec-5">5. Reporting bugs</a></li>
101 <li><a href="#sec-6">6. Emacs Community</a></li>
102 <li><a href="#sec-7">7. Contributing to Emacs</a></li>
103 <li><a href="#sec-8">8. Building Emacs from sources</a></li>
104 </ul>
105 </div>
106 </div>
107 <div id="outline-container-1" class="outline-2">
108 <h2 id="sec-1"><span class="section-number-2">1</span> Goals and non-Goals</h2>
109 <div class="outline-text-2" id="text-1">
111 This book will teach you
112 </p>
114 <ol class="org-ol">
115 <li>To use Emacs.
116 </li>
117 <li>To customize Emacs to your specific needs.
118 </li>
119 </ol>
122 This book will <b>not</b>
123 </p>
125 <ol class="org-ol">
126 <li>Teach you to program in Emacs lisp
127 </li>
128 <li>Document third-party libraries which don't ship with Emacs or GNU
129 ELPA.
130 </li>
131 </ol>
132 </div>
133 </div>
134 <div id="outline-container-2" class="outline-2">
135 <h2 id="sec-2"><span class="section-number-2">2</span> Audience</h2>
136 <div class="outline-text-2" id="text-2">
138 New Emacs users who are also non-programmers.
139 </p>
140 </div>
141 </div>
142 <div id="outline-container-3" class="outline-2">
143 <h2 id="sec-3"><span class="section-number-2">3</span> Installing Emacs</h2>
144 <div class="outline-text-2" id="text-3">
146 The latest stable release of Emacs as on the day of writing is Emacs
147 24.3.
148 </p>
151 You can download the pre-build binaries from <a href="http://ftp.gnu.org/gnu/emacs/">GNU FTP Archives</a>. If you
152 are on Windows, you can download the binaries from <a href="http://ftp.gnu.org/gnu/emacs/windows/">Windows
153 subdirectory</a>.
154 </p>
155 </div>
156 </div>
157 <div id="outline-container-4" class="outline-2">
158 <h2 id="sec-4"><span class="section-number-2">4</span> Text editing</h2>
159 </div>
161 <div id="outline-container-5" class="outline-2">
162 <h2 id="sec-5"><span class="section-number-2">5</span> Reporting bugs</h2>
163 <div class="outline-text-2" id="text-5">
165 You can submit a bug report with
166 </p>
168 <pre class="example">
169 M-x report-emacs-bug RET
170 </pre>
171 </div>
172 </div>
173 <div id="outline-container-6" class="outline-2">
174 <h2 id="sec-6"><span class="section-number-2">6</span> Emacs Community</h2>
175 <div class="outline-text-2" id="text-6">
177 The Emacs project has many <a href="https://savannah.gnu.org/mail/?group=emacs">mailing lists</a>. You may wish to subscribe
178 to one or more of these mailing lists.
179 </p>
181 <ol class="org-ol">
182 <li><a href="http://lists.gnu.org/mailman/listinfo/info-gnu-emacs">Emacs news</a>
183 </li>
184 <li><a href="http://lists.gnu.org/mailman/listinfo/help-gnu-emacs">Emacs users</a>
185 </li>
186 <li><a href="http://lists.gnu.org/mailman/listinfo/emacs-devel">Emacs developers</a>
187 </li>
188 <li><a href="http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs">Emacs bugs</a>
189 </li>
190 <li><a href="http://lists.gnu.org/mailman/listinfo/gnu-emacs-sources">Emacs sources</a>
191 </li>
192 </ol>
195 See <a href="http://www.gnu.org/software/emacs/">Emacs project page</a> for more information.
196 </p>
199 <a href="http://www.emacswiki.org/">Emacswiki</a>
200 </p>
203 IRC: #emacs @ irc.freenode.net
204 </p>
205 </div>
206 </div>
207 <div id="outline-container-7" class="outline-2">
208 <h2 id="sec-7"><span class="section-number-2">7</span> Contributing to Emacs</h2>
209 <div class="outline-text-2" id="text-7">
211 Emacs sources are maintained using Bazaar version control system. You
212 can obtain the version controlled source tree with
213 </p>
215 <pre class="example">
216 bzr branch bzr://bzr.savannah.gnu.org/emacs/trunk
217 </pre>
220 You can also browse the source repository for one-off purposes using
221 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>.
222 </p>
225 If you are a Git user, you can checkout the source tree using git as
226 follows
227 </p>
229 <pre class="example">
230 git clone git://git.savannah.gnu.org/emacs.git
231 </pre>
234 See <a href="http://savannah.gnu.org/maintenance/UsingGit">for more information on using git</a>.
235 </p>
236 </div>
237 </div>
238 <div id="outline-container-8" class="outline-2">
239 <h2 id="sec-8"><span class="section-number-2">8</span> Building Emacs from sources</h2>
240 <div class="outline-text-2" id="text-8">
242 If you are a developer or a user who is interested in testing out
243 Emacs trunk see <a href="http://www.emacswiki.org/emacs/BzrForEmacsDevs">instructions at Emacswiki</a>.
244 </p>
245 </div>
246 </div>
247 </div>
248 <div id="postamble" class="status">
249 <p class="author">Author: Jambunathan K</p>
250 <p class="date">Created: 2013-03-17 Sun 20:39</p>
251 <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.8.</p>
252 <p class="xhtml-validation"><a href="http://validator.w3.org/check?uri=referer">Validate XHTML 1.0</a></p>
253 </div>
254 </body>
255 </html>