From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ken Mankoff <mankoff@gmail.com>
Subject: :comments org doesn't export comments below code
Date: Thu, 12 Jul 2018 06:44:06 -0400
Message-ID: <m2va9klond.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:41205)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mankoff@gmail.com>) id 1fdZ53-0001Id-OH
	for emacs-orgmode@gnu.org; Thu, 12 Jul 2018 06:44:14 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mankoff@gmail.com>) id 1fdZ4y-00079u-Rb
	for emacs-orgmode@gnu.org; Thu, 12 Jul 2018 06:44:13 -0400
Received: from mail-qk0-x234.google.com ([2607:f8b0:400d:c09::234]:42227)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <mankoff@gmail.com>) id 1fdZ4y-00078q-Mi
	for emacs-orgmode@gnu.org; Thu, 12 Jul 2018 06:44:08 -0400
Received: by mail-qk0-x234.google.com with SMTP id 26-v6so4505081qks.9
	for <emacs-orgmode@gnu.org>; Thu, 12 Jul 2018 03:44:08 -0700 (PDT)
Received: from GEUS2690macwsm.local
	(pool-68-129-142-51.nycmny.fios.verizon.net. [68.129.142.51])
	by smtp.gmail.com with ESMTPSA id
	h195-v6sm14760832qke.58.2018.07.12.03.44.06
	for <emacs-orgmode@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Thu, 12 Jul 2018 03:44:07 -0700 (PDT)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Org-mode <emacs-orgmode@gnu.org>

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.