[Emacs-diffs] Changes to emacs/doc/misc/remember.texi,v

[Michael W. Olson]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael W. Olson <mwolson>      07/10/30 13:57:17

Index: remember.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/remember.texi,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- remember.texi       30 Oct 2007 12:36:46 -0000      1.3
+++ remember.texi       30 Oct 2007 13:57:17 -0000      1.4
@@ -58,10 +58,6 @@
 * Function Reference::          Interactive functions in remember.el.
 * Keystrokes::                  Keystrokes bound in Remember Mode.
 * Backends::                    Backends for saving notes.
-* Copying::                     The GNU General Public License gives you
-                                  permission to redistribute Remember on
-                                  certain terms; it also explains that
-                                  there is no warranty.
 * GNU Free Documentation License::  The license for this documentation.
 * Concept Index::               Search for terms.
 
@@ -71,9 +67,9 @@
 Backends
 
 * Text File::                   Saving to a text file.
+* Diary::                       Saving to a Diary file.
 * Mailbox::                     Saving to a mailbox.
-* Bibliography::                Saving to a bibliography.
-* Planner Page::                Saving to a Planner page.
+* Org::                         Saving to an Org Mode file.
 
 @end detailmenu
 @end menu
@@ -162,15 +158,14 @@
 M-r}), slam in your text however you like, and then hit @kbd{C-c C-c}.
 It will file the data away for later retrieval, and possibly indexing.
 
-Indexing is to data what ``studying'' is in the real world.  What you
-do when you study (or lucubrate, for some of us) is to realize certain
+Indexing is to data what ``studying'' is in the real world.  What you do
+when you study (or lucubrate, for some of us) is to realize certain
 relationships implicit in the data, so that you can make use of those
 relationships.  Expressing that a certain quote you remembered was a
-religious quote, and that you want the ability to pull up all quotes
-of a religious nature, is what studying does.  This is a more labor
-intensive task than the original remembering of the data, and it's
-typical in real life to set aside a special period of time for doing
-this work.
+literary quote, and that you want the ability to pull up all quotes of a
+literary nature, is what studying does.  This is a more labor intensive
+task than the original remembering of the data, and it's typical in real
+life to set aside a special period of time for doing this work.
 
 ``Remember'' works in the same way.  When you enter data, either by
 typing it into a buffer, or using the contents of the selected region,
@@ -240,12 +235,6 @@
 (define-key global-map (kbd "<f9> R") 'remember-region)
 @end lisp
 
-Check out the Planner package
-(@uref{http://www.emacswiki.org/cgi-bin/wiki/PlannerMode}) for plenty
-of annotation functions you can use with Remember. If you use Planner,
-you can easily publish your remembered notes as HTML and RSS.
-(@pxref{Planner Page})
-
 By default, remember uses the first annotation returned by
 @code{remember-annotation-functions}. To include all of the annotations,
 set @code{remember-run-all-annotation-functions-flag} to non-nil.
@@ -319,7 +308,7 @@
 
 @end table
 
address@hidden Backends, Copying, Keystrokes, Top
address@hidden Backends, GNU Free Documentation License, Keystrokes, Top
 @comment  node-name,  next,  previous,  up
 @chapter Backends
 
@@ -327,138 +316,80 @@
 
 @menu
 * Text File::                   Saving to a text file.
+* Diary::                       Saving to a Diary file.
 * Mailbox::                     Saving to a mailbox.
-* Bibliography::                Saving to a bibliography.
-* Planner Page::                Saving to a Planner page.
+* Org::                         Saving to an Org Mode file.
 @end menu
 
address@hidden Text File, Mailbox, Backends, Backends
address@hidden Text File, Diary, Backends, Backends
address@hidden  node-name,  next,  previous,  up
 @section Saving to a Text File
address@hidden text file
address@hidden outline
address@hidden text file, saving to
 
-This backend comes with Emacs.
address@hidden Insinuation
 
 @lisp
 (setq remember-handler-functions '(remember-append-to-file))
 @end lisp
 
address@hidden Options
+
 @defopt remember-data-file
+The file in which to store unprocessed data.
 @end defopt
 
 @defopt remember-leader-text
+The text used to begin each remember item.
 @end defopt
 
address@hidden Mailbox, Bibliography, Text File, Backends
address@hidden Saving to a Mailbox
address@hidden mailbox, saving to a
-
address@hidden
-(setq remember-handler-functions '(remember-store-in-mailbox))
address@hidden lisp
-
address@hidden remember-mailbox
-Name of mailbox to save messages to.
address@hidden defopt
-
-This backend does not come with Emacs.  To get it, download the latest
-version of Remember from @url{http://download.gna.org/remember-el/}.
-
-If you want to use BBDB to associate remembered snippets with entries
-in your contact database, use the following code snippet:
-
address@hidden
-(require 'remember-bbdb)
-(setq remember-handler-functions '(remember-bbdb-store-in-mailbox))
address@hidden lisp
-
address@hidden Bibliography, Planner Page, Mailbox, Backends
address@hidden Saving to a Bibliography
-
-This backend does not come with Emacs.  To get it, download the latest
-version of Remember from @url{http://download.gna.org/remember-el/}.
address@hidden Diary, Mailbox, Text File, Backends
address@hidden  node-name,  next,  previous,  up
address@hidden Saving to a Diary file
address@hidden diary, integration
 
-Bibl-mode is a major mode for maintaining bibliography files. You can
-get bibl-mode from:
address@hidden://ftp.azc.uam.mx/mirrors/gnu/emacs-lisp/bosullivan-packages/bibl-mode/}.
address@hidden Insinuation
 
 @lisp
-(require 'remember-bibl)
+(require 'remember-diary)
+(add-to-list 'remember-handler-functions 'remember-diary-extract-entries)
 @end lisp
 
address@hidden remember-url
-Remember a URL in @code{bibl-mode} that is being visited with w3.
address@hidden defun
address@hidden Options
 
address@hidden remember-location
-Remember a bookmark location in `bibl-mode'.
address@hidden defun
-
-You can use this in addition to your normal remember backend.
address@hidden remember-diary-file
+File for extracted diary entries.
address@hidden defopt
 
address@hidden Planner Page,  , Bibliography, Backends
address@hidden Mailbox, Org, Diary, Backends
 @comment  node-name,  next,  previous,  up
address@hidden Saving to a Planner Page
address@hidden @file{remember-planner.el}, using
address@hidden remember-el, using with PlannerMode
-
-This backend does not come with Emacs.  To get it, download the latest
-version of Remember from @url{http://download.gna.org/remember-el/}.
-
-If you are using PlannerMode, depending on your configuration, notes
-made using remember-el may actually be saved to a project and/or day
-plan page.
-
address@hidden makes the notes you save with remember have
-more context information associated with them, in the way that
-PlannerMode tasks do.
-
-To use remember-planner, place this in your @file{.emacs}:
-
address@hidden
-(require 'remember-planner)
-(setq remember-handler-functions '(remember-planner-append))
address@hidden lisp
address@hidden Saving to a Mailbox
address@hidden mailbox, saving to
 
-To take advantage of PlannerMode's annotation functions, add the
-following code as well:
address@hidden Insinuation
 
 @lisp
-(setq remember-annotation-functions planner-annotation-functions)
+(add-to-list 'remember-handler-functions 'remember-store-in-mailbox)
 @end lisp
 
-Then, type @kbd{M-x remember} to remember new text, @kbd{M-x
-remember-region} to remember the current region, or @kbd{C-u M-x
-remember} to remember the current region but have an opportunity to
-edit it before it is saved.
-
address@hidden remember-planner-xref-p
-Non-nil means cross-reference new entries with plan pages. Plan pages
-are useful for gathering related information. If you don't want a note
-associated with a plan page, you can press RET to accept the default
-(just today's page) or specify nil at the prompt.
address@hidden defopt
address@hidden Options
 
address@hidden remember-planner-copy-on-xref-flag
-Non-nil means copy note text instead of moving it to the plan page. If
-nil, move the note body to the plan page, leaving a cross-reference
-link on the day page. This results in shorter day pages but may be
-harder for people to read.
address@hidden remember-mailbox
+The file in which to store remember data as mail.
 @end defopt
 
address@hidden remember-planner-timestamp-format
-Format of timestamp for remember entries.
address@hidden remember-default-priority
+The default priority for remembered mail messages.
 @end defopt
 
address@hidden does not define any interactive functions
-or keybindings.
-
address@hidden Copying, GNU Free Documentation License, Backends, Top
address@hidden Org, , Mailbox, Backends
 @comment  node-name,  next,  previous,  up
address@hidden GNU GENERAL PUBLIC LICENSE
address@hidden gpl.texi
address@hidden Saving to an Org Mode file
address@hidden org mode, integration
+
+For instructions on how to integrate Remember with Org Mode,
+consult @ref{Remember, , , org}.
 
address@hidden GNU Free Documentation License, Concept Index, Copying, Top
address@hidden GNU Free Documentation License, Concept Index, Backends, Top
 @appendix GNU Free Documentation License
 @include doclicense.texi