MIME-Version: 1.0 In-Reply-To: <5343D797.6070006@redhat.com> X-Mailer: MIME-tools 5.428 (Entity 5.428) Content-Disposition: inline References: <5343D797.6070006@redhat.com> Content-Type: text/html; charset="UTF-8" Message-ID: Content-Transfer-Encoding: binary X-RT-Original-Encoding: utf-8 RT-Send-CC: Content-Length: 2362 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.