From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Subject: Re: Proposal for new/updated exporter tutorials on Worg Date: Mon, 08 Apr 2013 17:30:56 +0200 Message-ID: <87r4ik29xs.fsf@bzg.ath.cx> References: <9B43E6D4-7EF9-40BE-9AA4-E6236EB1793D@gmail.com> <87y5d5ypa6.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:42239) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UPG8E-0004pU-AT for emacs-orgmode@gnu.org; Mon, 08 Apr 2013 13:45:32 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UPG89-0002Dh-9W for emacs-orgmode@gnu.org; Mon, 08 Apr 2013 13:45:26 -0400 Received: from mail-wg0-f53.google.com ([74.125.82.53]:64273) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UPG89-0002DR-2r for emacs-orgmode@gnu.org; Mon, 08 Apr 2013 13:45:21 -0400 Received: by mail-wg0-f53.google.com with SMTP id c11so6199639wgh.20 for ; Mon, 08 Apr 2013 10:45:20 -0700 (PDT) In-Reply-To: (John Hendy's message of "Sun, 31 Mar 2013 23:58:44 -0500") 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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: John Hendy Cc: emacs-orgmode , "Thomas S. Dye" , Carsten Dominik Hi John, John Hendy writes: >> What do you think? > > Not sure how to implement this, but sounds reasonable. Thanks. So basically the idea is just to use #+PROPERTY: OrgCompat 8.0 on top of Worg files that contain 8.0-only information, and :PROPERTIES: :OrgCompat: 8.0 :END: in sections that are 8.0-only. I started to do this with the new tutorial I just pushed about agenda filtering/limiting: http://orgmode.org/worg/org-tutorials/agenda-filters.org We don't need to update Worg systematically at this point, just keep this property in mind when we write new stuff. > I'd like to get > everything export related into it's own directories, if possible. Sounds reasonable. > ox-template.org is now pushed as well. It's modified from >ob-doc-template.org. Thanks for all these updates! > [1] As an aside, is there a good reference for what Worg should/could > contain and what should live in the manual? I've noticed recently on > the list that, for example, :wrap was documented in the manual even > though =:results output wrap= came up on the mailing list and was not > in the Worg summary of header options. If too much is duplicated, it > make for double the things to track... The manual is a trade-off between completeness and minimalism: it reflects current fonctionalities and tries to give the minimal info needed for the max number of features. Worg is a trade-off between inclusiveness and precision: because it is inclusive (contributors are welcome to write 10-pages tutorial about an obscure feature), and because it's too hard to delete obsolete information, it lacks accurateness sometimes -- hence the OrgCompat trick, which will make things better. As for where to add things first, contributors should first think about fixing the manual, then contribute to Worg. If fixing the manual is possible (with the trade-off exposed above in mind), then let's go for it. If it's beyond this trade-off and falls into Worg's one, let's go for Worg. > Where's the manual with respect to the new exporter? If it's ahead of > Worg's state, the documentation on Worg can be used to supplement in > reference to the manual vs. duplicating what's to come! Nicolas, Thomas and I are working on it -- sorry it takes so long. -- Bastien