From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Using Org as the source format to generate org.texi Date: Mon, 12 Mar 2018 17:51:00 +0200 Message-ID: <83po49s36j.fsf@gnu.org> References: <878tb5axms.fsf@bzg.fr> <87371762r3.fsf@nicolasgoaziou.fr> <87zi3dcrq1.fsf@nicolasgoaziou.fr> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1520869883 4734 195.159.176.226 (12 Mar 2018 15:51:23 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 12 Mar 2018 15:51:23 +0000 (UTC) Cc: emacs-devel@gnu.org, rms@gnu.org, monnier@iro.umontreal.ca To: Nicolas Goaziou Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Mar 12 16:51:18 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1evPjJ-00015U-Cr for ged-emacs-devel@m.gmane.org; Mon, 12 Mar 2018 16:51:17 +0100 Original-Received: from localhost ([::1]:60731 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evPlM-0000Vk-9u for ged-emacs-devel@m.gmane.org; Mon, 12 Mar 2018 11:53:24 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:43936) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evPjg-0008OI-7o for emacs-devel@gnu.org; Mon, 12 Mar 2018 11:52:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1evPj4-00009T-0h for emacs-devel@gnu.org; Mon, 12 Mar 2018 11:51:40 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60311) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evPj3-00008n-Sm; Mon, 12 Mar 2018 11:51:01 -0400 Original-Received: from [176.228.60.248] (port=2764 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1evPiw-0005xb-HM; Mon, 12 Mar 2018 11:50:55 -0400 In-reply-to: <87zi3dcrq1.fsf@nicolasgoaziou.fr> (message from Nicolas Goaziou on Mon, 12 Mar 2018 15:07:34 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:223642 Archived-At: > From: Nicolas Goaziou > Date: Mon, 12 Mar 2018 15:07:34 +0100 > Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org > > @var, @kbd and @key are defined, in "org-manual.org", through > a one-liner mechanism called a macro. There, @var{foo} becomes > {{{var(foo)}}} and @kbd{M-@key{RET}} becomes {{{kbd(M-RET)}}} (the > "@key" part is automatically deduced from the contents of the macro). As I wrote elsewhere, we need to be able to use @key without losing it, at least outside @kbd. > At one point, I suggested to make the "kbd" macro readily available for > every export back-end. As such, the would be no need to define it in > each document making use of it. However there was little interest in the > Org ML. Also, there are some decisions to make. For example, the macro > needs to be useful in every format supported by Org, and there are > multiple ways to transcribe @kbd+@key in LaTeX parlance. It is not clear > which one we should use and how configurable it should be. How about using what texinfo.tex does? > I'm not sure about @dfn. Org has a lightweight markup, i.e., _this_, > which mean "underline" by default. Since it is ignored in the Texinfo > export back-end, we might use it for @dfn. It probably would not be > shocking if the term appeared as underlined in other formats. @dfn produces slanted typeface in printed output and “quoted” string in Info output. I'd suggest that Org produces something similar.