Hi all,
I happened to notice that linking to the 'User-defined macros' paragraph in
R-exts produces a less-than-fully-scrutable link [1]. grep-ing around I
found others peppered in the manuals, e.g. [2] [3].
In markdown (the flavors I'm used to, at least), we'd use something like
{#User-defined-macros} to customize the link as well as make it more stable.
I'm not particularly familiar with Texinfo, but a quick search around
suggests we could use '@anchor' tags to augment what's produced
automatically from '@node'. [4] [5]
It's fairly minor but would be a nice quality-of-life improvement; if
agreed, I think it would be a nice R-dev-day issue, too. One important
consideration is back-compatibility -- we'd like to ensure any existing
links with the "ugly" text continue to work. I believe that just means
leaving the '@node' unchanged. An advanced 3rd-order consideration would be
to look at the history of the '@node' text and generate new '@anchor'
entries if any have changed to retroactively improve back-compatibility.
Mike C
[1]
https://cran.r-project.org/doc/manuals/r-devel/R-exts.html#User_002ddefined-macros-1
[2]
https://cran.r-project.org/doc/manuals/r-release/R-admin.html#index-Installing-under-Unix_002dalikes
[3]
https://cran.r-project.org/doc/manuals/r-release/R-data.html#Spreadsheet_002dlike-data
[4]
https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#g_t_0040anchor
[aside, somewhat funny that Texinfo themselves leave this messy link here
:) ]
[5] https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Nodes
[[alternative HTML version deleted]]
______________________________________________
[email protected] mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
