org-manual: Clarify what :results drawer does for inline code blocks

* doc/org-manual.org (Format): Move :results raw description up.
Adapt :results drawer description from the docstring of
`org-babel-insert-result', mentioning what it means in inline src
blocks.

Link: https://orgmode.org/list/87v8dfnwcp.fsf@localhost
This commit is contained in:
Ihor Radchenko 2024-05-11 10:43:38 +03:00
parent f64c8a5a5b
commit 4deb06ea0a
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 8 additions and 6 deletions

View File

@ -18977,6 +18977,11 @@ Choose one of the options; they are mutually exclusive. The default
follows from the type specified above.
#+attr_texinfo: :sep ,
- =raw= ::
Interpreted as raw Org mode. Inserted directly into the buffer.
Aligned if it is a table. Usage example: =:results value raw=.
- =code= ::
Result enclosed in a code block. Useful for parsing. Usage
@ -18984,8 +18989,9 @@ follows from the type specified above.
- =drawer= ::
Result wrapped in a =RESULTS= drawer. Useful for containing =raw=
or =org= results for later scripting and automated processing.
Results are added directly to the Org file as with =raw=, but are
wrapped in a =RESULTS= drawer or results macro (for inline code
blocks), for later scripting and automated processing.
Usage example: =:results value drawer=.
- =html= ::
@ -19030,10 +19036,6 @@ follows from the type specified above.
block. Languages supported: Emacs Lisp, Python, and Ruby. Usage
example: =:results value pp=.
- =raw= ::
Interpreted as raw Org mode. Inserted directly into the buffer.
Aligned if it is a table. Usage example: =:results value raw=.
#+cindex: @samp{wrap}, header argument
The =wrap= header argument unconditionally marks the results block by