diff --git a/reference/parle/parle/lexer/push.xml b/reference/parle/parle/lexer/push.xml
index 01172e3e70..ba4c8a40a3 100644
--- a/reference/parle/parle/lexer/push.xml
+++ b/reference/parle/parle/lexer/push.xml
@@ -16,7 +16,7 @@
    <!--<methodparam choice="opt"><type>integer</type><parameter>userId</parameter></methodparam>-->
   </methodsynopsis>
   <para>
-
+   Push a pattern for lexeme recognition.
   </para>
  </refsect1>
 
@@ -35,7 +35,7 @@
     <term><parameter>id</parameter></term>
     <listitem>
      <para>
-      Auto assigned token id.
+      Token id. If the lexer instance is meant to be used standalone, this can be an arbitrary number. If the lexer instance is going to be passed to the parser, it has to be an id returned by <methodname>Parle\Parser::tokenid</methodname>.
      </para>
     </listitem>
    </varlistentry>
diff --git a/reference/parle/parle/rlexer/push.xml b/reference/parle/parle/rlexer/push.xml
index 171d41cf2c..2e56ada8d1 100644
--- a/reference/parle/parle/rlexer/push.xml
+++ b/reference/parle/parle/rlexer/push.xml
@@ -30,7 +30,7 @@
    <methodparam><type>string</type><parameter>newState</parameter></methodparam>
   </methodsynopsis>
   <para>
-
+   Push a pattern for lexeme recognition.
   </para>
  </refsect1>
 
@@ -49,7 +49,7 @@
     <term><parameter>id</parameter></term>
     <listitem>
      <para>
-      Auto assigned token id.
+      Token id. If the lexer instance is meant to be used standalone, this can be an arbitrary number. If the lexer instance is going to be passed to the parser, it has to be an id returned by <methodname>Parle\Parser::tokenid</methodname>.
      </para>
     </listitem>
    </varlistentry>