org.texi: Small fixes

* doc/org.texi (Structure of code blocks): Remove too recent @indentedblock structure and fix some @ref, @xref, @pxref uses.

org.texi: Small fixes
* doc/org.texi (Structure of code blocks): Remove too recent @indentedblock structure and fix some @ref, @xref, @pxref uses.
400186d8 · Nicolas Goaziou · b9ed40c4 · 400186d8
Commit 400186d8 authored Nov 18, 2016 by Nicolas Goaziou
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -14839,18 +14839,9 @@ Details of Org's facilities for working with source code are shown next.
 @cindex #+NAME
 @cindex #+BEGIN_SRC
  
-Org offers two ways to structure source code in org documents: in a
+Org offers two ways to structure source code in Org documents: in a
 @samp{src} block, and directly inline.  Both specifications are shown below.
  
-@indentedblock
-Org mode's @ref{Easy templates} system speeds up creating @samp{src} blocks
-with just a couple of keystrokes.  Don't be put-off by having to type or
-remember the source block syntax.  Any other completion system in Emacs (of
-which there are several, some even predate Org) can be customized to create
-these Org @samp{src} blocks to reduce errors, increase accuracy, and maintain
-consistency.
-@end indentedblock
-
 A @samp{src} block conforms to this structure:
  
 @example
@@ -14860,6 +14851,13 @@ A @samp{src} block conforms to this structure:
 #+END_SRC
 @end example
  
+Org mode's templates system (@pxref{Easy templates}) speeds up creating
+@samp{src} blocks with just a couple of keystrokes.  Don't be put-off by
+having to type or remember the source block syntax.  Any other completion
+system in Emacs---of which there are several, some even predate Org---can be
+customized to create these Org @samp{src} blocks to reduce errors, increase
+accuracy, and maintain consistency.
+
 @cindex source code, inline
 An inline code block conforms to this structure:
  
@@ -14877,8 +14875,8 @@ src_<language>[<header arguments>]@{<body>@}
 @item #+NAME: <name>
 Optional.  Names the @samp{src} block so it can be called, like a function,
 from other @samp{src} blocks or inline blocks to evaluate or to capture the
-results.  Code from other blocks, other files, and from table formulas (see
-@ref{The spreadsheet}) can use the name to reference a @samp{src} block.
+results.  Code from other blocks, other files, and from table formulas
+(@pxref{The spreadsheet}) can use the name to reference a @samp{src} block.
 This naming serves the same purpose as naming Org tables.  Org mode requires
 unique names.  For duplicate names, Org mode's behavior is undefined.
 @cindex #+NAME
@@ -14889,7 +14887,7 @@ Mandatory.  They mark the start and end of a block that Org requires.  The
 @cindex begin block, end block
 @item <language>
 Mandatory for live code blocks.  It is the identifier of the source code
-language in the block.  See @ref{Languages} for identifiers of supported
+language in the block.  @xref{Languages} for identifiers of supported
 languages.
 @cindex source code, language
 @item <switches>
@@ -14898,15 +14896,14 @@ format (see the discussion of switches in @ref{Literal examples})
 @cindex source code, switches
 @item <header arguments>
 Optional.  Heading arguments control many aspects of evaluation, export and
-tangling of code blocks (see @pxref{Header arguments}).  Using Org's
-properties feature, header arguments can be selectively applied to the entire
-buffer or specific sub-trees of the Org document.
+tangling of code blocks (@pxref{Header arguments}).  Using Org's properties
+feature, header arguments can be selectively applied to the entire buffer or
+specific sub-trees of the Org document.
 @item source code, header arguments
 @item <body>
 Source code in the dialect of the specified language identifier.
 @end table
  
-
 @node Editing source code
 @section Editing source code
 @cindex code block, editing