<html>
<head>
<style><!--
  body {background-color:#ffffff;}
  .file {border:1px solid #eeeeee;margin-top:1em;margin-bottom:1em;}
  .pathname {font-family:monospace; float:right;}
  .fileheader {margin-bottom:.5em;}
  .diff {margin:0;}
  .tasklist {padding:4px;border:1px dashed #000000;margin-top:1em;}
  .tasklist ul {margin-top:0;margin-bottom:0;}
  tr.alt {background-color:#eeeeee}
  #added {background-color:#ddffdd;}
  #addedchars {background-color:#99ff99;font-weight:bolder;}
  tr.alt #added {background-color:#ccf7cc;}
  #removed {background-color:#ffdddd;}
  #removedchars {background-color:#ff9999;font-weight:bolder;}
  tr.alt #removed {background-color:#f7cccc;}
  #copied {background-color:#ccccff;}
  tr.alt #copied {background-color:#bbbbf7;}
  #info {color:#888888;}
  #context {background-color:#eeeeee;}
  td {padding-left:.3em;padding-right:.3em;}
  tr.head {border-bottom-width:1px;border-bottom-style:solid;}
  tr.head td {padding:0;padding-top:.2em;}
  .task {background-color:#ffff00;}
  .comment {white-space:-moz-pre-wrap;white-space:-pre-wrap;white-space:-o-pre-wrap;white-space:pre-wrap;word-wrap:break-word;padding:4px;border:1px dashed #000000;background-color:#ffffdd}
  .error {color:red;}
  hr {border-width:0px;height:2px;background:black;}
--></style>
</head>
<body>
<table cellspacing="0" cellpadding="0" border="0" rules="cols">
<tr class="head"><td colspan="5">Commit in <b><tt>metaas/trunk/src/main/java/uk/co/badgersinfoil/metaas/dom</tt></b></td></tr>
<tr><td><tt><a href="#file1">ASExpressionStatement.java</a></tt> </td><td></td><td align="right" id="added">+25</td><td></td><td nowrap="nowrap" align="center">448 -&gt; 449</td></tr>
<tr class="alt"><td><tt><a href="#file2">ASReturnStatement.java</a></tt> </td><td></td><td align="right" id="added">+26</td><td></td><td nowrap="nowrap" align="center">448 -&gt; 449</td></tr>
<tr><td><tt><a href="#file3">Statement.java</a></tt> </td><td></td><td align="right" id="added">+2</td><td></td><td nowrap="nowrap" align="center">448 -&gt; 449</td></tr>
<tr class="alt"><td><tt><a href="#file4">StatementContainer.java</a></tt> </td><td></td><td align="right" id="added">+4</td><td align="right" id="removed">-4</td><td nowrap="nowrap" align="center">448 -&gt; 449</td></tr>
<tr><td></td><td></td><td align="right" id="added">+57</td><td align="right" id="removed">-4</td><td></td></tr>
</table>
<small id="info">4 modified files</small><br />
<pre class="comment">
more API documentation
</pre>
<hr /><a name="file1" /><div class="file">
<span class="pathname">metaas/trunk/src/main/java/uk/co/badgersinfoil/metaas/dom</span><br />
<div class="fileheader"><big><b>ASExpressionStatement.java</b></big> <small id="info">448 -&gt; 449</small></div>
<pre class="diff"><small id="info">--- trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/ASExpressionStatement.java        2007-03-14 22:07:07 UTC (rev 448)
+++ trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/ASExpressionStatement.java        2007-03-15 08:27:52 UTC (rev 449)
@@ -1,7 +1,32 @@
</small></pre><pre class="diff" id="added">+/**
+ * ASReturnStatement.java
+ * 
+ * Copyright (c) 2007 David Holroyd
+ */
+
</pre><pre class="diff" id="context"> package uk.co.badgersinfoil.metaas.dom;
 
</pre><pre class="diff" id="added">+/**
+ * A simple statement which evaluates an expression.
+ * 
+ * &lt;p&gt;Instances can be created using {@link StatementContainer#newExprStmt(String)}:&lt;/p&gt;
+ * &lt;pre class="eg"&gt;ASExpressionStatement stmt = method.newExprStmt("trace(\"hello world\")");&lt;/pre&gt;
+ * &lt;p&gt;Will result in the ActionScript code,&lt;/p&gt;
+ * &lt;pre class="eg"&gt;trace("hello world");&lt;/pre&gt;
+ */
</pre><pre class="diff" id="context"> public interface ASExpressionStatement extends Statement {
 
</pre><pre class="diff" id="added">+        /**
+         * Returns a string representation of the expression this statement
+         * would evaluate when run.
+         */
</pre><pre class="diff" id="context">         public String getExpressionString();
</pre><pre class="diff" id="added">+        
+        /**
+         * Changes the expression that this statement would evaluate when run.
+         * 
+         * @throws SyntaxException if the given string is not a valid
+         *         ActionScript expression.
+         */
</pre><pre class="diff" id="context">         public void setExpression(String expr);
 }
</pre></div>
<hr /><a name="file2" /><div class="file">
<span class="pathname">metaas/trunk/src/main/java/uk/co/badgersinfoil/metaas/dom</span><br />
<div class="fileheader"><big><b>ASReturnStatement.java</b></big> <small id="info">448 -&gt; 449</small></div>
<pre class="diff"><small id="info">--- trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/ASReturnStatement.java        2007-03-14 22:07:07 UTC (rev 448)
+++ trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/ASReturnStatement.java        2007-03-15 08:27:52 UTC (rev 449)
@@ -6,8 +6,34 @@
</small></pre><pre class="diff" id="context"> 
 package uk.co.badgersinfoil.metaas.dom;
 
</pre><pre class="diff" id="added">+/**
+ * A statement that exits the current ActionScript method or function,
+ * optionally returning a value to the caller.
+ * 
+ * &lt;p&gt;Instances can be created using {@link StatementContainer#newReturn(String)}:&lt;/p&gt;
+ * &lt;pre class="eg"&gt;ASExpressionStatement stmt = method.newReturn(null);&lt;/pre&gt;
+ * &lt;p&gt;Will result in ActionScript code like,&lt;/p&gt;
+ * &lt;pre class="eg"&gt;return;&lt;/pre&gt;
+ * &lt;p&gt;or, with an expression,this Java code,&lt;/p&gt;
+ * &lt;pre class="eg"&gt;ASExpressionStatement stmt = method.newReturn("doIt()");&lt;/pre&gt;
+ * &lt;p&gt;will result in ActionScript code like,&lt;/p&gt;
+ * &lt;pre class="eg"&gt;return doIt();&lt;/pre&gt;
+ */
</pre><pre class="diff" id="context"> public interface ASReturnStatement extends Statement {
 
</pre><pre class="diff" id="added">+        /**
+         * Returns a string representation of the expression who's value
+         * this statement would return when executed, or null if there is
+         * no such expression.
+         */
</pre><pre class="diff" id="context">         public String getExpressionString();
</pre><pre class="diff" id="added">+        
+        /**
+         * Changes the expression that this statement would return when
+         * executed.  If null is given, any expression will be removed.
+         * 
+         * @throws SyntaxException if the given string is not null and is not
+         *         a valid ActionScript expression.
+         */
</pre><pre class="diff" id="context">         public void setExpression(String expr);
 }
</pre><pre class="diff"><small id="info">\ No newline at end of file
</small></pre></div>
<hr /><a name="file3" /><div class="file">
<span class="pathname">metaas/trunk/src/main/java/uk/co/badgersinfoil/metaas/dom</span><br />
<div class="fileheader"><big><b>Statement.java</b></big> <small id="info">448 -&gt; 449</small></div>
<pre class="diff"><small id="info">--- trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/Statement.java        2007-03-14 22:07:07 UTC (rev 448)
+++ trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/Statement.java        2007-03-15 08:27:52 UTC (rev 449)
@@ -2,6 +2,8 @@
</small></pre><pre class="diff" id="context"> 
 /**
  * Super-interface for tagging objects that represent ActionScript 'statements'
</pre><pre class="diff" id="added">+ * 
+ * @see StatementContainer#getStatementList()
</pre><pre class="diff" id="context">  */
 public interface Statement {
 
</pre></div>
<hr /><a name="file4" /><div class="file">
<span class="pathname">metaas/trunk/src/main/java/uk/co/badgersinfoil/metaas/dom</span><br />
<div class="fileheader"><big><b>StatementContainer.java</b></big> <small id="info">448 -&gt; 449</small></div>
<pre class="diff"><small id="info">--- trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/StatementContainer.java        2007-03-14 22:07:07 UTC (rev 448)
+++ trunk/src/main/java/uk/co/badgersinfoil/metaas/dom/StatementContainer.java        2007-03-15 08:27:52 UTC (rev 449)
@@ -144,10 +144,10 @@
</small></pre><pre class="diff" id="context">         public boolean containsCode();
 
         /**
</pre><pre class="diff" id="removed">-         * Returns a list of the statements held in the containing element.  The
-         * list is immutable (entries cannnot be added, removed or replaced)
-         * but the objects obtained from the list my be modified via the
-         * methods they provide.
</pre><pre class="diff" id="added">+         * Returns a list of the {@link Statement} objects held in the
+         * containing element.  The list is immutable (entries cannnot be
+         * added, removed or replaced) but the objects obtained from the list
+         * my be modified via the methods they provide.
</pre><pre class="diff" id="context">          */
         public List getStatementList();
 }
</pre><pre class="diff"><small id="info">\ No newline at end of file
</small></pre></div>
<center><small><a href="http://www.badgers-in-foil.co.uk/projects/cvsspam/" title="commit -&gt; email">CVSspam</a> 0.2.12</small></center>
</body></html>