Re: [boost] Missing Documentation on Building and Installing Documentation.

Subject: Re: [boost] Missing Documentation on Building and Installing Documentation.
From: Julian Gonggrijp (j.gonggrijp_at_[hidden])
Date: 2011-03-18 05:41:55

Stirling Westrup wrote:

> On Thu, Mar 17, 2011 at 4:30 PM, Steven Watanabe <watanabesj_at_[hidden]> wrote:

>> The documentation should be pre-built.
>> You can access it at libs/libraries.htm
>> or libs/<library name>/index.html.
>> Unfortunately, there's no way to install
>> the documentation. It's set up to
>> live in the source tree and moving
>> would break a lot of links.
> 
> It should not be that impossible as several distributions, such as
> Debian, place the documentation in /usr/share/doc and the links all
> work. Besides, isn't the documentation generated by docbook or doxygen
> or some similar system? If it is, it should be simple enough to
> generate it for any desired target location.

Distributions like Debian's have been manually modified to suit the
needs of the distributor. They might also have changed other aspects
of the directory tree. Such adaptations are not provided by the Boost
developers.

Besides, not all documentation is generated with BoostBook. Also I
think it shouldn't have to, because in some cases such documentation
systems can be too rigid.

-Julian