From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: #+LATEX_HEADER:\newcommand{\orgtitle}{{{{TITLE}}}} Date: Wed, 19 Mar 2014 22:23:44 +0100 Message-ID: <87txatc273.fsf@gmail.com> References: <87y507fs5b.fsf@bzg.ath.cx> <87ppljck4w.fsf@bzg.ath.cx> <87bnx2cjuq.fsf@gmail.com> <87lhw6ryke.fsf@bzg.ath.cx> <8738iech65.fsf@gmail.com> <87ppliqid2.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39411) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WQNxL-0004iI-8G for emacs-orgmode@gnu.org; Wed, 19 Mar 2014 17:23:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WQNxF-000238-DU for emacs-orgmode@gnu.org; Wed, 19 Mar 2014 17:23:23 -0400 Received: from mail-wi0-x22b.google.com ([2a00:1450:400c:c05::22b]:57816) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WQNxF-00022y-5C for emacs-orgmode@gnu.org; Wed, 19 Mar 2014 17:23:17 -0400 Received: by mail-wi0-f171.google.com with SMTP id hn9so5534338wib.4 for ; Wed, 19 Mar 2014 14:23:16 -0700 (PDT) In-Reply-To: <87ppliqid2.fsf@bzg.ath.cx> (Bastien's message of "Wed, 19 Mar 2014 17:10:49 +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: Bastien Cc: emacs-orgmode@gnu.org, Luke Crook Bastien writes: > Nicolas Goaziou writes: > >> As you noticed, secondary strings are omitted in the manual, but still >> valid locations: titles in headlines or inlinetasks, inline footnotes, >> and plain list item tags. > > Any reason not to mention secondary strings? No reason besides clarity, maybe. A long list of locations could be confusing. > In this particular case, mentioning headlines and plain list items > would be useful, otherwise careful readers* may assume that macros > are not available there. What about excluding most tempting locations instead? "... which can be referenced with {{{name(arg1, arg2)}}}. These references, called macros, can be inserted anywhere Org markup is recognized. In particular, this excludes all keywords but CAPTION, TITLE, AUTHOR and EMAIL, source blocks, example blocks and comments. In addition to user-defined macros..." Regards, -- Nicolas Goaziou