diff options
author | Bastien Guerry <bzg@gnu.org> | 2014-04-22 16:07:45 +0200 |
---|---|---|
committer | Bastien Guerry <bzg@gnu.org> | 2014-04-22 16:07:45 +0200 |
commit | 30cb51f1bc9ce5976f492b5df5d30c6298f5a2aa (patch) | |
tree | 782f2f5767065ad571bf5b82a162da96064cf22a /doc/misc/org.texi | |
parent | d5ff4ded7a225306017006fc96b0a30180ae6f6b (diff) | |
download | emacs-30cb51f1bc9ce5976f492b5df5d30c6298f5a2aa.tar.gz |
Merge Org 8.2.6-1.
The last merge was from 8.2.5c, but many important bugs got
fixed between 8.2.5c and 8.2.6-1.
Diffstat (limited to 'doc/misc/org.texi')
-rw-r--r-- | doc/misc/org.texi | 63 |
1 files changed, 37 insertions, 26 deletions
diff --git a/doc/misc/org.texi b/doc/misc/org.texi index c6b8c90293f..48a6fe56cf6 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi @@ -2,7 +2,7 @@ @c %**start of header @setfilename ../../info/org @settitle The Org Manual -@set VERSION 8.2.5c +@set VERSION 8.2.6 @c Version and Contact Info @set MAINTAINERSITE @uref{http://orgmode.org,maintainers web page} @@ -275,7 +275,7 @@ modify this GNU manual.'' @dircategory Emacs editing modes @direntry -* Org Mode: (org). Outline-based notes management and organizer. +* Org Mode: (org). Outline-based notes management and organizer @end direntry @titlepage @@ -585,8 +585,8 @@ Exporting * OpenDocument Text export:: Exporting to OpenDocument Text * Org export:: Exporting to Org * iCalendar export:: Exporting to iCalendar -* Other built-in back-ends:: Exporting to @code{Texinfo}, a man page, or Org -* Export in foreign buffers:: Author tables in lists in Org syntax +* Other built-in back-ends:: Exporting to @code{Texinfo} or a man page +* Export in foreign buffers:: Author tables and lists in Org syntax * Advanced configuration:: Fine-tuning the export output HTML export @@ -877,7 +877,11 @@ We @b{strongly recommend} to stick to a single installation method. Recent Emacs distributions include a packaging system which lets you install Elisp libraries. You can install Org with @kbd{M-x package-install RET org}. -You need to do this in a session where no @code{.org} file has been visited. + +@noindent @b{Important}: you need to do this in a session where no @code{.org} file has +been visited, i.e. where no Org built-in function have been loaded. +Otherwise autoload Org functions will mess up the installation. + Then, to make sure your Org configuration is taken into account, initialize the package system with @code{(package-initialize)} in your @file{.emacs} before setting any Org option. If you want to use Org's package repository, @@ -1339,7 +1343,7 @@ When Emacs first visits an Org file, the global state is set to OVERVIEW, i.e., only the top level headlines are visible@footnote{When @code{org-agenda-inhibit-startup} is non-@code{nil}, Org will not honor the default visibility state when first opening a file for the agenda (@pxref{Speeding up -your agendas}).} This can be configured through the variable +your agendas}).}. This can be configured through the variable @code{org-startup-folded}, or on a per-file basis by adding one of the following lines anywhere in the buffer: @@ -5525,6 +5529,9 @@ of 5 to 20 days, representing what to expect if everything goes either extremely well or extremely poorly. In contrast, @code{est+} estimates the full job more realistically, at 10--15 days. +Numbers are right-aligned when a format specifier with an explicit width like +@code{%5d} or @code{%5.1f} is used. + Here is an example for a complete columns definition, along with allowed values. @@ -9729,8 +9736,8 @@ multiple footnotes side by side. @vindex org-fontify-emphasized-text @vindex org-emphasis-regexp-components @vindex org-emphasis-alist -You can make words @b{*bold*}, @i{/italic/}, _underlined_, @code{=code=} -and @code{~verbatim~}, and, if you must, @samp{+strike-through+}. Text +You can make words @b{*bold*}, @i{/italic/}, _underlined_, @code{=verbatim=} +and @code{~code~}, and, if you must, @samp{+strike-through+}. Text in the code and verbatim string is not processed for Org mode specific syntax, it is exported verbatim. @@ -9888,7 +9895,7 @@ Here is an example: @example #+BEGIN_SRC emacs-lisp -n -r (save-excursion (ref:sc) - (goto-char (point-min)) (ref:jump) + (goto-char (point-min))) (ref:jump) #+END_SRC In line [[(sc)]] we remember the current position. [[(jump)][Line (jump)]] jumps to point-min. @@ -10358,8 +10365,8 @@ in the iCalendar format. * OpenDocument Text export:: Exporting to OpenDocument Text * Org export:: Exporting to Org * iCalendar export:: Exporting to iCalendar -* Other built-in back-ends:: Exporting to @code{Texinfo}, a man page, or Org -* Export in foreign buffers:: Author tables in lists in Org syntax +* Other built-in back-ends:: Exporting to @code{Texinfo} or a man page +* Export in foreign buffers:: Author tables and lists in Org syntax * Advanced configuration:: Fine-tuning the export output @end menu @@ -10400,10 +10407,10 @@ export dispatcher with the following key combinations: Toggle asynchronous export. Asynchronous export uses an external Emacs process that is configured with a specified initialization file. -While exporting asynchronously, the output is not displayed. It is stored in -a list called ``the export stack'', and can be viewed from there. The stack -can be reached by calling the dispatcher with a double @kbd{C-u} prefix -argument, or with @kbd{&} key from the dispatcher. +While exporting asynchronously, the output is not displayed, but stored in +a place called ``the export stack''. This stack can be displayed by calling +the dispatcher with a double @kbd{C-u} prefix argument, or with @kbd{&} key +from the dispatcher menu. @vindex org-export-in-background To make this behavior the default, customize the variable @@ -11762,13 +11769,12 @@ the @LaTeX{} @code{\includegraphics} macro will be commented out. @cindex plain lists, in @LaTeX{} export Plain lists accept two optional attributes: @code{:environment} and -@code{:options}. The first one allows the use of a non-standard -environment (e.g., @samp{inparaenum}). The second one specifies -optional arguments for that environment (square brackets may be -omitted). +@code{:options}. The first one allows the use of a non-standard environment +(e.g., @samp{inparaenum}). The second one specifies additional arguments for +that environment. @example -#+ATTR_LATEX: :environment compactitem :options $\circ$ +#+ATTR_LATEX: :environment compactitem :options [$\circ$] - you need ``paralist'' package to reproduce this example. @end example @@ -13773,8 +13779,13 @@ can be used to map arbitrary language names to existing major modes. @item org-src-window-setup Controls the way Emacs windows are rearranged when the edit buffer is created. @item org-src-preserve-indentation -This variable is especially useful for tangling languages such as -Python, in which whitespace indentation in the output is critical. +By default, the value is @code{nil}, which means that when code blocks are +evaluated during export or tangled, they are re-inserted into the code block, +which may replace sequences of spaces with tab characters. When non-nil, +whitespace in code blocks will be preserved during export or tangling, +exactly as it appears. This variable is especially useful for tangling +languages such as Python, in which whitespace indentation in the output is +critical. @item org-src-ask-before-returning-to-edit-buffer By default, Org will ask before returning to an open edit buffer. Set this variable to @code{nil} to switch without asking. @@ -15827,7 +15838,7 @@ The corresponding variable is @code{org-archive-location}. This line sets the category for the agenda file. The category applies for all subsequent lines until the next @samp{#+CATEGORY} line, or the end of the file. The first such line also applies to any entries before it. -@item #+COLUMNS: %25ITEM ..... +@item #+COLUMNS: %25ITEM ... @cindex property, COLUMNS Set the default format for columns view. This format applies when columns view is invoked in locations where no @code{COLUMNS} property @@ -15842,11 +15853,11 @@ The global version of this variable is @item #+FILETAGS: :tag1:tag2:tag3: Set tags that can be inherited by any entry in the file, including the top-level entries. -@item #+DRAWERS: NAME1 ..... +@item #+DRAWERS: NAME1 ... @vindex org-drawers Set the file-local set of additional drawers. The corresponding global variable is @code{org-drawers}. -@item #+LINK: linkword replace +@item #+LINK: linkword replace @vindex org-link-abbrev-alist These lines (several are allowed) specify link abbreviations. @xref{Link abbreviations}. The corresponding variable is @@ -16862,7 +16873,7 @@ Orgtbl mode how to translate this table and where to install it. For example: @cindex #+ORGTBL @example -#+ORGTBL: SEND table_name translation_function arguments.... +#+ORGTBL: SEND table_name translation_function arguments... @end example @noindent |