This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: onlinedocs: How to link to external HTML documents?


Joseph Myers schrieb:
On Tue, 11 Jul 2017, Georg-Johann Lay wrote:

Hi, in a recent change I added a pointer to some
Binutils documentation in doc/extend.texi:

see the GNU Binutils
@w{@uref{https://sourceware.org/binutils/docs/as/AVR_002dDependent.html,AVR
assembler manual}}.

For other manuals in the Texinfo universe, it's best to use Texinfo @xref in its five-argument form. Then, for such a link to work on gcc.gnu.org, you need a .htaccess entry to redirect from /onlinedocs/as to a location where that manual is actually available online.

Sounds complicated and requiring access rights I don't have (and shouldn't be required to have or don't even want to have).

What's a bit annoying is that I can't even test this locally, because
locally all was fine and the external link worked as expected.

For now I just reverted...

http://gcc.gnu.org/ml/gcc-patches/2017-07/msg00507.html

Maybe what helps is escaping the "_" itself, like _005f002d or %5f002d. At least the first form cannot be tested locally as my local texinfo, for whatever reason, deviates from what runs on the gcc server. I'll give the 2nd version a try.

IIRC some links don't even work internally within onlinedocs, for example I found no way to link to
http://gcc.gnu.org/onlinedocs/gcc/AVR-Options.html#AVR-Built-in-Macros
even though there's an anchor "AVR-Built-in-Macros". texinfo will always add a redundant top-level anchor like AVR-Options.html#AVR-Options for some obscure reason.

Johann


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]