remember: Quick Start

 
 4 Quick Start
 *************
 
    • 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 ‘~/emacs.d/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 ‘~/.emacs.d/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 init file
 (SeeThe Emacs Initialization File (emacs)Init File.) to very
 accessible keystrokes facilities using the mode:
 
      (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 a non-‘nil’ value.
 
  -- 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)))
 
    The ‘remember-notes’ command creates a “notes” buffer that visits the
 file specified by the option ‘remember-data-file’.  The option
 ‘remember-notes-buffer-name’ specifies the name of the buffer.  The
 buffer uses ‘remember-notes-initial-major-mode’ and
 ‘remember-notes-mode’ minor mode.  Use ‘C-c C-c’ to save and bury the
 buffer.  The command ‘save-some-buffers’ saves this buffer without
 asking.  This function is a suitable setting for
 ‘initial-buffer-choice’.