Next: Function Reference, Previous: Implementation, Up: Top

## 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-finalize`) to save the note and close the ‘`*Remember*`’ buffer.

By default, `remember-finalize` 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)

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.

— User Option: remember-run-all-annotation-functions-flag

> Non-nil means use all annotations returned by `remember-annotation-functions`.

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)))