Mailing-List: contact flex-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: flex-dev@incubator.apache.org
Received-SPF: softfail (athena.apache.org: transitioning domain of
 david@davidarno.org does not designate 74.125.82.43 as permitted sender)
Message-ID: <1329381498.4139.10.camel@lapsang>
Subject: Re: asdoc comments for flash player and SDK version numbers
From: David Arno <david@davidarno.org>
To: flex-dev@incubator.apache.org
Date: Thu, 16 Feb 2012 08:38:18 +0000
In-Reply-To: <FA124D97-2584-41D4-A96D-F93293F0F8B4@classsoftware.com>
References: <FA124D97-2584-41D4-A96D-F93293F0F8B4@classsoftware.com>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Mime-Version: 1.0

On Thu, 2012-02-16 at 18:05 +1100, Justin Mclean wrote:
> Hi,
> 
> Was looking though some of the framework code and noticed that a lot of method are marked up with comments that are imported into documents re player version and the like.
> 
>  Here's a typical section.
>      *  @langversion 3.0
>      *  @playerversion Flash 9
>      *  @playerversion AIR 1.1
>      *  @productversion Flex 3
> 
> Going forward when adding new methods what are the values we should use? Do we just go with current versions like so:
>      *  @langversion 3.0
>      *  @playerversion Flash 11.1
>      *  @playerversion AIR 3.1
>      *  @productversion Apache Flex 4.7
> 
I'd really like it if we could figure out a way of getting rid of all
that crap out of the framework as it makes reading the code far more
difficult.

David.