Automatically generating libs/libraries.htm
Daniel James <[email protected]> Fri, 6 May 2016 10:00:46 +0100
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <CAHOE3ye6Eg_dbLbnkdOhTstC-mMY_NjFbQS7w86c-d38A4fQ+w@mail.gmail.com> |
Hi, One the new release is out, I'd like to start automatically generating libs/libraries.htm. 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? 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. Daniel