This is the mail archive of the
java-patches@gcc.gnu.org
mailing list for the Java project.
Re: YA Socket timeout patch
- From: Per Bothner <per at bothner dot com>
- To: Nic Ferrier <nferrier at tf1 dot tapsellferrier dot co dot uk>
- Cc: java-patches at gcc dot gnu dot org
- Date: Sun, 16 Dec 2001 10:02:15 -0800
- Subject: Re: YA Socket timeout patch
- References: <E16FdZ4-0007gB-00@tf1.tapsellferrier.co.uk>
Nic Ferrier wrote:
> I use the first line (the one with the double **) to be a very brief
> intro, as per the Sun suggestions.
This is *not* what Sun suggests. The /** line is otherwise *empty*
according to Sun's documnetation. See:
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
especially the section "General Form of a Doc Comment". We
are not obliged to follow Sun's recommendations, of course.
--
--Per Bothner
per@bothner.com http://www.bothner.com/per/