From mboxrd@z Thu Jan  1 00:00:00 1970
From: Bastien <bzg@altern.org>
Subject: Re: [RFC] Org syntax (draft)
Date: Sun, 10 Mar 2013 11:14:46 +0100
Message-ID: <87obera7e1.fsf@bzg.ath.cx>
References: <8738w7c5fh.fsf@gmail.com> <87ppz8upsx.fsf@Rainer.invalid>
	<878v5wi163.fsf@gmail.com> <87vc8zyiqj.fsf@gmail.com>
	<874ngjivfs.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 ([208.118.235.92]:50763)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bastienguerry@gmail.com>) id 1UEdHG-0005Wq-Gp
	for emacs-orgmode@gnu.org; Sun, 10 Mar 2013 06:14:51 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bastienguerry@gmail.com>) id 1UEdHF-0000ga-3h
	for emacs-orgmode@gnu.org; Sun, 10 Mar 2013 06:14:50 -0400
Received: from mail-we0-x232.google.com ([2a00:1450:400c:c03::232]:34472)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bastienguerry@gmail.com>) id 1UEdHE-0000fQ-Tv
	for emacs-orgmode@gnu.org; Sun, 10 Mar 2013 06:14:49 -0400
Received: by mail-we0-f178.google.com with SMTP id o45so2449439wer.23
	for <emacs-orgmode@gnu.org>; Sun, 10 Mar 2013 03:14:48 -0700 (PDT)
In-Reply-To: <874ngjivfs.fsf@gmail.com> (Nicolas Goaziou's message of "Sun, 10
	Mar 2013 08:08:07 +0100")
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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Nicolas Goaziou <n.goaziou@gmail.com>
Cc: Achim Gratz <Stromeko@nexgo.de>, emacs-orgmode@gnu.org, Jambunathan K <kjambunathan@gmail.com>

Hi Nicolas,

the manual would enjoy a subsection in "Hacking" on how to create
a new exporter, either from scratch or as a derived exporter.
(Such a subsection can be short enough, thanks to derived backend.)

>From this section, we can throw links to the exporter reference
document and the Org syntax document published on Worgs.

We may also add footnotes referring to the Org syntax relevant
sections, when needed.

But both reference documents don't fit into the manual IMO.  They
are great resources for developers, not for users.  The footnotes
are enough for advanced users who want to go beyond the manual.

Thanks!

-- 
 Bastien