Joel de Guzman wrote:
> Rene Rivera wrote:

>> Of course it's possible, and is the usual behavior for building. But 
>> that misses the problem entirely. Building the docs has no bearing on 
>> when the docs changed. For example the docs get built daily by metacomm, 
>> from scratch.
> 
> 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.

> I'll see what I can do.
> If anyone has a better/simpler idea, I'm all ears.

Ah, better yes, simpler not likely ;-)

Add an option to the document info which indicates that quickbook should 
not generate a BoostBook chunk from it, but instead just consider the 
info provided to augment the containing document chunk when there is 
one. Perhaps "info-only". That would allow adding "part" headers to the 
included files. For example:

[part Introduction
   [info-only]
   [quickbook 1.3]
   [copyright 2006 Joe Bloke]
   [authors [Bloke, Joe]]
   [license All mine.]
   [source-mode python]
   [last-revision $Date: 2006/09/16 09:21:08 $]
   ]

There are some options for what to do with that info.

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

The current value is that of the "parent" doc chunk as we are merging 
this part with that parent.

I would think that what to do would depend on the individual info item:

* version (c)
* id (c)
* dirname (c)
* copyright (b) or (d)
* purpose (c)
* category (c)
* authors (b) or (d)
* license (b) or (d)
* source-mode (d)
* last-revision (b), if it's more recent than current value

Of course this would be limited to what is actually possible in BoostBook.

OK, definitely not simpler :-\


-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo

-------------------------------------------------------------------------
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