Variable: org-agenda-files

org-agenda-files is a customizable variable defined in org.el.gz.

Value

nil

Documentation

The files to be used for agenda display.

If an entry is a directory, all files in that directory that are matched by org-agenda-file-regexp will be part of the file list.

If the value of the variable is not a list but a single file name, then the list of agenda files is actually stored and maintained in that file, one agenda file per line. In this file paths can be given relative to org-directory. Tilde expansion and environment variable substitution are also made.

Entries may be added to this list with M-x org-agenda-file-to-front (org-agenda-file-to-front) and removed with M-x org-remove-file (org-remove-file).

View in manual

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defcustom org-agenda-files nil
  "The files to be used for agenda display.

If an entry is a directory, all files in that directory that are matched
by `org-agenda-file-regexp' will be part of the file list.

If the value of the variable is not a list but a single file name, then
the list of agenda files is actually stored and maintained in that file,
one agenda file per line.  In this file paths can be given relative to
`org-directory'.  Tilde expansion and environment variable substitution
are also made.

Entries may be added to this list with `\\[org-agenda-file-to-front]'
and removed with `\\[org-remove-file]'."
  :group 'org-agenda
  :type '(choice
	  (repeat :tag "List of files and directories" file)
	  (file :tag "Store list in a file\n" :value "~/.agenda_files")))