5 Quick Start

• Load remember.el.
• Type M-x remember. The ‘*Remember*’ buffer should be displayed.
• Type in what you want to remember. The first line will be treated as the headline, and the rest of the buffer will contain the body of the note.
• Type C-c C-c (remember-buffer) to save the note and close the ‘*Remember*’ buffer.

By default, remember-buffer saves the note in ~/.notes. You can edit it now to see the remembered and timestamped note. You can edit this file however you want. New entries will always be added to the end.

To remember a region of text, use the universal prefix. C-u M-x remember displays a ‘*Remember*’ buffer with the region as the initial contents.

As a simple beginning, you can start by using the Text File backend, keeping your ~/.notes file in outline-mode format, with a final entry called ‘* Raw data’. Remembered data will be added to the end of the file. Every so often, you can move the data that gets appended there into other files, or reorganize your document.

You can also store remembered data in other backends. (see Backends)

Here is one way to map the remember functions in your .emacs to very accessible keystrokes facilities using the mode:

     (autoload 'remember ``remember'' nil t)
     (autoload 'remember-region ``remember'' nil t)
     
     (define-key global-map (kbd "<f9> r") 'remember)
     (define-key global-map (kbd "<f9> R") 'remember-region)

Check out the Planner package (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. (see Planner Page)

By default, remember uses the first annotation returned by remember-annotation-functions. To include all of the annotations, set remember-run-all-annotation-functions-flag to non-nil.

You can write custom functions that use a different set of remember-annotation-functions. For example:

     (defun my/remember-with-filename ()
      "Always use the filename."
      (interactive)
      (let ((remember-annotation-functions '(buffer-file-name)))
       (call-interactively 'remember)))