Transcription
The Org ManualRelease 9.4The Org Mode Developers
This manual is for Org version 9.4.Copyright c 2004–2021 Free Software Foundation, Inc.Permission is granted to copy, distribute and/or modify this document underthe terms of the GNU Free Documentation License, Version 1.3 or any laterversion published by the Free Software Foundation; with no Invariant Sections,with the Front-Cover Texts being “A GNU Manual,” and with the Back-CoverTexts as in (a) below. A copy of the license is included in the section entitled“GNU Free Documentation License.”(a) The FSF’s Back-Cover Text is: “You have the freedom to copy and modifythis GNU manual.”
iTable of Contents1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.11.21.31.41.52Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Typesetting Conventions Used in this Manual . . . . . . . . . . . . . . . . . .11234Document Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.12.2Headlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Visibility Cycling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.2.1 Global and local cycling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.2.2 Initial visibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2.3 Catching invisible edits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.3 Motion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.4 Structure Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.5 Sparse Trees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.6 Plain Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.7 Drawers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.8 Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.13.23.33.43.5Built-in Table Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Column Width and Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Column Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .The Orgtbl Minor Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .The Spreadsheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.1 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.2 Formula syntax for Calc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.3 Emacs Lisp forms as formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.4 Durations and time values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.5 Field and range formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.6 Column formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.7 Lookup functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.8 Editing and debugging formulas . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.9 Updating the table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.10 Advanced features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6 Org Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16202121222224262727282829313233
ii4Hyperlinks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364.14.24.34.44.54.64.74.84.95Link Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Internal Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Radio Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .External Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Handling Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Using Links Outside Org . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Link Abbreviations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Search Options in File Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Custom Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .TODO Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465.15.2Basic TODO Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Extended Use of TODO Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.1 TODO keywords as workflow states . . . . . . . . . . . . . . . . . . . . . .5.2.2 TODO keywords as types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.3 Multiple keyword sets in one file . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.4 Fast access to TODO states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.5 Setting up keywords for individual files . . . . . . . . . . . . . . . . . . .5.2.6 Faces for TODO keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.7 TODO dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3 Progress Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3.1 Closing items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3.2 Tracking TODO state changes . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3.3 Tracking your habits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.4 Priorities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.5 Breaking Down Tasks into Subtasks . . . . . . . . . . . . . . . . . . . . . . . . . . .5.6 Checkboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .646474747484949495051515153545556Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596.16.26.36.47363738384043434445Tag Inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Setting Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Tag Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Tag Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59596263Properties and Columns . . . . . . . . . . . . . . . . . . . . . . 647.17.27.37.47.5Property Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Special Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Property Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Property Inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Column View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.1 Defining columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.1.1 Scope of column definitions . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.1.2 Column attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.2 Using column view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.3 Capturing column view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64666667686868687071
iii8Dates and Times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738.18.2Timestamps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Creating Timestamps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.2.1 The date/time prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.2.2 Custom time format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.3 Deadlines and Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.3.1 Inserting deadlines or schedules . . . . . . . . . . . . . . . . . . . . . . . . . . .8.3.2 Repeated tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.4 Clocking Work Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.4.1 Clocking commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.4.2 The clock table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.4.3 Resolving idle time and continuous clocking. . . . . . . . . . . . . . .8.5 Effort Estimates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.6 Taking Notes with a Relative Timer . . . . . . . . . . . . . . . . . . . . . . . . . . .973747577777979818183868889Refiling and Archiving . . . . . . . . . . . . . . . . . . . . . . . . 909.19.210Refile and Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Archiving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9.2.1 Moving a tree to an archive file . . . . . . . . . . . . . . . . . . . . . . . . . . .9.2.2 Internal archiving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90919191Capture and Attachments . . . . . . . . . . . . . . . . . . . 9310.1 Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.1 Setting up capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.2 Using capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.3 Capture templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9410.1.3.1 Template elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9410.1.3.2 Template expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9710.1.3.3 Templates in contexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9910.2 Attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9910.2.1 Attachment defaults and dispatcher . . . . . . . . . . . . . . . . . . . . 10010.2.2 Attachment options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10110.2.3 Attachment links. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10210.2.4 Automatic version-control with Git . . . . . . . . . . . . . . . . . . . . . 10310.2.5 Attach from Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10310.3 RSS Feeds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311Agenda Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10511.1 Agenda Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.2 The Agenda Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.3 The Built-in Agenda Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.3.1 Weekly/daily agenda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.3.2 The global TODO list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.3.3 Matching tags and properties . . . . . . . . . . . . . . . . . . . . . . . . . .11.3.4 Search view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.3.5 Stuck projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.4 Presentation and Sorting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105106107107110111113113114
iv11.4.1 Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.4.2 Time-of-day specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.4.3 Sorting of agenda items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.4.4 Filtering/limiting agenda items . . . . . . . . . . . . . . . . . . . . . . . . .11.5 Commands in the Agenda Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.6 Custom Agenda Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11.6.1 Storing searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
04.03.2014 · with the Front-Cover Texts being “A GNU Manual,” and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled “GNU Free Documentation License.” (a) The FSF’s Back-Cover Text is: “You have the freedom to copy and modify this GNU manual.”File Size: 1MBPage Count: 300
