diff --git a/doc/org-manual.org b/doc/org-manual.org index f39a3651d..fd532941a 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -16180,6 +16180,19 @@ Here is an example source code block in the Emacs Lisp language: ,#+END_SRC #+end_example +Source code blocks are one of many Org block types, which also include +"center", "comment", "dynamic", "example", "export", "quote", +"special", and "verse". This section pertains to blocks between +=#+BEGIN_SRC= and =#+END_SRC=. + +Details of Org's facilities for working with source code are described +in the following sections. + +** Features +:PROPERTIES: +:DESCRIPTION: Enjoy the versatility of source blocks. +:END: + Org can manage the source code in the block delimited by =#+BEGIN_SRC= ... =#+END_SRC= in several ways that can simplify housekeeping tasks essential to modern source code maintenance. Org can edit, format, @@ -16188,14 +16201,8 @@ and execute a source code block, then capture the results. The Org mode literature sometimes refers to source code blocks as /live code/ blocks because they can alter the content of the Org document or the material that it exports. Users can control how live they want each -source code block by tweaking the header arguments (see [[*Using -Header Arguments]]) for compiling, execution, extraction, and -exporting. - -Source code blocks are one of many Org block types, which also include -"center", "comment", "dynamic", "example", "export", "quote", -"special", and "verse". This section pertains to blocks between -=#+BEGIN_SRC= and =#+END_SRC=. +source code block by tweaking the header arguments (see [[*Using Header +Arguments]]) for compiling, execution, extraction, and exporting. For editing and formatting a source code block, Org uses an appropriate Emacs major mode that includes features specifically @@ -16233,9 +16240,6 @@ configuration settings of the execution environment, the results of the execution, and associated narratives, claims, references, and internal and external links in a single Org document. -Details of Org's facilities for working with source code are described -in the following sections. - ** Structure of Code Blocks :PROPERTIES: :DESCRIPTION: Code block syntax described.