From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Cross reference in TeXinfo export
Date: Mon, 15 Jul 2019 12:09:48 +0200
Message-ID: <871ryrobgz.fsf@nicolasgoaziou.fr>
References: <CADn3Z2KmGf2MPRjNuf5LvV7yLLVZQZm04prdvMf2apbVLvU1Dw@mail.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 ([2001:470:142:3::10]:60472)
 by lists.gnu.org with esmtp (Exim 4.86_2)
 (envelope-from <mail@nicolasgoaziou.fr>) id 1hmxvf-0000hY-4r
 for emacs-orgmode@gnu.org; Mon, 15 Jul 2019 06:09:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <mail@nicolasgoaziou.fr>) id 1hmxve-0007xU-1y
 for emacs-orgmode@gnu.org; Mon, 15 Jul 2019 06:09:55 -0400
Received: from relay6-d.mail.gandi.net ([217.70.183.198]:54689)
 by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
 id 1hmxvd-0007vk-Qy
 for emacs-orgmode@gnu.org; Mon, 15 Jul 2019 06:09:53 -0400
In-Reply-To: <CADn3Z2KmGf2MPRjNuf5LvV7yLLVZQZm04prdvMf2apbVLvU1Dw@mail.gmail.com>
 (Carsten Dominik's message of "Mon, 15 Jul 2019 08:50:49 +0200")
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: <https://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"
 <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Carsten Dominik <dominik@uva.nl>
Cc: org-mode list <emacs-orgmode@gnu.org>

Hello,

Carsten Dominik <dominik@uva.nl> writes:

> I noticed that the link in the following line in org-guide.org
>
> This document is a much compressed derivative of the
> [[info:org][comprehensive Org mode manual]].
>
>
> gets turned into this in orgguide.texi
>
> @ref{Top,comprehensive Org mode manual,,org,}.
>
>
> The PDF version of the guide then looks like this:
>
> This document is a much compressed derivative of the org.
>
>
> So the link description in the PDF version is just "org", the name of the
> info node.  I think the link text should be "comprehensive Org mode
> manual".  Is anyone familiar enough with the texinfo exporter and texinfo
> to fix this?

Actually, this is not about the Texinfo exporter (ox-texinfo.el), but
the library responsible for handling info links (ol-info.el).

Maybe we should use

    @ref{Top,comprehensive Org mode manual,,org,comprehensive Org mode manual}

instead. But what should we do when a section is specified, e.g.,

    @ref{Section Name, description,,org,}

?

Regards,

-- 
Nicolas Goaziou