:comments org doesn't export comments below code

[Ken Mankoff <mankoff@gmail.com>]

Hi Org List,

I'm trying to understand the use-case of the ":comments org" header option. It seems like a nice way to generate code files with comments embedded in theory, but in practice I find it restrictive. I'm wondering if I'm misunderstanding its purpose, using it wrong, or have found a bug.

MWE:

========================================================
#+PROPERTY: header-args :comments org :tangle debug.sh 

* Foo

Foo text about Bar and Baz

** Bar
:PROPERTIES:
:SOMETHING: BAR VALUE
:END:

Bar pre text

#+BEGIN_SRC sh :results verbatim
echo "bar code"
#+END_SRC
#+RESULTS:

Bar post text

** Baz

Baz text

========================================================

Generates this:

========================================================

# Bar
# :PROPERTIES:
# :SOMETHING: BAR VALUE
# :END:

# Bar pre text
echo "bar code"

========================================================

The issues are 1) there is no "post text" exported. The "bar post text" discusses the results of the source block above it, but is not exported to the code file as comments, and 2) The Foo text is not exported either, but contains info relevant to the Bar code.

Is there a way to get more of the Org file embedded in the tangled code?

Thanks,

  -k.