Re: [boost] Copyright and License in XML documentation

From: Doug Gregor (dgregor_at_[hidden])
Date: 2004-08-30 08:50:27

On Aug 29, 2004, at 2:35 PM, Reece Dunn wrote:

> Jeff Garland wrote:
>> <libraryinfo>
>>   <author>
>>     <firstname>Jeff</firstname>
>>     <surname>Garland</surname>
>>   </author>
>>
>>   <copyright>
>>     <year>2001</year>
>>     <year>2002</year>
>>     <year>2003</year>
>>     <year>2004</year>
>>     <holder>CrystalClear Software, Inc</holder>
>>   </copyright>
>>
>>   <legalnotice>
>>     <para>Subject to the Boost Software License, Version 1.0. (See
>> accompanying file
>>     <filename>LICENSE_1_0.txt</filename> or copy at <ulink
>>
>> url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/ 
>> LICENSE_1_0.txt</ulink>)</para>
>>   </legalnotice>
>>
>>   <librarypurpose>A set of facilities to ease programming with dates  
>> and times.
>>   </librarypurpose>
>>   <librarycategory name="category:misc"/>
>> </libraryinfo>
>
> This is so that the legal notice can be rendered in the introduction  
> page of the library documentation.

A silly, foolish part of me keeps wishing this were enough :(

>> So it seems one option would be to change the boostbook schema and  
>> allow
>> copyright and legal notice elements in each file.  The other  
>> possibility would
>> be to add this as a comment:
>>
>> <!--
>>   Copyright (c) 2000-2004 CrystalClear Software, Inc.
>>   Subject to the Boost Software License, Version 1.0.
>>   (See accompanying file LICENSE-1.0 or  
>> http://www.boost.org/LICENSE-1.0)
>> -->
>>
>> Thoughts on how best to approach this?
>
> I think the best approach would be in a comment, since adding  
> copyright markup to each file would require adding code in the XSLT  
> files to prevent it from being rendered.

Agreed.

        Doug