On Wed, 2007-02-14 at 20:25 +0100, 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? >
Hi Roland, To me RFCs are _the_ ultimate reference for lots of protocol level components, and besides we are building HTTP components to conform to a very _specific_ set of RFCs, so I personally do not see an issue with quoting RFCs verbatim. Feel free to change / improve Javadocs as you find appropriate, though. Oleg > cheers, > Roland > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
