Quoting Tetsuya Kitahata <[EMAIL PROTECTED]>:
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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
