From a424317301c738e5d9d0325b594ff31be664d41c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aur=C3=A9lien=20Bosch=C3=A9?= Date: Fri, 29 Mar 2019 07:46:42 +0100 Subject: [PATCH 2/2] Docs: specify that raw option does not delimit the results --- doc/org-manual.org | 27 ++++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index b818b4bae..d006c5b73 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -17275,8 +17275,10 @@ follows from the type specified above. - =raw= :: - Interpreted as raw Org mode. Inserted directly into the buffer. - Aligned if it is a table. Usage example: =:results value raw=. + Interpreted as raw Org mode. Inserted directly into the buffer. + Aligned if it is a table. No delimiters are added to mark the end of + the raw output so options like =replace=, =append= and =prepend= + won't work as intended. Usage example: =:results value raw=. #+cindex: @samp{wrap}, header argument The =wrap= header argument unconditionnally marks the results block by @@ -17286,14 +17288,14 @@ specified, Org wraps the results in a =#+BEGIN_results= value listed above. E.g., #+begin_example -,#+BEGIN_SRC emacs-lisp :results html :wrap EXPORT markdown -"Welcome back to the 90's" -,#+END_SRC + ,#+BEGIN_SRC emacs-lisp :results html :wrap EXPORT markdown + "Welcome back to the 90's" + ,#+END_SRC -,#+RESULTS: -,#+BEGIN_EXPORT markdown -Welcome back to the 90's -,#+END_EXPORT + ,#+RESULTS: + ,#+BEGIN_EXPORT markdown + Welcome back to the 90's + ,#+END_EXPORT #+end_example *** Handling @@ -17325,6 +17327,13 @@ Handling options after collecting the results. Does not remove previous results. Usage example: =:results output prepend=. +Options =replace=, =append= and =prepend= need to find the end of the +previously inserted results and so won't work as intended if the =raw= +option to the =results= header argument was in force. In this case +consider using the =:wrap= header argument. + +Handling options after collecting the results. + *** Post-processing :PROPERTIES: :UNNUMBERED: notoc -- 2.21.0