Re: [Boost-docs] Automatically generating libs/libraries.htm

Subject: Re: [Boost-docs] Automatically generating libs/libraries.htm
From: Edward Diener (eldiener_at_[hidden])
Date: 2016-05-06 11:56:33

On 5/6/2016 5:00 AM, Daniel James wrote:
> Hi,
>
> One the new release is out, I'd like to start automatically generating
> libs/libraries.htm.

Excellent !

> You can see a rough version of the automatically
> generated file at:
>
> http://beta.boost.org/doc/libs/develop/libs/libraries.new.htm
>
> For comparison, the current manually maintained file is at:
>
> http://www.boost.org/doc/libs/1_60_0/libs/libraries.htm
>
> There are differences in capitalization, categories, etc. so it won't
> be a seamless change. I don't really think it's worth putting the
> effort in to avoid that. I might add a few anchors so that existing
> links don't break.
>
> Also, it's based on the current release, which is why it doesn't have
> any of the new 1.61 libraries in there. The final version will be
> based on the branch it's generated for, so that will be fixed.
>
> I'm currently thinking of checking the generated file into the repo,
> but maybe it'd be better to check in a template and generate it as
> part of the release process?

I think it is better to check in the template and just specify how to 
generate the library list from the template.

> The disadvantage would be that git
> checkouts won't have the library list, but the advantage would be that
> no one would accidentally check in changes that get overwritten.