org.texi (Exporting): Add a note about conversion commands

* org.texi (Exporting): Add a note about conversion commands.
(Feedback, Orgstruct mode, Built-in table editor)
(Built-in table editor, Orgtbl mode, Updating the table)
(Property syntax, Capturing column view, Capture)
(Agenda files, Agenda commands, CDLaTeX mode, CDLaTeX mode)
(Exporting, Extending ODT export)
(Working with @LaTeX{} math snippets, dir, Customization)
(Radio tables, A @LaTeX{} example, Pulling from MobileOrg):
Uniformly use @kbd{M-x command RET}.
This commit is contained in:
Bastien Guerry 2013-04-13 15:25:03 +02:00
parent 7c212b273c
commit 5840e4cc64
1 changed files with 40 additions and 31 deletions

View File

@ -1008,10 +1008,10 @@ version of Org available---if you are running an outdated version, it is
quite possible that the bug has been fixed already. If the bug persists,
prepare a report and provide as much information as possible, including the
version information of Emacs (@kbd{M-x emacs-version @key{RET}}) and Org
(@kbd{M-x org-version @key{RET}}), as well as the Org related setup in
(@kbd{M-x org-version RET}), as well as the Org related setup in
@file{.emacs}. The easiest way to do this is to use the command
@example
@kbd{M-x org-submit-bug-report}
@kbd{M-x org-submit-bug-report RET}
@end example
@noindent which will put all this information into an Emacs mail buffer so
that you only need to add your description. If you re not sending the Email
@ -1071,7 +1071,7 @@ Reload uncompiled versions of all Org mode Lisp files. The backtrace
contains much more information if it is produced with uncompiled code.
To do this, use
@example
C-u M-x org-reload RET
@kbd{C-u M-x org-reload RET}
@end example
@noindent
or select @code{Org -> Refresh/Reload -> Reload Org uncompiled} from the
@ -2016,7 +2016,7 @@ you can use the usual commands to follow these links.
If you like the intuitive way the Org mode structure editing and list
formatting works, you might want to use these commands in other modes like
Text mode or Mail mode as well. The minor mode @code{orgstruct-mode} makes
this possible. Toggle the mode with @kbd{M-x orgstruct-mode}, or
this possible. Toggle the mode with @kbd{M-x orgstruct-mode RET}, or
turn it on by default, for example in Message mode, with one of:
@lisp
@ -2261,7 +2261,7 @@ window follow the cursor through the table and always show the current
field. The follow mode exits automatically when the cursor leaves the table,
or when you repeat this command with @kbd{C-u C-u C-c `}.
@c
@item M-x org-table-import
@item M-x org-table-import RET
Import a file as a table. The table should be TAB or whitespace
separated. Use, for example, to import a spreadsheet table or data
from a database, because these programs generally can write
@ -2274,7 +2274,7 @@ Tables can also be imported by pasting tabular text into the Org
buffer, selecting the pasted text with @kbd{C-x C-x} and then using the
@kbd{C-c |} command (see above under @i{Creation and conversion}).
@c
@item M-x org-table-export
@item M-x org-table-export RET
@findex org-table-export
@vindex org-table-export-default-format
Export the table, by default as a TAB-separated file. Use for data
@ -2403,7 +2403,7 @@ every vertical line you would like to have:
If you like the intuitive way the Org table editor works, you
might also want to use it in other modes like Text mode or Mail mode.
The minor mode Orgtbl mode makes this possible. You can always toggle
the mode with @kbd{M-x orgtbl-mode}. To turn it on by default, for
the mode with @kbd{M-x orgtbl-mode RET}. To turn it on by default, for
example in Message mode, use
@lisp
@ -3096,10 +3096,10 @@ hline are left alone, assuming that these are part of the table header.
Iterate the table by recomputing it until no further changes occur.
This may be necessary if some computed fields use the value of other
fields that are computed @i{later} in the calculation sequence.
@item M-x org-table-recalculate-buffer-tables
@item M-x org-table-recalculate-buffer-tables RET
@findex org-table-recalculate-buffer-tables
Recompute all tables in the current buffer.
@item M-x org-table-iterate-buffer-tables
@item M-x org-table-iterate-buffer-tables RET
@findex org-table-iterate-buffer-tables
Iterate all tables in the current buffer, in order to converge table-to-table
dependencies.
@ -5206,7 +5206,7 @@ in the current file will be offered as possible completions.
@orgcmd{C-c C-x p,org-set-property}
Set a property. This prompts for a property name and a value. If
necessary, the property drawer is created as well.
@item C-u M-x org-insert-drawer
@item C-u M-x org-insert-drawer RET
@cindex org-insert-drawer
Insert a property drawer into the current entry. The drawer will be
inserted early in the entry, but after the lines with planning
@ -5604,7 +5604,7 @@ global @r{make a global view, including all headings in the file}
@r{run column view at the top of this file}
"@var{ID}" @r{call column view in the tree that has an @code{:ID:}}
@r{property with the value @i{label}. You can use}
@r{@kbd{M-x org-id-copy} to create a globally unique ID for}
@r{@kbd{M-x org-id-copy RET} to create a globally unique ID for}
@r{the current entry and copy it to the kill-ring.}
@end example
@item :hlines
@ -6776,7 +6776,7 @@ If your configuration depends on @file{org-remember.el}, you need to update
it and use the setup described below. To convert your
@code{org-remember-templates}, run the command
@example
@kbd{M-x org-capture-import-remember-templates @key{RET}}
@kbd{M-x org-capture-import-remember-templates RET}
@end example
@noindent and then customize the new variable with @kbd{M-x
customize-variable org-capture-templates}, check the result, and save the
@ -7606,7 +7606,7 @@ Remove current file from the list of agenda files.
@itemx C-,
Cycle through agenda file list, visiting one file after the other.
@kindex M-x org-iswitchb
@item M-x org-iswitchb
@item M-x org-iswitchb RET
Command to use an @code{iswitchb}-like interface to switch to and between Org
buffers.
@end table
@ -9000,7 +9000,7 @@ calendars.
@orgcmd{H,org-agenda-holidays}
Show holidays for three months around the cursor date.
@item M-x org-icalendar-combine-agenda-files
@item M-x org-icalendar-combine-agenda-files RET
Export a single iCalendar file containing entries from all agenda files.
This is a globally available command, and also available in the agenda menu.
@ -10177,7 +10177,7 @@ some of the features of CD@LaTeX{} mode. You need to install
AUC@TeX{}) from @url{http://www.astro.uva.nl/~dominik/Tools/cdlatex}.
Don't use CD@LaTeX{} mode itself under Org mode, but use the light
version @code{org-cdlatex-mode} that comes as part of Org mode. Turn it
on for the current buffer with @code{M-x org-cdlatex-mode}, or for all
on for the current buffer with @kbd{M-x org-cdlatex-mode RET}, or for all
Org files with
@lisp
@ -10202,7 +10202,7 @@ the second brace. Even outside fragments, @key{TAB} will expand
environment abbreviations at the beginning of a line. For example, if
you write @samp{equ} at the beginning of a line and press @key{TAB},
this abbreviation will be expanded to an @code{equation} environment.
To get a list of all abbreviations, type @kbd{M-x cdlatex-command-help}.
To get a list of all abbreviations, type @kbd{M-x cdlatex-command-help RET}.
@item
@kindex _
@kindex ^
@ -10248,14 +10248,23 @@ documentation for more information.
Org mode documents can be exported into a variety of other formats.
For printing and sharing notes, ASCII export produces a readable and simple
version of an Org file. HTML export allows you to publish a notes file on
the web. @LaTeX{} export lets you use Org mode and its structured editing
version of an Org file. HTML export allows you to publish notes on the web
easily. @LaTeX{} export lets you use Org mode and its structured editing
functions to easily create @LaTeX{} files. OpenDocument Text (ODT) export
allows seamless collaboration across organizational boundaries. To
allows seamless collaboration across organizational boundaries. Markdown
export lets you seamlessly collaborate with other developers. Finally, to
incorporate entries with associated times like deadlines or appointments into
a desktop calendar program like iCal, Org mode can also produce extracts in
the iCalendar format.
Note that the built-in back-ends come with commands to convert the selected
region: e.g., in a HTML buffer, @kbd{M-x org-html-convert-region-to-html
RET} will replace the selected region with its HTML export. Used in
combination with @code{orgtbl-mode} and/or @code{orgstruc-mode}, this is a
powerful way of quickly editing tables and lists in HTML, @LaTeX{},
@code{Texinfo}, etc.
@menu
* The Export Dispatcher:: The main exporter interface
* Export formats:: Available export formats
@ -11636,7 +11645,7 @@ the following command.
@vindex org-odt-convert
@table @kbd
@item M-x org-odt-convert
@item M-x org-odt-convert RET
Convert an existing document from one format to another. With a prefix
argument, also open the newly produced file.
@end table
@ -11916,10 +11925,10 @@ You can use the following commands to quickly verify the reliability of
the @LaTeX{}-to-MathML converter.
@table @kbd
@item M-x org-odt-export-as-odf
@item M-x org-odt-export-as-odf RET
Convert a @LaTeX{} math snippet to an OpenDocument formula (@file{.odf}) file.
@item M-x org-odt-export-as-odf-and-open
@item M-x org-odt-export-as-odf-and-open RET
Convert a @LaTeX{} math snippet to an OpenDocument formula (@file{.odf}) file
and open the formula file with the system-registered application.
@end table
@ -14038,7 +14047,7 @@ While the @code{:file} header argument can be used to specify the path to the
output file, @code{:dir} specifies the default directory during code block
execution. If it is absent, then the directory associated with the current
buffer is used. In other words, supplying @code{:dir path} temporarily has
the same effect as changing the current directory with @kbd{M-x cd path}, and
the same effect as changing the current directory with @kbd{M-x cd path RET}, and
then not supplying @code{:dir}. Under the surface, @code{:dir} simply sets
the value of the Emacs variable @code{default-directory}.
@ -15078,7 +15087,7 @@ either by the @i{calc} interpreter, or by the @i{Emacs Lisp} interpreter.
There are more than 500 variables that can be used to customize
Org. For the sake of compactness of the manual, I am not
describing the variables here. A structured overview of customization
variables is available with @kbd{M-x org-customize}. Or select
variables is available with @kbd{M-x org-customize RET}. Or select
@code{Browse Org Group} from the @code{Org->Customization} menu. Many
settings can also be activated on a per-file basis, by putting special
lines into the buffer (@pxref{In-buffer settings}).
@ -16177,7 +16186,7 @@ in @LaTeX{}.
@item
You can just comment the table line-by-line whenever you want to process
the file, and uncomment it whenever you need to edit the table. This
only sounds tedious---the command @kbd{M-x orgtbl-toggle-comment}
only sounds tedious---the command @kbd{M-x orgtbl-toggle-comment RET}
makes this comment-toggling very easy, in particular if you bind it to a
key.
@end itemize
@ -16192,7 +16201,7 @@ activated by placing @code{\usepackage@{comment@}} into the document
header. Orgtbl mode can insert a radio table skeleton@footnote{By
default this works only for @LaTeX{}, HTML, and Texinfo. Configure the
variable @code{orgtbl-radio-tables} to install templates for other
modes.} with the command @kbd{M-x orgtbl-insert-radio-table}. You will
modes.} with the command @kbd{M-x orgtbl-insert-radio-table RET}. You will
be prompted for a table name, let's say we use @samp{salesfigures}. You
will then get the following template:
@ -17053,11 +17062,11 @@ this flagged entry is finished.
@kindex C-c a ?
If you are not able to process all flagged entries directly, you can always
return to this agenda view@footnote{Note, however, that there is a subtle
difference. The view created automatically by @kbd{M-x org-mobile-pull
@key{RET}} is guaranteed to search all files that have been addressed by the
last pull. This might include a file that is not currently in your list of
agenda files. If you later use @kbd{C-c a ?} to regenerate the view, only
the current agenda files will be searched.} using @kbd{C-c a ?}.
difference. The view created automatically by @kbd{M-x org-mobile-pull RET}
is guaranteed to search all files that have been addressed by the last pull.
This might include a file that is not currently in your list of agenda files.
If you later use @kbd{C-c a ?} to regenerate the view, only the current
agenda files will be searched.} using @kbd{C-c a ?}.
@node History and Acknowledgments, GNU Free Documentation License, MobileOrg, Top
@appendix History and acknowledgments