Great idea Gavin ;) I should have picked up on your cue of attaching drafts to e-mails.<br><br>-Dan<br><br>p.s. Keep the following in mind, which I wrote in the "notes" section before the first chapter:<br><br>Note that this reference guide was started while changes were still being made to the specification. We've done<br>
our best to update it for accuracy. If you discover a conflict between what is written in this guide and<br>the specification, the specification is the authority--assume it is correct. If you believe you have found an<br>
error in the specification, please report it to the JSR-299 EG.<br><br><div class="gmail_quote">On Sun, Nov 1, 2009 at 11:40 PM, Gavin King <span dir="ltr"><<a href="mailto:gavin.king@gmail.com">gavin.king@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">Dan, that's really great!<br>
<br>
Could you mail us a PDF, so I can read it on the plane tomorrow? Thanks!<br>
<div><div></div><div class="h5"><br>
On Sun, Nov 1, 2009 at 11:33 PM, Dan Allen <<a href="mailto:dan.j.allen@gmail.com">dan.j.allen@gmail.com</a>> wrote:<br>
> I've made it all the way through the ref guide with revisions that reflect<br>
> that changes to the RI and spec names and the latest nomenclature and<br>
> semantics from the spec. It's now ready for a technical review and<br>
> proofreading (in trunk)<br>
><br>
> <a href="https://svn.jboss.org/repos/weld/doc/trunk/reference" target="_blank">https://svn.jboss.org/repos/weld/doc/trunk/reference</a><br>
> <a href="http://anonsvn.jboss.org/repos/weld/doc/trunk/reference" target="_blank">http://anonsvn.jboss.org/repos/weld/doc/trunk/reference</a><br>
><br>
> Since there was so much to change, I'm sure there are places where the<br>
> semantics didn't get properly updated or an explanation is still out of<br>
> date. Also, there were some areas of the ref guide that were thin, and I<br>
> didn't have time to fill it all in. If you feel comfortable explaining a<br>
> topic, please don't be shy to revise or suggest revisions.<br>
><br>
> Here are some notes to consider:<br>
><br>
> - Java SE sections need review for accuracy, relevance<br>
> - Extending CDI (extend.xml) is extremely thin, to the point of being<br>
> marginally useful compared to the spec<br>
> - Weld extensions (extensions.xml) is underwhelming; do we have more to say<br>
> than just about logging?<br>
> - The chapter on producer fields (producerfields.xml) is missing, though<br>
> producer fields are explained in intro.xml<br>
> - The Weld SPI needs to be reviewed for accuracy, relevance (ri-spi.xml);<br>
> this was a *long* chapter and I just don't know the Weld SPI yet<br>
><br>
> I did add a lot of content while revising, but the ref guide can always be<br>
> improved.<br>
><br>
> -Dan<br>
><br>
> --<br>
> Dan Allen<br>
> Senior Software Engineer, Red Hat | Author of Seam in Action<br>
> Registered Linux User #231597<br>
><br>
> <a href="http://mojavelinux.com" target="_blank">http://mojavelinux.com</a><br>
> <a href="http://mojavelinux.com/seaminaction" target="_blank">http://mojavelinux.com/seaminaction</a><br>
> <a href="http://www.google.com/profiles/dan.j.allen" target="_blank">http://www.google.com/profiles/dan.j.allen</a><br>
><br>
</div></div>> _______________________________________________<br>
> weld-dev mailing list<br>
> <a href="mailto:weld-dev@lists.jboss.org">weld-dev@lists.jboss.org</a><br>
> <a href="https://lists.jboss.org/mailman/listinfo/weld-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/weld-dev</a><br>
><br>
<font color="#888888"><br>
<br>
<br>
--<br>
Gavin King<br>
<a href="mailto:gavin.king@gmail.com">gavin.king@gmail.com</a><br>
<a href="http://in.relation.to/Bloggers/Gavin" target="_blank">http://in.relation.to/Bloggers/Gavin</a><br>
<a href="http://hibernate.org" target="_blank">http://hibernate.org</a><br>
<a href="http://seamframework.org" target="_blank">http://seamframework.org</a><br>
</font></blockquote></div><br><br clear="all"><br>-- <br>Dan Allen<br>Senior Software Engineer, Red Hat | Author of Seam in Action<br>Registered Linux User #231597<br><br><a href="http://mojavelinux.com">http://mojavelinux.com</a><br>
<a href="http://mojavelinux.com/seaminaction">http://mojavelinux.com/seaminaction</a><br><a href="http://www.google.com/profiles/dan.j.allen">http://www.google.com/profiles/dan.j.allen</a><br>