Subject: Re: [boost] ATTENTION: Library requirements..
From: AgustÃn K-ballo BergÃ© (kaballo86_at_[hidden])
Date: 2016-01-10 22:23:58
On 1/10/2016 11:56 PM, Rene Rivera wrote:
> On Sun, Jan 10, 2016 at 5:05 PM, AgustÃn K-ballo BergÃ© <
> kaballo86_at_[hidden]> wrote:
>> On 1/10/2016 7:51 PM, Louis Dionne wrote:
>>> Robert Ramey <ramey <at> rrsd.com> writes:
>>>> The extra space used seems a small price to pay for this benefit.
>>> It's not just about extra space. Source control is for _source_ files, not
>>> generated stuff. I don't want generated files to appear in the commit
>>> of a code branch (but another branch like gh-pages is fine).
>> By way of example, this is the kind of noise committing generated
>> documentation can yield:
> And by comparison, here's the minimal non-noise that pre-generating for
> Predef has: <
I honestly don't get this... No source code appears to change, but the
documentation somehow needs to be regenerated? Or does moving a .jam
file to a different directory cause macros to become uppercase? Or is
this commit a bunch of orthogonal changes bundled together?
Unless your documentation source is the HTML itself, committing
documentation output will necessarily introduce noise as it modifies
both the source and the target. But then we would be talking static
documentation, not generated documentation.
-- AgustÃn K-ballo BergÃ©.- http://talesofcpp.fusionfenix.com
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk