You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@jakarta.apache.org by robert burrell donkin <ro...@blueyonder.co.uk> on 2004/02/29 11:57:56 UTC
questions license for site documents
the generated html does not contain an explicit license just a
copyright. am i right in thinking that now it would be better to
publish them under the apache license 2?
also, am i right in thinking that all the source documentation should
have license notices added?
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by "Geir Magnusson Jr." <ge...@optonline.net>.
On Feb 29, 2004, at 5:57 AM, robert burrell donkin wrote:
> the generated html does not contain an explicit license just a
> copyright. am i right in thinking that now it would be better to
> publish them under the apache license 2?
>
> also, am i right in thinking that all the source documentation should
> have license notices added?
Might as well make it explicit
>
> - robert
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: general-help@jakarta.apache.org
>
>
--
Geir Magnusson Jr 203-247-1713(m)
geir@4quarters.com
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by Tetsuya Kitahata <te...@apache.org>.
On Tue, 2 Mar 2004 20:29:52 +0000
robert burrell donkin wrote:
> looks to me like that the jakarta website is now AL2 compliant :)
:-) -- Law-abiding nice citizens, Jakartaens.
> thanks for the hard work tetsuya.
I do also thank you, for the nice question upon the
licensing issue. This is an issue of critical importance
which I have been giving a heed/attention to.
--
Anyway, i also performed a slight change to all the XML files
in "site" module, too (except those in /foundation/ dir).
-- HTML files, generated files, as well.
Perhaps things go well. (do hope)
Cheers,
-- Tetsuya <te...@apache.org>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
On 2 Mar 2004, at 20:21, Tetsuya Kitahata wrote:
> On Tue, 2 Mar 2004 20:08:42 +0000
> robert burrell donkin wrote:
>
>> the .vsl template should definitely be altered to include the
>> boilerplate (as a comment) but i think that it'd be good to think
>> about
>> including a meta and/or link tags as well.
>
> I performed a slight change into .vsl and committed a little
> while ago. (<!-- --> style)
> "site" module (for www.apache.org) as well.
missed that change 8-)
looks to me like that the jakarta website is now AL2 compliant :)
thanks for the hard work tetsuya.
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by Tetsuya Kitahata <te...@apache.org>.
On Tue, 2 Mar 2004 20:08:42 +0000
robert burrell donkin wrote:
> the .vsl template should definitely be altered to include the
> boilerplate (as a comment) but i think that it'd be good to think about
> including a meta and/or link tags as well.
I performed a slight change into .vsl and committed a little
while ago. (<!-- --> style)
"site" module (for www.apache.org) as well.
For the time being, I do not include additional meta and/or
link tags in generated html files. If any ASF members put
them into htmls under "site" module, I'll follow them - precedent.
Cheers,
-- Tetsuya. (tetsuya@apache.org)
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: boilerplate LICENSE text in different formats
Posted by "Craig R. McClanahan" <cr...@apache.org>.
Quoting Tetsuya Kitahata <te...@apache.org>:
> On Tue, 2 Mar 2004 13:37:48 -0500
> Shapira, Yoav wrote:
>
> > >I have started a wiki page at
> > >http://wiki.apache.org/incubator/LicenseFormats for boilerplate text
> > in
> > >different formats.
> > Cool and useful -- thanks ;)
>
> Ditto. :-)
>
> I'll try it out.
Looks good. I just added a tweak that the XML format also works for HTML as
well.
>
> -- Tetsuya. (tetsuya@apache.org)
>
Craig
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: boilerplate LICENSE text in different formats
Posted by Tetsuya Kitahata <te...@apache.org>.
On Tue, 2 Mar 2004 13:37:48 -0500
Shapira, Yoav wrote:
> >I have started a wiki page at
> >http://wiki.apache.org/incubator/LicenseFormats for boilerplate text
> in
> >different formats.
> Cool and useful -- thanks ;)
Ditto. :-)
I'll try it out.
-- Tetsuya. (tetsuya@apache.org)
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
boilerplate LICENSE text in different formats was: questions license
for site documents
Posted by Nick Chalko <ni...@chalko.com>.
Craig R. McClanahan wrote:
>The instructions at the very end of
><http://www.apache.org/licenses/LICENSE-2.0.html>
>describe *exactly* what to do to documentation files, and adding a link in the
>manner you described is the wrong answer.
>
>Instead, you should enclose the same boilerplate text at the top of each such
>document that is included at the top of Java sources, enclosed in the
>appropriate comment characters for your format (i.e. for XML, surround by
>"<!--". and "-->", for properties files, prefix by "#", and so on).
>
>
>
I have started a wiki page at
http://wiki.apache.org/incubator/LicenseFormats for boilerplate text in
different formats.
R,
Nick
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
On 3 Mar 2004, at 22:28, Craig R. McClanahan wrote:
> Quoting Christopher Lenz <cm...@gmx.de>:
>
>>
>> You're not saying that the boilerplate text should appear as comment
>> in
>> every generated HTML document, are you?
>
> Yes, I am. For the same reason that it's in every Java file.
+1
(it probably needs to be added to every generated javadoc as well.)
i still quite like the idea of adding link and meta tags referring to
the license (in addition to the boilerplate comment).
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by "Craig R. McClanahan" <cr...@apache.org>.
Quoting Christopher Lenz <cm...@gmx.de>:
>
> You're not saying that the boilerplate text should appear as comment in
> every generated HTML document, are you?
>
Yes, I am. For the same reason that it's in every Java file.
> Cheers,
> Chris
Craig
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by Christopher Lenz <cm...@gmx.de>.
Am 02.03.2004 um 03:06 schrieb Craig R. McClanahan:
> Quoting Tetsuya Kitahata <te...@apache.org>:
>> On Mon, 1 Mar 2004 22:24:02 +0000
>> robert burrell donkin wrote:
>>> i've had a quick google and i'm not sure that there's a consensus out
>>> there on this. i like the idea of modifying the .vsl file and i'd be
>>> inclined to add both formulations. maybe this would be a good
>>> question
>>> to raise on community...
>>
>> Go ahead. I suspect it that we should modify site.vsl
>> in either case. :-)
>>
>> If we decide to modify all the xml files in /xdocs/,
>> appending <link rel="license"
>> href="http://jakarta.apache.org/LICENSE"/>
>> line would be more practical ... under /document/properties/ element.
>> (generated htmls should have <meta> tag, <link> tag or something
>> equivalent)
>
> The instructions at the very end of
> <http://www.apache.org/licenses/LICENSE-2.0.html>
> describe *exactly* what to do to documentation files, and adding a
> link in the
> manner you described is the wrong answer.
The discussion was about including a link to the license in the
generated HTML documents. That is totally independent of whether the
boilerplate text is included as XML comment in the xdoc sources IMHO,
which should be done anyway.
You're not saying that the boilerplate text should appear as comment in
every generated HTML document, are you?
Cheers,
Chris
--
Christopher Lenz
/=/ cmlenz at gmx.de
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
On 2 Mar 2004, at 02:06, Craig R. McClanahan wrote:
> Quoting Tetsuya Kitahata <te...@apache.org>:
>
>> On Mon, 1 Mar 2004 22:24:02 +0000
>> robert burrell donkin wrote:
>>
>>> i've had a quick google and i'm not sure that there's a consensus out
>>> there on this. i like the idea of modifying the .vsl file and i'd be
>>> inclined to add both formulations. maybe this would be a good
>>> question
>>> to raise on community...
>>
>> Go ahead. I suspect it that we should modify site.vsl
>> in either case. :-)
>>
>> If we decide to modify all the xml files in /xdocs/,
>> appending <link rel="license"
>> href="http://jakarta.apache.org/LICENSE"/>
>> line would be more practical ... under /document/properties/ element.
>> (generated htmls should have <meta> tag, <link> tag or something
>> equivalent)
>>
>
> The instructions at the very end of
> <http://www.apache.org/licenses/LICENSE-2.0.html>
> describe *exactly* what to do to documentation files, and adding a
> link in the
> manner you described is the wrong answer.
>
> Instead, you should enclose the same boilerplate text at the top of
> each such
> document that is included at the top of Java sources, enclosed in the
> appropriate comment characters for your format (i.e. for XML, surround
> by
> "<!--". and "-->", for properties files, prefix by "#", and so on).
the documentation source files are pretty clear. IMHO the generated
stuff is best done by altering the .vsl template. (i tried tricks with
the source to get the license into the generated document but anakia
dies.)
the .vsl template should definitely be altered to include the
boilerplate (as a comment) but i think that it'd be good to think about
including a meta and/or link tags as well.
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by "Craig R. McClanahan" <cr...@apache.org>.
Quoting Tetsuya Kitahata <te...@apache.org>:
> On Mon, 1 Mar 2004 22:24:02 +0000
> robert burrell donkin wrote:
>
> > i've had a quick google and i'm not sure that there's a consensus out
> > there on this. i like the idea of modifying the .vsl file and i'd be
> > inclined to add both formulations. maybe this would be a good question
> > to raise on community...
>
> Go ahead. I suspect it that we should modify site.vsl
> in either case. :-)
>
> If we decide to modify all the xml files in /xdocs/,
> appending <link rel="license" href="http://jakarta.apache.org/LICENSE"/>
> line would be more practical ... under /document/properties/ element.
> (generated htmls should have <meta> tag, <link> tag or something equivalent)
>
The instructions at the very end of
<http://www.apache.org/licenses/LICENSE-2.0.html>
describe *exactly* what to do to documentation files, and adding a link in the
manner you described is the wrong answer.
Instead, you should enclose the same boilerplate text at the top of each such
document that is included at the top of Java sources, enclosed in the
appropriate comment characters for your format (i.e. for XML, surround by
"<!--". and "-->", for properties files, prefix by "#", and so on).
> -- Tetsuya. (tetsuya@apache.org)
Craig McClanahan
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by Tetsuya Kitahata <te...@apache.org>.
On Mon, 1 Mar 2004 22:24:02 +0000
robert burrell donkin wrote:
> i've had a quick google and i'm not sure that there's a consensus out
> there on this. i like the idea of modifying the .vsl file and i'd be
> inclined to add both formulations. maybe this would be a good question
> to raise on community...
Go ahead. I suspect it that we should modify site.vsl
in either case. :-)
If we decide to modify all the xml files in /xdocs/,
appending <link rel="license" href="http://jakarta.apache.org/LICENSE"/>
line would be more practical ... under /document/properties/ element.
(generated htmls should have <meta> tag, <link> tag or something equivalent)
-- Tetsuya. (tetsuya@apache.org)
> - robert
>
> On 1 Mar 2004, at 17:25, Christopher Lenz wrote:
>
> > Am 01.03.2004 um 12:53 schrieb Tetsuya Kitahata:
> >> Use <META> tag.
> >> (e.g. <meta name="license"
> >> value="http://jakarta.apache.org/LICENSE"/>)
> >> Perhaps this can be easily done by editing /xdocs/stylesheets/site.vsl
> >>
> >> What would you say?
> >
> > If anything, that should be:
> >
> > <link rel="license" href="http://jakarta.apache.org/LICENSE">
> >
> > (See http://tantek.com/log/2004/02.html#d25t1805)
> >
> > Cheers,
> > Chris
> > --
> > Christopher Lenz
> > /=/ cmlenz at gmx.de
---------------------------------------------------------------------
Tetsuya Kitahata -- Terra-International, Inc.
E-mail: tetsuya@apache.org http://www.terra-intl.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
i've had a quick google and i'm not sure that there's a consensus out
there on this. i like the idea of modifying the .vsl file and i'd be
inclined to add both formulations. maybe this would be a good question
to raise on community...
- robert
On 1 Mar 2004, at 17:25, Christopher Lenz wrote:
> Am 01.03.2004 um 12:53 schrieb Tetsuya Kitahata:
>> Use <META> tag.
>> (e.g. <meta name="license"
>> value="http://jakarta.apache.org/LICENSE"/>)
>> Perhaps this can be easily done by editing /xdocs/stylesheets/site.vsl
>>
>> What would you say?
>
> If anything, that should be:
>
> <link rel="license" href="http://jakarta.apache.org/LICENSE">
>
> (See http://tantek.com/log/2004/02.html#d25t1805)
>
> Cheers,
> Chris
> --
> Christopher Lenz
> /=/ cmlenz at gmx.de
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: general-help@jakarta.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by Christopher Lenz <cm...@gmx.de>.
Am 01.03.2004 um 12:53 schrieb Tetsuya Kitahata:
> Use <META> tag.
> (e.g. <meta name="license" value="http://jakarta.apache.org/LICENSE"/>)
> Perhaps this can be easily done by editing /xdocs/stylesheets/site.vsl
>
> What would you say?
If anything, that should be:
<link rel="license" href="http://jakarta.apache.org/LICENSE">
(See http://tantek.com/log/2004/02.html#d25t1805)
Cheers,
Chris
--
Christopher Lenz
/=/ cmlenz at gmx.de
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org
Re: questions license for site documents
Posted by Tetsuya Kitahata <te...@apache.org>.
Might it be possible for us to add links to
http://jakarta.apache.org/LICENSE
from each generated htmls?? I think this would be enough.
Use <META> tag.
(e.g. <meta name="license" value="http://jakarta.apache.org/LICENSE"/>)
Perhaps this can be easily done by editing /xdocs/stylesheets/site.vsl
What would you say?
-- Tetsuya. (tetsuya@apache.org)
On Sun, 29 Feb 2004 10:57:56 +0000
(Subject: questions license for site documents)
robert burrell donkin wrote:
> the generated html does not contain an explicit license just a
> copyright. am i right in thinking that now it would be better to
> publish them under the apache license 2?
>
> also, am i right in thinking that all the source documentation should
> have license notices added?
>
> - robert
---------------------------------------------------------------------
Tetsuya Kitahata -- Terra-International, Inc.
E-mail: tetsuya@apache.org http://www.terra-intl.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@jakarta.apache.org
For additional commands, e-mail: general-help@jakarta.apache.org