aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRasmus2018-03-27 23:34:41 +0200
committerRasmus2018-03-27 23:34:41 +0200
commit613c9a5c1f3237fbdc3a3db2341c7c59353d2aa2 (patch)
tree7651699ebeb2a2a2d8d1081707d091fbc424e8fb /doc
parent1b075a9e38ca6812417f95ed2272e61d875d9e86 (diff)
downloademacs-613c9a5c1f3237fbdc3a3db2341c7c59353d2aa2.tar.gz
emacs-613c9a5c1f3237fbdc3a3db2341c7c59353d2aa2.zip
Update Org to v9.1.9
Please note this is a bugfix release. See etc/ORG-NEWS for details.
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/org.texi86
1 files changed, 38 insertions, 48 deletions
diff --git a/doc/misc/org.texi b/doc/misc/org.texi
index 216f43eb32b..7583e2b88a4 100644
--- a/doc/misc/org.texi
+++ b/doc/misc/org.texi
@@ -4,11 +4,11 @@
4@settitle The Org Manual 4@settitle The Org Manual
5@include docstyle.texi 5@include docstyle.texi
6 6
7@set VERSION 9.1.6 7@set VERSION 9.1.9
8@set DATE 2018-01-03 8@set DATE 2018-03-22
9 9
10@c Version and Contact Info 10@c Version and Contact Info
11@set MAINTAINERSITE @uref{http://orgmode.org,maintainers web page} 11@set MAINTAINERSITE @uref{https://orgmode.org,maintainers web page}
12@set AUTHOR Carsten Dominik 12@set AUTHOR Carsten Dominik
13@set MAINTAINER Carsten Dominik 13@set MAINTAINER Carsten Dominik
14@set MAINTAINEREMAIL @email{carsten at orgmode dot org} 14@set MAINTAINEREMAIL @email{carsten at orgmode dot org}
@@ -856,7 +856,7 @@ platform.
856There is a website for Org which provides links to the newest 856There is a website for Org which provides links to the newest
857version of Org, as well as additional information, frequently asked 857version of Org, as well as additional information, frequently asked
858questions (FAQ), links to tutorials, etc. This page is located at 858questions (FAQ), links to tutorials, etc. This page is located at
859@uref{http://orgmode.org}. 859@uref{https://orgmode.org}.
860@cindex print edition 860@cindex print edition
861 861
862An earlier version (7.3) of this manual is available as a 862An earlier version (7.3) of this manual is available as a
@@ -894,11 +894,11 @@ Otherwise autoload Org functions will mess up the installation.
894Then, to make sure your Org configuration is taken into account, initialize 894Then, to make sure your Org configuration is taken into account, initialize
895the package system with @code{(package-initialize)} in your Emacs init file 895the package system with @code{(package-initialize)} in your Emacs init file
896before setting any Org option. If you want to use Org's package repository, 896before setting any Org option. If you want to use Org's package repository,
897check out the @uref{http://orgmode.org/elpa.html, Org ELPA page}. 897check out the @uref{https://orgmode.org/elpa.html, Org ELPA page}.
898 898
899@subsubheading Downloading Org as an archive 899@subsubheading Downloading Org as an archive
900 900
901You can download Org latest release from @uref{http://orgmode.org/, Org's 901You can download Org latest release from @uref{https://orgmode.org/, Org's
902website}. In this case, make sure you set the load-path correctly in your 902website}. In this case, make sure you set the load-path correctly in your
903Emacs init file: 903Emacs init file:
904 904
@@ -923,7 +923,7 @@ You can clone Org's repository and install Org like this:
923 923
924@example 924@example
925$ cd ~/src/ 925$ cd ~/src/
926$ git clone git://orgmode.org/org-mode.git 926$ git clone https://code.orgmode.org/bzg/org-mode.git
927$ make autoloads 927$ make autoloads
928@end example 928@end example
929 929
@@ -939,7 +939,7 @@ install Org with @code{make install}. Please run @code{make help} to get
939the list of compilation/installation options. 939the list of compilation/installation options.
940 940
941For more detailed explanations on Org's build system, please check the Org 941For more detailed explanations on Org's build system, please check the Org
942Build System page on @uref{http://orgmode.org/worg/dev/org-build-system.html, 942Build System page on @uref{https://orgmode.org/worg/dev/org-build-system.html,
943Worg}. 943Worg}.
944 944
945@node Activation 945@node Activation
@@ -952,7 +952,7 @@ Worg}.
952@findex org-agenda 952@findex org-agenda
953@findex org-capture 953@findex org-capture
954@findex org-store-link 954@findex org-store-link
955@findex org-iswitchb 955@findex org-switchb
956 956
957Org mode buffers need font-lock to be turned on: this is the default in 957Org mode buffers need font-lock to be turned on: this is the default in
958Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer 958Emacs@footnote{If you don't use font-lock globally, turn it on in Org buffer
@@ -962,7 +962,7 @@ There are compatibility issues between Org mode and some other Elisp
962packages, please take the time to check the list (@pxref{Conflicts}). 962packages, please take the time to check the list (@pxref{Conflicts}).
963 963
964The four Org commands @command{org-store-link}, @command{org-capture}, 964The four Org commands @command{org-store-link}, @command{org-capture},
965@command{org-agenda}, and @command{org-iswitchb} should be accessible through 965@command{org-agenda}, and @command{org-switchb} should be accessible through
966global keys (i.e., anywhere in Emacs, not just in Org buffers). Here are 966global keys (i.e., anywhere in Emacs, not just in Org buffers). Here are
967suggested bindings for these keys, please modify the keys to your own 967suggested bindings for these keys, please modify the keys to your own
968liking. 968liking.
@@ -970,7 +970,7 @@ liking.
970(global-set-key "\C-cl" 'org-store-link) 970(global-set-key "\C-cl" 'org-store-link)
971(global-set-key "\C-ca" 'org-agenda) 971(global-set-key "\C-ca" 'org-agenda)
972(global-set-key "\C-cc" 'org-capture) 972(global-set-key "\C-cc" 'org-capture)
973(global-set-key "\C-cb" 'org-iswitchb) 973(global-set-key "\C-cb" 'org-switchb)
974@end lisp 974@end lisp
975 975
976@cindex Org mode, turning on 976@cindex Org mode, turning on
@@ -1902,7 +1902,7 @@ marker in square brackets, inside text. Markers always start with
1902@example 1902@example
1903The Org homepage[fn:1] now looks a lot better than it used to. 1903The Org homepage[fn:1] now looks a lot better than it used to.
1904... 1904...
1905[fn:1] The link is: http://orgmode.org 1905[fn:1] The link is: https://orgmode.org
1906@end example 1906@end example
1907 1907
1908Org mode extends the number-based syntax to @emph{named} footnotes and 1908Org mode extends the number-based syntax to @emph{named} footnotes and
@@ -2032,7 +2032,7 @@ prefix is set, but folding/unfolding will work correctly.
2032@cindex Org syntax 2032@cindex Org syntax
2033 2033
2034A reference document providing a formal description of Org's syntax is 2034A reference document providing a formal description of Org's syntax is
2035available as @uref{http://orgmode.org/worg/dev/org-syntax.html, a draft on 2035available as @uref{https://orgmode.org/worg/dev/org-syntax.html, a draft on
2036Worg}, written and maintained by Nicolas Goaziou. It defines Org's core 2036Worg}, written and maintained by Nicolas Goaziou. It defines Org's core
2037internal concepts such as @code{headlines}, @code{sections}, @code{affiliated 2037internal concepts such as @code{headlines}, @code{sections}, @code{affiliated
2038keywords}, @code{(greater) elements} and @code{objects}. Each part of an Org 2038keywords}, @code{(greater) elements} and @code{objects}. Each part of an Org
@@ -2280,17 +2280,6 @@ format used by Orgtbl radio tables, see @ref{Translator functions}, for a
2280detailed description. 2280detailed description.
2281@end table 2281@end table
2282 2282
2283If you don't like the automatic table editor because it gets in your
2284way on lines which you would like to start with @samp{|}, you can turn
2285it off with
2286
2287@lisp
2288(setq org-enable-table-editor nil)
2289@end lisp
2290
2291@noindent Then the only table command that still works is
2292@kbd{C-c C-c} to do a manual re-align.
2293
2294@node Column width and alignment 2283@node Column width and alignment
2295@section Column width and alignment 2284@section Column width and alignment
2296@cindex narrow columns in tables 2285@cindex narrow columns in tables
@@ -2950,7 +2939,7 @@ element of @code{R-LIST}.
2950 2939
2951These three functions can be used to implement associative arrays, count 2940These three functions can be used to implement associative arrays, count
2952matching cells, rank results, group data etc. For practical examples 2941matching cells, rank results, group data etc. For practical examples
2953see @uref{http://orgmode.org/worg/org-tutorials/org-lookups.html, this 2942see @uref{https://orgmode.org/worg/org-tutorials/org-lookups.html, this
2954tutorial on Worg}. 2943tutorial on Worg}.
2955 2944
2956@node Editing and debugging formulas 2945@node Editing and debugging formulas
@@ -3284,7 +3273,7 @@ Further control over the labels, type, content, and appearance of plots can
3284be exercised through the @code{#+PLOT:} lines preceding a table. See below 3273be exercised through the @code{#+PLOT:} lines preceding a table. See below
3285for a complete list of Org-plot options. The @code{#+PLOT:} lines are 3274for a complete list of Org-plot options. The @code{#+PLOT:} lines are
3286optional. For more information and examples see the Org-plot tutorial at 3275optional. For more information and examples see the Org-plot tutorial at
3287@uref{http://orgmode.org/worg/org-tutorials/org-plot.html}. 3276@uref{https://orgmode.org/worg/org-tutorials/org-plot.html}.
3288 3277
3289@subsubheading Plot Options 3278@subsubheading Plot Options
3290 3279
@@ -5835,7 +5824,7 @@ An alternative way to capture and process property values into a table is
5835provided by Eric Schulte's @file{org-collector.el} which is a contributed 5824provided by Eric Schulte's @file{org-collector.el} which is a contributed
5836package@footnote{Contributed packages are not part of Emacs, but are 5825package@footnote{Contributed packages are not part of Emacs, but are
5837distributed with the main distribution of Org (visit 5826distributed with the main distribution of Org (visit
5838@uref{http://orgmode.org}).}. It provides a general API to collect 5827@uref{https://orgmode.org}).}. It provides a general API to collect
5839properties from entries in a certain scope, and arbitrary Lisp expressions to 5828properties from entries in a certain scope, and arbitrary Lisp expressions to
5840process these values before inserting them into a table or a dynamic block. 5829process these values before inserting them into a table or a dynamic block.
5841 5830
@@ -7062,6 +7051,7 @@ through the customize interface.
7062 7051
7063@table @kbd 7052@table @kbd
7064@orgkey{C-c c C} 7053@orgkey{C-c c C}
7054@vindex org-capture-templates
7065Customize the variable @code{org-capture-templates}. 7055Customize the variable @code{org-capture-templates}.
7066@end table 7056@end table
7067 7057
@@ -7657,13 +7647,13 @@ The variable @code{org-protocol-project-alist} maps URLs to local file names,
7657by stripping URL parameters from the end and replacing the @code{:base-url} 7647by stripping URL parameters from the end and replacing the @code{:base-url}
7658with @code{:working-directory} and @code{:online-suffix} with 7648with @code{:working-directory} and @code{:online-suffix} with
7659@code{:working-suffix}. For example, assuming you own a local copy of 7649@code{:working-suffix}. For example, assuming you own a local copy of
7660@url{http://orgmode.org/worg/} contents at @file{/home/user/worg}, you can 7650@url{https://orgmode.org/worg/} contents at @file{/home/user/worg}, you can
7661set @code{org-protocol-project-alist} to the following 7651set @code{org-protocol-project-alist} to the following
7662 7652
7663@lisp 7653@lisp
7664(setq org-protocol-project-alist 7654(setq org-protocol-project-alist
7665 '(("Worg" 7655 '(("Worg"
7666 :base-url "http://orgmode.org/worg/" 7656 :base-url "https://orgmode.org/worg/"
7667 :working-directory "/home/user/worg/" 7657 :working-directory "/home/user/worg/"
7668 :online-suffix ".html" 7658 :online-suffix ".html"
7669 :working-suffix ".org"))) 7659 :working-suffix ".org")))
@@ -7671,7 +7661,7 @@ set @code{org-protocol-project-alist} to the following
7671 7661
7672@noindent 7662@noindent
7673If you are now browsing 7663If you are now browsing
7674@url{http://orgmode.org/worg/org-contrib/org-protocol.html} and find a typo 7664@url{https://orgmode.org/worg/org-contrib/org-protocol.html} and find a typo
7675or have an idea about how to enhance the documentation, simply click the 7665or have an idea about how to enhance the documentation, simply click the
7676bookmark and start editing. 7666bookmark and start editing.
7677 7667
@@ -8024,7 +8014,7 @@ Remove current file from the list of agenda files.
8024@orgcmd{C-',org-cycle-agenda-files} 8014@orgcmd{C-',org-cycle-agenda-files}
8025@itemx C-, 8015@itemx C-,
8026Cycle through agenda file list, visiting one file after the other. 8016Cycle through agenda file list, visiting one file after the other.
8027@item M-x org-iswitchb @key{RET} 8017@item M-x org-switchb @key{RET}
8028Command to use an @code{iswitchb}-like interface to switch to and between Org 8018Command to use an @code{iswitchb}-like interface to switch to and between Org
8029buffers. 8019buffers.
8030@end table 8020@end table
@@ -9984,7 +9974,7 @@ To turn off fontification for marked up text, you can set
9984available markup syntax, you can customize @code{org-emphasis-alist}. To fine 9974available markup syntax, you can customize @code{org-emphasis-alist}. To fine
9985tune what characters are allowed before and after the markup characters, you 9975tune what characters are allowed before and after the markup characters, you
9986can tweak @code{org-emphasis-regexp-components}. Beware that changing one of 9976can tweak @code{org-emphasis-regexp-components}. Beware that changing one of
9987the above variables will no take effect until you reload Org, for which you 9977the above variables will not take effect until you reload Org, for which you
9988may need to restart Emacs. 9978may need to restart Emacs.
9989 9979
9990@node Horizontal rules 9980@node Horizontal rules
@@ -11779,7 +11769,7 @@ to @code{<a>} or @code{<img>} tags. This example shows changing the link's
11779@cindex @code{#+ATTR_HTML} 11769@cindex @code{#+ATTR_HTML}
11780@example 11770@example
11781#+ATTR_HTML: :title The Org mode homepage :style color:red; 11771#+ATTR_HTML: :title The Org mode homepage :style color:red;
11782[[http://orgmode.org]] 11772[[https://orgmode.org]]
11783@end example 11773@end example
11784 11774
11785@node Tables in HTML export 11775@node Tables in HTML export
@@ -12054,9 +12044,9 @@ program enhances large files in two different ways of viewing. One is an
12054navigation can be done with the @kbd{n} and @kbd{p} keys (and some other keys 12044navigation can be done with the @kbd{n} and @kbd{p} keys (and some other keys
12055as well, press @kbd{?} for an overview of the available keys). The second 12045as well, press @kbd{?} for an overview of the available keys). The second
12056one has a @emph{folding} view, much like Org provides inside Emacs. The 12046one has a @emph{folding} view, much like Org provides inside Emacs. The
12057script is available at @url{http://orgmode.org/org-info.js} and the 12047script is available at @url{https://orgmode.org/org-info.js} and the
12058documentation at @url{http://orgmode.org/worg/code/org-info-js/}. The script 12048documentation at @url{https://orgmode.org/worg/code/org-info-js/}. The script
12059is hosted on @url{http://orgmode.org}, but for reliability, prefer installing 12049is hosted on @url{https://orgmode.org}, but for reliability, prefer installing
12060it on your own web server. 12050it on your own web server.
12061 12051
12062To use this program, just add this line to the Org file: 12052To use this program, just add this line to the Org file:
@@ -12073,7 +12063,7 @@ below:
12073 12063
12074@example 12064@example
12075path: @r{The path to the script. The default grabs the script from} 12065path: @r{The path to the script. The default grabs the script from}
12076 @r{@url{http://orgmode.org/org-info.js}, but you might want to have} 12066 @r{@url{https://orgmode.org/org-info.js}, but you might want to have}
12077 @r{a local copy and use a path like @samp{../scripts/org-info.js}.} 12067 @r{a local copy and use a path like @samp{../scripts/org-info.js}.}
12078view: @r{Initial view when the website is first shown. Possible values are:} 12068view: @r{Initial view when the website is first shown. Possible values are:}
12079 info @r{Info-like interface with one section per page.} 12069 info @r{Info-like interface with one section per page.}
@@ -12993,10 +12983,10 @@ of these examples works:
12993@subsubheading Embedding clickable images 12983@subsubheading Embedding clickable images
12994For clickable images, provide a link whose description is another link to an 12984For clickable images, provide a link whose description is another link to an
12995image file. For example, to embed an image @file{org-mode-unicorn.png} which 12985image file. For example, to embed an image @file{org-mode-unicorn.png} which
12996when clicked jumps to @uref{http://Orgmode.org} website, do the following 12986when clicked jumps to @uref{https://orgmode.org} website, do the following
12997 12987
12998@example 12988@example
12999[[http://orgmode.org][./org-mode-unicorn.png]] 12989[[https://orgmode.org][./org-mode-unicorn.png]]
13000@end example 12990@end example
13001 12991
13002@subsubheading Sizing and scaling of embedded images 12992@subsubheading Sizing and scaling of embedded images
@@ -15512,7 +15502,7 @@ For more examples of header arguments for @code{#+CALL:} lines,
15512The ``Library of Babel'' is a collection of code blocks. Like a function 15502The ``Library of Babel'' is a collection of code blocks. Like a function
15513library, these code blocks can be called from other Org files. A collection 15503library, these code blocks can be called from other Org files. A collection
15514of useful code blocks is available on 15504of useful code blocks is available on
15515@uref{http://orgmode.org/worg/library-of-babel.html,Worg}. For remote code 15505@uref{https://orgmode.org/worg/library-of-babel.html,Worg}. For remote code
15516block evaluation syntax, @pxref{Evaluating code blocks}. 15506block evaluation syntax, @pxref{Evaluating code blocks}.
15517 15507
15518@kindex C-c C-v i 15508@kindex C-c C-v i
@@ -15554,7 +15544,7 @@ Org supports the following languages for the @samp{src} code blocks:
15554@end multitable 15544@end multitable
15555 15545
15556Additional documentation for some languages are at 15546Additional documentation for some languages are at
15557@uref{http://orgmode.org/worg/org-contrib/babel/languages.html}. 15547@uref{https://orgmode.org/worg/org-contrib/babel/languages.html}.
15558 15548
15559@vindex org-babel-load-languages 15549@vindex org-babel-load-languages
15560By default, only @code{emacs-lisp} is enabled for evaluation. To enable or 15550By default, only @code{emacs-lisp} is enabled for evaluation. To enable or
@@ -15642,7 +15632,7 @@ Org expand @code{:noweb} references by default.
15642Each language can have separate default header arguments by customizing the 15632Each language can have separate default header arguments by customizing the
15643variable @code{org-babel-default-header-args:<lang>}, where @code{<lang>} is 15633variable @code{org-babel-default-header-args:<lang>}, where @code{<lang>} is
15644the name of the language. For details, see the language-specific online 15634the name of the language. For details, see the language-specific online
15645documentation at @uref{http://orgmode.org/worg/org-contrib/babel}. 15635documentation at @uref{https://orgmode.org/worg/org-contrib/babel/}.
15646 15636
15647@node Header arguments in Org mode properties 15637@node Header arguments in Org mode properties
15648@subsubheading Header arguments in Org mode properties 15638@subsubheading Header arguments in Org mode properties
@@ -18225,7 +18215,7 @@ Org.
18225Org has a large number of hook variables for adding functionality. This 18215Org has a large number of hook variables for adding functionality. This
18226appendix illustrates using a few. A complete list of hooks with 18216appendix illustrates using a few. A complete list of hooks with
18227documentation is maintained by the Worg project at 18217documentation is maintained by the Worg project at
18228@uref{http://orgmode.org/worg/doc.html#hooks}. 18218@uref{https://orgmode.org/worg/doc.html#hooks}.
18229 18219
18230@node Add-on packages 18220@node Add-on packages
18231@section Add-on packages 18221@section Add-on packages
@@ -18234,10 +18224,10 @@ documentation is maintained by the Worg project at
18234Various authors wrote a large number of add-on packages for Org. 18224Various authors wrote a large number of add-on packages for Org.
18235 18225
18236These packages are not part of Emacs, but they are distributed as contributed 18226These packages are not part of Emacs, but they are distributed as contributed
18237packages with the separate release available at @uref{http://orgmode.org}. 18227packages with the separate release available at @uref{https://orgmode.org}.
18238See the @file{contrib/README} file in the source code directory for a list of 18228See the @file{contrib/README} file in the source code directory for a list of
18239contributed files. Worg page with more information is at: 18229contributed files. Worg page with more information is at:
18240@uref{http://orgmode.org/worg/org-contrib/}. 18230@uref{https://orgmode.org/worg/org-contrib/}.
18241 18231
18242@node Adding hyperlink types 18232@node Adding hyperlink types
18243@section Adding hyperlink types 18233@section Adding hyperlink types
@@ -18358,7 +18348,7 @@ to an alist of export functions. This alist replaces the parent back-end
18358functions. 18348functions.
18359 18349
18360For complete documentation, see 18350For complete documentation, see
18361@url{http://orgmode.org/worg/dev/org-export-reference.html, the Org Export 18351@url{https://orgmode.org/worg/dev/org-export-reference.html, the Org Export
18362Reference on Worg}. 18352Reference on Worg}.
18363 18353
18364@node Context-sensitive commands 18354@node Context-sensitive commands
@@ -18869,7 +18859,7 @@ Disable tag inheritance for agendas:
18869 18859
18870These options can be applied to selected agenda views. For more details 18860These options can be applied to selected agenda views. For more details
18871about generation of agenda views, see the docstrings for the relevant 18861about generation of agenda views, see the docstrings for the relevant
18872variables, and this @uref{http://orgmode.org/worg/agenda-optimization.html, 18862variables, and this @uref{https://orgmode.org/worg/agenda-optimization.html,
18873dedicated Worg page} for agenda optimization. 18863dedicated Worg page} for agenda optimization.
18874 18864
18875@node Extracting agenda information 18865@node Extracting agenda information
@@ -19213,7 +19203,7 @@ For a server to host files, consider options like
19213@uref{http://dropbox.com,Dropbox.com} account@footnote{An alternative is to 19203@uref{http://dropbox.com,Dropbox.com} account@footnote{An alternative is to
19214use webdav server. MobileOrg documentation has details of webdav server 19204use webdav server. MobileOrg documentation has details of webdav server
19215configuration. Additional help is at 19205configuration. Additional help is at
19216@uref{http://orgmode.org/worg/org-faq.html#mobileorg_webdav, FAQ entry}.}. 19206@uref{https://orgmode.org/worg/org-faq.html#mobileorg_webdav, FAQ entry}.}.
19217On first connection, MobileOrg creates a directory @file{MobileOrg/} on 19207On first connection, MobileOrg creates a directory @file{MobileOrg/} on
19218Dropbox. Pass its location to Emacs through an init file variable as 19208Dropbox. Pass its location to Emacs through an init file variable as
19219follows: 19209follows: