--- langref2.html	2008-03-31 12:15:42.562500000 -0700
+++ langref3.html	2008-03-31 20:53:34.171875000 -0700
@@ -2984,7 +2984,7 @@
 bytes of memory from the operating system and returns a pointer of the
 appropriate type to the program.  If "NumElements" is specified, it is the
 number of elements allocated, otherwise "NumElements" is defaulted to be one.
-If an alignment is specified, the value result of the allocation is guaranteed to
+If a constant alignment is specified, the value result of the allocation is guaranteed to
 be aligned to at least that boundary.  If not specified, or if zero, the target can
 choose to align the allocation on any convenient boundary.</p>
 
@@ -2993,7 +2993,10 @@
 <h5>Semantics:</h5>
 
 <p>Memory is allocated using the system "<tt>malloc</tt>" function, and
-a pointer is returned.</p>
+a pointer is returned.
+The operation is undefined if NumElements is negative.  Allocating zero
+bytes is legal, but the result is undefined.  The result is null if there
+is insufficient memory available.</p>
 
 <h5>Example:</h5>
 
@@ -3038,7 +3041,7 @@
 <h5>Semantics:</h5>
 
 <p>Access to the memory pointed to by the pointer is no longer defined
-after this instruction executes.</p>
+after this instruction executes.  If the pointer is null, free has no effect.</p>
 
 <h5>Example:</h5>
 
@@ -3075,7 +3078,7 @@
 bytes of memory on the runtime stack, returning a pointer of the
 appropriate type to the program.  If "NumElements" is specified, it is the
 number of elements allocated, otherwise "NumElements" is defaulted to be one.
-If an alignment is specified, the value result of the allocation is guaranteed
+If a constant alignment is specified, the value result of the allocation is guaranteed
 to be aligned to at least that boundary.  If not specified, or if zero, the target
 can choose to align the allocation on any convenient boundary.</p>
 
@@ -3089,7 +3092,9 @@
 have an address available.  When the function returns (either with the <tt><a
  href="#i_ret">ret</a></tt> or <tt><a href="#i_unwind">unwind</a></tt>
 
-instructions), the memory is reclaimed.</p>
+instructions), the memory is reclaimed.
+The operation is undefined if NumElements is negative.  Allocating zero bytes
+is legal, but the result is undefined.</p>
 
 <h5>Example:</h5>
 
@@ -3122,7 +3127,7 @@
 
 instructions. </p>
 <p>
-The optional "align" argument specifies the alignment of the operation
+The optional constant "align" argument specifies the alignment of the operation
 (that is, the alignment of the memory address). A value of 0 or an
 omitted "align" argument means that the operation has the preferential
 alignment for the target. It is the responsibility of the code emitter
@@ -3157,14 +3162,14 @@
 <h5>Arguments:</h5>
 <p>There are two arguments to the '<tt>store</tt>' instruction: a value
 to store and an address at which to store it.  The type of the '<tt>&lt;pointer&gt;</tt>'
-operand must be a pointer to the type of the '<tt>&lt;value&gt;</tt>'
+operand must be a pointer to the <a href="#t_firstclass">first class</a> type of the '<tt>&lt;value&gt;</tt>'
 operand. If the <tt>store</tt> is marked as <tt>volatile</tt>, then the
 optimizer is not allowed to modify the number or order of execution of
 this <tt>store</tt> with other volatile <tt>load</tt> and <tt><a
  href="#i_store">store</a></tt> instructions.</p>
 
 <p>
-The optional "align" argument specifies the alignment of the operation
+The optional constant "align" argument specifies the alignment of the operation
 (that is, the alignment of the memory address). A value of 0 or an
 omitted "align" argument means that the operation has the preferential
 alignment for the target. It is the responsibility of the code emitter
@@ -3258,9 +3263,8 @@
 on the pointer type that is being indexed into. <a href="#t_pointer">Pointer</a>
 and <a href="#t_array">array</a> types can use a 32-bit or 64-bit
 <a href="#t_integer">integer</a> type but the value will always be sign extended
-to 64-bits.  <a href="#t_struct">Structure</a> types require <tt>i32</tt>
-
-<b>constants</b>.</p>
+to 64-bits.  <a href="#t_struct">Structure</a> and <a href="#t_pstruct">packed structure</a> types
+require <tt>i32</tt> <b>constants</b>.</p>
 
 <p>In the example above, the first index is indexing into the '<tt>%ST*</tt>'
 type, which is a pointer, yielding a '<tt>%ST</tt>' = '<tt>{ i32, double, %RT
@@ -3814,7 +3818,7 @@
 </pre>
 <h5>Overview:</h5>
 <p>The '<tt>icmp</tt>' instruction returns a boolean value based on comparison
-of its two integer operands.</p>
+of its two integer or pointer operands.</p>
 <h5>Arguments:</h5>
 <p>The '<tt>icmp</tt>' instruction takes three operands. The first operand is
 the condition code indicating the kind of comparison to perform. It is not
@@ -4219,7 +4223,7 @@
 
 <p>The '<tt>getresult</tt>' instruction takes a call or invoke value as its
 first argument.  The value must have <a href="#t_struct">structure type</a>.
-The second argument is an unsigned index value which must be in range for
+The second argument is a constant unsigned index value which must be in range for
 the number of values returned by the call.</p>
 
 <h5>Semantics:</h5>
