Re: [aspectj-users] Re: [aspectj-dev] AspectJ 1.6.9M1 released

[Andy Clement <andrew.clement@xxxxxxxxx>]

Hi Manuel,

I *try* to update at least the relevant documentation periodically -
DeclareMixin is doc'd, parameter annotation matching has some doc.  I
probably still consider the Developers Notebook the most relevant doc
these days (since that was basically written in the 1.5.0 timeframe) -
and so that is what gets the most love when I have time.  The kinds of
features I've mentioned in the README for 1.6.9m1 may change before
final inclusion in 1.6.9 final, so I wouldn't necessarily be doing a
big doc update for them just yet.

Any assistance on documentation would be great! The wiki is here:
http://wiki.eclipse.org/AspectJ (and AJDT has one too) but it only
gets sporadic updates, I think Simone Gianni has written more of it
than I have.  I think right now the split is that the wiki is
tips/tricks and techniques for using AspectJ, whilst the core
documentation is held internally to the project, then published to the
web at http://www.eclipse.org/aspectj/doc/released

Do you know how to edit the existing documentation?  Perhaps I could
create an article on the wiki that describes how to edit and build the
documentation, that might lower the bar to making contributions.

cheers,
Andy

2010/4/17 Manuel Menezes de Sequeira <Manuel.Sequeira@xxxxxxxx>:
> Hi Andy,
> Are there any plans to update the documentation? Can the community
> contribute to it? Have you considered using a wiki for that purpose? If
> there were a wiki, anyone (e.g., myself) would be able take the description
> of new features, as in the README below, and produce the necessary
> documentation. The initial effort of bringing the documentation up to date
> would be the hardest, but after that it would be easy to keep it up to date.
> Regards,
> Manuel
>
> 2010/4/17 Andy Clement <andrew.clement@xxxxxxxxx>
>>
>> AspectJ 1.6.9 milestone 1 is now available!  This release includes
>> some new features:
>>
>> - message inserts for declare warning/error messages
>> - declare warning/error for type patterns
>> - type category type patterns
>> - intertype fields on classes preserve visibility and name
>> - AspectJ snapshots are now in an accessible maven repo
>>
>> More information on all these can be found in the README:
>> http://eclipse.org/aspectj/doc/released/README-169.html
>>
>> AspectJ 1.6.9M1 can be downloaded from the usual place:
>> http://eclipse.org/aspectj/downloads.php
>>
>> It is in the AJDT builds for Eclipse 3.5 and Eclipse 3.6.
>>
>> Please be aware that if you update to this version then you will need
>> to update any 'downstream' AspectJ weavers that you use (for later
>> binary weaving or load-time weaving).  Some of the changes above have
>> required an update to the aspect version format we use and earlier
>> versions of AspectJ will not completely understand code built by
>> 1.6.9M1.  See this article for more information about this:
>>
>> http://andrewclement.blogspot.com/2010/04/aspectj-169m1-message-unable-to.html
>> .
>>
>> The 'milestone' tag does indicate that this is a work in progress
>> towards the 1.6.9 release.  Any feedback is appreciated on the
>> milestone so that we can ensure the features are fully robust by
>> release.
>>
>> enjoy!
>> AspectJ team.
>> _______________________________________________
>> aspectj-dev mailing list
>> aspectj-dev@xxxxxxxxxxx
>> https://dev.eclipse.org/mailman/listinfo/aspectj-dev
>
>
>
> --
> http://www.google.com/profiles/MMSequeira
>
> _______________________________________________
> aspectj-users mailing list
> aspectj-users@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/aspectj-users
>
>