On 04/08/2014 06:04 AM, Petr Spacek via RT wrote:
> Ticket <URL: https://bugs.isc.org/Ticket/Display.html?id=35713 >
> I would like to propose small improvement for your BIND ARM in HTML:
>
> It would be great if sections and commands had some stable names in <a
> name="something"> tag.
>
> Currently the HTML looks like:
>
> <div lang="en" class="sect3">
> <div class="titlepage"><div><div><h4 class="title">
> <a name="id2583370"></a>Forwarding</h4></div></div></div>
> <p>
> The forwarding facility can be used to create a large site-wide
>
> Unfortunately, it seems that "id2583370" changes between versions so it
> is not possible to create truly permanent link to it.
>
> It would be really handy to create links like:
> http://ftp.isc.org/isc/bind9/cur/9.9/doc/arm/Bv9ARM.ch06.html#id2583370
Permanent links are good, but permanent links with sensible names are
much better.
> Link targets like
> #sec-forwarding
> #option-forward
> #option-forwarders
>
> would be really great.
Yes, you're right. This is already under consideration. I myself made
a similar proposal, like the latter one (where all anchor names would
be human readable and make sense.)
There are macros involved; the same docbook/XML source is used to
create all versions of the ARM, not just the HTML.
> Thank you for your time.
Thank you for the suggestion, and yes, time is what it will require.
Right now I'm unable to give you a target date for completion, but
please be assured that this is a long-term project goal. Those
projects have to compete with (and usually lose out to) day-to-day
work like customer support and development / bug fixes.
--
Chuck Aurora : ISC Software Support : chucka@isc.org
Internet Systems Consortium, Inc.