You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hc.apache.org by Apache Wiki <wi...@apache.org> on 2008/01/27 18:06:37 UTC
[Jakarta-httpclient Wiki] Trivial Update of "HttpClientApiJavadocGuidelines"
by RolandWeber
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Jakarta-httpclient Wiki" for change notification.
The following page has been changed by RolandWeber:
http://wiki.apache.org/jakarta-httpclient/HttpClientApiJavadocGuidelines
The comment on the change is:
page moved
------------------------------------------------------------------------------
- = HttpClient 4.0 Javadoc guidelines: =
+ #DEPRECATED
+ This page has been [http://wiki.apache.org/HttpComponents/JavaDocGuidelines moved]
+ to the new [http://wiki.apache.org/HttpComponents/ HttpComponents Wiki].
- == Interface description must consist of ==
- * Purpose
- * Description (''optional'')
- * Statement whether this interface represents an entity or a process defined by a standard specification such as RFC document, when applicable (''optional'')
+ ##
- == Class description must consist of ==
- * Purpose
- * Description (''optional'')
- * Statement whether this class implements an entity or a process defined by a standard specification such as RFC document, when applicable (''optional'')
- * Statement whether instances of this class are mutable (''optional''). If not explicitly stated, instances of this class are assumed to be mutable
- * Statement whether this class is multi-threading safe (''optional''). If not explicitly stated, the class is assumed to be '''NOT''' threading-safe
- == Method description must consist of ==
- * Purpose
- * Expected effect
- * Description (''optional'')
- * Statement whether this method is modal, that is, if the object must be in a specific state (pre-conditions) or mode in order to execute correctly (''optional''). If not explicitly stated, the method is assumed to be non-modal.
- * Required parameters. It must be explicitly stated whether null is permitted as a parameter value. Per default parameters are assumed to require a non-null value and to cause a {{{ IllegalArgumentException }}} if null is given.
- * Exceptions that can be thrown in the course of method's execution and their possible cause (post-conditions).
- * private methods can have minimal or no JavaDoc if they are short and trivial enough.
- * methods that implement a signature from an interface or base class that is sufficiently documented there can omit JavaDocs in favor of comments like:
-
- {{{ // non-javadoc, see interface XXX }}}
-
- {{{ // non-javadoc, see class XYZ }}}
-
- The non-javadoc comment with a pointer to the documentation is required for people reading the source code. The JavaDoc tool will automatically copy the description from the interface or base class into the generated documentation.
-
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org