Roland, I have the same opinion as Oleg about the issue. Quoting makes it absolutely clear which version of the spec was used for the implementation. If you use links they will become unavailable at some point and may be hard to restore!
I guess we can use the RFC documents in citations. Their copyright is very open: "This document [...] may be [...] copied [...] without restriction of any kind provided that the above copyright notice and this paragraph are included on all such copies [...]" To be sure we should probably reproduce their (The Internet Society) copyright statement in the documentation. The legal aspect should be properly discussed on the legal mailing list, however. Odi Roland Weber wrote:
Hi Oleg, there are a few places where our JavaDocs include more or less verbatim quotes from RFCs, including context free grammars. I don't think that's a good idea. For one there is the copyright question. But I've also seen some quotes from obsolete RFCs in code that probably hasn't changed much since HC 2.0. If a particular piece of code refers to a specific part of an RFC, we should give a short description of the purpose and reference the RFC down to the section, but not copy the text of the RFC into the JavaDocs. www.rfc.net has nice formatted versions of RFCs where we can even hyperlink to sections. What do you think? cheers, Roland --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
-- [web] http://www.odi.ch/ [blog] http://www.odi.ch/weblog/ [pgp] key 0x81CF3416 finger print F2B1 B21F F056 D53E 5D79 A5AF 02BE 70F5 81CF 3416 --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
