Boost C++ Libraries: Ticket #1200: Revamp the header information https://svn.boost.org/trac10/ticket/1200 <p> (see this thread for context: <a class="ext-link" href="http://tinyurl.com/2b9ywv"><span class="icon">​</span>http://tinyurl.com/2b9ywv</a>) </p> <p> Allow a couple of the (header) items there to be *overridden* in included files. Example: </p> <ul><li>copyright (a) or (b) </li><li>authors (a) or (b) </li><li>license (a) or (b) </li><li>last-revision (a), if it's more recent than current value </li></ul><p> where: </p> <p> a) Merge with the current value. b) Use new value only for current file/doc. </p> <p> 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. </p> <p> So, these overrides can be placed anywhere. Example: </p> <p> main.qbk </p> <blockquote> <p> [library foo </p> <blockquote> <p> [quickbook 1.4] [version 1.4] [copyright 2006 Joe Bloke] [authors [Bloke, Joe]] [purpose Whatever...] [license </p> <blockquote> <p> Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at [@<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>]) </p> </blockquote> <p> ] [last-revision $Date: 2006/09/16 09:21:08 $] </p> </blockquote> <p> ] </p> </blockquote> <p> include.qbk </p> <blockquote> <p> [license </p> <blockquote> <p> Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at [@<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>]) </p> </blockquote> <p> ] </p> </blockquote> <blockquote> <p> [last-revision $Date: 2006/09/16 09:21:08 $] </p> </blockquote> <p> John (M): </p> <p> I like the way this is going, but I would actually prune the list of overrides a little more: </p> <p> [last-revision...] </p> <p> Definitely needed, as per my original post :-) </p> <p> [quickbook....] </p> <p> Also needed so that individual includes can start using new features without having to go through and fix errors in the whole doc. </p> <p> [version...] </p> <p> Not sure about this one, shouldn't a library have a single version number? </p> <p> [copywrite...][authors...] </p> <p> These would be useful to have: especially for "meta-libraries" like Boost.Math which has many sub-components by different authors. </p> <p> The ideal world senario - probably not possible (!) - would be to merge all the author names onto the main front page, but for sections just to include the authors who worked on that section. Does that make sence? </p> <p> [purpose...] </p> <p> Isn't this used just once on the main page, or maybe the index of libraries? I don't see any great advantage to having more than one such block. </p> <p> [license...] </p> <p> Given that everything should be under the same license (as far as Boost is concerned anyway), having more than one such block just complicates things. </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/1200 Trac 1.4.3 Joel de Guzman Wed, 22 Aug 2007 23:46:58 GMT <link>https://svn.boost.org/trac10/ticket/1200#comment:1 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/1200#comment:1</guid> <description> <p> Also, from John: </p> <p> Another couple of bug reports, and a couple of feature requests as well (just tell me when to shut up!). </p> <p> The [category tag] markup inside the the main [library ..] block over-writes previous invocations, so for example in <a class="missing wiki">BoostBook</a> I can assign a library to multiple categories (and if you look in boost.xml you'll see several that make use of this), but if I have: </p> <p> [library Boost.<a class="missing wiki">TypeTraits</a> [copyright 2000 2005 blah blah] [purpose Meta-programming support library] [license blah blah] [authors [authors, various]] [category template] [category generic] [last-revision $Date: 2005/04/16 16:29:33 $] ] </p> <p> Then the last [category ...] seen over-writes whatever other invocations have been made (so the only category in the XML output is "generic" in this case). </p> <p> To fix this I tried escaping to <a class="missing wiki">BoostBook</a>, but any attempt to put a <strong> escape inside a [library ..] block produced quickbook errors. </strong></p> </description> <category>Ticket</category> </item> <item> <dc:creator>Daniel James</dc:creator> <pubDate>Sun, 06 Jun 2010 07:23:47 GMT</pubDate> <title/> <link>https://svn.boost.org/trac10/ticket/1200#comment:2 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/1200#comment:2</guid> <description> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/62471" title="Support multiple categories. Refs #1200.">[62471]</a>) Support multiple categories. Refs <a class="new ticket" href="https://svn.boost.org/trac10/ticket/1200" title="#1200: Tasks: Revamp the header information (new)">#1200</a>. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Joel de Guzman</dc:creator> <pubDate>Wed, 09 Apr 2014 02:28:04 GMT</pubDate> <title>owner changed https://svn.boost.org/trac10/ticket/1200#comment:3 https://svn.boost.org/trac10/ticket/1200#comment:3 <ul> <li><strong>owner</strong> changed from <span class="trac-author">Joel de Guzman</span> to <span class="trac-author">Daniel James</span> </li> </ul> <p> Daniel, I reassigned the Qbk tickets to you. I hope you don't mind. I'm no longer updated with the latest Qbk developments. </p> Ticket