Format of links to Info node and Info index

Format of links to Info node and Info index

[Michael Brand]

Hi all

I noticed that the link format with only single colons for the Info
node like info:org:Feedback stopped to work. Now I am confused about
the difference of info:org#Feedback that is documented as a link to an
info _node_ in [[info:org#External Links]] but never used in
org-manual.org versus info:org::Feedback that is not documented in
org-manual.org but used for all Info links there, like for example in
the section info:org::Activation for the link to Key Binding
Conventions.

Currently both link formats can also be used for links to Info
_index_, for example info:org::table.el and info:org#table.el

Should there be a different link format for Info node versus Info index or not?

Who would prefer (my favorite)

    | =info:org::External links= | Info node, preferred format  |
    | =info:org#External links=  | (alternative format)         |
    | =info:org#table.el=        | Info index, preferred format |
    | =info:org::table.el=       | (alternative format)         |

or who would prefer

    | =info:org::External links= | Info node link  |
    | =info:org#table.el=        | Info index link |

or who would prefer something else?

Michael

Re: Format of links to Info node and Info index

[Michael Brand]

Hi all

On Sat, Feb 2, 2019 at 11:14 AM Michael Brand
<michael.ch.brand@gmail.com> wrote:

> [...] Now I am confused about
> the difference of info:org#Feedback that is documented as a link to an
> info _node_ in [[info:org#External Links]] but never used in
> org-manual.org versus info:org::Feedback that is not documented in
> org-manual.org but used for all Info links there, like for example in
> the section info:org::Activation for the link to Key Binding
> Conventions. [...]

Short version: I would just like to know how to fix my Org files. Is
the rule to use info:org::Feedback or info:org#Feedback ?

Michael

Re: Format of links to Info node and Info index

[Nicolas Goaziou]

Hello,

Michael Brand <michael.ch.brand@gmail.com> writes:

> On Sat, Feb 2, 2019 at 11:14 AM Michael Brand
> <michael.ch.brand@gmail.com> wrote:
>
>> [...] Now I am confused about
>> the difference of info:org#Feedback that is documented as a link to an
>> info _node_ in [[info:org#External Links]] but never used in
>> org-manual.org versus info:org::Feedback that is not documented in
>> org-manual.org but used for all Info links there, like for example in
>> the section info:org::Activation for the link to Key Binding
>> Conventions. [...]
>
> Short version: I would just like to know how to fix my Org files. Is
> the rule to use info:org::Feedback or info:org#Feedback ?

I suggest :: since this is the markup Org uses to separate uri from
parameters.

Regards,

-- 
Nicolas Goaziou