emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: emacs-28 b4f47d2: Use @pxref when necessary


From: Robert Pluim
Subject: Re: emacs-28 b4f47d2: Use @pxref when necessary
Date: Thu, 25 Nov 2021 15:38:02 +0100

>>>>> On Thu, 25 Nov 2021 12:53:33 +0200, Eli Zaretskii <eliz@gnu.org> said:

    >> From: Robert Pluim <rpluim@gmail.com>
    >> Cc: emacs-devel@gnu.org
    >> Date: Thu, 25 Nov 2021 11:18:03 +0100
    >> 
    >> >>>>> On Thu, 25 Nov 2021 10:19:22 +0100, Robert Pluim 
<rpluim@gmail.com> said:
    Robert> This is "(see @ref", not "see @ref". The latter works correctly. 
Maybe
    Robert> this can be fixed in info.el as you say (it would certainly clean up
    Robert> the display of org.info).
    >> 
    >> Something like this, with 'Also *note'/'See also *note' as a bonus,
    >> although that might be going a bit far.

    Eli> "Also *note" that comes from "Also @ref" should be fine.  If you mean
    Eli> "Also see @ref", which currently produces "Also see see", then yes, it
    Eli> should be fixed as well.

Not quite:

Before:

Texi                  Info display

"Also @ref"        => "Also see <link>"
"See @ref"         => "See <link>"
"Also see @ref"    => "Also see <link>"
"See also @ref"    => "See also see <link>"
"(Also @ref)"      => "(Also see <link>)"
"(See @ref)"       => "(See see <link>)"
"(Also see @ref)"  => "(Also see <link>)"
"(See also @ref)"  => "(See also see <link>)"

After:

"Also @ref"        => "Also see <link>"
"See @ref"         => "See <link>"
"Also see @ref"    => "Also see <link>"
"See also @ref"    => "See also <link>"
"(Also @ref)"      => "(Also see <link>)"
"(See @ref)"       => "(See <link>)"
"(Also see @ref)"  => "(Also see <link>)"
"(See also @ref)"  => "(See also <link>)"

    Eli> Anyway, if this fixes the Org manual, feel free to install on master,
    Eli> and thanks.

The org texi generation always produces @ref, even inside parens, so I
think itʼs the best we can do.

Robert
-- 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]