From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rasmus Subject: Re: [ox, patch] Add #+SUBTITLE Date: Tue, 24 Mar 2015 10:37:25 +0100 Message-ID: <87twxa7n3e.fsf@gmx.us> References: <87a8z7z20k.fsf@gmx.us> <87vbht2kri.fsf@nicolasgoaziou.fr> <87sicx6of8.fsf@gmx.us> <87vbhqn4u4.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:52245) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YaLHE-0005DV-A8 for emacs-orgmode@gnu.org; Tue, 24 Mar 2015 05:37:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YaLHA-0004qv-4x for emacs-orgmode@gnu.org; Tue, 24 Mar 2015 05:37:36 -0400 Received: from mout.gmx.net ([212.227.17.21]:57775) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YaLH9-0004oA-Qj for emacs-orgmode@gnu.org; Tue, 24 Mar 2015 05:37:32 -0400 Received: from x200s ([109.201.154.158]) by mail.gmx.com (mrgmx101) with ESMTPSA (Nemesis) id 0MGnPx-1YePsk2VW5-00DbPy for ; Tue, 24 Mar 2015 10:37:27 +0100 In-Reply-To: <87vbhqn4u4.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Tue, 24 Mar 2015 10:05:07 +0100") 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: emacs-orgmode@gnu.org Nicolas Goaziou writes: > E.g., when creating a new export back-end, it is quite obvious that one > will need to handle TITLE, DATE, AUTHOR and EMAIL somehow. Now, if you > request handlers for SUBTITLE, KEYWORDS and DESCRIPTION, it becomes more > tedious to achieve the task. Isn't the point that you don't have to support those (e.g. markddown). The current documentation is pretty specific about not having expectations about KEYWORDS and DESCRIPTION working. It would be the same for SUBTITLE. > This is not really about SUBTITLE, but, sooner or later, we will have to > draw a line between common features ensuring compatibility between > back-ends and specific ones. The cost of the former is some orders of > magnitude higher. This is why I proposed SUBTITLE as a feature of a few backends: ox-ascii, ox-html, ox-odt, and ox-latex (and some derived backends). >> Yeah, I still have a patch for that... I still have to do the >> documentation changes. > > Unless we decide that KEYWORD and DESCRIPTION should move to the "common > features" discussed above. In this case, they stay in "ox.el" and all > major back-ends are expected to handle them. WDYT? I think it is fine either way. But I have never used DESCRIPTION and I don't use KEYWORDS regularly. >>> Now, if SUBTITLE is a feature desperately needed everywhere, which can >>> be discussed, it should be moved to "ox.el" and probably >>> `org-element-document-keywords'. IMO, this is not necessary. SUBTITLE >>> should be kept for back-ends that can handle it. >> >> IMO it is. > > See above. I don't mind much, as long as we eventually stop > compatibility hell at some point. I think I didn't understand the first quote above (prefixed with ">>>"). It should *not* be a common feature. It should be a feature of the backend where it makes sense, namely backends for text documents at large. =E2=80=94Rasmus --=20 Together we'll stand, divided we'll fall