classpath
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Usage of RFC documentation for Javadoc


From: Wolfgang Baer
Subject: Usage of RFC documentation for Javadoc
Date: Wed, 30 Nov 2005 20:03:03 +0100
User-agent: Debian Thunderbird 1.0.7 (X11/20051017)

Hi all,

working on the javax.print namespace and also starting
with the internals I found that the javadoc of the
Java Print Service API is mostly a word by word copy
from the RFC documents of IPP 1.1 (RFC 2910, 2911).

As I also look at the specification source my documentation
(although I try to explain in my own words) will almost every
time sound the same like the one from SUN.

So the question comes to my mind if we also can use or
maybe quote from the RFC documents in our javadocs.
This would make documentation easier and as its the
specification also correct in every detail.

For your convenience I attached the full copyright
statement of the RFC documents.

Opinions ?

Wolfgang



18.  Full Copyright Statement

   Copyright (C) The Internet Society (2000).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]