code.delx.au - gnu-emacs-elpa/blob - packages/notes-mode/HTML/notes-mode_3.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: 3. Advanced Features</title>
  14
  15 <meta name="description" content="Notes-mode: 3. Advanced Features">
  16 <meta name="keywords" content="Notes-mode: 3. Advanced Features">
  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="Advanced-Features"></a>
  45 <table cellpadding="1" cellspacing="1" border="0">
  46 <tr><td valign="middle" align="left">[<a href="notes-mode_2.html#The-notes-directories" title="Previous section in reading order"> &lt; </a>]</td>
  47 <td valign="middle" align="left">[<a href="#Notes-files" title="Next section in reading order"> &gt; </a>]</td>
  48 <td valign="middle" align="left"> &nbsp; </td>
  49 <td valign="middle" align="left">[<a href="notes-mode_2.html#Basics" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
  50 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Up section"> Up </a>]</td>
  51 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
  52 <td valign="middle" align="left"> &nbsp; </td>
  53 <td valign="middle" align="left"> &nbsp; </td>
  54 <td valign="middle" align="left"> &nbsp; </td>
  55 <td valign="middle" align="left"> &nbsp; </td>
  56 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
  57 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
  58 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
  59 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
  60 </tr></table>
  61 <a name="Advanced-Features-1"></a>
  62 <h1 class="chapter">3. Advanced Features</h1>
  63
  64 <p>Notes-mode, the minutiae, and some other good stuff.
  65 </p>
  66 <table class="menu" border="0" cellspacing="0">
  67 <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">
  68 </td></tr>
  69 <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">
  70 </td></tr>
  71 <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">
  72 </td></tr>
  73 </table>
  74
  75 <hr size="6">
  76 <a name="Notes-files"></a>
  77 <table cellpadding="1" cellspacing="1" border="0">
  78 <tr><td valign="middle" align="left">[<a href="#Advanced-Features" title="Previous section in reading order"> &lt; </a>]</td>
  79 <td valign="middle" align="left">[<a href="#Getting-around" title="Next section in reading order"> &gt; </a>]</td>
  80 <td valign="middle" align="left"> &nbsp; </td>
  81 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
  82 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Up section"> Up </a>]</td>
  83 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
  84 <td valign="middle" align="left"> &nbsp; </td>
  85 <td valign="middle" align="left"> &nbsp; </td>
  86 <td valign="middle" align="left"> &nbsp; </td>
  87 <td valign="middle" align="left"> &nbsp; </td>
  88 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
  89 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
  90 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
  91 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
  92 </tr></table>
  93 <a name="Notes-files-1"></a>
  94 <h2 class="section">3.1 Notes files</h2>
  95
  96 <table class="menu" border="0" cellspacing="0">
  97 <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">
  98 </td></tr>
  99 <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">
 100 </td></tr>
 101 <tr><td align="left" valign="top"><a href="#Encryption">3.1.3 Encryption</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 102 </td></tr>
 103 <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">
 104 </td></tr>
 105 </table>
 106
 107 <hr size="6">
 108 <a name="Getting-around"></a>
 109 <table cellpadding="1" cellspacing="1" border="0">
 110 <tr><td valign="middle" align="left">[<a href="#Notes-files" title="Previous section in reading order"> &lt; </a>]</td>
 111 <td valign="middle" align="left">[<a href="#Subject-summary" title="Next section in reading order"> &gt; </a>]</td>
 112 <td valign="middle" align="left"> &nbsp; </td>
 113 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 114 <td valign="middle" align="left">[<a href="#Notes-files" title="Up section"> Up </a>]</td>
 115 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 116 <td valign="middle" align="left"> &nbsp; </td>
 117 <td valign="middle" align="left"> &nbsp; </td>
 118 <td valign="middle" align="left"> &nbsp; </td>
 119 <td valign="middle" align="left"> &nbsp; </td>
 120 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 121 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 122 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 123 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 124 </tr></table>
 125 <a name="Getting-around-1"></a>
 126 <h3 class="subsection">3.1.1 Getting around</h3>
 127
 128 <p>Moving between notes entries and around the hierarchy is fairly common,
 129  so there are some accelerators.
 130 </p>
 131 <dl compact="compact">
 132 <dt> <kbd>C-c C-i</kbd></dt>
 133 <dd><p>Jump to the index entry for the current entry&rsquo;s subject
 134 (<code>notes-goto-index-entry</code>).
 135 <a name="index-C_002dc-C_002di"></a>
 136 </p>
 137 </dd>
 138 <dt> <kbd>C-c C-n</kbd></dt>
 139 <dt> <kbd>C-c C-p</kbd></dt>
 140 <dd><p>Move to the next or prior note with the same subject
 141 (<code>notes-follow-next-link</code> and <code>notes-follow-prev-link</code>).
 142 These functions follow the links in the note,
 143  if they&rsquo;re defined.
 144 If not,
 145  they look through the index file.
 146 This approach usually works,
 147  but will fail if there are multiple new entries created
 148  with the given subject
 149  between when the index is recomputed.
 150 <a name="index-C_002dc-C_002dn"></a>
 151 <a name="index-C_002dc-C_002dp"></a>
 152 </p>
 153 </dd>
 154 <dt> <kbd>C-c&lt;RTN&gt;</kbd></dt>
 155 <dd><p>Follow the link under the point
 156 (<code>notes-w3-follow-link</code>),
 157  a keyboard equivalent of &lt;S-mouse-2&gt;.
 158 <a name="index-C_002dcRTN"></a>
 159 </p>
 160 </dd>
 161 <dt> <kbd>M-C-a</kbd></dt>
 162 <dt> <kbd>M-C-e</kbd></dt>
 163 <dd><p>Jump to the beginning or end of the current note entry
 164 (<code>notes-beginning-of-defun</code> and <code>notes-end-of-defun</code>).
 165 <a name="index-M_002dC_002da"></a>
 166 <a name="index-M_002dC_002de"></a>
 167 </p>
 168 </dd>
 169 <dt> <kbd>C-c C-k</kbd></dt>
 170 <dd><p>Copies the pseudo-URL for the current note into the kill-ring
 171 (<code>current-url-as-kill</code>).
 172 To link two entries, go to the target,
 173  grab its URL with <kbd>C-c C-k</kbd>,
 174  go to where you want to make the link,
 175  and yank the URL with <kbd>C-y</kbd>.
 176 <a name="index-C_002dc-C_002dk"></a>
 177 </p>
 178 </dd>
 179 </dl>
 180
 181
 182 <p>Notes mode supports imenu,
 183  if you have it bound to something
 184  (I use <code>(global-set-key [down-mouse-3] 'imenu)</code>).
 185 <a name="index-imenu"></a>
 186 </p>
 187
 188 <hr size="6">
 189 <a name="Subject-summary"></a>
 190 <table cellpadding="1" cellspacing="1" border="0">
 191 <tr><td valign="middle" align="left">[<a href="#Getting-around" title="Previous section in reading order"> &lt; </a>]</td>
 192 <td valign="middle" align="left">[<a href="#Encryption" title="Next section in reading order"> &gt; </a>]</td>
 193 <td valign="middle" align="left"> &nbsp; </td>
 194 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 195 <td valign="middle" align="left">[<a href="#Notes-files" title="Up section"> Up </a>]</td>
 196 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 197 <td valign="middle" align="left"> &nbsp; </td>
 198 <td valign="middle" align="left"> &nbsp; </td>
 199 <td valign="middle" align="left"> &nbsp; </td>
 200 <td valign="middle" align="left"> &nbsp; </td>
 201 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 202 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 203 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 204 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 205 </tr></table>
 206 <a name="Subject-summary-1"></a>
 207 <h3 class="subsection">3.1.2 Subject summary</h3>
 208
 209 <p>It&rsquo;s often helpful to look at all
 210  entries for a given subject
 211 <kbd>C-c C-s</kbd>
 212  collects all entries with the subject of the current
 213  entry in a new buffer
 214  (<code>notes-summarize-subject</code>).
 215 <a name="index-C_002dc-C_002ds"></a>
 216 <a name="index-Subject-summary"></a>
 217 </p>
 218
 219 <hr size="6">
 220 <a name="Encryption"></a>
 221 <table cellpadding="1" cellspacing="1" border="0">
 222 <tr><td valign="middle" align="left">[<a href="#Subject-summary" title="Previous section in reading order"> &lt; </a>]</td>
 223 <td valign="middle" align="left">[<a href="#Useful-conventions" title="Next section in reading order"> &gt; </a>]</td>
 224 <td valign="middle" align="left"> &nbsp; </td>
 225 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 226 <td valign="middle" align="left">[<a href="#Notes-files" title="Up section"> Up </a>]</td>
 227 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 228 <td valign="middle" align="left"> &nbsp; </td>
 229 <td valign="middle" align="left"> &nbsp; </td>
 230 <td valign="middle" align="left"> &nbsp; </td>
 231 <td valign="middle" align="left"> &nbsp; </td>
 232 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 233 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 234 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 235 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 236 </tr></table>
 237 <a name="Encryption-1"></a>
 238 <h3 class="subsection">3.1.3 Encryption</h3>
 239
 240 <a name="index-Encryption"></a>
 241 <a name="index-Decryption"></a>
 242
 243 <p>Notes occasionally contain private material.
 244 While Unix has strong services for file protection
 245  (compared to other, say, more wide-selling operating systems),
 246  in many systems root passwords are shared,
 247  while other systems are vulnerable to physical compromise.
 248 In such systems,
 249  properly used encryption is the best approach to security.
 250 </p>
 251 <p>Notes-mode encryption is based
 252  Phill Zimmerman&rsquo;s PGP (Pretty Good Privacy)
 253 (see &lsquo;<tt>http://www.mantis.co.uk/pgp/pgp.html</tt>&rsquo;)
 254  and either
 255  with Rick Campbell&rsquo;s
 256  emacs interface, PAM (PGP Augmented Messaging)
 257 (from &lsquo;<tt>ftp://h.gp.cs.cmu.edu/usr/rfb/pam/</tt>&rsquo;)
 258  (note that as of January 1997, PAM is no longer at this ftp site
 259  and appears to not be publicly available),
 260  or LoPresti and Choi&rsquo;s mailcrypt
 261 (from &lsquo;<tt>http://cag-www.lcs.mit.edu/mailcrypt/</tt>&rsquo;).
 262 <a name="index-PGP"></a>
 263 <a name="index-Pretty-good-privacy"></a>
 264 <a name="index-PAM"></a>
 265 <a name="index-PGP-Augmented-Messaging"></a>
 266 <a name="index-mailcrypt"></a>
 267 </p>
 268 <dl compact="compact">
 269 <dt> <kbd>C-c C-e</kbd></dt>
 270 <dd><p>Encrypt the current note
 271 (<code>notes-encrypt-note</code>).
 272 By default this function encrypts the whole entry.
 273 With a prefix argument,
 274  only the part from the point to the end of the entry is encrypted.
 275 <a name="index-C_002dc-C_002de"></a>
 276 </p>
 277 </dd>
 278 <dt> <kbd>C-c C-d</kbd></dt>
 279 <dd><p>Decrypt the current note
 280 (<code>notes-decrypt-note</code>).
 281 </p></dd>
 282 </dl>
 283 <a name="index-C_002dc-C_002dd"></a>
 284
 285 <p>By default notes-mode determines your public key by looking
 286  up your <code>user-full-name</code> in your PGP keyring.
 287 You can override this default by setting
 288  <code>notes-encryption-key-id</code>
 289  to the desired key-id.
 290 <a name="index-key_002did"></a>
 291 </p>
 292
 293 <hr size="6">
 294 <a name="Useful-conventions"></a>
 295 <table cellpadding="1" cellspacing="1" border="0">
 296 <tr><td valign="middle" align="left">[<a href="#Encryption" title="Previous section in reading order"> &lt; </a>]</td>
 297 <td valign="middle" align="left">[<a href="#Notes-indices" title="Next section in reading order"> &gt; </a>]</td>
 298 <td valign="middle" align="left"> &nbsp; </td>
 299 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 300 <td valign="middle" align="left">[<a href="#Notes-files" title="Up section"> Up </a>]</td>
 301 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 302 <td valign="middle" align="left"> &nbsp; </td>
 303 <td valign="middle" align="left"> &nbsp; </td>
 304 <td valign="middle" align="left"> &nbsp; </td>
 305 <td valign="middle" align="left"> &nbsp; </td>
 306 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 307 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 308 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 309 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 310 </tr></table>
 311 <a name="Useful-conventions-1"></a>
 312 <h3 class="subsection">3.1.4 Useful conventions</h3>
 313
 314
 315 <a name="index-conventions"></a>
 316 <a name="index-mknew"></a>
 317
 318 <p>There are a number of conventions which can make notes-mode
 319  easier to use.
 320 These conventions are a matter of personal taste,
 321  of course.
 322 Do what works for you.
 323 </p>
 324 <p>First,
 325  I find it helpful to keep the date of each notes-file at the top
 326  of the file.
 327 This makes the file self-identifying
 328  if the filename is lost.
 329 </p>
 330 <p>Second,
 331  I find it useful to have the first entry of each file
 332  have the same subject (perhaps &ldquo;Today&rdquo;).
 333 This entry then links all notes together,
 334  making it easy to go to yesterday and tomorrow.
 335 I keep a to-do list on this entry,
 336  bringing the list forward each day.
 337 <a name="index-Today"></a>
 338 </p>
 339 <p>A third useful convention is to keep an
 340  entry with the name based on the day of the week
 341  in each file.
 342 Analogous to &ldquo;Today&rdquo;, this entry links together
 343  weeks.
 344 </p>
 345 <p>Notes-mode supports these conventions.
 346 When you make a new notes-file in emacs,
 347  notes-mode searches for the preceding file.
 348 If it follows any of these conventions,
 349  the new file is initialized appropriately.
 350 Currently
 351  the approach to do this process
 352  (in the program &lsquo;<tt>mknew</tt>&rsquo;)
 353  is fairly sensitive,
 354  so it may not work in all cases.
 355 In particular,
 356  the date convention works only on
 357  for English-language dates.
 358 (If you use notes-mode with a non-English language,
 359  let me know and I&rsquo;ll work with you to fix this limitation.)
 360 </p>
 361 <p>If you find other helpful conventions,
 362  please let me know.
 363 Modifications to &lsquo;<tt>mknew</tt>&rsquo; to implement
 364  new conventions are also invited.
 365 </p>
 366 <p>If you don&rsquo;t want to use these conventions,
 367  or if you want to use different ones,
 368  set the emacs variable notes-mode-initialization-program
 369  to nil or the name of your initialization program.
 370 <a name="index-notes_002dmode_002dinitialization_002dprogram"></a>
 371 </p>
 372
 373 <hr size="6">
 374 <a name="Notes-indices"></a>
 375 <table cellpadding="1" cellspacing="1" border="0">
 376 <tr><td valign="middle" align="left">[<a href="#Useful-conventions" title="Previous section in reading order"> &lt; </a>]</td>
 377 <td valign="middle" align="left">[<a href="#Notes_002dmode-configuration" title="Next section in reading order"> &gt; </a>]</td>
 378 <td valign="middle" align="left"> &nbsp; </td>
 379 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 380 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Up section"> Up </a>]</td>
 381 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 382 <td valign="middle" align="left"> &nbsp; </td>
 383 <td valign="middle" align="left"> &nbsp; </td>
 384 <td valign="middle" align="left"> &nbsp; </td>
 385 <td valign="middle" align="left"> &nbsp; </td>
 386 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 387 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 388 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 389 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 390 </tr></table>
 391 <a name="Notes-indices-1"></a>
 392 <h2 class="section">3.2 Notes indices</h2>
 393
 394
 395 <p>Only two features of notes index mode haven&rsquo;t yet been described.
 396 First,
 397  you can open any notes-file based on date
 398  with <code>notes-index-link</code>,
 399  normally bound to &lt;o&gt;.
 400 <a name="index-o"></a>
 401 </p>
 402 <p>Second,
 403  you can get a subject-summary
 404  with &lt;C-c C-s&gt;
 405  (see section <a href="#Subject-summary">Subject summary</a>).
 406 The subject defaults to that of the current index line.
 407 <a name="index-C_002dc-C_002ds-1"></a>
 408 </p>
 409
 410 <hr size="6">
 411 <a name="Notes_002dmode-configuration"></a>
 412 <table cellpadding="1" cellspacing="1" border="0">
 413 <tr><td valign="middle" align="left">[<a href="#Notes-indices" title="Previous section in reading order"> &lt; </a>]</td>
 414 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next section in reading order"> &gt; </a>]</td>
 415 <td valign="middle" align="left"> &nbsp; </td>
 416 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 417 <td valign="middle" align="left">[<a href="#Advanced-Features" title="Up section"> Up </a>]</td>
 418 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 419 <td valign="middle" align="left"> &nbsp; </td>
 420 <td valign="middle" align="left"> &nbsp; </td>
 421 <td valign="middle" align="left"> &nbsp; </td>
 422 <td valign="middle" align="left"> &nbsp; </td>
 423 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 424 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 425 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 426 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 427 </tr></table>
 428 <a name="Notes_002dmode-configuration-1"></a>
 429 <h2 class="section">3.3 Notes-mode configuration</h2>
 430
 431 <a name="index-configuration"></a>
 432 <a name="index-_002enotesrc"></a>
 433
 434 <p>Several aspects of notes mode are particularly visible
 435  to the user.
 436 Because I&rsquo;m not a fascist,
 437  a user can change most of these.
 438 </p>
 439 <p>Preferences are specified in &lsquo;<tt>~/.notesrc</tt>&rsquo;.
 440 This file lists things to change:
 441 </p>
 442 <table><tr><td>&nbsp;</td><td><pre class="example"># lines beginning with a hash are comments
 443 dir: ~/NOTES
 444 int_form: %Y%m
 445 </pre></td></tr></table>
 446
 447 <p>Currently, two things can be changed:
 448 </p>
 449 <dl compact="compact">
 450 <dt> <code>dir</code></dt>
 451 <dd><p>Specifies the root of the notes directory hierarchy
 452  (see section <a href="notes-mode_2.html#The-notes-directories">The notes directories</a>).
 453 </p>
 454 </dd>
 455 <dt> <code>int_form</code></dt>
 456 <dd><p>Specifies the form of the intermediate directory.
 457 A limited subset of <code>strftime(3)</code>
 458  formatting is allowed.
 459 </p></dd>
 460 </dl>
 461
 462 <p>The subset of <code>strftime(3)</code> supported in <code>int_form</code> is:
 463 </p><dl compact="compact">
 464 <dt> <code>%Y</code></dt>
 465 <dd><p>The four-digit year.
 466 </p>
 467 </dd>
 468 <dt> <code>%y</code></dt>
 469 <dd><p>The two-digit year.
 470 </p>
 471 </dd>
 472 <dt> <code>%m</code></dt>
 473 <dd><p>A two-digit numeric month.
 474 </p>
 475 </dd>
 476 <dt> <code>%d</code></dt>
 477 <dd><p>A two-digit day.
 478 </p></dd>
 479 </dl>
 480
 481 <p>In addition to &lsquo;<tt>.notesrc</tt>&rsquo;,
 482  there are a number of emacs-specific variables.
 483 These variables are documented in the file
 484  &lsquo;<tt>notes-variables.el</tt>&rsquo;.
 485 </p>
 486
 487
 488
 489 <hr size="6">
 490 <table cellpadding="1" cellspacing="1" border="0">
 491 <tr><td valign="middle" align="left">[<a href="#Advanced-Features" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 492 <td valign="middle" align="left">[<a href="notes-mode_4.html#History" title="Next chapter"> &gt;&gt; </a>]</td>
 493 <td valign="middle" align="left"> &nbsp; </td>
 494 <td valign="middle" align="left"> &nbsp; </td>
 495 <td valign="middle" align="left"> &nbsp; </td>
 496 <td valign="middle" align="left"> &nbsp; </td>
 497 <td valign="middle" align="left"> &nbsp; </td>
 498 <td valign="middle" align="left">[<a href="notes-mode.html#Top" title="Cover (top) of document">Top</a>]</td>
 499 <td valign="middle" align="left">[<a href="notes-mode_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 500 <td valign="middle" align="left">[<a href="notes-mode_6.html#Keystroke-index" title="Index">Index</a>]</td>
 501 <td valign="middle" align="left">[<a href="notes-mode_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 502 </tr></table>
 503 <p>
 504  <font size="-1">
 505   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>.
 506  </font>
 507  <br>
 508
 509 </p>
 510 </body>
 511 </html>