Re: [boost] What would make tool authors happier..

Subject: Re: [boost] What would make tool authors happier..
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2015-06-04 13:47:30

> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Robert Ramey
> Sent: 04 June 2015 14:17
> To: boost_at_[hidden]
> Subject: Re: [boost] What would make tool authors happier..
> 
> On 6/4/15 12:32 AM, Andrey Semashev wrote:
> > On Thu, Jun 4, 2015 at 1:46 AM, Robert Ramey <ramey_at_[hidden]> wrote:
> >>
> >> Libraries should have the following directories with jamfiles in them
> >>
> >> build
> >
> > build can be missing if the library does not need compiling.
> >
> >> test
> >> doc
> >
> 
> also I would expand this slightly to
> 
> build(if required)
> test
> doc
>    jamfile.v2 (if required
>    html
> 
> I've always disliked having documentation in one place if they are built with boost book and in an
other
> place if they are built some other way.
>   So either use the above or copy all the handcrafted html to the "other place"  I prefer the
above because
> it keeps all the library under one directory.

Wherever it is, surely there should be a

 /libs/some_library/index.html 

redirect to get to wherever the real stuff is.
(and there is no reason why not to have another index.html in the /doc folder as well - in case
users expect it there).

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
[phone]