Info Catalog org: Agenda Views org: Agenda Views org: Agenda dispatcher

org: Agenda files

 
 10.1 Agenda files
 =================
 
 The information to be shown is normally collected from all _agenda
 files_, the files listed in the variable ‘org-agenda-files’(1).  If a
 directory is part of this list, all files with the extension ‘.org’ in
 this directory will be part of the list.
 
    Thus, even if you only work with a single Org file, that file should
 be put into the list(2).  You can customize ‘org-agenda-files’, but the
 easiest way to maintain it is through the following commands
 
 ‘C-c [     (org-agenda-file-to-front)’
      Add current file to the list of agenda files.  The file is added to
      the front of the list.  If it was already in the list, it is moved
      to the front.  With a prefix argument, file is added/moved to the
      end.
 ‘C-c ]     (org-remove-file)’
      Remove current file from the list of agenda files.
 ‘C-'     (org-cycle-agenda-files)’
 ‘C-,’
      Cycle through agenda file list, visiting one file after the other.
 ‘M-x org-iswitchb RET’
      Command to use an ‘iswitchb’-like interface to switch to and
      between Org buffers.
 
 The Org menu contains the current list of files and can be used to visit
 any of them.
 
    If you would like to focus the agenda temporarily on a file not in
 this list, or on just one file in the list, or even on only a subtree in
 a file, then this can be done in different ways.  For a single agenda
 command, you may press ‘<’ once or several times in the dispatcher
 (Agenda dispatcher).  To restrict the agenda scope for an
 extended period, use the following commands:
 
 ‘C-c C-x <     (org-agenda-set-restriction-lock)’
      Permanently restrict the agenda to the current subtree.  When with
      a prefix argument, or with the cursor before the first headline in
      a file, the agenda scope is set to the entire file.  This
      restriction remains in effect until removed with ‘C-c C-x >’, or by
      typing either ‘<’ or ‘>’ in the agenda dispatcher.  If there is a
      window displaying an agenda view, the new restriction takes effect
      immediately.
 ‘C-c C-x >     (org-agenda-remove-restriction-lock)’
      Remove the permanent restriction created by ‘C-c C-x <’.
 
 When working with ‘speedbar.el’, you can use the following commands in
 the Speedbar frame:
 
 ‘< in the speedbar frame     (org-speedbar-set-agenda-restriction)’
      Permanently restrict the agenda to the item—either an Org file or a
      subtree in such a file—at the cursor in the Speedbar frame.  If
      there is a window displaying an agenda view, the new restriction
      takes effect immediately.
 ‘> in the speedbar frame     (org-agenda-remove-restriction-lock)’
      Lift the restriction.
 
    ---------- Footnotes ----------
 
    (1) If the value of that variable is not a list, but a single file
 name, then the list of agenda files will be maintained in that external
 file.
 
    (2) When using the dispatcher, pressing ‘<’ before selecting a
 command will actually limit the command to the current file, and ignore
 ‘org-agenda-files’ until the next dispatcher command.
 

Info Catalog org: Agenda Views org: Agenda Views org: Agenda dispatcher