From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ken Mankoff Subject: :comments org doesn't export comments below code Date: Thu, 12 Jul 2018 06:44:06 -0400 Message-ID: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:41205) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) 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 ) 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 ) 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 ; 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 (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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Org-mode 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.