ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefan Bodewig <bode...@apache.org>
Subject Re: [PATCH] /src/main/org/apache/tools/ant/IntrospectionHelper.java (More JavaDocs)
Date Wed, 20 Feb 2002 07:19:28 GMT
On Tue, 19 Feb 2002, Jon Skeet <jon.skeet@peramon.com> wrote:
>> Saw a couple of minor issues with this patch.
>> 1. In many places is this: (String->Class).
>>    It would be better as: (String-&gt;Class).
> 
> I pondered this myself. Obviously from a purist point of view,
> you're right - but then the source code ends up being harder to
> read.

We are using entities in javadocs in several other classes as well, I
think Erik has replaced all occurences of unescaped <, > and & some
months ago.

Bottom line, please don't use >. 8-)

> Possibly just (String-Class) or (String to Class)?

I prefer String to Class.

> If it breaks things for 1.1 and/or 1.2 though, I'm happy to go back
> and fix this up.

I think the javadocs should work for all people who compile Ant, which
means they should work in 1.1, but then again, I'm sure I've added
{@link a b} constructs in several places myself.

No religious issue, but 1.1 compatibility would be nice.

Stefan

--
To unsubscribe, e-mail:   <mailto:ant-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-dev-help@jakarta.apache.org>


Mime
View raw message