ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Stephane Bailliez" <sbaill...@apache.org>
Subject Re: Speaking of deprecation...
Date Fri, 08 Feb 2002 00:09:12 GMT
----- Original Message -----
From: "Conor MacNeill" <conor@cortexebusiness.com.au>


> Magesh,
>
> I think you missed Bruce's point. Consider this scenario:
>
> You are given a build file. It uses some deprecated features. You are
asked
> to bring it up to date. If the documentation doesn't specify what the
> deprecated features do, how can you confidently make the changes.

You use ant-update.xsl and you're done in 10 seconds :-]

> I agree with Bruce. Documentation should reflect the code.
> If a feature is in the code, it should be in the documentation
> If a feature is deprecated in the code, it should be marked as deprecated
in
> the documentation but it should still be described.

Good point though.

Stephane


--
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