org-manual: Slight rewording for indented source blocks

* doc/org-manual.org (Literal Examples): Slight rewording.  Merge
indentation information into the same paragraph.
This commit is contained in:
Nicolas Goaziou 2019-08-17 14:50:08 +02:00
parent d8778d9305
commit d841b38086
1 changed files with 9 additions and 7 deletions

View File

@ -11014,11 +11014,9 @@ suited for source code and similar examples.
,#+END_EXAMPLE ,#+END_EXAMPLE
#+end_example #+end_example
Note that such blocks may be /indented/ in order to align nicely with For simplicity when using small examples, you can also start the
indented text and in particular with plain list structure (see example lines with a colon followed by a space. There may also be
[[*Plain Lists]]). For simplicity when using small examples, you can additional whitespace before the colon:
also start the example lines with a colon followed by a space. There
may also be additional whitespace before the colon:
#+begin_example #+begin_example
Here is an example Here is an example
@ -11086,8 +11084,12 @@ jumps to point-min.
#+end_example #+end_example
#+cindex: indentation, in source blocks #+cindex: indentation, in source blocks
Finally, you can use =-i= to preserve the indentation of a specific Source code and examples may be /indented/ in order to align nicely
code block (see [[*Editing Source Code]]). with the surrounding text, and in particular with plain list structure
(see [[*Plain Lists]]). By default, Org only retains the relative
indentation between lines, e.g., when exporting the contents of the
block. However, you can use the =-i= switch to also preserve the
global indentation, if it does matter. See [[*Editing Source Code]].
#+vindex: org-coderef-label-format #+vindex: org-coderef-label-format
If the syntax for the label format conflicts with the language syntax, If the syntax for the label format conflicts with the language syntax,