Rene Rivera wrote:
> Joel de Guzman wrote:
>> Rene Rivera wrote:
>>> Joel de Guzman wrote:
>>>> Indeed. Ok, I think I know how to fix this in quickbook. But that would
>>>> require having knowledge of the modification dates of included files
>>>> (via filesystem last_write_time perhaps?).
>>> That won't work either. As file system timestamps also have no bearing 
>>> on when the content changed. Same example as before. Metacomm does a 
>>> clean build, which means that the archive is expanded each time and then 
>>> used to build stuff. Hence the access times will not correspond to 
>>> content changes.
>> Yah :(
>>
>>>> I'll see what I can do.
>>>> If anyone has a better/simpler idea, I'm all ears.
>>> Ah, better yes, simpler not likely ;-)
>>>
>> [snip not simple suggestion]
>>> OK, definitely not simpler :-\
>> Ok, here's a simpler suggestion: Allow
>>
>>      [last-revision $Date: 2006/09/16 09:21:08 $]
>>
>> on all qbk files and make quickbook use the latest date.
>>
>> Thoughts?
> 
> Define "latest date" please. Hopefully you mean "most recent date".
> 
> Sure, it would work. But my suggestion has the benefit of allowing for 
> the individual files to stand alone. Not a big benefit I know :-) And of 
> setting some of the other info. Like having a place to put the license 
> and copyright since I noticed that people don't seem to currently put 
> those in comments of such included qbk files.

Right. Looking at it again, I think we only need to allow a couple of
the items there to be *overridden* in included files. Example:

* copyright (a) or (b)
* authors (a) or (b)
* license (a) or (b)
* last-revision (a), if it's more recent than current value

where:

a) Merge with the current value.
b) Use new value only for current file/doc.

I took out all the ones you have as (c) -- Ignore the new value.
I also took out source-mode since this can already be overridden.

So, these overrides can be placed anywhere. Example:

main.qbk

     [library foo
         [quickbook 1.4]
         [version 1.4]
         [copyright 2006 Joe Bloke]
         [authors [Bloke, Joe]]
         [purpose Whatever...]
         [license
             Distributed under the Boost Software License, Version 1.0.
             (See accompanying file LICENSE_1_0.txt or copy at
             [EMAIL PROTECTED]://www.boost.org/LICENSE_1_0.txt])
         ]
         [last-revision $Date: 2006/09/16 09:21:08 $]
     ]

include.qbk

     [license
         Distributed under the Boost Software License, Version 1.0.
         (See accompanying file LICENSE_1_0.txt or copy at
         [EMAIL PROTECTED]://www.boost.org/LICENSE_1_0.txt])
     ]

     [last-revision $Date: 2006/09/16 09:21:08 $]

How does that sound?

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net


-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to