From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: setting local variables Date: Wed, 06 Sep 2017 15:08:13 +0200 Message-ID: <87fuc0asaq.fsf@nicolasgoaziou.fr> References: <871sotiqld.fsf@ericabrahamsen.net> <87r2wsly88.fsf@nicolasgoaziou.fr> <877eykbpho.fsf@ericabrahamsen.net> <87wp5dmkm0.fsf@gmx.us> <87h8wh13tm.fsf@ericabrahamsen.net> <87y3psp5ne.fsf@gmx.us> <87mv68159v.fsf@nicolasgoaziou.fr> <87h8wgov62.fsf@gmx.us> 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]:33556) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dpa49-00022P-Nh for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 09:08:33 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dpa3z-00060I-R7 for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 09:08:25 -0400 Received: from relay2-d.mail.gandi.net ([2001:4b98:c:538::194]:56306) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dpa3z-0005zi-L3 for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 09:08:15 -0400 In-Reply-To: <87h8wgov62.fsf@gmx.us> (rasmus@gmx.us's message of "Wed, 06 Sep 2017 14:42:29 +0200") 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: Rasmus Cc: emacs-orgmode@gnu.org Rasmus writes: > I could not get it to work. I tried stuff like "[[(org) Tables]]", > "[[*(org) Tables]]" and , [[texinfo:(org) tables]]. You are talking about a special case for cross-referencing (which could include internal reference, URL referencess). This is the job of "org-info.el": [[info:org#tables]] > It is always unresolved. I couldn=E2=80=99t think of any other way of re= ferencing > an external manual, even skimming ox-texinfo.el, so it is not > straightforward to me. See=20 [[info:org#External links]] oops, I mean=20 (info "(org) External links") ;) > That is why I asked for a reference as I do not remember having seen such > a layout in an info page. If we know of an example, it might not be hard > to implement. The problem is not implementing it, really. It is about finding a way to integrate it with Org syntax. "org.texi" uses a lot of "@subheading" and related. See for example (info "(org) Installation") "Using Emacs packaging system", "Downloading Org as an archive" and "Using Org's git repository" are three examples of such layout. >> What it sophisticated referencing? "ox-texinfo" supports internal and >> external links without specific syntax. @pxref and @xref is just >> syntactic sugar over @ref. >> >> "ox-texinfo.el" supports @email, @ref and @uref. > > I don=E2=80=99t know as I am not a texinfo expert, but in the texinfo man= ual they > tell you to be vary of @ref. It is probably a bit over the top. > > The @ref command can tempt writers to express themselves in a manner > that is suitable for a printed manual but looks awkward in the Info > format. Bear in mind that your audience could be using both the > printed and the Info format. For example: > > Sea surges are described in @ref{Hurricanes}. > > looks ok in the printed output: > > Sea surges are described in Section 6.7 [Hurricanes], page 72.=20 > > but is awkward to read in Info, =E2=80=9Cnote=E2=80=9D being a verb: > > Sea surges are described in *note Hurricanes::. In Org, just write For sea surges, see [[*Hurricanes]] E.g., insert the "see" manually. > Also, does Org support all four @ref arguments? In either case, these are > questions that I find reasonable and cannot find the answer to in the > manual. The manual is not targeted to Texinfo experts. The difference between @ref arguments are subtle. At this point, I suggest to generate some template with Org and tweak the result. BTW, Org supports @ref with 1 argument and with arguments 1 and 3. There is no way in Org to distinguish between online label and printed label. The fourth and fifth arguments are not supported either, for the same reason. You need to insert raw Texinfo code to achieve this. > I guess the idea of Texinfo is produce info, html, and paper manuals > consistently, though. I personally agree, but just look at the Org manual > and the fuss about @code vs @samp (which, I believe, are also displayed in > the same way). @code and @samp are not a problem, being respectively ~...~ and =3D...=3D. > Texinfo is proudly pedantic. People exporting to Texinfo might care > about @kbd{} vs @code{} and explaining how to get such fine-grained > control would be a fine thing to document in the manual IMO. Patch welcome! Also, two emphasis markers are unused in "ox-texinfo.el": _..._ and +...+. Another solution would be to use them for Texinfo special markup. However, it feels awkward to provide this by default. Regards,