updated from sources 2013/04/21
authorDavid Arroyo Menéndez <davidam@es.gnu.org>
Sun, 21 Apr 2013 09:24:07 +0000 (11:24 +0200)
committerDavid Arroyo Menéndez <davidam@es.gnu.org>
Sun, 21 Apr 2013 09:24:07 +0000 (11:24 +0200)
orgguide/orgguide.texi

index b92a9ba..a2feede 100644 (file)
@@ -147,7 +147,7 @@ Tags
 
 * Tag inheritance::            Tags use the tree structure of the outline
 * Setting tags::               How to assign tags to a headline
-* Tag searches::               Searching for combinations of tags
+* Tag groups::                 Use one tag to search for several tags
 * Tag searches::               Searching for combinations of tags
 
 Dates and Times
@@ -188,7 +188,7 @@ The built-in agenda views
 Markup for rich export
 
 * Structural markup elements:: The basic structure as seen by the exporter
-* Images and tables::          Tables and Images will be included
+* Images and tables::          Images, tables and caption mechanism
 * Literal examples::           Source code examples with special formatting
 * Include files::              Include additional files into a document
 * Embedded @LaTeX{}::          @LaTeX{} can be freely used inside Org documents
@@ -730,6 +730,9 @@ Links such as @samp{[[My Target]]} or @samp{[[My Target][Find my target]]}
 lead to a text search in the current file for the corresponding target which
 looks like @samp{<<My Target>>}.
 
+Internal links will be used to reference their destination, through links or
+numbers, when possible.
+
 @node External links, Handling links, Internal links, Hyperlinks
 @section External links
 
@@ -1110,7 +1113,7 @@ Tags will by default be in bold face with the same color as the headline.
 @menu
 * Tag inheritance::            Tags use the tree structure of the outline
 * Setting tags::               How to assign tags to a headline
-* Tag searches::               Searching for combinations of tags
+* Tag groups::                 Use one tag to search for several tags
 * Tag searches::               Searching for combinations of tags
 @end menu
 
@@ -1140,7 +1143,7 @@ changes in the line.}:
 #+FILETAGS: :Peter:Boss:Secret:
 @end smallexample
 
-@node Setting tags, Tag searches, Tag inheritance, Tags
+@node Setting tags, Tag groups, Tag inheritance, Tags
 @section Setting tags
 
 Tags can simply be typed into the buffer at the end of a headline.
@@ -1191,7 +1194,7 @@ can instead set the TAGS option line as:
 #+TAGS: @@work(w)  @@home(h)  @@tennisclub(t)  laptop(l)  pc(p)
 @end smallexample
 
-@node Tag searches, Tag searches, Setting tags, Tags
+@node Tag groups, Tag searches, Setting tags, Tags
 @section Tag groups
 
 @cindex group tags
@@ -1230,7 +1233,7 @@ If you want to ignore group tags temporarily, toggle group tags support
 with @command{org-toggle-tags-groups}, bound to @kbd{C-c C-x q}.  If you
 want to disable tag groups completely, set @var{org-group-tags} to nil.
 
-@node Tag searches,  , Tag searches, Tags
+@node Tag searches,  , Tag groups, Tags
 @section Tag searches
 
 Once a system of tags has been set up, it can be used to collect related
@@ -2087,7 +2090,7 @@ summarizes the markup rules used in an Org-mode buffer.
 
 @menu
 * Structural markup elements:: The basic structure as seen by the exporter
-* Images and tables::          Tables and Images will be included
+* Images and tables::          Images, tables and caption mechanism
 * Literal examples::           Source code examples with special formatting
 * Include files::              Include additional files into a document
 * Embedded @LaTeX{}::          @LaTeX{} can be freely used inside Org documents
@@ -2208,32 +2211,30 @@ Toggle the COMMENT keyword at the beginning of an entry.
 For Org mode tables, the lines before the first horizontal separator line
 will become table header lines.  You can use the following lines somewhere
 before the table to assign a caption and a label for cross references, and in
-the text you can refer to the object with @code{\ref@{tab:basic-data@}}:
+the text you can refer to the object with @code{[[tab:basic-data]]}:
 
 @smallexample
 #+CAPTION: This is the caption for the next table (or link)
-#+LABEL:   tbl:basic-data
+#+NAME:   tbl:basic-data
    | ... | ...|
    |-----|----|
 @end smallexample
 
-Some backends (HTML, @LaTeX{}, and DocBook) allow you to directly include
-images into the exported document.  Org does this, if a link to an image
-files does not have a description part, for example @code{[[./img/a.jpg]]}.
-If you wish to define a caption for the image and maybe a label for internal
-cross references, you sure that the link is on a line by itself precede it
-with:
+Some backends allow you to directly include images into the exported
+document.  Org does this, if a link to an image files does not have
+a description part, for example @code{[[./img/a.jpg]]}.  If you wish to
+define a caption for the image and maybe a label for internal cross
+references, you sure that the link is on a line by itself precede it with:
 
 @smallexample
 #+CAPTION: This is the caption for the next figure link (or table)
-#+LABEL:   fig:SED-HR4049
+#+NAME:   fig:SED-HR4049
 [[./img/a.jpg]]
 @end smallexample
 
-You may also define additional attributes for the figure.  As this is
-backend-specific, see the sections about the individual backends for more
-information.
-
+The same caption mechanism applies to other structures than images and tables
+(e.g., @LaTeX{} equations, source code blocks), provided the chosen export
+back-end supports them.
 
 @node Literal examples, Include files, Images and tables, Markup
 @section Literal examples
@@ -2293,7 +2294,7 @@ processed normally. @kbd{C-c '} will visit the included file.
 
 For scientific notes which need to be able to contain mathematical symbols
 and the occasional formula, Org-mode supports embedding @LaTeX{} code into
-its files.  You can directly use TeX-like macros for special symbols, enter
+its files.  You can directly use TeX-like syntax for special symbols, enter
 formulas and entire @LaTeX{} environments.
 
 @smallexample