-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Robert Ramey Sent: 20 July 2014 17:59 To: boost@lists.boost.org Subject: Re: [boost] [Boost Library Incubator] Unable to submit library
Edward Diener-3 wrote
On 7/20/2014 2:03 AM, Robert Ramey wrote:
Edward Diener-3 wrote
I think you can appreciate that having to duplicate tests which already exist through bjam/Boost Build when the user clones the project is not something I really want to do. I really don't see the big deal of someone interested in my library cloning it locally under modular-boost and then having all the documentation and tests locally. I explain very carefully in my top-level *.txt files how to do all this.
There's no disagreement here. That's exactly how I envision that this site be used.
I do appreciate the work you put into it. But I think that anyone interested in a library in the Boost Library Incubator sight should be trying it out locally just like everyone does with Git projects.
There's no disagreement here either.
But there are a couple issues you've left unaddressed.
a) One looking for a library can only find documentation for libraries already in boost. For the sandbox one had to download the package and (maybe) build the documentation in order to see the decimation. For me this was a big problem which I addressed by requiring browsable html documentation. The github method - (has a minor/temporary problem - I know) is perfect for this. It means one can browse the documentation immediately. So this issue is resolved for me.
The issue of generated (mainly html) files in GIT is still a nuisance. If you are a sole developer, then it is quite easy - you simply include all the /doc folder with /html etc in GIT. But if you are developing *with* someone else, these generated files are a PITA. You have keep reverting the /html files every time you want to GIT pull. And you have push the updated docs every time too - and these may be quite big. I don't see a better way round this yet. Ideas? Paul --- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 01539 561830