1 <!DOCTYPE html PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
3 <!-- Created on April 4, 2012 by texi2html 1.82
4 texi2html was written by:
5 Lionel Cons <Lionel.Cons@cern.ch> (original author)
6 Karl Berry <karl@freefriends.org>
7 Olaf Bachmann <obachman@mathematik.uni-kl.de>
9 Maintained by: Many creative people.
10 Send bugs and suggestions to <texi2html-bug@nongnu.org>
13 <title>Notes-mode
</title>
15 <meta name=
"description" content=
"Notes-mode">
16 <meta name=
"keywords" content=
"Notes-mode">
17 <meta name=
"resource-type" content=
"document">
18 <meta name=
"distribution" content=
"global">
19 <meta name=
"Generator" content=
"texi2html 1.82">
20 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
21 <style type=
"text/css">
23 a.summary-letter {text-decoration: none}
24 blockquote.smallquotation {font-size: smaller}
25 pre.display {font-family: serif}
26 pre.format {font-family: serif}
27 pre.menu-comment {font-family: serif}
28 pre.menu-preformatted {font-family: serif}
29 pre.smalldisplay {font-family: serif; font-size: smaller}
30 pre.smallexample {font-size: smaller}
31 pre.smallformat {font-family: serif; font-size: smaller}
32 pre.smalllisp {font-size: smaller}
33 span.roman {font-family:serif; font-weight:normal;}
34 span.sansserif {font-family:sans-serif; font-weight:normal;}
35 ul.toc {list-style: none}
42 <body lang=
"en" bgcolor=
"#FFFFFF" text=
"#000000" link=
"#0000FF" vlink=
"#800080" alink=
"#FF0000">
45 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
46 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
47 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
48 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
49 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
51 <h1 class=
"settitle">Notes-mode
</h1>
58 <table class=
"menu" border=
"0" cellspacing=
"0">
59 <tr><td align=
"left" valign=
"top"><a href=
"#Introduction">1. Introduction
</a></td><td> </td><td align=
"left" valign=
"top">
61 <tr><td align=
"left" valign=
"top"><a href=
"#Basics">2. Basics
</a></td><td> </td><td align=
"left" valign=
"top">
63 <tr><td align=
"left" valign=
"top"><a href=
"#Advanced-Features">3. Advanced Features
</a></td><td> </td><td align=
"left" valign=
"top">
65 <tr><td align=
"left" valign=
"top"><a href=
"#History">4. History
</a></td><td> </td><td align=
"left" valign=
"top">
67 <tr><td align=
"left" valign=
"top"><a href=
"#Installation">5. Installation
</a></td><td> </td><td align=
"left" valign=
"top">
69 <tr><td align=
"left" valign=
"top"><a href=
"#Keystroke-index">Keystroke index
</a></td><td> </td><td align=
"left" valign=
"top">
71 <tr><td align=
"left" valign=
"top"><a href=
"#Concept-index">Concept index
</a></td><td> </td><td align=
"left" valign=
"top">
73 <tr><th colspan=
"3" align=
"left" valign=
"top"><pre class=
"menu-comment"> — The Detailed Node Listing
—
77 </pre></th></tr><tr><td align=
"left" valign=
"top"><a href=
"#What-is-it_003f">1.1 What is it?
</a></td><td> </td><td align=
"left" valign=
"top">
79 <tr><td align=
"left" valign=
"top"><a href=
"#Why-keep-notes-at-all_003f">1.2 Why keep notes at all?
</a></td><td> </td><td align=
"left" valign=
"top">
81 <tr><td align=
"left" valign=
"top"><a href=
"#Why-keep-notes-on_002dline_003f">1.3 Why keep notes on-line?
</a></td><td> </td><td align=
"left" valign=
"top">
83 <tr><td align=
"left" valign=
"top"><a href=
"#Why-use-notes_002dmode_003f">1.4 Why use notes-mode?
</a></td><td> </td><td align=
"left" valign=
"top">
85 <tr><td align=
"left" valign=
"top"><a href=
"#Y2K-Statement">1.5 Y2K Statement
</a></td><td> </td><td align=
"left" valign=
"top">
87 <tr><td align=
"left" valign=
"top"><a href=
"#Related-work">1.6 Related work
</a></td><td> </td><td align=
"left" valign=
"top">
89 <tr><td align=
"left" valign=
"top"><a href=
"#Staying-on-top">1.7 Staying on top
</a></td><td> </td><td align=
"left" valign=
"top">
91 <tr><th colspan=
"3" align=
"left" valign=
"top"><pre class=
"menu-comment">
94 </pre></th></tr><tr><td align=
"left" valign=
"top"><a href=
"#Getting-started">2.1 Getting started
</a></td><td> </td><td align=
"left" valign=
"top">
96 <tr><td align=
"left" valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td><td> </td><td align=
"left" valign=
"top">
98 <tr><td align=
"left" valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td><td> </td><td align=
"left" valign=
"top">
100 <tr><td align=
"left" valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td><td> </td><td align=
"left" valign=
"top">
102 <tr><th colspan=
"3" align=
"left" valign=
"top"><pre class=
"menu-comment">
105 </pre></th></tr><tr><td align=
"left" valign=
"top"><a href=
"#Notes-files">3.1 Notes files
</a></td><td> </td><td align=
"left" valign=
"top">
107 <tr><td align=
"left" valign=
"top"><a href=
"#Notes-indices">3.2 Notes indices
</a></td><td> </td><td align=
"left" valign=
"top">
109 <tr><td align=
"left" valign=
"top"><a href=
"#Notes_002dmode-configuration">3.3 Notes-mode configuration
</a></td><td> </td><td align=
"left" valign=
"top">
111 <tr><th colspan=
"3" align=
"left" valign=
"top"><pre class=
"menu-comment">
114 </pre></th></tr><tr><td align=
"left" valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td><td> </td><td align=
"left" valign=
"top">
116 <tr><td align=
"left" valign=
"top"><a href=
"#Subject-summary">3.1.2 Subject summary
</a></td><td> </td><td align=
"left" valign=
"top">
118 <tr><td align=
"left" valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td><td> </td><td align=
"left" valign=
"top">
120 <tr><td align=
"left" valign=
"top"><a href=
"#Useful-conventions">3.1.4 Useful conventions
</a></td><td> </td><td align=
"left" valign=
"top">
122 <tr><th colspan=
"3" align=
"left" valign=
"top"><pre class=
"menu-comment">
125 </pre></th></tr><tr><td align=
"left" valign=
"top"><a href=
"#Notes_002dmode-history">4.1 Notes-mode history
</a></td><td> </td><td align=
"left" valign=
"top">
127 <tr><td align=
"left" valign=
"top"><a href=
"#Credits">4.2 Credits
</a></td><td> </td><td align=
"left" valign=
"top">
129 <tr><td align=
"left" valign=
"top"><a href=
"#Changes">4.3 Changes
</a></td><td> </td><td align=
"left" valign=
"top">
131 <tr><th colspan=
"3" align=
"left" valign=
"top"><pre class=
"menu-comment">
132 </pre></th></tr></table>
136 <a name=
"Introduction"></a>
137 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
138 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Previous section in reading order"> < </a>]
</td>
139 <td valign=
"middle" align=
"left">[
<a href=
"#What-is-it_003f" title=
"Next section in reading order"> > </a>]
</td>
140 <td valign=
"middle" align=
"left"> </td>
141 <td valign=
"middle" align=
"left">[
<< ]
</td>
142 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
143 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
144 <td valign=
"middle" align=
"left"> </td>
145 <td valign=
"middle" align=
"left"> </td>
146 <td valign=
"middle" align=
"left"> </td>
147 <td valign=
"middle" align=
"left"> </td>
148 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
149 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
150 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
151 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
153 <a name=
"Introduction-1"></a>
154 <h1 class=
"chapter">1. Introduction
</h1>
156 <p>What is notes-mode and why should you (perhaps) use it?
158 <table class=
"menu" border=
"0" cellspacing=
"0">
159 <tr><td align=
"left" valign=
"top"><a href=
"#What-is-it_003f">1.1 What is it?
</a></td><td> </td><td align=
"left" valign=
"top">
161 <tr><td align=
"left" valign=
"top"><a href=
"#Why-keep-notes-at-all_003f">1.2 Why keep notes at all?
</a></td><td> </td><td align=
"left" valign=
"top">
163 <tr><td align=
"left" valign=
"top"><a href=
"#Why-keep-notes-on_002dline_003f">1.3 Why keep notes on-line?
</a></td><td> </td><td align=
"left" valign=
"top">
165 <tr><td align=
"left" valign=
"top"><a href=
"#Why-use-notes_002dmode_003f">1.4 Why use notes-mode?
</a></td><td> </td><td align=
"left" valign=
"top">
167 <tr><td align=
"left" valign=
"top"><a href=
"#Y2K-Statement">1.5 Y2K Statement
</a></td><td> </td><td align=
"left" valign=
"top">
169 <tr><td align=
"left" valign=
"top"><a href=
"#Related-work">1.6 Related work
</a></td><td> </td><td align=
"left" valign=
"top">
171 <tr><td align=
"left" valign=
"top"><a href=
"#Staying-on-top">1.7 Staying on top
</a></td><td> </td><td align=
"left" valign=
"top">
176 <a name=
"What-is-it_003f"></a>
177 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
178 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Previous section in reading order"> < </a>]
</td>
179 <td valign=
"middle" align=
"left">[
<a href=
"#Why-keep-notes-at-all_003f" title=
"Next section in reading order"> > </a>]
</td>
180 <td valign=
"middle" align=
"left"> </td>
181 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
182 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
183 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
184 <td valign=
"middle" align=
"left"> </td>
185 <td valign=
"middle" align=
"left"> </td>
186 <td valign=
"middle" align=
"left"> </td>
187 <td valign=
"middle" align=
"left"> </td>
188 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
189 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
190 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
191 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
193 <a name=
"What-is-it_003f-1"></a>
194 <h2 class=
"section">1.1 What is it?
</h2>
196 <p>Notes-mode is an indexing system for on-line note-taking.
197 Notes-mode is composed of two parts, the visible part,
198 a major-mode for emacs to aid note-taking;
199 and the invisible part,
200 scripts which periodically index your notes for you.
202 <p>Note that notes-mode provides tools to
<em>index
</em> your notes,
203 not to
<em>search
</em> them.
204 (Other existing tools such as
‘<tt>grep
</tt>’,
‘<tt>agrep
</tt>’, and
‘<tt>glimpse
</tt>’
205 already allow file search.)
207 <p>A digression about indexing vs. searching:
208 Indexing in this sense means
209 organize them according to categories you give,
210 while searching looks through all text for arbitrary strings.
211 Drawing on the World Wide Web for examples,
212 Yahoo (
‘<tt>http://www.yahoo.com/
</tt>’) is an index,
213 while Alta Vista (
‘<tt>http://www.altavista.digital.com/
</tt>’)
215 In (potentially) more familiar terms,
217 <a name=
"DOCF1" href=
"#FOOT1">(
1)
</a>
219 while directory information (
411 in the USA)
220 is sort of a search-engine.
224 <a name=
"Why-keep-notes-at-all_003f"></a>
225 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
226 <tr><td valign=
"middle" align=
"left">[
<a href=
"#What-is-it_003f" title=
"Previous section in reading order"> < </a>]
</td>
227 <td valign=
"middle" align=
"left">[
<a href=
"#Why-keep-notes-on_002dline_003f" title=
"Next section in reading order"> > </a>]
</td>
228 <td valign=
"middle" align=
"left"> </td>
229 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
230 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
231 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
232 <td valign=
"middle" align=
"left"> </td>
233 <td valign=
"middle" align=
"left"> </td>
234 <td valign=
"middle" align=
"left"> </td>
235 <td valign=
"middle" align=
"left"> </td>
236 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
237 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
238 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
239 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
241 <a name=
"Why-keep-notes-at-all_003f-1"></a>
242 <h2 class=
"section">1.2 Why keep notes at all?
</h2>
244 <p>So why should you use notes-mode?
245 Well, first, consider why you should (perhaps)
246 keep your notes on line.
248 I assume that you take notes as part of your work or school.
250 you can stop reading now and go back to watching TV.
252 <p>If you keep notes, ask yourself why you keep them.
253 Reasons vary for different people, but some include:
257 To remember what is said or done.
260 To focus on what is important about what is said.
263 To provide proof of having done something
264 at a particular time or date.
267 I know there were other reasons here,
268 but they slipped my mind.
273 <a name=
"Why-keep-notes-on_002dline_003f"></a>
274 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
275 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Why-keep-notes-at-all_003f" title=
"Previous section in reading order"> < </a>]
</td>
276 <td valign=
"middle" align=
"left">[
<a href=
"#Why-use-notes_002dmode_003f" title=
"Next section in reading order"> > </a>]
</td>
277 <td valign=
"middle" align=
"left"> </td>
278 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
279 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
280 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
281 <td valign=
"middle" align=
"left"> </td>
282 <td valign=
"middle" align=
"left"> </td>
283 <td valign=
"middle" align=
"left"> </td>
284 <td valign=
"middle" align=
"left"> </td>
285 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
286 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
287 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
288 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
290 <a name=
"Why-keep-notes-on_002dline_003f-1"></a>
291 <h2 class=
"section">1.3 Why keep notes on-line?
</h2>
293 <p>OK, I
’ve talked you into keeping notes.
295 Again, there are different reasons for different people.
296 If you don
’t want to consider keeping your notes on-line,
297 you
’re welcome to go back to your (clay tablets)
300 <p>However, if you do much of your work on-line,
301 or if you have portable computer,
302 then you might want to consider keeping your notes on-line.
306 It
’s faster to type than write,
307 and possibly more legible at high speed.
310 Often information is already on-line.
311 For example, in software development, bug reports,
312 measurement results, and everything else that
’s useful
316 You can take down more detail than you otherwise would
317 (especially if the data is already on-line).
318 Taking more copious notes can be helpful when you go back
319 to figure out why that strange thing was happening.
322 On-line notes are easy to search.
323 Full-text search with
324 grep, agrep, and glimpse are all much faster
325 and are often more accurate than paging through paper notes
326 looking for a particular keyword.
329 On-line notes are easy to index.
330 (At least with notes-mode!)
331 In addition to full-text search,
332 it
’s helpful to organize notes by category.
333 If you keep a table-of-contents of your paper notes,
334 you are either extremely fastidious
335 or a librarian (Nadia?).
338 You can keep all of your notes with you at all times
339 (if you have a portable computer).
340 Even at a page a day,
341 paper notes quickly become bulky and awkward to carry around.
342 On-line notes fit on your computer
’s hard disk,
343 an extraordinarily compact medium
347 Your notes can be automatically backed up.
348 Paper notes can become damaged with time,
349 and as a graduate student
350 one of my fears was fire in Boelter Hall
351 consuming all my research experiments
352 and and therefore hopes of a degree.
353 Electronic notes are extremely easy to duplicate
354 and can be automatically backed up with the rest of your computer.
355 (You
<em>do
</em> back up your computer, don
’t you?)
359 <p>While these advantages are undoubtedly clear to any
360 right-thinking computer user,
361 it should be said that there are a few disadvantages
362 for on-line note-taking.
366 If you don
’t have a computer with you most of the time,
367 it
’s difficult take notes on-line (because you
’re off-line, of course).
368 <a name=
"DOCF2" href=
"#FOOT2">(
2)
</a>
371 Computers require power.
372 If your portable computer runs out of juice,
373 you
’re on your own.
374 Corollary: watch your power, or bring paper.
375 Better corollary: watch your power,
<em>and
</em> bring paper.
379 It
’s not always socially acceptable to take notes-on-line.
382 few people would use a computer
383 to take down the phone number of a person
384 to whom they
’re attracted
385 (at least, if they wanted the attraction to be mutual).
386 <a name=
"DOCF3" href=
"#FOOT3">(
3)
</a>
387 Sometimes other people find the sound of typing distracting.
391 Repetitive stress injuries do occur
392 writing (slower) by hand is at least
393 an alternate motion than typing.
397 If you want to use your electronic notes
398 to justify a patent or invention,
399 you may be breaking legal ground.
400 Being on the legal cutting-edge is rarely an easy thing
401 for the person involved.
<a name=
"DOCF4" href=
"#FOOT4">(
4)
</a>
407 <a name=
"Why-use-notes_002dmode_003f"></a>
408 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
409 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Why-keep-notes-on_002dline_003f" title=
"Previous section in reading order"> < </a>]
</td>
410 <td valign=
"middle" align=
"left">[
<a href=
"#Y2K-Statement" title=
"Next section in reading order"> > </a>]
</td>
411 <td valign=
"middle" align=
"left"> </td>
412 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
413 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
414 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
415 <td valign=
"middle" align=
"left"> </td>
416 <td valign=
"middle" align=
"left"> </td>
417 <td valign=
"middle" align=
"left"> </td>
418 <td valign=
"middle" align=
"left"> </td>
419 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
420 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
421 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
422 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
424 <a name=
"Why-use-notes_002dmode_003f-1"></a>
425 <h2 class=
"section">1.4 Why use notes-mode?
</h2>
427 <p>OK, I
’ve sold you on note-taking and even on on-line note-taking.
428 What about notes-mode?
430 it slices, dices, and makes julienne fries.
431 But wait, there
’s more:
435 It automates indexing your notes,
436 linking notes with the same subject together.
439 It supports embedded links,
440 allowing you to manually link together different topics
444 It includes a number of convenience-features in emacs.
445 Subjects can be completed based on existing subjects.
446 The usual emacs customization mechanisms are available.
449 Notes containing sensitive information can be encrypted.
452 Notes-mode seems better than the other, currently available alternatives.
455 <p>What are the alternatives? I
’m glad you asked.
456 <a name=
"DOCF5" href=
"#FOOT5">(
5)
</a>
460 <strong>HTML
</strong>.
461 HTML has better formatting capabilities than notes-mode,
462 and it has excellent linking capabilities.
464 HTML
’s tags are fairly intrusive
465 (each is at least four characters long and most come with a pair),
466 tags can get confused with normal text,
467 errors in HTML can be bad (obscuring data),
468 and there
’s no automatic indexing feature
469 (at least with plain HTML).
471 all data should be kept as close to the ASCII from whence it came,
472 as God Intended (hi, Steve).
475 <strong>Word Processors
</strong>.
476 Word processors are strong in the formatting department,
477 but most don
’t really have linking capabilities,
478 and have poor or restricted indexing.
483 <a name=
"Y2K-Statement"></a>
484 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
485 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Why-use-notes_002dmode_003f" title=
"Previous section in reading order"> < </a>]
</td>
486 <td valign=
"middle" align=
"left">[
<a href=
"#Related-work" title=
"Next section in reading order"> > </a>]
</td>
487 <td valign=
"middle" align=
"left"> </td>
488 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
489 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
490 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
491 <td valign=
"middle" align=
"left"> </td>
492 <td valign=
"middle" align=
"left"> </td>
493 <td valign=
"middle" align=
"left"> </td>
494 <td valign=
"middle" align=
"left"> </td>
495 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
496 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
497 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
498 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
500 <a name=
"Y2K-Statement-1"></a>
501 <h2 class=
"section">1.5 Y2K Statement
</h2>
503 <p>Notes mode uses dates extensively,
504 both two-digit years and seconds-since-
1970.
505 However, notes-mode has been coded to function correctly through
508 <p>To avoid problems with the year
2000, notes-mode assumes
509 that any two-digit years before
“70” are
20xx, not
19xx.
510 Notes-mode should therefore work correctly in both the year
1999 and
2000.
512 <p>(Notes-mode
1.17 released February
1999 fixes a lingering Y2K problem.)
514 <p>Because notes-mode uses seconds-since-
1970 for some date calculations
515 it will fail beyond the year
2038 on computers with
32-bit integers.
517 <p>If I
’m still using notes-mode then on a
32-bit machine I
’ll see what I can do.
521 <a name=
"Related-work"></a>
522 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
523 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Y2K-Statement" title=
"Previous section in reading order"> < </a>]
</td>
524 <td valign=
"middle" align=
"left">[
<a href=
"#Staying-on-top" title=
"Next section in reading order"> > </a>]
</td>
525 <td valign=
"middle" align=
"left"> </td>
526 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
527 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
528 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
529 <td valign=
"middle" align=
"left"> </td>
530 <td valign=
"middle" align=
"left"> </td>
531 <td valign=
"middle" align=
"left"> </td>
532 <td valign=
"middle" align=
"left"> </td>
533 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
534 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
535 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
536 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
538 <a name=
"Related-work-1"></a>
539 <h2 class=
"section">1.6 Related work
</h2>
541 <p>What would a document be without related work?
543 <p>Notes-mode is not related in any way to Lotus Notes.
545 <p>I am told (by David Weisman)
546 that it
’s something like the now defunct Lotus Agenda.
548 <p>Ashvin Goel, one of the contributors to notes-mode,
549 has gone off and done a from-scratch reimplementation
551 It
’s very similar to notes mode,
552 and emphasizes on-the-fly updates to entry links
554 You may want to check it out at
555 ‘<tt>http://www.cse.ogi.edu/~ashvin/software.html
</tt>’.
557 <p>Hyperbole (by Bob Weiner) offers better linking facilities
558 than notes-mode, but it has a bunch of stuff notes-mode doesn
’t need
559 and it
’s missing notes-specific indexing provided by notes-mode.
560 For people already using Hyperbole
561 it would be interesting to replace notes-mode
’s linking
562 with Hyperbole
’s.
563 Contributions in this area are welcome, provided they make Hyperbole
567 <a name=
"Staying-on-top"></a>
568 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
569 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Related-work" title=
"Previous section in reading order"> < </a>]
</td>
570 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next section in reading order"> > </a>]
</td>
571 <td valign=
"middle" align=
"left"> </td>
572 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
573 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Up section"> Up
</a>]
</td>
574 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Next chapter"> >> </a>]
</td>
575 <td valign=
"middle" align=
"left"> </td>
576 <td valign=
"middle" align=
"left"> </td>
577 <td valign=
"middle" align=
"left"> </td>
578 <td valign=
"middle" align=
"left"> </td>
579 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
580 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
581 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
582 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
584 <a name=
"Staying-on-top-1"></a>
585 <h2 class=
"section">1.7 Staying on top
</h2>
587 <p>The most recent distribution of notes-mode
588 is always available via
589 ‘<tt>http://www.isi.edu/~johnh/SOFTWARE/NOTES_MODE/
</tt>’.
591 <p>After you
’ve installed notes mode you
’re encouraged to subscribe
592 to the mailing lists.
593 To subscribe, go to the web page
594 Send the message
"subscribe
" to
595 ‘<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-announce
</tt>’ or
596 ‘<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-talk
</tt>’.
598 <p>The announce list will contain only release announcements
599 and so is guaranteed to be very low bandwidth.
604 <a name=
"Basics"></a>
605 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
606 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Staying-on-top" title=
"Previous section in reading order"> < </a>]
</td>
607 <td valign=
"middle" align=
"left">[
<a href=
"#Getting-started" title=
"Next section in reading order"> > </a>]
</td>
608 <td valign=
"middle" align=
"left"> </td>
609 <td valign=
"middle" align=
"left">[
<a href=
"#Introduction" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
610 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
611 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Next chapter"> >> </a>]
</td>
612 <td valign=
"middle" align=
"left"> </td>
613 <td valign=
"middle" align=
"left"> </td>
614 <td valign=
"middle" align=
"left"> </td>
615 <td valign=
"middle" align=
"left"> </td>
616 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
617 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
618 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
619 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
621 <a name=
"Basics-1"></a>
622 <h1 class=
"chapter">2. Basics
</h1>
624 <p>All you need to use notes-mode
626 (Except for installation, See section
<a href=
"#Installation">Installation
</a>.)
628 <table class=
"menu" border=
"0" cellspacing=
"0">
629 <tr><td align=
"left" valign=
"top"><a href=
"#Getting-started">2.1 Getting started
</a></td><td> </td><td align=
"left" valign=
"top">
631 <tr><td align=
"left" valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td><td> </td><td align=
"left" valign=
"top">
633 <tr><td align=
"left" valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td><td> </td><td align=
"left" valign=
"top">
635 <tr><td align=
"left" valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td><td> </td><td align=
"left" valign=
"top">
640 <a name=
"Getting-started"></a>
641 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
642 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Previous section in reading order"> < </a>]
</td>
643 <td valign=
"middle" align=
"left">[
<a href=
"#A-notes-file" title=
"Next section in reading order"> > </a>]
</td>
644 <td valign=
"middle" align=
"left"> </td>
645 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
646 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Up section"> Up
</a>]
</td>
647 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Next chapter"> >> </a>]
</td>
648 <td valign=
"middle" align=
"left"> </td>
649 <td valign=
"middle" align=
"left"> </td>
650 <td valign=
"middle" align=
"left"> </td>
651 <td valign=
"middle" align=
"left"> </td>
652 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
653 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
654 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
655 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
657 <a name=
"Getting-started-1"></a>
658 <h2 class=
"section">2.1 Getting started
</h2>
659 <a name=
"index-notesinit"></a>
660 <a name=
"index-setup"></a>
662 <p>To get started with notes-mode,
663 read the introduction this chapter,
669 <kbd>M-x
</kbd> <code>load-library
</code> <kbd>RET
</kbd> <code>notes-mode
</code> <kbd>RET
</kbd>
670 This approach will set up notes-mode with the default parameters.
674 run the program
‘<tt>notesinit
</tt>’.
675 This approach will ask you some questions about how you want to configure
680 <p>Either way these should set up everything notes-mode needs.
681 This program will modify your environment (as described in this section),
682 or it will give you the exact commands you should run yourself.
684 <p>After you
’ve done one of these,
685 start up emacs and note-away.
687 day of note-taking by running the command
688 <kbd>M-x
</kbd> <code>notes-index-todays-link
</code>
689 to jump directly to today
’s note.
690 You may even wish to bind this to something,
692 <code>(define-key global-map
"\C-cn
" 'notes-index-todays-link)
</code>
693 in your
‘<tt>.emacs
</tt>’.
695 <p>If you want to browse your existing notes,
696 you might instead want to edit the
697 ‘<tt>~/NOTES/index
</tt>’.
698 (What is a notes file and the index? Hurry up and finish
699 reading this chapter.)
703 <a name=
"A-notes-file"></a>
704 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
705 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Getting-started" title=
"Previous section in reading order"> < </a>]
</td>
706 <td valign=
"middle" align=
"left">[
<a href=
"#The-notes-index" title=
"Next section in reading order"> > </a>]
</td>
707 <td valign=
"middle" align=
"left"> </td>
708 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
709 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Up section"> Up
</a>]
</td>
710 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Next chapter"> >> </a>]
</td>
711 <td valign=
"middle" align=
"left"> </td>
712 <td valign=
"middle" align=
"left"> </td>
713 <td valign=
"middle" align=
"left"> </td>
714 <td valign=
"middle" align=
"left"> </td>
715 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
716 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
717 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
718 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
720 <a name=
"A-notes-file-1"></a>
721 <h2 class=
"section">2.2 A notes file
</h2>
723 <a name=
"index-Notes-files"></a>
725 <p>The notes file is the focus of most of the activity in notes-mode,
726 it
’s where you take your notes.
727 Notes files are mostly free-form text
728 broken up into
<em>entries
</em>.
729 Here
’s an example:
731 <a name=
"index-Notes-entries"></a>
733 <table><tr><td> </td><td><pre class=
"example">8-Jun-
95 Thursday
739 next:
<file:///~/NOTES/
199506/
950609#* Today
>
741 next week - release notes-mode
747 I explained notes mode to Ashvin and Geoff.
749 </pre></td></tr></table>
751 <p>Each entry has a subject-block, (maybe) some links, and then (maybe) some text.
753 <p>The subject-block must begin with an asterisk-space (
<kbd>*
</kbd>)
754 at the beginning of a line, followed by the subject itself.
755 Subjects must be underlined with a row of dashes
756 (if they
’re not exact, that
’s OK;
757 notes-mode will fix them periodically).
759 notes-mode will automatically add the underlines when you
760 hit
<kbd><RTN
></kbd> (
<code>notes-electric-return
</code>),
761 and
<kbd><TAB
></kbd> on a partially completed subject will
762 invoke completion based on indexed subjects (
<code>notes-complete-subject
</code>).
763 <a name=
"index-Notes-subjects"></a>
764 <a name=
"index-RTN"></a>
765 <a name=
"index-TAB"></a>
767 <p>Following the subject may be links.
768 (In the example, the
“Today
” entry has links,
769 the
“Environment/notes
” entry doesn
’t.)
770 These links will be automatically updated by notes-mode
771 when your notes are re-indexed;
772 just leave a blank line when writing the note.
773 <a name=
"index-Notes-links"></a>
775 <p>Links are made with pseudo-URLs,
776 sort of like those in the World Wide Web.
777 Any of these URLs can be followed in notes-mode files
778 by clicking
<kbd>S-mouse-
2</kbd> on the pseudo-URL
779 (
<code>notes-w3-follow-link-mouse
</code>).
780 <a name=
"index-Pseudo_002dURLs"></a>
781 <a name=
"index-URLs"></a>
782 <a name=
"index-S_002dmouse_002d2"></a>
784 <p>Finally comes the text.
785 Go wild, but just don
’t include text that looks like a subject.
786 You can embed pseudo-URLs to link notes together manually.
788 <p>The more anal of you may have noticed
789 that the lines before the first subject
790 are not part of any entry.
792 <em>front matter
</em>.
793 They
’re not usually used for much,
794 but they can be a good place to label the file.
795 <a name=
"index-Notes-files_002c-font-matter"></a>
796 <a name=
"index-Font-matter"></a>
798 <p>There are a number of useful conventions
799 that can be adopted to organize your notes.
800 The most common is the
“Today
” entry.
801 If you keep an entry with the same subject
802 at the beginning of each file,
803 you link all of your notes together.
804 Notes-mode will help you out with some of these convetions
805 by automatically creating or copying some fields for you;
806 see see section
<a href=
"#Useful-conventions">Useful conventions
</a> for details.
808 <p>Finally, notes-mode can also work with outline-minor-mode
809 (thanks to Tim Carroll for pointing this out).
810 Outline-mode supports hiding and revealing text and other helpful
811 features beyond the scope of this document.
812 See
<a href=
"emacs.html#Outline-Mode">Outline Mode: (emacs)Outline Mode
</a> section
‘Outline Mode
’ in
<cite>The Emacs Editor
</cite>, for details.
815 <a name=
"The-notes-index"></a>
816 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
817 <tr><td valign=
"middle" align=
"left">[
<a href=
"#A-notes-file" title=
"Previous section in reading order"> < </a>]
</td>
818 <td valign=
"middle" align=
"left">[
<a href=
"#The-notes-directories" title=
"Next section in reading order"> > </a>]
</td>
819 <td valign=
"middle" align=
"left"> </td>
820 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
821 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Up section"> Up
</a>]
</td>
822 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Next chapter"> >> </a>]
</td>
823 <td valign=
"middle" align=
"left"> </td>
824 <td valign=
"middle" align=
"left"> </td>
825 <td valign=
"middle" align=
"left"> </td>
826 <td valign=
"middle" align=
"left"> </td>
827 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
828 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
829 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
830 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
832 <a name=
"The-notes-index-1"></a>
833 <h2 class=
"section">2.3 The notes index
</h2>
835 <a name=
"index-Notes-index"></a>
837 <p>The notes index lists all subjects you
’ve kept notes about,
838 and each date of each note.
839 Impress your friends,
840 show your advisor why you
’re worth the
<em>big
</em> peanuts,
841 you
’ll soon have the biggest index of all.
843 <p>The index has one line per subject, listing the subject
844 and each day a note was made about that subject.
847 <table><tr><td> </td><td><pre class=
"example">Bicycle:
950314,
950316
848 Bicycle/maintenance/books:
951028
849 Bridge/hands:
951113,
951114,
951116,
951117
850 Bridge/UCLA:
960222,
960409
851 </pre></td></tr></table>
853 <p>Clicking on any of the dates with
<kbd>mouse-
2</kbd>
854 will take you to that note
855 (
<code>notes-index-mouse-follow-link
</code>).
856 (You can also move the point over the date and hit
<kbd><RTN
></kbd>
857 if you
’re musaphobic [
<code>notes-index-follow-link
</code>].)
858 <a name=
"index-mouse_002d2"></a>
859 <a name=
"index-RTN-1"></a>
861 <p>The notes index is automatically updated by the program
‘<tt>mkall
</tt>’.
862 Typically
‘<tt>mkall
</tt>’ is run nightly by
‘<tt>cron
</tt>’.
863 On most modern versions of Unix, you can add this command to cron by
864 running
‘<tt>crontab -e
</tt>’ and adding the line:
866 <table><tr><td> </td><td><pre class=
"example">0 4 * * * /usr/local/lib/notes-mode/mkall
867 </pre></td></tr></table>
868 <a name=
"index-Crontab"></a>
869 <a name=
"index-mkall"></a>
870 <a name=
"index-re_002dindexing"></a>
872 <p>(Assuming that your notes programs are installed
873 in /usr/local/lib/notes-mode, the default location.)
877 <a name=
"The-notes-directories"></a>
878 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
879 <tr><td valign=
"middle" align=
"left">[
<a href=
"#The-notes-index" title=
"Previous section in reading order"> < </a>]
</td>
880 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Next section in reading order"> > </a>]
</td>
881 <td valign=
"middle" align=
"left"> </td>
882 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
883 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Up section"> Up
</a>]
</td>
884 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Next chapter"> >> </a>]
</td>
885 <td valign=
"middle" align=
"left"> </td>
886 <td valign=
"middle" align=
"left"> </td>
887 <td valign=
"middle" align=
"left"> </td>
888 <td valign=
"middle" align=
"left"> </td>
889 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
890 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
891 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
892 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
894 <a name=
"The-notes-directories-1"></a>
895 <h2 class=
"section">2.4 The notes directories
</h2>
897 <a name=
"index-Notes-directories"></a>
898 <a name=
"index-Directory-hierarchy"></a>
900 <p>The final thing needed to tie basic notes-mode together his how
901 the pieces fit together.
902 Since my graduate work is in file systems,
903 you can bet that directories are involved.
905 <p>Notes-mode keeps its files in a two-level hierarchy:
907 <table><tr><td> </td><td><pre class=
"example">~/NOTES
911 ~/NOTES/
199603/
960329
912 ~/NOTES/
199603/
960330
914 ~/NOTES/
199604/
960401
915 </pre></td></tr></table>
917 <p>The top level,
‘<tt>~/NOTES
</tt>’, is the notes directory.
918 It keeps all notes in one place.
919 (The name of this directory is configurable, See section
<a href=
"#Notes_002dmode-configuration">Notes-mode configuration
</a>.)
921 <p>Inside the notes directory are two files and a number of directories.
922 The files are
‘<tt>index
</tt>’,
923 the index of all entries (see section
<a href=
"#The-notes-index">The notes index
</a>),
924 and
‘<tt>rawindex
</tt>’,
926 <a name=
"index-Root-directory"></a>
928 <p>The notes directory also contains a number of subdirectories,
929 sometimes called
<em>intermediate directories
</em>.
930 These directories group the actual notes files into manageable chunks,
931 keeping any directory from getting too large.
932 Intermediate directories are named
933 by the four-digit year and the two-digit month
934 of the entries they contain.
935 (The format of intermediate directories
936 is configurable, See section
<a href=
"#Notes_002dmode-configuration">Notes-mode configuration
</a>.)
937 <a name=
"index-Intermediate-directories"></a>
940 each intermediate directory are the notes files themselves,
941 named according to the two-digit year, month, and day-of-month.
942 <a name=
"index-Notes-files-1"></a>
944 <p>For the most part,
945 notes-mode will automatically maintain this organization of files,
946 once you create the top-level directory.
947 Notes-mode will also automatically insure
948 that all files in the notes directory are unreadable by
949 anyone other than their owner.
950 Notes are personal things.
951 (This behavior is not currently configurable,
952 but it probably should be.)
953 <a name=
"index-Notes-file-permissions"></a>
958 <a name=
"Advanced-Features"></a>
959 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
960 <tr><td valign=
"middle" align=
"left">[
<a href=
"#The-notes-directories" title=
"Previous section in reading order"> < </a>]
</td>
961 <td valign=
"middle" align=
"left">[
<a href=
"#Notes-files" title=
"Next section in reading order"> > </a>]
</td>
962 <td valign=
"middle" align=
"left"> </td>
963 <td valign=
"middle" align=
"left">[
<a href=
"#Basics" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
964 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
965 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
966 <td valign=
"middle" align=
"left"> </td>
967 <td valign=
"middle" align=
"left"> </td>
968 <td valign=
"middle" align=
"left"> </td>
969 <td valign=
"middle" align=
"left"> </td>
970 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
971 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
972 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
973 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
975 <a name=
"Advanced-Features-1"></a>
976 <h1 class=
"chapter">3. Advanced Features
</h1>
978 <p>Notes-mode, the minutiae, and some other good stuff.
980 <table class=
"menu" border=
"0" cellspacing=
"0">
981 <tr><td align=
"left" valign=
"top"><a href=
"#Notes-files">3.1 Notes files
</a></td><td> </td><td align=
"left" valign=
"top">
983 <tr><td align=
"left" valign=
"top"><a href=
"#Notes-indices">3.2 Notes indices
</a></td><td> </td><td align=
"left" valign=
"top">
985 <tr><td align=
"left" valign=
"top"><a href=
"#Notes_002dmode-configuration">3.3 Notes-mode configuration
</a></td><td> </td><td align=
"left" valign=
"top">
990 <a name=
"Notes-files"></a>
991 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
992 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Previous section in reading order"> < </a>]
</td>
993 <td valign=
"middle" align=
"left">[
<a href=
"#Getting-around" title=
"Next section in reading order"> > </a>]
</td>
994 <td valign=
"middle" align=
"left"> </td>
995 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
996 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Up section"> Up
</a>]
</td>
997 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
998 <td valign=
"middle" align=
"left"> </td>
999 <td valign=
"middle" align=
"left"> </td>
1000 <td valign=
"middle" align=
"left"> </td>
1001 <td valign=
"middle" align=
"left"> </td>
1002 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1003 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1004 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1005 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1007 <a name=
"Notes-files-1"></a>
1008 <h2 class=
"section">3.1 Notes files
</h2>
1010 <table class=
"menu" border=
"0" cellspacing=
"0">
1011 <tr><td align=
"left" valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td><td> </td><td align=
"left" valign=
"top">
1013 <tr><td align=
"left" valign=
"top"><a href=
"#Subject-summary">3.1.2 Subject summary
</a></td><td> </td><td align=
"left" valign=
"top">
1015 <tr><td align=
"left" valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td><td> </td><td align=
"left" valign=
"top">
1017 <tr><td align=
"left" valign=
"top"><a href=
"#Useful-conventions">3.1.4 Useful conventions
</a></td><td> </td><td align=
"left" valign=
"top">
1022 <a name=
"Getting-around"></a>
1023 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1024 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Notes-files" title=
"Previous section in reading order"> < </a>]
</td>
1025 <td valign=
"middle" align=
"left">[
<a href=
"#Subject-summary" title=
"Next section in reading order"> > </a>]
</td>
1026 <td valign=
"middle" align=
"left"> </td>
1027 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1028 <td valign=
"middle" align=
"left">[
<a href=
"#Notes-files" title=
"Up section"> Up
</a>]
</td>
1029 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
1030 <td valign=
"middle" align=
"left"> </td>
1031 <td valign=
"middle" align=
"left"> </td>
1032 <td valign=
"middle" align=
"left"> </td>
1033 <td valign=
"middle" align=
"left"> </td>
1034 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1035 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1036 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1037 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1039 <a name=
"Getting-around-1"></a>
1040 <h3 class=
"subsection">3.1.1 Getting around
</h3>
1042 <p>Moving between notes entries and around the hierarchy is fairly common,
1043 so there are some accelerators.
1045 <dl compact=
"compact">
1046 <dt> <kbd>C-c C-i
</kbd></dt>
1047 <dd><p>Jump to the index entry for the current entry
’s subject
1048 (
<code>notes-goto-index-entry
</code>).
1049 <a name=
"index-C_002dc-C_002di"></a>
1052 <dt> <kbd>C-c C-n
</kbd></dt>
1053 <dt> <kbd>C-c C-p
</kbd></dt>
1054 <dd><p>Move to the next or prior note with the same subject
1055 (
<code>notes-follow-next-link
</code> and
<code>notes-follow-prev-link
</code>).
1056 These functions follow the links in the note,
1057 if they
’re defined.
1059 they look through the index file.
1060 This approach usually works,
1061 but will fail if there are multiple new entries created
1062 with the given subject
1063 between when the index is recomputed.
1064 <a name=
"index-C_002dc-C_002dn"></a>
1065 <a name=
"index-C_002dc-C_002dp"></a>
1068 <dt> <kbd>C-c
<RTN
></kbd></dt>
1069 <dd><p>Follow the link under the point
1070 (
<code>notes-w3-follow-link
</code>),
1071 a keyboard equivalent of
<S-mouse-
2>.
1072 <a name=
"index-C_002dcRTN"></a>
1075 <dt> <kbd>M-C-a
</kbd></dt>
1076 <dt> <kbd>M-C-e
</kbd></dt>
1077 <dd><p>Jump to the beginning or end of the current note entry
1078 (
<code>notes-beginning-of-defun
</code> and
<code>notes-end-of-defun
</code>).
1079 <a name=
"index-M_002dC_002da"></a>
1080 <a name=
"index-M_002dC_002de"></a>
1083 <dt> <kbd>C-c C-k
</kbd></dt>
1084 <dd><p>Copies the pseudo-URL for the current note into the kill-ring
1085 (
<code>current-url-as-kill
</code>).
1086 To link two entries, go to the target,
1087 grab its URL with
<kbd>C-c C-k
</kbd>,
1088 go to where you want to make the link,
1089 and yank the URL with
<kbd>C-y
</kbd>.
1090 <a name=
"index-C_002dc-C_002dk"></a>
1096 <p>Notes mode supports imenu,
1097 if you have it bound to something
1098 (I use
<code>(global-set-key [down-mouse-
3] 'imenu)
</code>).
1099 <a name=
"index-imenu"></a>
1103 <a name=
"Subject-summary"></a>
1104 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1105 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Getting-around" title=
"Previous section in reading order"> < </a>]
</td>
1106 <td valign=
"middle" align=
"left">[
<a href=
"#Encryption" title=
"Next section in reading order"> > </a>]
</td>
1107 <td valign=
"middle" align=
"left"> </td>
1108 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1109 <td valign=
"middle" align=
"left">[
<a href=
"#Notes-files" title=
"Up section"> Up
</a>]
</td>
1110 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
1111 <td valign=
"middle" align=
"left"> </td>
1112 <td valign=
"middle" align=
"left"> </td>
1113 <td valign=
"middle" align=
"left"> </td>
1114 <td valign=
"middle" align=
"left"> </td>
1115 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1116 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1117 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1118 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1120 <a name=
"Subject-summary-1"></a>
1121 <h3 class=
"subsection">3.1.2 Subject summary
</h3>
1123 <p>It
’s often helpful to look at all
1124 entries for a given subject
1126 collects all entries with the subject of the current
1127 entry in a new buffer
1128 (
<code>notes-summarize-subject
</code>).
1129 <a name=
"index-C_002dc-C_002ds"></a>
1130 <a name=
"index-Subject-summary"></a>
1134 <a name=
"Encryption"></a>
1135 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1136 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Subject-summary" title=
"Previous section in reading order"> < </a>]
</td>
1137 <td valign=
"middle" align=
"left">[
<a href=
"#Useful-conventions" title=
"Next section in reading order"> > </a>]
</td>
1138 <td valign=
"middle" align=
"left"> </td>
1139 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1140 <td valign=
"middle" align=
"left">[
<a href=
"#Notes-files" title=
"Up section"> Up
</a>]
</td>
1141 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
1142 <td valign=
"middle" align=
"left"> </td>
1143 <td valign=
"middle" align=
"left"> </td>
1144 <td valign=
"middle" align=
"left"> </td>
1145 <td valign=
"middle" align=
"left"> </td>
1146 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1147 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1148 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1149 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1151 <a name=
"Encryption-1"></a>
1152 <h3 class=
"subsection">3.1.3 Encryption
</h3>
1154 <a name=
"index-Encryption"></a>
1155 <a name=
"index-Decryption"></a>
1157 <p>Notes occasionally contain private material.
1158 While Unix has strong services for file protection
1159 (compared to other, say, more wide-selling operating systems),
1160 in many systems root passwords are shared,
1161 while other systems are vulnerable to physical compromise.
1163 properly used encryption is the best approach to security.
1165 <p>Notes-mode encryption is based
1166 Phill Zimmerman
’s PGP (Pretty Good Privacy)
1167 (see
‘<tt>http://www.mantis.co.uk/pgp/pgp.html
</tt>’)
1169 with Rick Campbell
’s
1170 emacs interface, PAM (PGP Augmented Messaging)
1171 (from
‘<tt>ftp://h.gp.cs.cmu.edu/usr/rfb/pam/
</tt>’)
1172 (note that as of January
1997, PAM is no longer at this ftp site
1173 and appears to not be publicly available),
1174 or LoPresti and Choi
’s mailcrypt
1175 (from
‘<tt>http://cag-www.lcs.mit.edu/mailcrypt/
</tt>’).
1176 <a name=
"index-PGP"></a>
1177 <a name=
"index-Pretty-good-privacy"></a>
1178 <a name=
"index-PAM"></a>
1179 <a name=
"index-PGP-Augmented-Messaging"></a>
1180 <a name=
"index-mailcrypt"></a>
1182 <dl compact=
"compact">
1183 <dt> <kbd>C-c C-e
</kbd></dt>
1184 <dd><p>Encrypt the current note
1185 (
<code>notes-encrypt-note
</code>).
1186 By default this function encrypts the whole entry.
1187 With a prefix argument,
1188 only the part from the point to the end of the entry is encrypted.
1189 <a name=
"index-C_002dc-C_002de"></a>
1192 <dt> <kbd>C-c C-d
</kbd></dt>
1193 <dd><p>Decrypt the current note
1194 (
<code>notes-decrypt-note
</code>).
1197 <a name=
"index-C_002dc-C_002dd"></a>
1199 <p>By default notes-mode determines your public key by looking
1200 up your
<code>user-full-name
</code> in your PGP keyring.
1201 You can override this default by setting
1202 <code>notes-encryption-key-id
</code>
1203 to the desired key-id.
1204 <a name=
"index-key_002did"></a>
1208 <a name=
"Useful-conventions"></a>
1209 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1210 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Encryption" title=
"Previous section in reading order"> < </a>]
</td>
1211 <td valign=
"middle" align=
"left">[
<a href=
"#Notes-indices" title=
"Next section in reading order"> > </a>]
</td>
1212 <td valign=
"middle" align=
"left"> </td>
1213 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1214 <td valign=
"middle" align=
"left">[
<a href=
"#Notes-files" title=
"Up section"> Up
</a>]
</td>
1215 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
1216 <td valign=
"middle" align=
"left"> </td>
1217 <td valign=
"middle" align=
"left"> </td>
1218 <td valign=
"middle" align=
"left"> </td>
1219 <td valign=
"middle" align=
"left"> </td>
1220 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1221 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1222 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1223 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1225 <a name=
"Useful-conventions-1"></a>
1226 <h3 class=
"subsection">3.1.4 Useful conventions
</h3>
1229 <a name=
"index-conventions"></a>
1230 <a name=
"index-mknew"></a>
1232 <p>There are a number of conventions which can make notes-mode
1234 These conventions are a matter of personal taste,
1236 Do what works for you.
1239 I find it helpful to keep the date of each notes-file at the top
1241 This makes the file self-identifying
1242 if the filename is lost.
1245 I find it useful to have the first entry of each file
1246 have the same subject (perhaps
“Today
”).
1247 This entry then links all notes together,
1248 making it easy to go to yesterday and tomorrow.
1249 I keep a to-do list on this entry,
1250 bringing the list forward each day.
1251 <a name=
"index-Today"></a>
1253 <p>A third useful convention is to keep an
1254 entry with the name based on the day of the week
1256 Analogous to
“Today
”, this entry links together
1259 <p>Notes-mode supports these conventions.
1260 When you make a new notes-file in emacs,
1261 notes-mode searches for the preceding file.
1262 If it follows any of these conventions,
1263 the new file is initialized appropriately.
1265 the approach to do this process
1266 (in the program
‘<tt>mknew
</tt>’)
1267 is fairly sensitive,
1268 so it may not work in all cases.
1270 the date convention works only on
1271 for English-language dates.
1272 (If you use notes-mode with a non-English language,
1273 let me know and I
’ll work with you to fix this limitation.)
1275 <p>If you find other helpful conventions,
1277 Modifications to
‘<tt>mknew
</tt>’ to implement
1278 new conventions are also invited.
1280 <p>If you don
’t want to use these conventions,
1281 or if you want to use different ones,
1282 set the emacs variable notes-mode-initialization-program
1283 to nil or the name of your initialization program.
1284 <a name=
"index-notes_002dmode_002dinitialization_002dprogram"></a>
1288 <a name=
"Notes-indices"></a>
1289 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1290 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Useful-conventions" title=
"Previous section in reading order"> < </a>]
</td>
1291 <td valign=
"middle" align=
"left">[
<a href=
"#Notes_002dmode-configuration" title=
"Next section in reading order"> > </a>]
</td>
1292 <td valign=
"middle" align=
"left"> </td>
1293 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1294 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Up section"> Up
</a>]
</td>
1295 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
1296 <td valign=
"middle" align=
"left"> </td>
1297 <td valign=
"middle" align=
"left"> </td>
1298 <td valign=
"middle" align=
"left"> </td>
1299 <td valign=
"middle" align=
"left"> </td>
1300 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1301 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1302 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1303 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1305 <a name=
"Notes-indices-1"></a>
1306 <h2 class=
"section">3.2 Notes indices
</h2>
1309 <p>Only two features of notes index mode haven
’t yet been described.
1311 you can open any notes-file based on date
1312 with
<code>notes-index-link
</code>,
1313 normally bound to
<o
>.
1314 <a name=
"index-o"></a>
1317 you can get a subject-summary
1318 with
<C-c C-s
>
1319 (see section
<a href=
"#Subject-summary">Subject summary
</a>).
1320 The subject defaults to that of the current index line.
1321 <a name=
"index-C_002dc-C_002ds-1"></a>
1325 <a name=
"Notes_002dmode-configuration"></a>
1326 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1327 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Notes-indices" title=
"Previous section in reading order"> < </a>]
</td>
1328 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next section in reading order"> > </a>]
</td>
1329 <td valign=
"middle" align=
"left"> </td>
1330 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1331 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Up section"> Up
</a>]
</td>
1332 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Next chapter"> >> </a>]
</td>
1333 <td valign=
"middle" align=
"left"> </td>
1334 <td valign=
"middle" align=
"left"> </td>
1335 <td valign=
"middle" align=
"left"> </td>
1336 <td valign=
"middle" align=
"left"> </td>
1337 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1338 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1339 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1340 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1342 <a name=
"Notes_002dmode-configuration-1"></a>
1343 <h2 class=
"section">3.3 Notes-mode configuration
</h2>
1345 <a name=
"index-configuration"></a>
1346 <a name=
"index-_002enotesrc"></a>
1348 <p>Several aspects of notes mode are particularly visible
1350 Because I
’m not a fascist,
1351 a user can change most of these.
1353 <p>Preferences are specified in
‘<tt>~/.notesrc
</tt>’.
1354 This file lists things to change:
1356 <table><tr><td> </td><td><pre class=
"example"># lines beginning with a hash are comments
1359 </pre></td></tr></table>
1361 <p>Currently, two things can be changed:
1363 <dl compact=
"compact">
1364 <dt> <code>dir
</code></dt>
1365 <dd><p>Specifies the root of the notes directory hierarchy
1366 (see section
<a href=
"#The-notes-directories">The notes directories
</a>).
1369 <dt> <code>int_form
</code></dt>
1370 <dd><p>Specifies the form of the intermediate directory.
1371 A limited subset of
<code>strftime(
3)
</code>
1372 formatting is allowed.
1376 <p>The subset of
<code>strftime(
3)
</code> supported in
<code>int_form
</code> is:
1377 </p><dl compact=
"compact">
1378 <dt> <code>%Y
</code></dt>
1379 <dd><p>The four-digit year.
1382 <dt> <code>%y
</code></dt>
1383 <dd><p>The two-digit year.
1386 <dt> <code>%m
</code></dt>
1387 <dd><p>A two-digit numeric month.
1390 <dt> <code>%d
</code></dt>
1391 <dd><p>A two-digit day.
1395 <p>In addition to
‘<tt>.notesrc
</tt>’,
1396 there are a number of emacs-specific variables.
1397 These variables are documented in the file
1398 ‘<tt>notes-variables.el
</tt>’.
1404 <a name=
"History"></a>
1405 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1406 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Notes_002dmode-configuration" title=
"Previous section in reading order"> < </a>]
</td>
1407 <td valign=
"middle" align=
"left">[
<a href=
"#Notes_002dmode-history" title=
"Next section in reading order"> > </a>]
</td>
1408 <td valign=
"middle" align=
"left"> </td>
1409 <td valign=
"middle" align=
"left">[
<a href=
"#Advanced-Features" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1410 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
1411 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Next chapter"> >> </a>]
</td>
1412 <td valign=
"middle" align=
"left"> </td>
1413 <td valign=
"middle" align=
"left"> </td>
1414 <td valign=
"middle" align=
"left"> </td>
1415 <td valign=
"middle" align=
"left"> </td>
1416 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1417 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1418 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1419 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1421 <a name=
"History-1"></a>
1422 <h1 class=
"chapter">4. History
</h1>
1424 <p>More about notes-mode than you wanted to know,
1427 <table class=
"menu" border=
"0" cellspacing=
"0">
1428 <tr><td align=
"left" valign=
"top"><a href=
"#Notes_002dmode-history">4.1 Notes-mode history
</a></td><td> </td><td align=
"left" valign=
"top">
1430 <tr><td align=
"left" valign=
"top"><a href=
"#Credits">4.2 Credits
</a></td><td> </td><td align=
"left" valign=
"top">
1432 <tr><td align=
"left" valign=
"top"><a href=
"#Changes">4.3 Changes
</a></td><td> </td><td align=
"left" valign=
"top">
1434 <tr><td align=
"left" valign=
"top"><a href=
"#Suggested-features">4.4 Suggested features
</a></td><td> </td><td align=
"left" valign=
"top">
1441 <a name=
"Notes_002dmode-history"></a>
1442 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1443 <tr><td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Previous section in reading order"> < </a>]
</td>
1444 <td valign=
"middle" align=
"left">[
<a href=
"#Credits" title=
"Next section in reading order"> > </a>]
</td>
1445 <td valign=
"middle" align=
"left"> </td>
1446 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1447 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Up section"> Up
</a>]
</td>
1448 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Next chapter"> >> </a>]
</td>
1449 <td valign=
"middle" align=
"left"> </td>
1450 <td valign=
"middle" align=
"left"> </td>
1451 <td valign=
"middle" align=
"left"> </td>
1452 <td valign=
"middle" align=
"left"> </td>
1453 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1454 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1455 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1456 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1458 <a name=
"Notes_002dmode-history-1"></a>
1459 <h2 class=
"section">4.1 Notes-mode history
</h2>
1462 I started keeping notes on-line shortly after I got a portable computer
1464 After a month-and-a-half of notes, I realized that
1465 one does not live by grep alone,
1466 so I started adding indexing facilities.
1469 some other Ficus-project members started
1470 keeping and indexing on-line notes
1471 using other home-grown systems.
1472 After some discussion,
1473 we generalized my notes-mode work and
1474 they started using it.
1476 <p>Over the next
18 months notes-mode grew.
1477 Finally, in April,
1996 I wrote documentation,
1478 guaranteeing that innovation on notes-mode will now cease
1479 or the documentation will become out of date.
1483 <a name=
"Credits"></a>
1484 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1485 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Notes_002dmode-history" title=
"Previous section in reading order"> < </a>]
</td>
1486 <td valign=
"middle" align=
"left">[
<a href=
"#Changes" title=
"Next section in reading order"> > </a>]
</td>
1487 <td valign=
"middle" align=
"left"> </td>
1488 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1489 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Up section"> Up
</a>]
</td>
1490 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Next chapter"> >> </a>]
</td>
1491 <td valign=
"middle" align=
"left"> </td>
1492 <td valign=
"middle" align=
"left"> </td>
1493 <td valign=
"middle" align=
"left"> </td>
1494 <td valign=
"middle" align=
"left"> </td>
1495 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1496 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1497 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1498 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1500 <a name=
"Credits-1"></a>
1501 <h2 class=
"section">4.2 Credits
</h2>
1503 <p>I (John Heidemann,
<johnh@isi.edu
>)
1504 started, documented, and currently maintain notes-mode.
1505 I take ultimate responsibility for the code,
1506 especially for the ugly parts that I won
’t let others change.
1509 <ashvin@ficus.cs.ucla.edu
>
1510 has been a very enthusiastic notes-mode user and contributor.
1511 He is responsible for at least
1512 the ideas behind
<code>notes-summarize-subject
</code>
1513 and the ideas and initial implementations of
1514 some of the original generalization and modularity improvements,
1515 <code>notes-follow-next-link
</code> and
<code>notes-follow-prev-link
</code>,
1516 <code>notes-goto-index-entry
</code>,
1517 programmed subject completion,
1519 context-sensitive mouse-
2 handling.
1521 he is an invaluable second opinion about
1522 what and how things should be done
1523 (even if I don
’t always agree with him).
1526 <geoff@ficus.cs.ucla.edu
>
1527 has been another enthusiastic notes-mode user and victim.
1528 He is responsible for
1529 finding several bugs,
1530 motivation for mouse-less operation,
1531 comments about the documentation,
1532 the day-of-week convention,
1533 and an initial implementation and the idea of
1534 multiple entries with the same subjects in a single notes-file.
1536 <p>Ramesh Govindan
<govindan@isi.edu
> did the xemacs port.
1538 <p>Since it
’s release on Usenet in April
1996 several
1539 other folks have contributed.
1541 David Weisman
<weisman@app1.osf.org
>,
1542 Martin L. Smith
<martin@ner.com
>,
1543 Jason Bastek
<jason@aai.com
>,
1544 Ulrich Herbst
<Ulrich.Herbst@t-systems.com
>.
1545 See the next section (See section
<a href=
"#Changes">Changes
</a>.) for details of their exploits.
1547 <p>Thanks to Larry Ayers
<layers@marktwain.net
>
1548 for popularizing notes-mode with reviews in
1550 (at
<http://www.linuxgazette.com/issue22/notes-mode.html
> and
1551 <http://www.linuxgazette.com/issue35/ayers.html
>).
1554 <a name=
"Changes"></a>
1555 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1556 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Credits" title=
"Previous section in reading order"> < </a>]
</td>
1557 <td valign=
"middle" align=
"left">[
<a href=
"#Suggested-features" title=
"Next section in reading order"> > </a>]
</td>
1558 <td valign=
"middle" align=
"left"> </td>
1559 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1560 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Up section"> Up
</a>]
</td>
1561 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Next chapter"> >> </a>]
</td>
1562 <td valign=
"middle" align=
"left"> </td>
1563 <td valign=
"middle" align=
"left"> </td>
1564 <td valign=
"middle" align=
"left"> </td>
1565 <td valign=
"middle" align=
"left"> </td>
1566 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1567 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1568 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1569 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1571 <a name=
"Changes-1"></a>
1572 <h2 class=
"section">4.3 Changes
</h2>
1576 <p>First semi-public release.
12-Jul-
95: version
0.1
1577 Shared a version with Ashvin and Geoff.
1579 <p>Changed
6-Dec-
95: version
0.3
1580 Ashvin
’s changes for note traversal added (C-c C-p and C-c C-n now
1581 move to the prev/next note in note-mode).
1582 URL parsing changed so that
"localhost
" is optional.
1584 <p>Changed
19-Dec-
95: version
0.4
1585 More robust prev/next code added, both to handle going back and
1586 forward in the middle of chains through the index file, and to handle
1587 back/forward in a single file.
1588 URL parsing changed so that notes-goto-index-entry correctly handles
1589 lookups on notes names such as
"252A
".
1591 <p>Changed
20-Dec-
95: version
0.5.
1592 Fixed a missing variable in notes-url.el.
1593 Added a work-around to a bug in emacs-
19.30’s define-derived-mode.
1595 <p>Changed
24-Dec-
95: version
0.6.
1596 Prev/next code re-re-written to be more robust.
1598 <p>Changed
26-Dec-
96: version
0.7.
1601 <p>Changed
23-Jan-
96: version
0.8.
1602 Initialization code added to set up a new note.
1603 New variable: notes-bin-dir.
1605 <p> I
’m skipping version
0.9 because I erroneously release version
0.1
1606 as version
0.9 (only on the web, not on Usenet).
1608 <p> I
’m bumping from version
"0" to version
"1" since the code is has been
1609 in production use for more than a year by several people. Minor
1610 numbers are the same.
1612 <p>Changed
26-Mar-
96: version
1.10.
1613 Setup code completely re-written.
1614 Several incompatible changes have been made:
1615 - the lisp and Perl code must be installed via make install,
1617 - some data is specified in a .notesrc file; copy and modify sample.notesrc.
1618 - several internal elisp changes.
1619 - catsubject added (bound to C-cC-s): collect all notes about the
1621 - new notes-files are initialized with fields based on the prior
1622 day
’s notes; see mknew for details.
1623 - daily_work is gone; mkall is rewritten to use .notesrc.
1625 <p>Changed
29-Apr-
96: version
1.11.
1627 Mknew caching added.
1629 <p>Changed
9-Aug-
96: version
1.12.
1630 Added notesinit to do all setup for new users.
1632 <p>Changed
24-Aug-
96: version
1.13.
1633 Minor documentation fixes.
1635 <p>Changed
20-Dec-
97: version
1.14.
1638 <p>Fontification of the index buffer is now pre-computed in perl
1639 other than done when the file is needed (in elisp with slow regular
1640 expressions).
2000-line index files are now
1-
2 seconds rather than
1641 15-
30 on a
100MHz Pentium. If necessary (the
1642 pre-computed version isn
’t up-to-date) we fall back on the slower
1645 <p>Related work improved (suggestion by David Weisman
<weisman@app1.osf.org
>).
1647 <p>Documentation improvement (problem found by Martin L. Smith
1648 <martin@ner.com
>).
1650 <p>Installation improved (code by Jason Bastek
<jason@aai.com
>).
1652 <p>Bug in notes-index mode with subjects containing colons fixed (johnh).
1654 <p>Encryption now supports mailcrypt.el.
1656 <p>Support for emacs
20 (a small font-lock change).
1658 <p>Changed
5-Jan-
98: version
1.15.
1659 Bug in decryption for non-PAM users fixed
1660 (suggestion by Kevin Davidson
<tkld@quadstone.com
>).
1662 <p>Y2K statement added
1663 (suggestion by Kevin Davidson
<tkld@quadstone.com
>).
1665 <p>Pointer to mailcrypt added (as a supported encryption package).
1666 Problem pointed out by K. Ueda
<kueda@jupiter.qse.tohoku.ac.jp
>.
1668 <p>Changed
4-Nov-
98: version
1.16.
1669 Bug in kill-ring handling of notes-old-underline-line
1670 fixed by Tim Potter
<timp@jna.com.au
>.
1671 Bug in whitespace handling after PGP encryption fixed by Tim Potter.
1672 Bugs in handling of entries with hash signs in their name fixed
1673 (found by Tim Potter).
1674 Fontification of index buffer further improved
1675 (mapcar is your friend).
1676 Xemacs support added based on code contributed by Ramesh Govindan.
1678 <p>Changed
28-Feb-
99: version
1.17:
1679 Improvement: notes-electric-return now fixes up the prev/next links
1680 of new entries (only). Code contributed by
1683 <p>Bug fix: reversed options -batch and -q in configure.in to placate
1684 XEmacs
20.0; changed notesinit to not downcase the pathname
1685 (bugs found by Thierry Bezecourt).
1687 <p>Clarification: Autofilling of new notes more clear in the manual (hopefully,
1688 suggested by Solofo Ramangalahy).
1690 <p>Bug fix: a y2k bug in was found and fixed in mkindex. Sigh.
1692 <p>New: Two mailing lists for notes-mode have been created:
1693 ‘<tt>notes-mode-announce@heidemann.la.ca.us
</tt>’ and
1694 ‘<tt>notes-mode-talk@heidemann.la.ca.us
</tt>’.
1695 Send the line
“subscribe notes-mode-announce
”
1696 (or
“subscribe notes-mode-talk
”)
1697 to
‘<tt>majordomo@heidemann.la.ca.us
</tt>’
1699 [
<em>These instructions are now superceeded; to subscribe, go to
1700 ‘<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-talk
</tt>’
1702 ‘<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-announce
</tt>’.
</em>]
1704 <p>Changed
6-Oct-
99: version
1.18:
1705 Bug fix: handling of electric-prevnext is better when there are
1706 existing prev/next links.
1708 <p>Clarification: I added some pointers in the code to the installation
1709 instructions. (Apparently people can
’t RTF README.)
1711 <p>Extension: mailcrypt-
3.5.x suported including pgp, pgp5 and gpg.
1713 <p>Changed (date
23-Dec-
00): version
1.19:
1714 Bug fix (cosmetic): suppress comments in encrypted nodes.
1716 <p>Install fixes from Kannan Varadhan: elisp directories changed on install.
1718 <p>Added C-j as a synonym for RET in notes-mode to parallel C++ or perl mode.
1719 (Suggested by Fred Jaggi
‘<tt>jaggi@rsn.hp.com
</tt>’.)
1721 <p>Outline-minor-mode support added and documented.
1722 (Suggested by Tim Carroll
‘<tt>tim@boomboom.com
</tt>’.)
1724 <p>Bug/typo fixes in gpg support
1725 (Contributed by William A. Perkins
‘<tt>wa_perkins@pnl.gov
</tt>’,
1726 with separate patches from Knut Anders Hatlen
‘<tt>kahatlen@online.no
</tt>’.)
1728 <p>Installation improvements suggested by Christophe Troestler
1729 ‘<tt>Ch.Troestler@linkline.be
</tt>’:
1730 use install-info to update the info dir,
1731 warn users of
–prefix that lisp files go elsewhere.
1733 <p>Changed (date
1-Feb-
01): version
1.20:
1734 Bug fix: missing file notes-first.el added to the distribution.
1735 (Bug found by Michael Totschnig
‘<tt>michaelt@supernet.ca
</tt>’.)
1737 <p>Changed (
5-Dec-
01): version
1.21:
1738 (backed-out
—didn
’t work with spaced URLs)
1739 URL lookup now uses thing-at-point.
1741 <p>Fix to make notes-mode work with emacs-
21.1
1742 (Fix from Klaus Zeitler
‘<tt>kzeitler@lucent.com
</tt>’.)
1744 <p>Changed (
3-Jan-
02): version
1.22:
1745 Several bugs in
‘<tt>notesinit
</tt>’ for stricter Perl implementations
1746 (bug found by Paul Craven
" ‘<tt>pcraven@yorku.ca
</tt>’,
1747 and Kasper van Wijk
‘<tt>kasper@acoustics.mines.edu
</tt>’)
1748 and to make it run cleanly more often.
1750 <p>Notes-first now autoinitializes notes mode from emacs.
1751 (As instisted by rms, unfortunately about two years later than requested.)
1754 <p>Changed (
20-Feb-
05): version
1.23:
1755 Outline mode is now forcebly turned on to avoid interactions
1756 with user
’s text-mode hooks
1757 (bug and fix from Nils Ackermann
‘<tt>nils@nieback.de
</tt>’).
1759 <p>Install bug involving ordering of scripts and byte-compilation
1760 fixed (bug and fix from Mark Allman
‘<tt>mallman@grc.nasa.gov
</tt>’).
1762 <p>Fix obscure bug in configure, reported by Klaus Zeitler
‘<tt>kzeitler@lucent.com
</tt>’.
1764 <p>Fix for notes-summarize-subject when no subject is specified (bug and fix
1765 from Geoff Kuenning).
1767 <p>Changed (
14-Jan-
06): version
1.24:
1769 <p>install-info bug documented with the Debian install-info
1770 (bug reported by Aaron Falk
‘<tt>falk@isi.edu
</tt>’).
1772 <p>Automatic date completion in new days is now done in the current
1773 locale, so it should now work for non-English languages. Bug reported
1774 by Torsten Bronger
‘<tt>bronger@physik.rwth-aachen.de
</tt>’.
1776 <p>Fixed a bug in mkindexcache, triggered by subjects with percent signs
1777 in them. Bug reported by Philip Austin
‘<tt>paustin@eos.ubc.ca
</tt>’.
1779 <p>We
’re a bit more robust about subjects, I hope. Warnings should
1780 appear about embedded number signs, and leading spaces should be
1781 filtered. Bug reported by Philip Austin
‘<tt>paustin@eos.ubc.ca
</tt>’.
1783 <p>Notes-mode now dervies from indented-text-mode rather than
1784 paragraph-indent-text mode. Unfortunatley this is not customizable
1785 because of limitations of define-derived-mode. Change suggested by
1786 Aaron Falk
‘<tt>falk@isi.edu
</tt>’.
1788 <p>Provide better hints about how to get started after installation or
1789 running notes-mode in emacs for the first time.
1791 <p>In notes init, the default path for dir was the full path, not the tilde
1792 version of the path. Now it defaults to using tidle for home
1793 directory. Bug reported by Mark Allman
‘<tt>allman@icir.org
</tt>’.
1795 <p>Changed (
26-May-
06): version
1.25:
1797 <p>fixed a bug in the release tar.gz file that had a additional copies
1800 <p>Changed (
30-Jun-
08): version
1.26:
1802 <p>Force unicode I/O in
‘<tt>mkindexcache
</tt>’ to fix highlighting mis-alignment
1803 when using emacs-
21 with unicode subject lines.
1805 <p>Changed mkprevnext and mkrawindex to optionally take the list of notes files
1806 to index from stdin rather than from the command line. Yes, I finally
1807 have
4093 notes files, overflowing the Unix command line buffer.
1809 <p>Changes notes-mode.el to put path in quotes, allowing spaces to appear in home directory names (bug fix from Ulrich Herbst).
1811 <p>Added a suggested features section.
1813 <p>Changed (
8-Aug-
08): version
1.27:
1815 <p>Change I/O in
‘<tt>mkindexcache
</tt>’ to use locale (the sadly correct thing)
1816 rather than forcing utf-
8 (the Righteous Path).
1817 Bug report from Geoff Kuenning, a man with an older Unix environment than I.
1819 <p>Changed (
20-Jun-
10): version
1.28:
1821 <p>Changed a regular expression in
‘<tt>notes-index-mode.el
</tt>’ that was
1822 causing emacs-v23 (a pre-release version)
1823 to regular expression infinite recursion.
1825 <p>Changed (
2012-
04-
04): version
1.29
1827 <p>(
2011-
08-
23) Changed
<code>run-hooks
</code> to
<code>run-mode-hooks
</code>.
1828 Bug report from Geoff Kuenning.
1830 <p>Changed some handling of PGP encryption to account for
1831 some apparent API changes.
1833 <p>(
2012-
04-
04) Fixed encyrption to handle encrypting empty notes at the end
1834 of buffers without going into an infinite loop.
1835 Clearly wrong code, but you have to ask this guy for why he tried:
1836 Bug report from Geoff Kuenning.
1841 <a name=
"Suggested-features"></a>
1842 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1843 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Changes" title=
"Previous section in reading order"> < </a>]
</td>
1844 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Next section in reading order"> > </a>]
</td>
1845 <td valign=
"middle" align=
"left"> </td>
1846 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1847 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Up section"> Up
</a>]
</td>
1848 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Next chapter"> >> </a>]
</td>
1849 <td valign=
"middle" align=
"left"> </td>
1850 <td valign=
"middle" align=
"left"> </td>
1851 <td valign=
"middle" align=
"left"> </td>
1852 <td valign=
"middle" align=
"left"> </td>
1853 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1854 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1855 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1856 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1858 <a name=
"Suggested-features-1"></a>
1859 <h2 class=
"section">4.4 Suggested features
</h2>
1861 <p>Features suggested by users but not yet implemented:
1863 <p>21-Feb-
08: (from Xavier Maillard): should support
“disconnected
” notes that
1864 are indexed but not date-based.
1866 <p>21-Feb-
08: (from John Heidemann): should switch all notes files to have an extension (maybe
‘<tt>.notes
</tt>’).
1869 <a name=
"Installation"></a>
1870 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1871 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Suggested-features" title=
"Previous section in reading order"> < </a>]
</td>
1872 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Next section in reading order"> > </a>]
</td>
1873 <td valign=
"middle" align=
"left"> </td>
1874 <td valign=
"middle" align=
"left">[
<a href=
"#History" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1875 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
1876 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Next chapter"> >> </a>]
</td>
1877 <td valign=
"middle" align=
"left"> </td>
1878 <td valign=
"middle" align=
"left"> </td>
1879 <td valign=
"middle" align=
"left"> </td>
1880 <td valign=
"middle" align=
"left"> </td>
1881 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1882 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1883 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1884 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1886 <a name=
"Installation-1"></a>
1887 <h1 class=
"chapter">5. Installation
</h1>
1889 <p>To install notes-mode,
1893 Unpack and extract the distribution
1894 (gunzip notes-mode-xxx.tar.gz; tar xvf notes-mode-xxx.tar; cd notes-mode-xxx).
1897 Run configure (./configure).
1900 Type
“make install
”.
1903 <p>(To control what
’s installed where, use
–prefix=/where, or
1904 –with-lisp-dir=/where,
–datadir=/where (for scripts),
1905 and
–infodir=/where.)
1913 <p>If you have problems with paths being incorrect, please be aware that
1914 you
<em>cannot
</em> run notes directly out of where you untar it. The
1915 installation process customizes the programs for where things are on
1917 Make sure you move out of the directory where you untarred it
1921 <p>The most recent distribution of notes-mode
1922 is always available via
1923 ‘<tt>http://www.isi.edu/~johnh/SOFTWARE/NOTES_MODE/
</tt>’.
1928 <a name=
"Keystroke-index"></a>
1929 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
1930 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Previous section in reading order"> < </a>]
</td>
1931 <td valign=
"middle" align=
"left">[
<a href=
"#Concept-index" title=
"Next section in reading order"> > </a>]
</td>
1932 <td valign=
"middle" align=
"left"> </td>
1933 <td valign=
"middle" align=
"left">[
<a href=
"#Installation" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
1934 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
1935 <td valign=
"middle" align=
"left">[
<a href=
"#Concept-index" title=
"Next chapter"> >> </a>]
</td>
1936 <td valign=
"middle" align=
"left"> </td>
1937 <td valign=
"middle" align=
"left"> </td>
1938 <td valign=
"middle" align=
"left"> </td>
1939 <td valign=
"middle" align=
"left"> </td>
1940 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
1941 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
1942 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
1943 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
1945 <a name=
"Keystroke-index-1"></a>
1946 <h1 class=
"unnumbered">Keystroke index
</h1>
1948 <p>This index lists notes-mode keystrokes.
1950 <table><tr><th valign=
"top">Jump to:
</th><td><a href=
"#Keystroke-index-1_ky_letter-C" class=
"summary-letter"><b>C
</b></a>
1952 <a href=
"#Keystroke-index-1_ky_letter-M" class=
"summary-letter"><b>M
</b></a>
1954 <a href=
"#Keystroke-index-1_ky_letter-O" class=
"summary-letter"><b>O
</b></a>
1956 <a href=
"#Keystroke-index-1_ky_letter-R" class=
"summary-letter"><b>R
</b></a>
1958 <a href=
"#Keystroke-index-1_ky_letter-S" class=
"summary-letter"><b>S
</b></a>
1960 <a href=
"#Keystroke-index-1_ky_letter-T" class=
"summary-letter"><b>T
</b></a>
1963 <table border=
"0" class=
"index-ky">
1964 <tr><td></td><th align=
"left">Index Entry
</th><th align=
"left"> Section
</th></tr>
1965 <tr><td colspan=
"3"> <hr></td></tr>
1966 <tr><th><a name=
"Keystroke-index-1_ky_letter-C">C
</a></th><td></td><td></td></tr>
1967 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002dd"><code>C-c C-d
</code></a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
1968 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002de"><code>C-c C-e
</code></a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
1969 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002di"><code>C-c C-i
</code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1970 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002dk"><code>C-c C-k
</code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1971 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002dn"><code>C-c C-n
</code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1972 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002dp"><code>C-c C-p
</code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1973 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002ds"><code>C-c C-s
</code></a></td><td valign=
"top"><a href=
"#Subject-summary">3.1.2 Subject summary
</a></td></tr>
1974 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dc-C_002ds-1"><code>C-c C-s
</code></a></td><td valign=
"top"><a href=
"#Notes-indices">3.2 Notes indices
</a></td></tr>
1975 <tr><td></td><td valign=
"top"><a href=
"#index-C_002dcRTN"><code>C-c
<RTN
></code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1976 <tr><td colspan=
"3"> <hr></td></tr>
1977 <tr><th><a name=
"Keystroke-index-1_ky_letter-M">M
</a></th><td></td><td></td></tr>
1978 <tr><td></td><td valign=
"top"><a href=
"#index-M_002dC_002da"><code>M-C-a
</code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1979 <tr><td></td><td valign=
"top"><a href=
"#index-M_002dC_002de"><code>M-C-e
</code></a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
1980 <tr><td></td><td valign=
"top"><a href=
"#index-mouse_002d2"><code>mouse-
2</code></a></td><td valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td></tr>
1981 <tr><td colspan=
"3"> <hr></td></tr>
1982 <tr><th><a name=
"Keystroke-index-1_ky_letter-O">O
</a></th><td></td><td></td></tr>
1983 <tr><td></td><td valign=
"top"><a href=
"#index-o"><code>o
</code></a></td><td valign=
"top"><a href=
"#Notes-indices">3.2 Notes indices
</a></td></tr>
1984 <tr><td colspan=
"3"> <hr></td></tr>
1985 <tr><th><a name=
"Keystroke-index-1_ky_letter-R">R
</a></th><td></td><td></td></tr>
1986 <tr><td></td><td valign=
"top"><a href=
"#index-RTN"><code>RTN
</code></a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
1987 <tr><td></td><td valign=
"top"><a href=
"#index-RTN-1"><code>RTN
</code></a></td><td valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td></tr>
1988 <tr><td colspan=
"3"> <hr></td></tr>
1989 <tr><th><a name=
"Keystroke-index-1_ky_letter-S">S
</a></th><td></td><td></td></tr>
1990 <tr><td></td><td valign=
"top"><a href=
"#index-S_002dmouse_002d2"><code>S-mouse-
2</code></a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
1991 <tr><td colspan=
"3"> <hr></td></tr>
1992 <tr><th><a name=
"Keystroke-index-1_ky_letter-T">T
</a></th><td></td><td></td></tr>
1993 <tr><td></td><td valign=
"top"><a href=
"#index-TAB"><code>TAB
</code></a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
1994 <tr><td colspan=
"3"> <hr></td></tr>
1996 <table><tr><th valign=
"top">Jump to:
</th><td><a href=
"#Keystroke-index-1_ky_letter-C" class=
"summary-letter"><b>C
</b></a>
1998 <a href=
"#Keystroke-index-1_ky_letter-M" class=
"summary-letter"><b>M
</b></a>
2000 <a href=
"#Keystroke-index-1_ky_letter-O" class=
"summary-letter"><b>O
</b></a>
2002 <a href=
"#Keystroke-index-1_ky_letter-R" class=
"summary-letter"><b>R
</b></a>
2004 <a href=
"#Keystroke-index-1_ky_letter-S" class=
"summary-letter"><b>S
</b></a>
2006 <a href=
"#Keystroke-index-1_ky_letter-T" class=
"summary-letter"><b>T
</b></a>
2012 <a name=
"Concept-index"></a>
2013 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
2014 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Previous section in reading order"> < </a>]
</td>
2015 <td valign=
"middle" align=
"left">[
> ]
</td>
2016 <td valign=
"middle" align=
"left"> </td>
2017 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Beginning of this chapter or previous chapter"> << </a>]
</td>
2018 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Up section"> Up
</a>]
</td>
2019 <td valign=
"middle" align=
"left">[
>> ]
</td>
2020 <td valign=
"middle" align=
"left"> </td>
2021 <td valign=
"middle" align=
"left"> </td>
2022 <td valign=
"middle" align=
"left"> </td>
2023 <td valign=
"middle" align=
"left"> </td>
2024 <td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
2025 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
2026 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
2027 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
2029 <a name=
"Concept-index-1"></a>
2030 <h1 class=
"unnumbered">Concept index
</h1>
2032 <p>This index lists notes-mode concepts.
2034 <table><tr><th valign=
"top">Jump to:
</th><td><a href=
"#Concept-index-1_cp_symbol-1" class=
"summary-letter"><b>.
</b></a>
2037 <a href=
"#Concept-index-1_cp_letter-C" class=
"summary-letter"><b>C
</b></a>
2039 <a href=
"#Concept-index-1_cp_letter-D" class=
"summary-letter"><b>D
</b></a>
2041 <a href=
"#Concept-index-1_cp_letter-E" class=
"summary-letter"><b>E
</b></a>
2043 <a href=
"#Concept-index-1_cp_letter-F" class=
"summary-letter"><b>F
</b></a>
2045 <a href=
"#Concept-index-1_cp_letter-I" class=
"summary-letter"><b>I
</b></a>
2047 <a href=
"#Concept-index-1_cp_letter-K" class=
"summary-letter"><b>K
</b></a>
2049 <a href=
"#Concept-index-1_cp_letter-M" class=
"summary-letter"><b>M
</b></a>
2051 <a href=
"#Concept-index-1_cp_letter-N" class=
"summary-letter"><b>N
</b></a>
2053 <a href=
"#Concept-index-1_cp_letter-P" class=
"summary-letter"><b>P
</b></a>
2055 <a href=
"#Concept-index-1_cp_letter-R" class=
"summary-letter"><b>R
</b></a>
2057 <a href=
"#Concept-index-1_cp_letter-S" class=
"summary-letter"><b>S
</b></a>
2059 <a href=
"#Concept-index-1_cp_letter-T" class=
"summary-letter"><b>T
</b></a>
2061 <a href=
"#Concept-index-1_cp_letter-U" class=
"summary-letter"><b>U
</b></a>
2064 <table border=
"0" class=
"index-cp">
2065 <tr><td></td><th align=
"left">Index Entry
</th><th align=
"left"> Section
</th></tr>
2066 <tr><td colspan=
"3"> <hr></td></tr>
2067 <tr><th><a name=
"Concept-index-1_cp_symbol-1">.
</a></th><td></td><td></td></tr>
2068 <tr><td></td><td valign=
"top"><a href=
"#index-_002enotesrc">.notesrc
</a></td><td valign=
"top"><a href=
"#Notes_002dmode-configuration">3.3 Notes-mode configuration
</a></td></tr>
2069 <tr><td colspan=
"3"> <hr></td></tr>
2070 <tr><th><a name=
"Concept-index-1_cp_letter-C">C
</a></th><td></td><td></td></tr>
2071 <tr><td></td><td valign=
"top"><a href=
"#index-configuration">configuration
</a></td><td valign=
"top"><a href=
"#Notes_002dmode-configuration">3.3 Notes-mode configuration
</a></td></tr>
2072 <tr><td></td><td valign=
"top"><a href=
"#index-conventions">conventions
</a></td><td valign=
"top"><a href=
"#Useful-conventions">3.1.4 Useful conventions
</a></td></tr>
2073 <tr><td></td><td valign=
"top"><a href=
"#index-Crontab">Crontab
</a></td><td valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td></tr>
2074 <tr><td colspan=
"3"> <hr></td></tr>
2075 <tr><th><a name=
"Concept-index-1_cp_letter-D">D
</a></th><td></td><td></td></tr>
2076 <tr><td></td><td valign=
"top"><a href=
"#index-Decryption">Decryption
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2077 <tr><td></td><td valign=
"top"><a href=
"#index-Directory-hierarchy">Directory hierarchy
</a></td><td valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td></tr>
2078 <tr><td colspan=
"3"> <hr></td></tr>
2079 <tr><th><a name=
"Concept-index-1_cp_letter-E">E
</a></th><td></td><td></td></tr>
2080 <tr><td></td><td valign=
"top"><a href=
"#index-Encryption">Encryption
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2081 <tr><td colspan=
"3"> <hr></td></tr>
2082 <tr><th><a name=
"Concept-index-1_cp_letter-F">F
</a></th><td></td><td></td></tr>
2083 <tr><td></td><td valign=
"top"><a href=
"#index-Font-matter">Font matter
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2084 <tr><td colspan=
"3"> <hr></td></tr>
2085 <tr><th><a name=
"Concept-index-1_cp_letter-I">I
</a></th><td></td><td></td></tr>
2086 <tr><td></td><td valign=
"top"><a href=
"#index-imenu">imenu
</a></td><td valign=
"top"><a href=
"#Getting-around">3.1.1 Getting around
</a></td></tr>
2087 <tr><td></td><td valign=
"top"><a href=
"#index-Intermediate-directories">Intermediate directories
</a></td><td valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td></tr>
2088 <tr><td colspan=
"3"> <hr></td></tr>
2089 <tr><th><a name=
"Concept-index-1_cp_letter-K">K
</a></th><td></td><td></td></tr>
2090 <tr><td></td><td valign=
"top"><a href=
"#index-key_002did">key-id
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2091 <tr><td colspan=
"3"> <hr></td></tr>
2092 <tr><th><a name=
"Concept-index-1_cp_letter-M">M
</a></th><td></td><td></td></tr>
2093 <tr><td></td><td valign=
"top"><a href=
"#index-mailcrypt">mailcrypt
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2094 <tr><td></td><td valign=
"top"><a href=
"#index-mkall">mkall
</a></td><td valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td></tr>
2095 <tr><td></td><td valign=
"top"><a href=
"#index-mknew">mknew
</a></td><td valign=
"top"><a href=
"#Useful-conventions">3.1.4 Useful conventions
</a></td></tr>
2096 <tr><td colspan=
"3"> <hr></td></tr>
2097 <tr><th><a name=
"Concept-index-1_cp_letter-N">N
</a></th><td></td><td></td></tr>
2098 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-directories">Notes directories
</a></td><td valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td></tr>
2099 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-entries">Notes entries
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2100 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-file-permissions">Notes file permissions
</a></td><td valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td></tr>
2101 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-files">Notes files
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2102 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-files-1">Notes files
</a></td><td valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td></tr>
2103 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-files_002c-font-matter">Notes files, font matter
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2104 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-index">Notes index
</a></td><td valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td></tr>
2105 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-links">Notes links
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2106 <tr><td></td><td valign=
"top"><a href=
"#index-Notes-subjects">Notes subjects
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2107 <tr><td></td><td valign=
"top"><a href=
"#index-notes_002dmode_002dinitialization_002dprogram">notes-mode-initialization-program
</a></td><td valign=
"top"><a href=
"#Useful-conventions">3.1.4 Useful conventions
</a></td></tr>
2108 <tr><td></td><td valign=
"top"><a href=
"#index-notesinit">notesinit
</a></td><td valign=
"top"><a href=
"#Getting-started">2.1 Getting started
</a></td></tr>
2109 <tr><td colspan=
"3"> <hr></td></tr>
2110 <tr><th><a name=
"Concept-index-1_cp_letter-P">P
</a></th><td></td><td></td></tr>
2111 <tr><td></td><td valign=
"top"><a href=
"#index-PAM">PAM
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2112 <tr><td></td><td valign=
"top"><a href=
"#index-PGP">PGP
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2113 <tr><td></td><td valign=
"top"><a href=
"#index-PGP-Augmented-Messaging">PGP Augmented Messaging
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2114 <tr><td></td><td valign=
"top"><a href=
"#index-Pretty-good-privacy">Pretty good privacy
</a></td><td valign=
"top"><a href=
"#Encryption">3.1.3 Encryption
</a></td></tr>
2115 <tr><td></td><td valign=
"top"><a href=
"#index-Pseudo_002dURLs">Pseudo-URLs
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2116 <tr><td colspan=
"3"> <hr></td></tr>
2117 <tr><th><a name=
"Concept-index-1_cp_letter-R">R
</a></th><td></td><td></td></tr>
2118 <tr><td></td><td valign=
"top"><a href=
"#index-re_002dindexing">re-indexing
</a></td><td valign=
"top"><a href=
"#The-notes-index">2.3 The notes index
</a></td></tr>
2119 <tr><td></td><td valign=
"top"><a href=
"#index-Root-directory">Root directory
</a></td><td valign=
"top"><a href=
"#The-notes-directories">2.4 The notes directories
</a></td></tr>
2120 <tr><td colspan=
"3"> <hr></td></tr>
2121 <tr><th><a name=
"Concept-index-1_cp_letter-S">S
</a></th><td></td><td></td></tr>
2122 <tr><td></td><td valign=
"top"><a href=
"#index-setup">setup
</a></td><td valign=
"top"><a href=
"#Getting-started">2.1 Getting started
</a></td></tr>
2123 <tr><td></td><td valign=
"top"><a href=
"#index-Subject-summary">Subject summary
</a></td><td valign=
"top"><a href=
"#Subject-summary">3.1.2 Subject summary
</a></td></tr>
2124 <tr><td colspan=
"3"> <hr></td></tr>
2125 <tr><th><a name=
"Concept-index-1_cp_letter-T">T
</a></th><td></td><td></td></tr>
2126 <tr><td></td><td valign=
"top"><a href=
"#index-Today">Today
</a></td><td valign=
"top"><a href=
"#Useful-conventions">3.1.4 Useful conventions
</a></td></tr>
2127 <tr><td colspan=
"3"> <hr></td></tr>
2128 <tr><th><a name=
"Concept-index-1_cp_letter-U">U
</a></th><td></td><td></td></tr>
2129 <tr><td></td><td valign=
"top"><a href=
"#index-URLs">URLs
</a></td><td valign=
"top"><a href=
"#A-notes-file">2.2 A notes file
</a></td></tr>
2130 <tr><td colspan=
"3"> <hr></td></tr>
2132 <table><tr><th valign=
"top">Jump to:
</th><td><a href=
"#Concept-index-1_cp_symbol-1" class=
"summary-letter"><b>.
</b></a>
2135 <a href=
"#Concept-index-1_cp_letter-C" class=
"summary-letter"><b>C
</b></a>
2137 <a href=
"#Concept-index-1_cp_letter-D" class=
"summary-letter"><b>D
</b></a>
2139 <a href=
"#Concept-index-1_cp_letter-E" class=
"summary-letter"><b>E
</b></a>
2141 <a href=
"#Concept-index-1_cp_letter-F" class=
"summary-letter"><b>F
</b></a>
2143 <a href=
"#Concept-index-1_cp_letter-I" class=
"summary-letter"><b>I
</b></a>
2145 <a href=
"#Concept-index-1_cp_letter-K" class=
"summary-letter"><b>K
</b></a>
2147 <a href=
"#Concept-index-1_cp_letter-M" class=
"summary-letter"><b>M
</b></a>
2149 <a href=
"#Concept-index-1_cp_letter-N" class=
"summary-letter"><b>N
</b></a>
2151 <a href=
"#Concept-index-1_cp_letter-P" class=
"summary-letter"><b>P
</b></a>
2153 <a href=
"#Concept-index-1_cp_letter-R" class=
"summary-letter"><b>R
</b></a>
2155 <a href=
"#Concept-index-1_cp_letter-S" class=
"summary-letter"><b>S
</b></a>
2157 <a href=
"#Concept-index-1_cp_letter-T" class=
"summary-letter"><b>T
</b></a>
2159 <a href=
"#Concept-index-1_cp_letter-U" class=
"summary-letter"><b>U
</b></a>
2167 <a name=
"SEC_Foot"></a>
2168 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
2169 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
2170 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
2171 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
2172 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
2175 <h3><a name=
"FOOT1" href=
"#DOCF1">(
1)
</a></h3>
2176 <p>Trademarked, in Great Britain, Sunone tells me.
2177 </p><h3><a name=
"FOOT2" href=
"#DOCF2">(
2)
</a></h3>
2178 <p>I consider myself pretty anal about this subject,
2179 often typing notes in from paper after-the-fact,
2180 and
<em>I
</em> certainly don
’t manage to back-enter
2181 my notes all time time.
2182 </p><h3><a name=
"FOOT3" href=
"#DOCF3">(
3)
</a></h3>
2184 <p>On the other hand, some folks at MIT are working
2185 on this problem from both the hardware and the social side of
2186 things (
‘<tt>http://wearables.www.media.mit.edu/projects/wearables/
</tt>’)
2187 (Perhaps they have wild parties with computers, too.)
2188 </p><h3><a name=
"FOOT4" href=
"#DOCF4">(
4)
</a></h3>
2189 <p>My hat is off to Rosa Parks
2190 and the many other normal people who triggered landmark cases.
2191 </p><h3><a name=
"FOOT5" href=
"#DOCF5">(
5)
</a></h3>
2192 <p>If you think I
’m missing an alternative, please let me know.
2194 <a name=
"SEC_Contents"></a>
2195 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
2196 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
2197 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
2198 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
2199 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
2201 <h1>Table of Contents
</h1>
2202 <div class=
"contents">
2205 <li><a name=
"toc-Introduction-1" href=
"#Introduction">1. Introduction
</a>
2207 <li><a name=
"toc-What-is-it_003f-1" href=
"#What-is-it_003f">1.1 What is it?
</a></li>
2208 <li><a name=
"toc-Why-keep-notes-at-all_003f-1" href=
"#Why-keep-notes-at-all_003f">1.2 Why keep notes at all?
</a></li>
2209 <li><a name=
"toc-Why-keep-notes-on_002dline_003f-1" href=
"#Why-keep-notes-on_002dline_003f">1.3 Why keep notes on-line?
</a></li>
2210 <li><a name=
"toc-Why-use-notes_002dmode_003f-1" href=
"#Why-use-notes_002dmode_003f">1.4 Why use notes-mode?
</a></li>
2211 <li><a name=
"toc-Y2K-Statement-1" href=
"#Y2K-Statement">1.5 Y2K Statement
</a></li>
2212 <li><a name=
"toc-Related-work-1" href=
"#Related-work">1.6 Related work
</a></li>
2213 <li><a name=
"toc-Staying-on-top-1" href=
"#Staying-on-top">1.7 Staying on top
</a></li>
2215 <li><a name=
"toc-Basics-1" href=
"#Basics">2. Basics
</a>
2217 <li><a name=
"toc-Getting-started-1" href=
"#Getting-started">2.1 Getting started
</a></li>
2218 <li><a name=
"toc-A-notes-file-1" href=
"#A-notes-file">2.2 A notes file
</a></li>
2219 <li><a name=
"toc-The-notes-index-1" href=
"#The-notes-index">2.3 The notes index
</a></li>
2220 <li><a name=
"toc-The-notes-directories-1" href=
"#The-notes-directories">2.4 The notes directories
</a></li>
2222 <li><a name=
"toc-Advanced-Features-1" href=
"#Advanced-Features">3. Advanced Features
</a>
2224 <li><a name=
"toc-Notes-files-1" href=
"#Notes-files">3.1 Notes files
</a>
2226 <li><a name=
"toc-Getting-around-1" href=
"#Getting-around">3.1.1 Getting around
</a></li>
2227 <li><a name=
"toc-Subject-summary-1" href=
"#Subject-summary">3.1.2 Subject summary
</a></li>
2228 <li><a name=
"toc-Encryption-1" href=
"#Encryption">3.1.3 Encryption
</a></li>
2229 <li><a name=
"toc-Useful-conventions-1" href=
"#Useful-conventions">3.1.4 Useful conventions
</a></li>
2231 <li><a name=
"toc-Notes-indices-1" href=
"#Notes-indices">3.2 Notes indices
</a></li>
2232 <li><a name=
"toc-Notes_002dmode-configuration-1" href=
"#Notes_002dmode-configuration">3.3 Notes-mode configuration
</a></li>
2234 <li><a name=
"toc-History-1" href=
"#History">4. History
</a>
2236 <li><a name=
"toc-Notes_002dmode-history-1" href=
"#Notes_002dmode-history">4.1 Notes-mode history
</a></li>
2237 <li><a name=
"toc-Credits-1" href=
"#Credits">4.2 Credits
</a></li>
2238 <li><a name=
"toc-Changes-1" href=
"#Changes">4.3 Changes
</a></li>
2239 <li><a name=
"toc-Suggested-features-1" href=
"#Suggested-features">4.4 Suggested features
</a></li>
2241 <li><a name=
"toc-Installation-1" href=
"#Installation">5. Installation
</a></li>
2242 <li><a name=
"toc-Keystroke-index-1" href=
"#Keystroke-index">Keystroke index
</a></li>
2243 <li><a name=
"toc-Concept-index-1" href=
"#Concept-index">Concept index
</a></li>
2247 <a name=
"SEC_About"></a>
2248 <table cellpadding=
"1" cellspacing=
"1" border=
"0">
2249 <tr><td valign=
"middle" align=
"left">[
<a href=
"#Top" title=
"Cover (top) of document">Top
</a>]
</td>
2250 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_Contents" title=
"Table of contents">Contents
</a>]
</td>
2251 <td valign=
"middle" align=
"left">[
<a href=
"#Keystroke-index" title=
"Index">Index
</a>]
</td>
2252 <td valign=
"middle" align=
"left">[
<a href=
"#SEC_About" title=
"About (help)"> ?
</a>]
</td>
2254 <h1>About This Document
</h1>
2256 This document was generated by
<em>John Heidemann
</em> on
<em>April
4,
2012</em> using
<a href=
"http://www.nongnu.org/texi2html/"><em>texi2html
1.82</em></a>.
2259 The buttons in the navigation panels have the following meaning:
2266 <th> From
1.2.3 go to
</th>
2269 <td align=
"center"> [
< ]
</td>
2270 <td align=
"center">Back
</td>
2271 <td>Previous section in reading order
</td>
2275 <td align=
"center"> [
> ]
</td>
2276 <td align=
"center">Forward
</td>
2277 <td>Next section in reading order
</td>
2281 <td align=
"center"> [
<< ]
</td>
2282 <td align=
"center">FastBack
</td>
2283 <td>Beginning of this chapter or previous chapter
</td>
2287 <td align=
"center"> [ Up ]
</td>
2288 <td align=
"center">Up
</td>
2293 <td align=
"center"> [
>> ]
</td>
2294 <td align=
"center">FastForward
</td>
2295 <td>Next chapter
</td>
2299 <td align=
"center"> [Top]
</td>
2300 <td align=
"center">Top
</td>
2301 <td>Cover (top) of document
</td>
2305 <td align=
"center"> [Contents]
</td>
2306 <td align=
"center">Contents
</td>
2307 <td>Table of contents
</td>
2311 <td align=
"center"> [Index]
</td>
2312 <td align=
"center">Index
</td>
2317 <td align=
"center"> [ ? ]
</td>
2318 <td align=
"center">About
</td>
2319 <td>About (help)
</td>
2325 where the
<strong> Example
</strong> assumes that the current position is at
<strong> Subsubsection One-Two-Three
</strong> of a document of the following structure:
2331 <li>1.1 Subsection One-One
2336 <li>1.2 Subsection One-Two
2338 <li>1.2.1 Subsubsection One-Two-One
</li>
2339 <li>1.2.2 Subsubsection One-Two-Two
</li>
2340 <li>1.2.3 Subsubsection One-Two-Three
2341 <strong><== Current Position
</strong></li>
2342 <li>1.2.4 Subsubsection One-Two-Four
</li>
2345 <li>1.3 Subsection One-Three
2350 <li>1.4 Subsection One-Four
</li>
2358 This document was generated by
<em>John Heidemann
</em> on
<em>April
4,
2012</em> using
<a href=
"http://www.nongnu.org/texi2html/"><em>texi2html
1.82</em></a>.