--- imcc/docs/syntax.pod	2005-12-05 19:49:30.000000000 +0100
+++ imcc/docs/syntax2.pod	2005-12-05 20:15:53.000000000 +0100
@@ -207,6 +207,25 @@
 them with commas:
   .sym int i, j
 
+=item .lex <identifier>, <reg>
+
+Declare a lexical variable that is an alias for a PMC register. The 
+PIR compiler calls this method in response to a .lex STRING, PREG 
+directive. For example, given this preamble:
+
+    .lex "$a", $P0
+    $P1 = new Integer
+
+    These two opcodes have an identical effect:
+
+    $P0 = $P1
+    store_lex "$a", $P1
+
+    And these two opcodes also have an identical effect:
+
+    $P1 = $P0
+    $P1 = find_lex "$a"
+
 =item .const <type> <identifier> = <const>
 
 Define a named constant of style I<type> and value I<const>.