Bladeren bron

Manual: edits to Working With Source Code chapter

- Clarify that switches and header arguments are optional
- Document `org-src-fontify-natively'
Dan Davison 14 jaren geleden
bovenliggende
commit
a33a4003a1
1 gewijzigde bestanden met toevoegingen van 6 en 2 verwijderingen
  1. 6 2
      doc/org.texi

+ 6 - 2
doc/org.texi

@@ -11174,7 +11174,8 @@ The structure of code blocks is as follows:
 #+end_src
 @end example
 
-code blocks can also be embedded in text as so called inline code blocks as
+Switches and header arguments are optional. Code can also be embedded in text
+inline using
 
 @example
 src_<language>@{<body>@}
@@ -11196,7 +11197,7 @@ formulas (see @ref{The spreadsheet}).
 @item <language>
 The language of the code in the block.
 @item <switches>
-Switches controlling exportation of the code block (see switches discussion in
+Optional switches controlling exportation of the code block (see switches discussion in
 @ref{Literal examples})
 @item <header arguments>
 Optional header arguments control many aspects of evaluation, export and
@@ -11242,6 +11243,9 @@ By default, Org will ask before returning to an open edit buffer. Set
 this variable to nil to switch without asking.
 @end table
 
+To turn on native code fontification in the @emph{Org} buffer, configure the
+variable @code{org-src-fontify-natively}.
+
 @comment  node-name,  next,  previous,  up
 @comment  Exporting code blocks, Extracting source code, Editing source code, Working With Source Code