Due to the way Org works, TODO items, time-stamped items, and tagged headlines can be scattered throughout a file or even a number of files. To get an overview of open action items, or of events that are important for a particular date, this information must be collected, sorted and displayed in an organized way.
Org can select items based on various criteria and display them in a separate buffer. Six different view types are provided:
The extracted information is displayed in a special agenda buffer. This buffer is read-only, but provides commands to visit the corresponding locations in the original Org files, and even to edit these files remotely.
By default, the report ignores commented (see Comment lines) and archived
(see Internal archiving) entries. You can override this by setting
Two variables control how the agenda buffer is displayed and whether the
window configuration is restored when the agenda exits:
|• Agenda files:||Files being searched for agenda information|
|• Agenda dispatcher:||Keyboard access to agenda views|
|• Built-in agenda views:||What is available out of the box?|
|• Presentation and sorting:||How agenda items are prepared for display|
|• Agenda commands:||Remote editing of Org trees|
|• Custom agenda views:||Defining special searches and views|
|• Exporting agenda views:||Writing a view to a file|
|• Agenda column view:||Using column view for collected entries|