org: Internal archiving
9.6.2 Internal archiving
------------------------
If you want to just switch off (for agenda views) certain subtrees
without moving them to a different file, you can use the ‘ARCHIVE tag’.
A headline that is marked with the ARCHIVE tag (Tags) stays
at its location in the outline tree, but behaves in the following way:
− It does not open when you attempt to do so with a visibility
cycling command (Visibility cycling). You can force
cycling archived subtrees with ‘C-<TAB>’, or by setting the option
‘org-cycle-open-archived-trees’. Also normal outline commands like
‘show-all’ will open archived subtrees.
− During sparse tree construction (Sparse trees), matches in
archived subtrees are not exposed, unless you configure the option
‘org-sparse-tree-open-archived-trees’.
− During agenda view construction (Agenda Views), the content
of archived trees is ignored unless you configure the option
‘org-agenda-skip-archived-trees’, in which case these trees will
always be included. In the agenda you can press ‘v a’ to get
archives temporarily included.
− Archived trees are not exported (Exporting), only the
headline is. Configure the details using the variable
‘org-export-with-archived-trees’.
− Archived trees are excluded from column view unless the variable
‘org-columns-skip-archived-trees’ is configured to ‘nil’.
The following commands help manage the ARCHIVE tag:
‘C-c C-x a (org-toggle-archive-tag)’
Toggle the ARCHIVE tag for the current headline. When the tag is
set, the headline changes to a shadowed face, and the subtree below
it is hidden.
‘C-u C-c C-x a’
Check if any direct children of the current headline should be
archived. To do this, each subtree is checked for open TODO
entries. If none are found, the command offers to set the ARCHIVE
tag for the child. If the cursor is _not_ on a headline when this
command is invoked, the level 1 trees will be checked.
‘C-TAB (org-force-cycle-archived)’
Cycle a tree even if it is tagged with ARCHIVE.
‘C-c C-x A (org-archive-to-archive-sibling)’
Move the current entry to the _Archive Sibling_. This is a sibling
of the entry with the heading ‘Archive’ and the tag ‘ARCHIVE’. The
entry becomes a child of that sibling and in this way retains a lot
of its original context, including inherited tags and approximate
position in the outline.