From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Cook, Malcolm" Subject: seeking good practices for writing about org using org Date: Wed, 3 Aug 2016 23:50:45 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:41189) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bV5w5-0006Yo-Ry for emacs-orgmode@gnu.org; Wed, 03 Aug 2016 19:50:54 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bV5vz-0005PT-Lw for emacs-orgmode@gnu.org; Wed, 03 Aug 2016 19:50:52 -0400 Received: from smtp02.stowers.org ([40.141.174.62]:35067) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bV5vz-0005PP-Dx for emacs-orgmode@gnu.org; Wed, 03 Aug 2016 19:50:47 -0400 Received: from pps.filterd (smtp02.stowers.org [127.0.0.1]) by smtp02.stowers.org (8.15.0.59/8.15.0.59) with SMTP id u73NokKE009635 for ; Wed, 3 Aug 2016 18:50:46 -0500 Received: from mail.stowers.org (exchsrv1.sgc.loc [10.0.52.156]) by smtp02.stowers.org with ESMTP id 24kkacr1u9-1 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT) for ; Wed, 03 Aug 2016 18:50:46 -0500 Content-Language: en-US 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: "'emacs-orgmode@gnu.org'" Hi, I am seeking good practices for writing about org using , erhm, well, org i= tself. (doh!) I'd use these practices, for example, when writing examples of using org, o= r lessons in using org, or bug reports about org. I reached of ob-org thinking this is what it was for, and wrote the followi= ng --------------------------------------- (beginning of example) Here is simple org book structure with chapters and a table of contents at the end: #+BEGIN_SRC org :exports both :results value * chapter one Fa la la * chapter two La di di * table of contents #+TOC: #+END_SRC --------------------------------------- (end of example) My dashed expectations were that when executed and exported, this would pro= duce a block of the org source, appropriately quoted, followed be the RESUL= TS, being, well, the rendered org. =20 Are your expectations the same as mine? What do YOU do in such cases?=20 Are there good practices for this? Am I off by a level in my meta-thinking? Thanks! Malcolm Cook - Kansas City