code.delx.au - gnu-emacs-elpa/blob - packages/notes-mode/HTML/notes-mode.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
   2 <html>
   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>
   8             and many others.
   9 Maintained by: Many creative people.
  10 Send bugs and suggestions to <texi2html-bug@nongnu.org>
  11 -->
  12 <head>
  13 <title>Notes-mode</title>
  14
  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">
  22 <!--
  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}
  36 -->
  37 </style>
  38
  39
  40 </head>
  41
  42 <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  43
  44 <a name="Top"></a>
  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>
  50 </tr></table>
  51 <h1 class="settitle">Notes-mode</h1>
  52
  53
  54
  55
  56
  57
  58 <table class="menu" border="0" cellspacing="0">
  59 <tr><td align="left" valign="top"><a href="#Introduction">1. Introduction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  60 </td></tr>
  61 <tr><td align="left" valign="top"><a href="#Basics">2. Basics</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  62 </td></tr>
  63 <tr><td align="left" valign="top"><a href="#Advanced-Features">3. Advanced Features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  64 </td></tr>
  65 <tr><td align="left" valign="top"><a href="#History">4. History</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  66 </td></tr>
  67 <tr><td align="left" valign="top"><a href="#Installation">5. Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  68 </td></tr>
  69 <tr><td align="left" valign="top"><a href="#Keystroke-index">Keystroke index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  70 </td></tr>
  71 <tr><td align="left" valign="top"><a href="#Concept-index">Concept index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  72 </td></tr>
  73 <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;
  74
  75 Introduction
  76
  77 </pre></th></tr><tr><td align="left" valign="top"><a href="#What-is-it_003f">1.1 What is it?</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  78 </td></tr>
  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>&nbsp;&nbsp;</td><td align="left" valign="top">
  80 </td></tr>
  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>&nbsp;&nbsp;</td><td align="left" valign="top">
  82 </td></tr>
  83 <tr><td align="left" valign="top"><a href="#Why-use-notes_002dmode_003f">1.4 Why use notes-mode?</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  84 </td></tr>
  85 <tr><td align="left" valign="top"><a href="#Y2K-Statement">1.5 Y2K Statement</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  86 </td></tr>
  87 <tr><td align="left" valign="top"><a href="#Related-work">1.6 Related work</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  88 </td></tr>
  89 <tr><td align="left" valign="top"><a href="#Staying-on-top">1.7 Staying on top</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  90 </td></tr>
  91 <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
  92 Basics
  93
  94 </pre></th></tr><tr><td align="left" valign="top"><a href="#Getting-started">2.1 Getting started</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  95 </td></tr>
  96 <tr><td align="left" valign="top"><a href="#A-notes-file">2.2 A notes file</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  97 </td></tr>
  98 <tr><td align="left" valign="top"><a href="#The-notes-index">2.3 The notes index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  99 </td></tr>
 100 <tr><td align="left" valign="top"><a href="#The-notes-directories">2.4 The notes directories</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 101 </td></tr>
 102 <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
 103 Advanced Features
 104
 105 </pre></th></tr><tr><td align="left" valign="top"><a href="#Notes-files">3.1 Notes files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 106 </td></tr>
 107 <tr><td align="left" valign="top"><a href="#Notes-indices">3.2 Notes indices</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 108 </td></tr>
 109 <tr><td align="left" valign="top"><a href="#Notes_002dmode-configuration">3.3 Notes-mode configuration</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 110 </td></tr>
 111 <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
 112 Notes files
 113
 114 </pre></th></tr><tr><td align="left" valign="top"><a href="#Getting-around">3.1.1 Getting around</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 115 </td></tr>
 116 <tr><td align="left" valign="top"><a href="#Subject-summary">3.1.2 Subject summary</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 117 </td></tr>
 118 <tr><td align="left" valign="top"><a href="#Encryption">3.1.3 Encryption</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 119 </td></tr>
 120 <tr><td align="left" valign="top"><a href="#Useful-conventions">3.1.4 Useful conventions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 121 </td></tr>
 122 <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
 123 History
 124
 125 </pre></th></tr><tr><td align="left" valign="top"><a href="#Notes_002dmode-history">4.1 Notes-mode history</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 126 </td></tr>
 127 <tr><td align="left" valign="top"><a href="#Credits">4.2 Credits</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 128 </td></tr>
 129 <tr><td align="left" valign="top"><a href="#Changes">4.3 Changes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 130 </td></tr>
 131 <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
 132 </pre></th></tr></table>
 133
 134
 135 <hr size="1">
 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"> &lt; </a>]</td>
 139 <td valign="middle" align="left">[<a href="#What-is-it_003f" title="Next section in reading order"> &gt; </a>]</td>
 140 <td valign="middle" align="left"> &nbsp; </td>
 141 <td valign="middle" align="left">[ &lt;&lt; ]</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"> &gt;&gt; </a>]</td>
 144 <td valign="middle" align="left"> &nbsp; </td>
 145 <td valign="middle" align="left"> &nbsp; </td>
 146 <td valign="middle" align="left"> &nbsp; </td>
 147 <td valign="middle" align="left"> &nbsp; </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>
 152 </tr></table>
 153 <a name="Introduction-1"></a>
 154 <h1 class="chapter">1. Introduction</h1>
 155
 156 <p>What is notes-mode and why should you (perhaps) use it?
 157 </p>
 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>&nbsp;&nbsp;</td><td align="left" valign="top">
 160 </td></tr>
 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>&nbsp;&nbsp;</td><td align="left" valign="top">
 162 </td></tr>
 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>&nbsp;&nbsp;</td><td align="left" valign="top">
 164 </td></tr>
 165 <tr><td align="left" valign="top"><a href="#Why-use-notes_002dmode_003f">1.4 Why use notes-mode?</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 166 </td></tr>
 167 <tr><td align="left" valign="top"><a href="#Y2K-Statement">1.5 Y2K Statement</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 168 </td></tr>
 169 <tr><td align="left" valign="top"><a href="#Related-work">1.6 Related work</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 170 </td></tr>
 171 <tr><td align="left" valign="top"><a href="#Staying-on-top">1.7 Staying on top</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 172 </td></tr>
 173 </table>
 174
 175 <hr size="6">
 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"> &lt; </a>]</td>
 179 <td valign="middle" align="left">[<a href="#Why-keep-notes-at-all_003f" title="Next section in reading order"> &gt; </a>]</td>
 180 <td valign="middle" align="left"> &nbsp; </td>
 181 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 184 <td valign="middle" align="left"> &nbsp; </td>
 185 <td valign="middle" align="left"> &nbsp; </td>
 186 <td valign="middle" align="left"> &nbsp; </td>
 187 <td valign="middle" align="left"> &nbsp; </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>
 192 </tr></table>
 193 <a name="What-is-it_003f-1"></a>
 194 <h2 class="section">1.1 What is it?</h2>
 195
 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.
 201 </p>
 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 &lsquo;<tt>grep</tt>&rsquo;, &lsquo;<tt>agrep</tt>&rsquo;, and &lsquo;<tt>glimpse</tt>&rsquo;
 205 already allow file search.)
 206 </p>
 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 (&lsquo;<tt>http://www.yahoo.com/</tt>&rsquo;) is an index,
 213 while Alta Vista (&lsquo;<tt>http://www.altavista.digital.com/</tt>&rsquo;)
 214 is a search-engine.
 215 In (potentially) more familiar terms,
 216 the yellow pages
 217 <a name="DOCF1" href="#FOOT1">(1)</a>
 218 are an index,
 219 while directory information (411 in the USA)
 220 is sort of a search-engine.
 221 </p>
 222
 223 <hr size="6">
 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"> &lt; </a>]</td>
 227 <td valign="middle" align="left">[<a href="#Why-keep-notes-on_002dline_003f" title="Next section in reading order"> &gt; </a>]</td>
 228 <td valign="middle" align="left"> &nbsp; </td>
 229 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 232 <td valign="middle" align="left"> &nbsp; </td>
 233 <td valign="middle" align="left"> &nbsp; </td>
 234 <td valign="middle" align="left"> &nbsp; </td>
 235 <td valign="middle" align="left"> &nbsp; </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>
 240 </tr></table>
 241 <a name="Why-keep-notes-at-all_003f-1"></a>
 242 <h2 class="section">1.2 Why keep notes at all?</h2>
 243
 244 <p>So why should you use notes-mode?
 245 Well, first, consider why you should (perhaps)
 246 keep your notes on line.
 247 First,
 248 I assume that you take notes as part of your work or school.
 249 If you don&rsquo;t,
 250 you can stop reading now and go back to watching TV.
 251 </p>
 252 <p>If you keep notes, ask yourself why you keep them.
 253 Reasons vary for different people, but some include:
 254 </p>
 255 <ul>
 256 <li>
 257 To remember what is said or done.
 258
 259 </li><li>
 260 To focus on what is important about what is said.
 261
 262 </li><li>
 263 To provide proof of having done something
 264 at a particular time or date.
 265
 266 </li><li>
 267 I know there were other reasons here,
 268 but they slipped my mind.
 269 </li></ul>
 270
 271
 272 <hr size="6">
 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"> &lt; </a>]</td>
 276 <td valign="middle" align="left">[<a href="#Why-use-notes_002dmode_003f" title="Next section in reading order"> &gt; </a>]</td>
 277 <td valign="middle" align="left"> &nbsp; </td>
 278 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 281 <td valign="middle" align="left"> &nbsp; </td>
 282 <td valign="middle" align="left"> &nbsp; </td>
 283 <td valign="middle" align="left"> &nbsp; </td>
 284 <td valign="middle" align="left"> &nbsp; </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>
 289 </tr></table>
 290 <a name="Why-keep-notes-on_002dline_003f-1"></a>
 291 <h2 class="section">1.3 Why keep notes on-line?</h2>
 292
 293 <p>OK, I&rsquo;ve talked you into keeping notes.
 294 Why do it on-line?
 295 Again, there are different reasons for different people.
 296 If you don&rsquo;t want to consider keeping your notes on-line,
 297 you&rsquo;re welcome to go back to your (clay tablets)
 298 paper notes.
 299 </p>
 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.
 303 </p>
 304 <ul>
 305 <li>
 306 It&rsquo;s faster to type than write,
 307 and possibly more legible at high speed.
 308
 309 </li><li>
 310 Often information is already on-line.
 311 For example, in software development, bug reports,
 312 measurement results, and everything else that&rsquo;s useful
 313 is on-line.
 314
 315 </li><li>
 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.
 320
 321 </li><li>
 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.
 327
 328 </li><li>
 329 On-line notes are easy to index.
 330 (At least with notes-mode!)
 331 In addition to full-text search,
 332 it&rsquo;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?).
 336
 337 </li><li>
 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&rsquo;s hard disk,
 343 an extraordinarily compact medium
 344 by comparison.
 345
 346 </li><li>
 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&rsquo;t you?)
 356
 357 </li></ul>
 358
 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.
 363 </p>
 364 <ul>
 365 <li>
 366 If you don&rsquo;t have a computer with you most of the time,
 367 it&rsquo;s difficult take notes on-line (because you&rsquo;re off-line, of course).
 368 <a name="DOCF2" href="#FOOT2">(2)</a>
 369
 370 </li><li>
 371 Computers require power.
 372 If your portable computer runs out of juice,
 373 you&rsquo;re on your own.
 374 Corollary:  watch your power, or bring paper.
 375 Better corollary:  watch your power, <em>and</em> bring paper.
 376
 377 </li><li>
 378 Social limitations.
 379 It&rsquo;s not always socially acceptable to take notes-on-line.
 380 For example,
 381 at a party,
 382 few people would use a computer
 383 to take down the phone number of a person
 384 to whom they&rsquo;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.
 388
 389 </li><li>
 390 Health issues.
 391 Repetitive stress injuries do occur
 392 writing (slower) by hand is at least
 393 an alternate motion than typing.
 394
 395 </li><li>
 396 Legal limitations.
 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>
 402
 403 </li></ul>
 404
 405
 406 <hr size="6">
 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"> &lt; </a>]</td>
 410 <td valign="middle" align="left">[<a href="#Y2K-Statement" title="Next section in reading order"> &gt; </a>]</td>
 411 <td valign="middle" align="left"> &nbsp; </td>
 412 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 415 <td valign="middle" align="left"> &nbsp; </td>
 416 <td valign="middle" align="left"> &nbsp; </td>
 417 <td valign="middle" align="left"> &nbsp; </td>
 418 <td valign="middle" align="left"> &nbsp; </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>
 423 </tr></table>
 424 <a name="Why-use-notes_002dmode_003f-1"></a>
 425 <h2 class="section">1.4 Why use notes-mode?</h2>
 426
 427 <p>OK, I&rsquo;ve sold you on note-taking and even on on-line note-taking.
 428 What about notes-mode?
 429 Naturally,
 430 it slices, dices, and makes julienne fries.
 431 But wait, there&rsquo;s more:
 432 </p>
 433 <ul>
 434 <li>
 435 It automates indexing your notes,
 436 linking notes with the same subject together.
 437
 438 </li><li>
 439 It supports embedded links,
 440 allowing you to manually link together different topics
 441 and external files.
 442
 443 </li><li>
 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.
 447
 448 </li><li>
 449 Notes containing sensitive information can be encrypted.
 450
 451 </li><li>
 452 Notes-mode seems better than the other, currently available alternatives.
 453 </li></ul>
 454
 455 <p>What are the alternatives?  I&rsquo;m glad you asked.
 456 <a name="DOCF5" href="#FOOT5">(5)</a>
 457 </p>
 458 <ul>
 459 <li>
 460 <strong>HTML</strong>.
 461 HTML has better formatting capabilities than notes-mode,
 462 and it has excellent linking capabilities.
 463 Unfortunately,
 464 HTML&rsquo;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&rsquo;s no automatic indexing feature
 469  (at least with plain HTML).
 470 Besides,
 471  all data should be kept as close to the ASCII from whence it came,
 472  as God Intended (hi, Steve).
 473
 474 </li><li>
 475 <strong>Word Processors</strong>.
 476 Word processors are strong in the formatting department,
 477  but most don&rsquo;t really have linking capabilities,
 478  and have poor or restricted indexing.
 479
 480 </li></ul>
 481
 482 <hr size="6">
 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"> &lt; </a>]</td>
 486 <td valign="middle" align="left">[<a href="#Related-work" title="Next section in reading order"> &gt; </a>]</td>
 487 <td valign="middle" align="left"> &nbsp; </td>
 488 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 491 <td valign="middle" align="left"> &nbsp; </td>
 492 <td valign="middle" align="left"> &nbsp; </td>
 493 <td valign="middle" align="left"> &nbsp; </td>
 494 <td valign="middle" align="left"> &nbsp; </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>
 499 </tr></table>
 500 <a name="Y2K-Statement-1"></a>
 501 <h2 class="section">1.5 Y2K Statement</h2>
 502
 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
 506  the year 2038.
 507 </p>
 508 <p>To avoid problems with the year 2000, notes-mode assumes
 509  that any two-digit years before &ldquo;70&rdquo; are 20xx, not 19xx.
 510 Notes-mode should therefore work correctly in both the year 1999 and 2000.
 511 </p>
 512 <p>(Notes-mode 1.17 released February 1999 fixes a lingering Y2K problem.)
 513 </p>
 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.
 516 </p>
 517 <p>If I&rsquo;m still using notes-mode then on a 32-bit machine I&rsquo;ll see what I can do.
 518 </p>
 519
 520 <hr size="6">
 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"> &lt; </a>]</td>
 524 <td valign="middle" align="left">[<a href="#Staying-on-top" title="Next section in reading order"> &gt; </a>]</td>
 525 <td valign="middle" align="left"> &nbsp; </td>
 526 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 529 <td valign="middle" align="left"> &nbsp; </td>
 530 <td valign="middle" align="left"> &nbsp; </td>
 531 <td valign="middle" align="left"> &nbsp; </td>
 532 <td valign="middle" align="left"> &nbsp; </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>
 537 </tr></table>
 538 <a name="Related-work-1"></a>
 539 <h2 class="section">1.6 Related work</h2>
 540
 541 <p>What would a document be without related work?
 542 </p>
 543 <p>Notes-mode is not related in any way to Lotus Notes.
 544 </p>
 545 <p>I am told (by David Weisman)
 546  that it&rsquo;s something like the now defunct Lotus Agenda.
 547 </p>
 548 <p>Ashvin Goel, one of the contributors to notes-mode,
 549  has gone off and done a from-scratch reimplementation
 550  called records-mode.
 551 It&rsquo;s very similar to notes mode,
 552  and emphasizes on-the-fly updates to entry links
 553  but lacks a manual.
 554 You may want to check it out at
 555  &lsquo;<tt>http://www.cse.ogi.edu/~ashvin/software.html</tt>&rsquo;.
 556 </p>
 557 <p>Hyperbole (by Bob Weiner) offers better linking facilities
 558 than notes-mode, but it has a bunch of stuff notes-mode doesn&rsquo;t need
 559 and it&rsquo;s missing notes-specific indexing provided by notes-mode.
 560 For people already using Hyperbole
 561  it would be interesting to replace notes-mode&rsquo;s linking
 562  with Hyperbole&rsquo;s.
 563 Contributions in this area are welcome, provided they make Hyperbole
 564  optional.
 565 </p>
 566 <hr size="6">
 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"> &lt; </a>]</td>
 570 <td valign="middle" align="left">[<a href="#Basics" title="Next section in reading order"> &gt; </a>]</td>
 571 <td valign="middle" align="left"> &nbsp; </td>
 572 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 575 <td valign="middle" align="left"> &nbsp; </td>
 576 <td valign="middle" align="left"> &nbsp; </td>
 577 <td valign="middle" align="left"> &nbsp; </td>
 578 <td valign="middle" align="left"> &nbsp; </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>
 583 </tr></table>
 584 <a name="Staying-on-top-1"></a>
 585 <h2 class="section">1.7 Staying on top</h2>
 586
 587 <p>The most recent distribution of notes-mode
 588  is always available via
 589  &lsquo;<tt>http://www.isi.edu/~johnh/SOFTWARE/NOTES_MODE/</tt>&rsquo;.
 590 </p>
 591 <p>After you&rsquo;ve installed notes mode you&rsquo;re encouraged to subscribe
 592 to the mailing lists.
 593 To subscribe, go to the web page
 594 Send the message &quot;subscribe&quot; to
 595 &lsquo;<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-announce</tt>&rsquo; or
 596 &lsquo;<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-talk</tt>&rsquo;.
 597 </p>
 598 <p>The announce list will contain only release announcements
 599 and so is guaranteed to be very low bandwidth.
 600 </p>
 601
 602
 603 <hr size="6">
 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"> &lt; </a>]</td>
 607 <td valign="middle" align="left">[<a href="#Getting-started" title="Next section in reading order"> &gt; </a>]</td>
 608 <td valign="middle" align="left"> &nbsp; </td>
 609 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 612 <td valign="middle" align="left"> &nbsp; </td>
 613 <td valign="middle" align="left"> &nbsp; </td>
 614 <td valign="middle" align="left"> &nbsp; </td>
 615 <td valign="middle" align="left"> &nbsp; </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>
 620 </tr></table>
 621 <a name="Basics-1"></a>
 622 <h1 class="chapter">2. Basics</h1>
 623
 624 <p>All you need to use notes-mode
 625  in a chapter.
 626 (Except for installation, See section <a href="#Installation">Installation</a>.)
 627 </p>
 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>&nbsp;&nbsp;</td><td align="left" valign="top">
 630 </td></tr>
 631 <tr><td align="left" valign="top"><a href="#A-notes-file">2.2 A notes file</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 632 </td></tr>
 633 <tr><td align="left" valign="top"><a href="#The-notes-index">2.3 The notes index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 634 </td></tr>
 635 <tr><td align="left" valign="top"><a href="#The-notes-directories">2.4 The notes directories</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 636 </td></tr>
 637 </table>
 638
 639 <hr size="6">
 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"> &lt; </a>]</td>
 643 <td valign="middle" align="left">[<a href="#A-notes-file" title="Next section in reading order"> &gt; </a>]</td>
 644 <td valign="middle" align="left"> &nbsp; </td>
 645 <td valign="middle" align="left">[<a href="#Basics" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 648 <td valign="middle" align="left"> &nbsp; </td>
 649 <td valign="middle" align="left"> &nbsp; </td>
 650 <td valign="middle" align="left"> &nbsp; </td>
 651 <td valign="middle" align="left"> &nbsp; </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>
 656 </tr></table>
 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>
 661
 662 <p>To get started with notes-mode,
 663  read the introduction this chapter,
 664  then either:
 665 </p>
 666 <ul>
 667 <li>
 668 Start emacs, do
 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.
 671
 672 </li><li>
 673 OR, from the shell,
 674  run the program &lsquo;<tt>notesinit</tt>&rsquo;.
 675 This approach will ask you some questions about how you want to configure
 676  notes mode.
 677
 678 </li></ul>
 679
 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.
 683 </p>
 684 <p>After you&rsquo;ve done one of these,
 685  start up emacs and note-away.
 686 I usually begin a
 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&rsquo;s note.
 690 You may even wish to bind this to something,
 691  perhaps with
 692  <code>(define-key global-map &quot;\C-cn&quot; 'notes-index-todays-link)</code>
 693  in your &lsquo;<tt>.emacs</tt>&rsquo;.
 694 </p>
 695 <p>If you want to browse your existing notes,
 696  you might instead want to edit the
 697  &lsquo;<tt>~/NOTES/index</tt>&rsquo;.
 698 (What is a notes file and the index? Hurry up and finish
 699  reading this chapter.)
 700 </p>
 701
 702 <hr size="6">
 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"> &lt; </a>]</td>
 706 <td valign="middle" align="left">[<a href="#The-notes-index" title="Next section in reading order"> &gt; </a>]</td>
 707 <td valign="middle" align="left"> &nbsp; </td>
 708 <td valign="middle" align="left">[<a href="#Basics" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 711 <td valign="middle" align="left"> &nbsp; </td>
 712 <td valign="middle" align="left"> &nbsp; </td>
 713 <td valign="middle" align="left"> &nbsp; </td>
 714 <td valign="middle" align="left"> &nbsp; </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>
 719 </tr></table>
 720 <a name="A-notes-file-1"></a>
 721 <h2 class="section">2.2 A notes file</h2>
 722
 723 <a name="index-Notes-files"></a>
 724
 725 <p>The notes file is the focus of most of the activity in notes-mode,
 726  it&rsquo;s where you take your notes.
 727 Notes files are mostly free-form text
 728  broken up into <em>entries</em>.
 729 Here&rsquo;s an example:
 730 </p>
 731 <a name="index-Notes-entries"></a>
 732
 733 <table><tr><td>&nbsp;</td><td><pre class="example">8-Jun-95 Thursday
 734 -----------------
 735
 736 * Today
 737 -------
 738 prev: &lt;none&gt;
 739 next: &lt;file:///~/NOTES/199506/950609#* Today&gt;
 740
 741 next week - release notes-mode
 742
 743
 744 * Environment/notes
 745 -------------------
 746
 747 I explained notes mode to Ashvin and Geoff.
 748 ...
 749 </pre></td></tr></table>
 750
 751 <p>Each entry has a subject-block, (maybe) some links, and then (maybe) some text.
 752 </p>
 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&rsquo;re not exact, that&rsquo;s OK;
 757  notes-mode will fix them periodically).
 758 For convenience,
 759  notes-mode will automatically add the underlines when you
 760  hit <kbd>&lt;RTN&gt;</kbd> (<code>notes-electric-return</code>),
 761  and <kbd>&lt;TAB&gt;</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>
 766 </p>
 767 <p>Following the subject may be links.
 768 (In the example, the &ldquo;Today&rdquo; entry has links,
 769  the &ldquo;Environment/notes&rdquo; entry doesn&rsquo;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>
 774 </p>
 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>
 783 </p>
 784 <p>Finally comes the text.
 785 Go wild, but just don&rsquo;t include text that looks like a subject.
 786 You can embed pseudo-URLs to link notes together manually.
 787 </p>
 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.
 791 These lines are
 792  <em>front matter</em>.
 793 They&rsquo;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>
 797 </p>
 798 <p>There are a number of useful conventions
 799  that can be adopted to organize your notes.
 800 The most common is the &ldquo;Today&rdquo; 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.
 807 </p>
 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 &lsquo;Outline Mode&rsquo; in <cite>The Emacs Editor</cite>, for details.
 813 </p>
 814 <hr size="6">
 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"> &lt; </a>]</td>
 818 <td valign="middle" align="left">[<a href="#The-notes-directories" title="Next section in reading order"> &gt; </a>]</td>
 819 <td valign="middle" align="left"> &nbsp; </td>
 820 <td valign="middle" align="left">[<a href="#Basics" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 823 <td valign="middle" align="left"> &nbsp; </td>
 824 <td valign="middle" align="left"> &nbsp; </td>
 825 <td valign="middle" align="left"> &nbsp; </td>
 826 <td valign="middle" align="left"> &nbsp; </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>
 831 </tr></table>
 832 <a name="The-notes-index-1"></a>
 833 <h2 class="section">2.3 The notes index</h2>
 834
 835 <a name="index-Notes-index"></a>
 836
 837 <p>The notes index lists all subjects you&rsquo;ve kept notes about,
 838  and each date of each note.
 839 Impress your friends,
 840  show your advisor why you&rsquo;re worth the <em>big</em> peanuts,
 841  you&rsquo;ll soon have the biggest index of all.
 842 </p>
 843 <p>The index has one line per subject, listing the subject
 844  and each day a note was made about that subject.
 845 For example:
 846 </p>
 847 <table><tr><td>&nbsp;</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>
 852
 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>&lt;RTN&gt;</kbd>
 857  if you&rsquo;re musaphobic [<code>notes-index-follow-link</code>].)
 858 <a name="index-mouse_002d2"></a>
 859 <a name="index-RTN-1"></a>
 860 </p>
 861 <p>The notes index is automatically updated by the program &lsquo;<tt>mkall</tt>&rsquo;.
 862 Typically &lsquo;<tt>mkall</tt>&rsquo; is run nightly by &lsquo;<tt>cron</tt>&rsquo;.
 863 On most modern versions of Unix, you can add this command to cron by
 864  running &lsquo;<tt>crontab -e</tt>&rsquo; and adding the line:
 865 </p>
 866 <table><tr><td>&nbsp;</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>
 871
 872 <p>(Assuming that your notes programs are installed
 873  in /usr/local/lib/notes-mode, the default location.)
 874 </p>
 875
 876 <hr size="6">
 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"> &lt; </a>]</td>
 880 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Next section in reading order"> &gt; </a>]</td>
 881 <td valign="middle" align="left"> &nbsp; </td>
 882 <td valign="middle" align="left">[<a href="#Basics" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 885 <td valign="middle" align="left"> &nbsp; </td>
 886 <td valign="middle" align="left"> &nbsp; </td>
 887 <td valign="middle" align="left"> &nbsp; </td>
 888 <td valign="middle" align="left"> &nbsp; </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>
 893 </tr></table>
 894 <a name="The-notes-directories-1"></a>
 895 <h2 class="section">2.4 The notes directories</h2>
 896
 897 <a name="index-Notes-directories"></a>
 898 <a name="index-Directory-hierarchy"></a>
 899
 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.
 904 </p>
 905 <p>Notes-mode keeps its files in a two-level hierarchy:
 906 </p>
 907 <table><tr><td>&nbsp;</td><td><pre class="example">~/NOTES
 908 ~/NOTES/index
 909 ~/NOTES/rawindex
 910 ~/NOTES/199603
 911 ~/NOTES/199603/960329
 912 ~/NOTES/199603/960330
 913 ~/NOTES/199604
 914 ~/NOTES/199604/960401
 915 </pre></td></tr></table>
 916
 917 <p>The top level, &lsquo;<tt>~/NOTES</tt>&rsquo;, 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>.)
 920 </p>
 921 <p>Inside the notes directory are two files and a number of directories.
 922 The files are &lsquo;<tt>index</tt>&rsquo;,
 923  the index of all entries (see section <a href="#The-notes-index">The notes index</a>),
 924  and &lsquo;<tt>rawindex</tt>&rsquo;,
 925  used internally.
 926 <a name="index-Root-directory"></a>
 927 </p>
 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>
 938 </p>
 939 <p>Finally,
 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>
 943 </p>
 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>
 954 </p>
 955
 956
 957 <hr size="6">
 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"> &lt; </a>]</td>
 961 <td valign="middle" align="left">[<a href="#Notes-files" title="Next section in reading order"> &gt; </a>]</td>
 962 <td valign="middle" align="left"> &nbsp; </td>
 963 <td valign="middle" align="left">[<a href="#Basics" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 966 <td valign="middle" align="left"> &nbsp; </td>
 967 <td valign="middle" align="left"> &nbsp; </td>
 968 <td valign="middle" align="left"> &nbsp; </td>
 969 <td valign="middle" align="left"> &nbsp; </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>
 974 </tr></table>
 975 <a name="Advanced-Features-1"></a>
 976 <h1 class="chapter">3. Advanced Features</h1>
 977
 978 <p>Notes-mode, the minutiae, and some other good stuff.
 979 </p>
 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>&nbsp;&nbsp;</td><td align="left" valign="top">
 982 </td></tr>
 983 <tr><td align="left" valign="top"><a href="#Notes-indices">3.2 Notes indices</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 984 </td></tr>
 985 <tr><td align="left" valign="top"><a href="#Notes_002dmode-configuration">3.3 Notes-mode configuration</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 986 </td></tr>
 987 </table>
 988
 989 <hr size="6">
 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"> &lt; </a>]</td>
 993 <td valign="middle" align="left">[<a href="#Getting-around" title="Next section in reading order"> &gt; </a>]</td>
 994 <td valign="middle" align="left"> &nbsp; </td>
 995 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
 998 <td valign="middle" align="left"> &nbsp; </td>
 999 <td valign="middle" align="left"> &nbsp; </td>
1000 <td valign="middle" align="left"> &nbsp; </td>
1001 <td valign="middle" align="left"> &nbsp; </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>
1006 </tr></table>
1007 <a name="Notes-files-1"></a>
1008 <h2 class="section">3.1 Notes files</h2>
1009
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>&nbsp;&nbsp;</td><td align="left" valign="top">
1012 </td></tr>
1013 <tr><td align="left" valign="top"><a href="#Subject-summary">3.1.2 Subject summary</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
1014 </td></tr>
1015 <tr><td align="left" valign="top"><a href="#Encryption">3.1.3 Encryption</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
1016 </td></tr>
1017 <tr><td align="left" valign="top"><a href="#Useful-conventions">3.1.4 Useful conventions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
1018 </td></tr>
1019 </table>
1020
1021 <hr size="6">
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"> &lt; </a>]</td>
1025 <td valign="middle" align="left">[<a href="#Subject-summary" title="Next section in reading order"> &gt; </a>]</td>
1026 <td valign="middle" align="left"> &nbsp; </td>
1027 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1030 <td valign="middle" align="left"> &nbsp; </td>
1031 <td valign="middle" align="left"> &nbsp; </td>
1032 <td valign="middle" align="left"> &nbsp; </td>
1033 <td valign="middle" align="left"> &nbsp; </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>
1038 </tr></table>
1039 <a name="Getting-around-1"></a>
1040 <h3 class="subsection">3.1.1 Getting around</h3>
1041
1042 <p>Moving between notes entries and around the hierarchy is fairly common,
1043  so there are some accelerators.
1044 </p>
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&rsquo;s subject
1048 (<code>notes-goto-index-entry</code>).
1049 <a name="index-C_002dc-C_002di"></a>
1050 </p>
1051 </dd>
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&rsquo;re defined.
1058 If not,
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>
1066 </p>
1067 </dd>
1068 <dt> <kbd>C-c&lt;RTN&gt;</kbd></dt>
1069 <dd><p>Follow the link under the point
1070 (<code>notes-w3-follow-link</code>),
1071  a keyboard equivalent of &lt;S-mouse-2&gt;.
1072 <a name="index-C_002dcRTN"></a>
1073 </p>
1074 </dd>
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>
1081 </p>
1082 </dd>
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>
1091 </p>
1092 </dd>
1093 </dl>
1094
1095
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>
1100 </p>
1101
1102 <hr size="6">
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"> &lt; </a>]</td>
1106 <td valign="middle" align="left">[<a href="#Encryption" title="Next section in reading order"> &gt; </a>]</td>
1107 <td valign="middle" align="left"> &nbsp; </td>
1108 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1111 <td valign="middle" align="left"> &nbsp; </td>
1112 <td valign="middle" align="left"> &nbsp; </td>
1113 <td valign="middle" align="left"> &nbsp; </td>
1114 <td valign="middle" align="left"> &nbsp; </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>
1119 </tr></table>
1120 <a name="Subject-summary-1"></a>
1121 <h3 class="subsection">3.1.2 Subject summary</h3>
1122
1123 <p>It&rsquo;s often helpful to look at all
1124  entries for a given subject
1125 <kbd>C-c C-s</kbd>
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>
1131 </p>
1132
1133 <hr size="6">
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"> &lt; </a>]</td>
1137 <td valign="middle" align="left">[<a href="#Useful-conventions" title="Next section in reading order"> &gt; </a>]</td>
1138 <td valign="middle" align="left"> &nbsp; </td>
1139 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1142 <td valign="middle" align="left"> &nbsp; </td>
1143 <td valign="middle" align="left"> &nbsp; </td>
1144 <td valign="middle" align="left"> &nbsp; </td>
1145 <td valign="middle" align="left"> &nbsp; </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>
1150 </tr></table>
1151 <a name="Encryption-1"></a>
1152 <h3 class="subsection">3.1.3 Encryption</h3>
1153
1154 <a name="index-Encryption"></a>
1155 <a name="index-Decryption"></a>
1156
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.
1162 In such systems,
1163  properly used encryption is the best approach to security.
1164 </p>
1165 <p>Notes-mode encryption is based
1166  Phill Zimmerman&rsquo;s PGP (Pretty Good Privacy)
1167 (see &lsquo;<tt>http://www.mantis.co.uk/pgp/pgp.html</tt>&rsquo;)
1168  and either
1169  with Rick Campbell&rsquo;s
1170  emacs interface, PAM (PGP Augmented Messaging)
1171 (from &lsquo;<tt>ftp://h.gp.cs.cmu.edu/usr/rfb/pam/</tt>&rsquo;)
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&rsquo;s mailcrypt
1175 (from &lsquo;<tt>http://cag-www.lcs.mit.edu/mailcrypt/</tt>&rsquo;).
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>
1181 </p>
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>
1190 </p>
1191 </dd>
1192 <dt> <kbd>C-c C-d</kbd></dt>
1193 <dd><p>Decrypt the current note
1194 (<code>notes-decrypt-note</code>).
1195 </p></dd>
1196 </dl>
1197 <a name="index-C_002dc-C_002dd"></a>
1198
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>
1205 </p>
1206
1207 <hr size="6">
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"> &lt; </a>]</td>
1211 <td valign="middle" align="left">[<a href="#Notes-indices" title="Next section in reading order"> &gt; </a>]</td>
1212 <td valign="middle" align="left"> &nbsp; </td>
1213 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1216 <td valign="middle" align="left"> &nbsp; </td>
1217 <td valign="middle" align="left"> &nbsp; </td>
1218 <td valign="middle" align="left"> &nbsp; </td>
1219 <td valign="middle" align="left"> &nbsp; </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>
1224 </tr></table>
1225 <a name="Useful-conventions-1"></a>
1226 <h3 class="subsection">3.1.4 Useful conventions</h3>
1227
1228
1229 <a name="index-conventions"></a>
1230 <a name="index-mknew"></a>
1231
1232 <p>There are a number of conventions which can make notes-mode
1233  easier to use.
1234 These conventions are a matter of personal taste,
1235  of course.
1236 Do what works for you.
1237 </p>
1238 <p>First,
1239  I find it helpful to keep the date of each notes-file at the top
1240  of the file.
1241 This makes the file self-identifying
1242  if the filename is lost.
1243 </p>
1244 <p>Second,
1245  I find it useful to have the first entry of each file
1246  have the same subject (perhaps &ldquo;Today&rdquo;).
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>
1252 </p>
1253 <p>A third useful convention is to keep an
1254  entry with the name based on the day of the week
1255  in each file.
1256 Analogous to &ldquo;Today&rdquo;, this entry links together
1257  weeks.
1258 </p>
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.
1264 Currently
1265  the approach to do this process
1266  (in the program &lsquo;<tt>mknew</tt>&rsquo;)
1267  is fairly sensitive,
1268  so it may not work in all cases.
1269 In particular,
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&rsquo;ll work with you to fix this limitation.)
1274 </p>
1275 <p>If you find other helpful conventions,
1276  please let me know.
1277 Modifications to &lsquo;<tt>mknew</tt>&rsquo; to implement
1278  new conventions are also invited.
1279 </p>
1280 <p>If you don&rsquo;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>
1285 </p>
1286
1287 <hr size="6">
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"> &lt; </a>]</td>
1291 <td valign="middle" align="left">[<a href="#Notes_002dmode-configuration" title="Next section in reading order"> &gt; </a>]</td>
1292 <td valign="middle" align="left"> &nbsp; </td>
1293 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1296 <td valign="middle" align="left"> &nbsp; </td>
1297 <td valign="middle" align="left"> &nbsp; </td>
1298 <td valign="middle" align="left"> &nbsp; </td>
1299 <td valign="middle" align="left"> &nbsp; </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>
1304 </tr></table>
1305 <a name="Notes-indices-1"></a>
1306 <h2 class="section">3.2 Notes indices</h2>
1307
1308
1309 <p>Only two features of notes index mode haven&rsquo;t yet been described.
1310 First,
1311  you can open any notes-file based on date
1312  with <code>notes-index-link</code>,
1313  normally bound to &lt;o&gt;.
1314 <a name="index-o"></a>
1315 </p>
1316 <p>Second,
1317  you can get a subject-summary
1318  with &lt;C-c C-s&gt;
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>
1322 </p>
1323
1324 <hr size="6">
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"> &lt; </a>]</td>
1328 <td valign="middle" align="left">[<a href="#History" title="Next section in reading order"> &gt; </a>]</td>
1329 <td valign="middle" align="left"> &nbsp; </td>
1330 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1333 <td valign="middle" align="left"> &nbsp; </td>
1334 <td valign="middle" align="left"> &nbsp; </td>
1335 <td valign="middle" align="left"> &nbsp; </td>
1336 <td valign="middle" align="left"> &nbsp; </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>
1341 </tr></table>
1342 <a name="Notes_002dmode-configuration-1"></a>
1343 <h2 class="section">3.3 Notes-mode configuration</h2>
1344
1345 <a name="index-configuration"></a>
1346 <a name="index-_002enotesrc"></a>
1347
1348 <p>Several aspects of notes mode are particularly visible
1349  to the user.
1350 Because I&rsquo;m not a fascist,
1351  a user can change most of these.
1352 </p>
1353 <p>Preferences are specified in &lsquo;<tt>~/.notesrc</tt>&rsquo;.
1354 This file lists things to change:
1355 </p>
1356 <table><tr><td>&nbsp;</td><td><pre class="example"># lines beginning with a hash are comments
1357 dir: ~/NOTES
1358 int_form: %Y%m
1359 </pre></td></tr></table>
1360
1361 <p>Currently, two things can be changed:
1362 </p>
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>).
1367 </p>
1368 </dd>
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.
1373 </p></dd>
1374 </dl>
1375
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.
1380 </p>
1381 </dd>
1382 <dt> <code>%y</code></dt>
1383 <dd><p>The two-digit year.
1384 </p>
1385 </dd>
1386 <dt> <code>%m</code></dt>
1387 <dd><p>A two-digit numeric month.
1388 </p>
1389 </dd>
1390 <dt> <code>%d</code></dt>
1391 <dd><p>A two-digit day.
1392 </p></dd>
1393 </dl>
1394
1395 <p>In addition to &lsquo;<tt>.notesrc</tt>&rsquo;,
1396  there are a number of emacs-specific variables.
1397 These variables are documented in the file
1398  &lsquo;<tt>notes-variables.el</tt>&rsquo;.
1399 </p>
1400
1401
1402
1403 <hr size="6">
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"> &lt; </a>]</td>
1407 <td valign="middle" align="left">[<a href="#Notes_002dmode-history" title="Next section in reading order"> &gt; </a>]</td>
1408 <td valign="middle" align="left"> &nbsp; </td>
1409 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1412 <td valign="middle" align="left"> &nbsp; </td>
1413 <td valign="middle" align="left"> &nbsp; </td>
1414 <td valign="middle" align="left"> &nbsp; </td>
1415 <td valign="middle" align="left"> &nbsp; </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>
1420 </tr></table>
1421 <a name="History-1"></a>
1422 <h1 class="chapter">4. History</h1>
1423
1424 <p>More about notes-mode than you wanted to know,
1425 and some thanks.
1426 </p>
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>&nbsp;&nbsp;</td><td align="left" valign="top">
1429 </td></tr>
1430 <tr><td align="left" valign="top"><a href="#Credits">4.2 Credits</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
1431 </td></tr>
1432 <tr><td align="left" valign="top"><a href="#Changes">4.3 Changes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
1433 </td></tr>
1434 <tr><td align="left" valign="top"><a href="#Suggested-features">4.4 Suggested features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
1435 </td></tr>
1436 </table>
1437
1438
1439
1440 <hr size="6">
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"> &lt; </a>]</td>
1444 <td valign="middle" align="left">[<a href="#Credits" title="Next section in reading order"> &gt; </a>]</td>
1445 <td valign="middle" align="left"> &nbsp; </td>
1446 <td valign="middle" align="left">[<a href="#History" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1449 <td valign="middle" align="left"> &nbsp; </td>
1450 <td valign="middle" align="left"> &nbsp; </td>
1451 <td valign="middle" align="left"> &nbsp; </td>
1452 <td valign="middle" align="left"> &nbsp; </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>
1457 </tr></table>
1458 <a name="Notes_002dmode-history-1"></a>
1459 <h2 class="section">4.1 Notes-mode history</h2>
1460
1461 <p>Briefly,
1462  I started keeping notes on-line shortly after I got a portable computer
1463  in January, 1994.
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.
1467 </p>
1468 <p>In June of 1995
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.
1475 </p>
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.
1480 </p>
1481
1482 <hr size="6">
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"> &lt; </a>]</td>
1486 <td valign="middle" align="left">[<a href="#Changes" title="Next section in reading order"> &gt; </a>]</td>
1487 <td valign="middle" align="left"> &nbsp; </td>
1488 <td valign="middle" align="left">[<a href="#History" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1491 <td valign="middle" align="left"> &nbsp; </td>
1492 <td valign="middle" align="left"> &nbsp; </td>
1493 <td valign="middle" align="left"> &nbsp; </td>
1494 <td valign="middle" align="left"> &nbsp; </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>
1499 </tr></table>
1500 <a name="Credits-1"></a>
1501 <h2 class="section">4.2 Credits</h2>
1502
1503 <p>I (John Heidemann, &lt;johnh@isi.edu&gt;)
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&rsquo;t let others change.
1507 </p>
1508 <p>Ashvin Goel
1509  &lt;ashvin@ficus.cs.ucla.edu&gt;
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,
1518  and
1519  context-sensitive mouse-2 handling.
1520 In addition,
1521  he is an invaluable second opinion about
1522  what and how things should be done
1523  (even if I don&rsquo;t always agree with him).
1524 </p>
1525 <p>Geoff Kuenning
1526  &lt;geoff@ficus.cs.ucla.edu&gt;
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.
1535 </p>
1536 <p>Ramesh Govindan &lt;govindan@isi.edu&gt; did the xemacs port.
1537 </p>
1538 <p>Since it&rsquo;s release on Usenet in April 1996 several
1539  other folks have contributed.
1540 Thanks to
1541  David Weisman &lt;weisman@app1.osf.org&gt;,
1542  Martin L. Smith &lt;martin@ner.com&gt;,
1543  Jason Bastek &lt;jason@aai.com&gt;,
1544  Ulrich Herbst &lt;Ulrich.Herbst@t-systems.com&gt;.
1545 See the next section (See section <a href="#Changes">Changes</a>.) for details of their exploits.
1546 </p>
1547 <p>Thanks to Larry Ayers &lt;layers@marktwain.net&gt;
1548  for popularizing notes-mode with reviews in
1549  the Linux Gazette
1550  (at &lt;http://www.linuxgazette.com/issue22/notes-mode.html&gt; and
1551  &lt;http://www.linuxgazette.com/issue35/ayers.html&gt;).
1552 </p>
1553 <hr size="6">
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"> &lt; </a>]</td>
1557 <td valign="middle" align="left">[<a href="#Suggested-features" title="Next section in reading order"> &gt; </a>]</td>
1558 <td valign="middle" align="left"> &nbsp; </td>
1559 <td valign="middle" align="left">[<a href="#History" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1562 <td valign="middle" align="left"> &nbsp; </td>
1563 <td valign="middle" align="left"> &nbsp; </td>
1564 <td valign="middle" align="left"> &nbsp; </td>
1565 <td valign="middle" align="left"> &nbsp; </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>
1570 </tr></table>
1571 <a name="Changes-1"></a>
1572 <h2 class="section">4.3 Changes</h2>
1573
1574 <p>For the bored:
1575 </p>
1576 <p>First semi-public release. 12-Jul-95: version 0.1
1577  Shared a version with Ashvin and Geoff.
1578 </p>
1579 <p>Changed  6-Dec-95: version 0.3
1580  Ashvin&rsquo;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 &quot;localhost&quot; is optional.
1583 </p>
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 &quot;252A&quot;.
1590 </p>
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&rsquo;s define-derived-mode.
1594 </p>
1595 <p>Changed 24-Dec-95: version 0.6.
1596  Prev/next code re-re-written to be more robust.
1597 </p>
1598 <p>Changed 26-Dec-96:  version 0.7.
1599  Bug fix release.
1600 </p>
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.
1604 </p>
1605 <p> I&rsquo;m skipping version 0.9 because I erroneously release version 0.1
1606 as version 0.9 (only on the web, not on Usenet).
1607 </p>
1608 <p> I&rsquo;m bumping from version &quot;0&quot; to version &quot;1&quot; since the code is has been
1609 in production use for more than a year by several people.  Minor
1610 numbers are the same.
1611 </p>
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,
1616 not by copying.
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
1620 current subject.
1621  - new notes-files are initialized with fields based on the prior
1622 day&rsquo;s notes; see mknew for details.
1623  - daily_work is gone; mkall is rewritten to use .notesrc.
1624 </p>
1625 <p>Changed 29-Apr-96: version 1.11.
1626  Real documentation.
1627  Mknew caching added.
1628 </p>
1629 <p>Changed  9-Aug-96: version 1.12.
1630  Added notesinit to do all setup for new users.
1631 </p>
1632 <p>Changed 24-Aug-96: version 1.13.
1633  Minor documentation fixes.
1634 </p>
1635 <p>Changed 20-Dec-97: version 1.14.
1636 Autoconf support.
1637 </p>
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&rsquo;t up-to-date) we fall back on the slower
1643 code.
1644 </p>
1645 <p>Related work improved (suggestion by David Weisman &lt;weisman@app1.osf.org&gt;).
1646 </p>
1647 <p>Documentation improvement (problem found by Martin L. Smith
1648 &lt;martin@ner.com&gt;).
1649 </p>
1650 <p>Installation improved (code by Jason Bastek &lt;jason@aai.com&gt;).
1651 </p>
1652 <p>Bug in notes-index mode with subjects containing colons fixed (johnh).
1653 </p>
1654 <p>Encryption now supports mailcrypt.el.
1655 </p>
1656 <p>Support for emacs 20 (a small font-lock change).
1657 </p>
1658 <p>Changed  5-Jan-98: version 1.15.
1659 Bug in decryption for non-PAM users fixed
1660  (suggestion by Kevin Davidson &lt;tkld@quadstone.com&gt;).
1661 </p>
1662 <p>Y2K statement added
1663  (suggestion by Kevin Davidson &lt;tkld@quadstone.com&gt;).
1664 </p>
1665 <p>Pointer to mailcrypt added (as a supported encryption package).
1666 Problem pointed out by K. Ueda &lt;kueda@jupiter.qse.tohoku.ac.jp&gt;.
1667 </p>
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 &lt;timp@jna.com.au&gt;.
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.
1677 </p>
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
1681  Takashi Nishimoto.
1682 </p>
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).
1686 </p>
1687 <p>Clarification: Autofilling of new notes more clear in the manual (hopefully,
1688  suggested by Solofo Ramangalahy).
1689 </p>
1690 <p>Bug fix:  a y2k bug in was found and fixed in mkindex.  Sigh.
1691 </p>
1692 <p>New:  Two mailing lists for notes-mode have been created:
1693 &lsquo;<tt>notes-mode-announce@heidemann.la.ca.us</tt>&rsquo; and
1694 &lsquo;<tt>notes-mode-talk@heidemann.la.ca.us</tt>&rsquo;.
1695 Send the line &ldquo;subscribe notes-mode-announce&rdquo;
1696 (or &ldquo;subscribe notes-mode-talk&rdquo;)
1697 to &lsquo;<tt>majordomo@heidemann.la.ca.us</tt>&rsquo;
1698 to join them.
1699 [<em>These instructions are now superceeded; to subscribe, go to
1700 &lsquo;<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-talk</tt>&rsquo;
1701 and
1702 &lsquo;<tt>http://www.heidemann.la.ca.us/mailman/listinfo/notes-mode-announce</tt>&rsquo;.</em>]
1703 </p>
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.
1707 </p>
1708 <p>Clarification: I added some pointers in the code to the installation
1709  instructions.  (Apparently people can&rsquo;t RTF README.)
1710 </p>
1711 <p>Extension: mailcrypt-3.5.x suported including pgp, pgp5 and gpg.
1712 </p>
1713 <p>Changed (date 23-Dec-00): version 1.19:
1714 Bug fix (cosmetic): suppress comments in encrypted nodes.
1715 </p>
1716 <p>Install fixes from Kannan Varadhan: elisp directories changed on install.
1717 </p>
1718 <p>Added C-j as a synonym for RET in notes-mode to parallel C++ or perl mode.
1719 (Suggested by Fred Jaggi &lsquo;<tt>jaggi@rsn.hp.com</tt>&rsquo;.)
1720 </p>
1721 <p>Outline-minor-mode support added and documented.
1722 (Suggested by Tim Carroll &lsquo;<tt>tim@boomboom.com</tt>&rsquo;.)
1723 </p>
1724 <p>Bug/typo fixes in gpg support
1725 (Contributed by William A. Perkins &lsquo;<tt>wa_perkins@pnl.gov</tt>&rsquo;,
1726 with separate patches from Knut Anders Hatlen &lsquo;<tt>kahatlen@online.no</tt>&rsquo;.)
1727 </p>
1728 <p>Installation improvements suggested by Christophe Troestler
1729 &lsquo;<tt>Ch.Troestler@linkline.be</tt>&rsquo;:
1730 use install-info to update the info dir,
1731 warn users of &ndash;prefix that lisp files go elsewhere.
1732 </p>
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 &lsquo;<tt>michaelt@supernet.ca</tt>&rsquo;.)
1736 </p>
1737 <p>Changed ( 5-Dec-01): version 1.21:
1738 (backed-out&mdash;didn&rsquo;t work with spaced URLs)
1739 URL lookup now uses thing-at-point.
1740 </p>
1741 <p>Fix to make notes-mode work with emacs-21.1
1742 (Fix from Klaus Zeitler  &lsquo;<tt>kzeitler@lucent.com</tt>&rsquo;.)
1743 </p>
1744 <p>Changed ( 3-Jan-02): version 1.22:
1745 Several bugs in &lsquo;<tt>notesinit</tt>&rsquo; for stricter Perl implementations
1746 (bug found by Paul Craven&quot; &lsquo;<tt>pcraven@yorku.ca</tt>&rsquo;,
1747 and Kasper van Wijk &lsquo;<tt>kasper@acoustics.mines.edu</tt>&rsquo;)
1748 and to make it run cleanly more often.
1749 </p>
1750 <p>Notes-first now autoinitializes notes mode from emacs.
1751 (As instisted by rms, unfortunately about two years later than requested.)
1752 </p>
1753
1754 <p>Changed (20-Feb-05): version 1.23:
1755 Outline mode is now forcebly turned on to avoid interactions
1756 with user&rsquo;s text-mode hooks
1757 (bug and fix from Nils Ackermann &lsquo;<tt>nils@nieback.de</tt>&rsquo;).
1758 </p>
1759 <p>Install bug involving ordering of scripts and byte-compilation
1760 fixed (bug and fix from Mark Allman &lsquo;<tt>mallman@grc.nasa.gov</tt>&rsquo;).
1761 </p>
1762 <p>Fix obscure bug in configure, reported by Klaus Zeitler &lsquo;<tt>kzeitler@lucent.com</tt>&rsquo;.
1763 </p>
1764 <p>Fix for notes-summarize-subject when no subject is specified (bug and fix
1765 from Geoff Kuenning).
1766 </p>
1767 <p>Changed (14-Jan-06): version 1.24:
1768 </p>
1769 <p>install-info bug documented with the Debian install-info
1770 (bug reported by Aaron Falk &lsquo;<tt>falk@isi.edu</tt>&rsquo;).
1771 </p>
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 &lsquo;<tt>bronger@physik.rwth-aachen.de</tt>&rsquo;.
1775 </p>
1776 <p>Fixed a bug in mkindexcache, triggered by subjects with percent signs
1777 in them.  Bug reported by Philip Austin &lsquo;<tt>paustin@eos.ubc.ca</tt>&rsquo;.
1778 </p>
1779 <p>We&rsquo;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 &lsquo;<tt>paustin@eos.ubc.ca</tt>&rsquo;.
1782 </p>
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 &lsquo;<tt>falk@isi.edu</tt>&rsquo;.
1787 </p>
1788 <p>Provide better hints about how to get started after installation or
1789 running notes-mode in emacs for the first time.
1790 </p>
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 &lsquo;<tt>allman@icir.org</tt>&rsquo;.
1794 </p>
1795 <p>Changed (26-May-06): version 1.25:
1796 </p>
1797 <p>fixed a bug in the release tar.gz file that had a additional copies
1798 copy nested.
1799 </p>
1800 <p>Changed (30-Jun-08): version 1.26:
1801 </p>
1802 <p>Force unicode I/O in &lsquo;<tt>mkindexcache</tt>&rsquo; to fix highlighting mis-alignment
1803 when using emacs-21 with unicode subject lines.
1804 </p>
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.
1808 </p>
1809 <p>Changes notes-mode.el to put path in quotes, allowing spaces to appear in home directory names (bug fix from Ulrich Herbst).
1810 </p>
1811 <p>Added a suggested features section.
1812 </p>
1813 <p>Changed ( 8-Aug-08): version 1.27:
1814 </p>
1815 <p>Change I/O in &lsquo;<tt>mkindexcache</tt>&rsquo; 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.
1818 </p>
1819 <p>Changed (20-Jun-10): version 1.28:
1820 </p>
1821 <p>Changed a regular expression in &lsquo;<tt>notes-index-mode.el</tt>&rsquo; that was
1822 causing emacs-v23 (a pre-release version)
1823 to regular expression infinite recursion.
1824 </p>
1825 <p>Changed (2012-04-04): version 1.29
1826 </p>
1827 <p>(2011-08-23) Changed <code>run-hooks</code> to <code>run-mode-hooks</code>.
1828 Bug report from Geoff Kuenning.
1829 </p>
1830 <p>Changed some handling of PGP encryption to account for
1831 some apparent API changes.
1832 </p>
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.
1837 </p>
1838
1839
1840 <hr size="6">
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"> &lt; </a>]</td>
1844 <td valign="middle" align="left">[<a href="#Installation" title="Next section in reading order"> &gt; </a>]</td>
1845 <td valign="middle" align="left"> &nbsp; </td>
1846 <td valign="middle" align="left">[<a href="#History" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1849 <td valign="middle" align="left"> &nbsp; </td>
1850 <td valign="middle" align="left"> &nbsp; </td>
1851 <td valign="middle" align="left"> &nbsp; </td>
1852 <td valign="middle" align="left"> &nbsp; </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>
1857 </tr></table>
1858 <a name="Suggested-features-1"></a>
1859 <h2 class="section">4.4 Suggested features</h2>
1860
1861 <p>Features suggested by users but not yet implemented:
1862 </p>
1863 <p>21-Feb-08: (from Xavier Maillard): should support &ldquo;disconnected&rdquo; notes that
1864 are indexed but not date-based.
1865 </p>
1866 <p>21-Feb-08: (from John Heidemann): should switch all notes files to have an extension (maybe &lsquo;<tt>.notes</tt>&rsquo;).
1867 </p>
1868 <hr size="6">
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"> &lt; </a>]</td>
1872 <td valign="middle" align="left">[<a href="#Keystroke-index" title="Next section in reading order"> &gt; </a>]</td>
1873 <td valign="middle" align="left"> &nbsp; </td>
1874 <td valign="middle" align="left">[<a href="#History" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1877 <td valign="middle" align="left"> &nbsp; </td>
1878 <td valign="middle" align="left"> &nbsp; </td>
1879 <td valign="middle" align="left"> &nbsp; </td>
1880 <td valign="middle" align="left"> &nbsp; </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>
1885 </tr></table>
1886 <a name="Installation-1"></a>
1887 <h1 class="chapter">5. Installation</h1>
1888
1889 <p>To install notes-mode,
1890 </p>
1891 <ol>
1892 <li>
1893 Unpack and extract the distribution
1894 (gunzip notes-mode-xxx.tar.gz; tar xvf notes-mode-xxx.tar; cd notes-mode-xxx).
1895
1896 </li><li>
1897 Run configure (./configure).
1898
1899 </li><li>
1900 Type &ldquo;make install&rdquo;.
1901 </li></ol>
1902
1903 <p>(To control what&rsquo;s installed where, use &ndash;prefix=/where, or
1904 &ndash;with-lisp-dir=/where, &ndash;datadir=/where (for scripts),
1905 and &ndash;infodir=/where.)
1906 </p>
1907 <p>For each user:
1908 </p><ol>
1909 <li>
1910 Run notesinit
1911 </li></ol>
1912
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
1916 your system.
1917 Make sure you move out of the directory where you untarred it
1918 before running it.
1919 </p>
1920
1921 <p>The most recent distribution of notes-mode
1922  is always available via
1923  &lsquo;<tt>http://www.isi.edu/~johnh/SOFTWARE/NOTES_MODE/</tt>&rsquo;.
1924 </p>
1925
1926
1927 <hr size="6">
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"> &lt; </a>]</td>
1931 <td valign="middle" align="left">[<a href="#Concept-index" title="Next section in reading order"> &gt; </a>]</td>
1932 <td valign="middle" align="left"> &nbsp; </td>
1933 <td valign="middle" align="left">[<a href="#Installation" title="Beginning of this chapter or previous chapter"> &lt;&lt; </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"> &gt;&gt; </a>]</td>
1936 <td valign="middle" align="left"> &nbsp; </td>
1937 <td valign="middle" align="left"> &nbsp; </td>
1938 <td valign="middle" align="left"> &nbsp; </td>
1939 <td valign="middle" align="left"> &nbsp; </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>
1944 </tr></table>
1945 <a name="Keystroke-index-1"></a>
1946 <h1 class="unnumbered">Keystroke index</h1>
1947
1948 <p>This index lists notes-mode keystrokes.
1949 </p>
1950 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Keystroke-index-1_ky_letter-C" class="summary-letter"><b>C</b></a>
1951  &nbsp;
1952 <a href="#Keystroke-index-1_ky_letter-M" class="summary-letter"><b>M</b></a>
1953  &nbsp;
1954 <a href="#Keystroke-index-1_ky_letter-O" class="summary-letter"><b>O</b></a>
1955  &nbsp;
1956 <a href="#Keystroke-index-1_ky_letter-R" class="summary-letter"><b>R</b></a>
1957  &nbsp;
1958 <a href="#Keystroke-index-1_ky_letter-S" class="summary-letter"><b>S</b></a>
1959  &nbsp;
1960 <a href="#Keystroke-index-1_ky_letter-T" class="summary-letter"><b>T</b></a>
1961  &nbsp;
1962 </td></tr></table>
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&lt;RTN&gt;</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>
1995 </table>
1996 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Keystroke-index-1_ky_letter-C" class="summary-letter"><b>C</b></a>
1997  &nbsp;
1998 <a href="#Keystroke-index-1_ky_letter-M" class="summary-letter"><b>M</b></a>
1999  &nbsp;
2000 <a href="#Keystroke-index-1_ky_letter-O" class="summary-letter"><b>O</b></a>
2001  &nbsp;
2002 <a href="#Keystroke-index-1_ky_letter-R" class="summary-letter"><b>R</b></a>
2003  &nbsp;
2004 <a href="#Keystroke-index-1_ky_letter-S" class="summary-letter"><b>S</b></a>
2005  &nbsp;
2006 <a href="#Keystroke-index-1_ky_letter-T" class="summary-letter"><b>T</b></a>
2007  &nbsp;
2008 </td></tr></table>
2009
2010
2011 <hr size="6">
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"> &lt; </a>]</td>
2015 <td valign="middle" align="left">[ &gt; ]</td>
2016 <td valign="middle" align="left"> &nbsp; </td>
2017 <td valign="middle" align="left">[<a href="#Keystroke-index" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2018 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
2019 <td valign="middle" align="left">[ &gt;&gt; ]</td>
2020 <td valign="middle" align="left"> &nbsp; </td>
2021 <td valign="middle" align="left"> &nbsp; </td>
2022 <td valign="middle" align="left"> &nbsp; </td>
2023 <td valign="middle" align="left"> &nbsp; </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>
2028 </tr></table>
2029 <a name="Concept-index-1"></a>
2030 <h1 class="unnumbered">Concept index</h1>
2031
2032 <p>This index lists notes-mode concepts.
2033 </p>
2034 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Concept-index-1_cp_symbol-1" class="summary-letter"><b>.</b></a>
2035  &nbsp;
2036 <br>
2037 <a href="#Concept-index-1_cp_letter-C" class="summary-letter"><b>C</b></a>
2038  &nbsp;
2039 <a href="#Concept-index-1_cp_letter-D" class="summary-letter"><b>D</b></a>
2040  &nbsp;
2041 <a href="#Concept-index-1_cp_letter-E" class="summary-letter"><b>E</b></a>
2042  &nbsp;
2043 <a href="#Concept-index-1_cp_letter-F" class="summary-letter"><b>F</b></a>
2044  &nbsp;
2045 <a href="#Concept-index-1_cp_letter-I" class="summary-letter"><b>I</b></a>
2046  &nbsp;
2047 <a href="#Concept-index-1_cp_letter-K" class="summary-letter"><b>K</b></a>
2048  &nbsp;
2049 <a href="#Concept-index-1_cp_letter-M" class="summary-letter"><b>M</b></a>
2050  &nbsp;
2051 <a href="#Concept-index-1_cp_letter-N" class="summary-letter"><b>N</b></a>
2052  &nbsp;
2053 <a href="#Concept-index-1_cp_letter-P" class="summary-letter"><b>P</b></a>
2054  &nbsp;
2055 <a href="#Concept-index-1_cp_letter-R" class="summary-letter"><b>R</b></a>
2056  &nbsp;
2057 <a href="#Concept-index-1_cp_letter-S" class="summary-letter"><b>S</b></a>
2058  &nbsp;
2059 <a href="#Concept-index-1_cp_letter-T" class="summary-letter"><b>T</b></a>
2060  &nbsp;
2061 <a href="#Concept-index-1_cp_letter-U" class="summary-letter"><b>U</b></a>
2062  &nbsp;
2063 </td></tr></table>
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>
2131 </table>
2132 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Concept-index-1_cp_symbol-1" class="summary-letter"><b>.</b></a>
2133  &nbsp;
2134 <br>
2135 <a href="#Concept-index-1_cp_letter-C" class="summary-letter"><b>C</b></a>
2136  &nbsp;
2137 <a href="#Concept-index-1_cp_letter-D" class="summary-letter"><b>D</b></a>
2138  &nbsp;
2139 <a href="#Concept-index-1_cp_letter-E" class="summary-letter"><b>E</b></a>
2140  &nbsp;
2141 <a href="#Concept-index-1_cp_letter-F" class="summary-letter"><b>F</b></a>
2142  &nbsp;
2143 <a href="#Concept-index-1_cp_letter-I" class="summary-letter"><b>I</b></a>
2144  &nbsp;
2145 <a href="#Concept-index-1_cp_letter-K" class="summary-letter"><b>K</b></a>
2146  &nbsp;
2147 <a href="#Concept-index-1_cp_letter-M" class="summary-letter"><b>M</b></a>
2148  &nbsp;
2149 <a href="#Concept-index-1_cp_letter-N" class="summary-letter"><b>N</b></a>
2150  &nbsp;
2151 <a href="#Concept-index-1_cp_letter-P" class="summary-letter"><b>P</b></a>
2152  &nbsp;
2153 <a href="#Concept-index-1_cp_letter-R" class="summary-letter"><b>R</b></a>
2154  &nbsp;
2155 <a href="#Concept-index-1_cp_letter-S" class="summary-letter"><b>S</b></a>
2156  &nbsp;
2157 <a href="#Concept-index-1_cp_letter-T" class="summary-letter"><b>T</b></a>
2158  &nbsp;
2159 <a href="#Concept-index-1_cp_letter-U" class="summary-letter"><b>U</b></a>
2160  &nbsp;
2161 </td></tr></table>
2162
2163
2164
2165
2166 <hr size="6">
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>
2173 </tr></table>
2174 <h1>Footnotes</h1>
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&rsquo;t manage to back-enter
2181 my notes all time time.
2182 </p><h3><a name="FOOT3" href="#DOCF3">(3)</a></h3>
2183
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 (&lsquo;<tt>http://wearables.www.media.mit.edu/projects/wearables/</tt>&rsquo;)
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&rsquo;m missing an alternative, please let me know.
2193 </p><hr size="1">
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>
2200 </tr></table>
2201 <h1>Table of Contents</h1>
2202 <div class="contents">
2203
2204 <ul class="toc">
2205   <li><a name="toc-Introduction-1" href="#Introduction">1. Introduction</a>
2206   <ul class="toc">
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>
2214   </ul></li>
2215   <li><a name="toc-Basics-1" href="#Basics">2. Basics</a>
2216   <ul class="toc">
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>
2221   </ul></li>
2222   <li><a name="toc-Advanced-Features-1" href="#Advanced-Features">3. Advanced Features</a>
2223   <ul class="toc">
2224     <li><a name="toc-Notes-files-1" href="#Notes-files">3.1 Notes files</a>
2225     <ul class="toc">
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>
2230     </ul></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>
2233   </ul></li>
2234   <li><a name="toc-History-1" href="#History">4. History</a>
2235   <ul class="toc">
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>
2240   </ul></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>
2244 </ul>
2245 </div>
2246 <hr size="1">
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>
2253 </tr></table>
2254 <h1>About This Document</h1>
2255 <p>
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>.
2257 </p>
2258 <p>
2259   The buttons in the navigation panels have the following meaning:
2260 </p>
2261 <table border="1">
2262   <tr>
2263     <th> Button </th>
2264     <th> Name </th>
2265     <th> Go to </th>
2266     <th> From 1.2.3 go to</th>
2267   </tr>
2268   <tr>
2269     <td align="center"> [ &lt; ] </td>
2270     <td align="center">Back</td>
2271     <td>Previous section in reading order</td>
2272     <td>1.2.2</td>
2273   </tr>
2274   <tr>
2275     <td align="center"> [ &gt; ] </td>
2276     <td align="center">Forward</td>
2277     <td>Next section in reading order</td>
2278     <td>1.2.4</td>
2279   </tr>
2280   <tr>
2281     <td align="center"> [ &lt;&lt; ] </td>
2282     <td align="center">FastBack</td>
2283     <td>Beginning of this chapter or previous chapter</td>
2284     <td>1</td>
2285   </tr>
2286   <tr>
2287     <td align="center"> [ Up ] </td>
2288     <td align="center">Up</td>
2289     <td>Up section</td>
2290     <td>1.2</td>
2291   </tr>
2292   <tr>
2293     <td align="center"> [ &gt;&gt; ] </td>
2294     <td align="center">FastForward</td>
2295     <td>Next chapter</td>
2296     <td>2</td>
2297   </tr>
2298   <tr>
2299     <td align="center"> [Top] </td>
2300     <td align="center">Top</td>
2301     <td>Cover (top) of document</td>
2302     <td> &nbsp; </td>
2303   </tr>
2304   <tr>
2305     <td align="center"> [Contents] </td>
2306     <td align="center">Contents</td>
2307     <td>Table of contents</td>
2308     <td> &nbsp; </td>
2309   </tr>
2310   <tr>
2311     <td align="center"> [Index] </td>
2312     <td align="center">Index</td>
2313     <td>Index</td>
2314     <td> &nbsp; </td>
2315   </tr>
2316   <tr>
2317     <td align="center"> [ ? ] </td>
2318     <td align="center">About</td>
2319     <td>About (help)</td>
2320     <td> &nbsp; </td>
2321   </tr>
2322 </table>
2323
2324 <p>
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:
2326 </p>
2327
2328 <ul>
2329   <li> 1. Section One
2330     <ul>
2331       <li>1.1 Subsection One-One
2332         <ul>
2333           <li>...</li>
2334         </ul>
2335       </li>
2336       <li>1.2 Subsection One-Two
2337         <ul>
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 &nbsp; &nbsp;
2341             <strong>&lt;== Current Position </strong></li>
2342           <li>1.2.4 Subsubsection One-Two-Four</li>
2343         </ul>
2344       </li>
2345       <li>1.3 Subsection One-Three
2346         <ul>
2347           <li>...</li>
2348         </ul>
2349       </li>
2350       <li>1.4 Subsection One-Four</li>
2351     </ul>
2352   </li>
2353 </ul>
2354
2355 <hr size="1">
2356 <p>
2357  <font size="-1">
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>.
2359  </font>
2360  <br>
2361
2362 </p>
2363 </body>
2364 </html>