Re: [Boost-build] B2 documentation..

Subject: Re: [Boost-build] B2 documentation..
From: Daniel James (dnljms_at_[hidden])
Date: 2017-08-08 09:55:07

On 8 August 2017 at 10:18, Raffi Enficiaud via Boost-build
<boost-build_at_[hidden]> wrote:
>
>   * can you generate an index easily, and play with the structure of the
> documentation? Can you easily change the structure? For instance, in
> Quickbook, restructuring breaks the URLS if you link to eg. section by the
> name in the documentation tree. In Sphinx, you have commands like
> :py:class:`` that references a global object, wherever it is in the
> documentation.

I have no interest in a debate about which is the bestest
documentation system, but to answer the question, in quickbook you can
use anchors (e.g [#link.something]), which can be moved around and
survive restructuring.<div
id="DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2"><br />
<table style="border-top: 1px solid #D3D4DE;">
        <tr>
        <td style="width: 55px; padding-top: 13px;"><a
href="https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail"
target="_blank"><img
src="https://ipmcdn.avast.com/images/icons/icon-envelope-tick-round-orange-animated-no-repeat-v1.gif"
alt="" width="46" height="29" style="width: 46px; height: 29px;"
/></a></td>
                <td style="width: 470px; padding-top: 12px; color: #41424e;
font-size: 13px; font-family: Arial, Helvetica, sans-serif;
line-height: 18px;">Virus-free. <a
href="https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail"
target="_blank" style="color: #4453ea;">www.avast.com</a>
                </td>
        </tr>
</table><a href="#DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2" width="1"
height="1"></a></div>