Docs: updated descriptions of some inplace configurations.

diff --git a/re2c/bootstrap/doc/manual.html b/re2c/bootstrap/doc/manual.html
index f462cbe7f61dc335cd955a757207bb357956284d..c74e2fd6298de2e92e0e267a23682c922d3f498d 100644 (file)
--- a/re2c/bootstrap/doc/manual.html
+++ b/re2c/bootstrap/doc/manual.html
@@ -1786,16 +1786,44 @@ This can be set 0 to suppress output of the pre condition using <strong>YYCURSOR
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
+<strong>re2c:define:YYFILL</strong> = &#8220;YYFILL&#8221;; \r
+</dt>\r
+<dd>\r
+<p>\r
+Substitution for <strong>YYFILL</strong>.\r
+Note that by default <strong>re2c</strong> generates argument in braces and semicolon after <strong>YYFILL</strong>.\r
+If you need to make <strong>YYFILL</strong> an arbitrary statement rather than a call,\r
+set <strong>re2c:define:YYFILL:naked</strong> to non-zero and use <strong>re2c:define:YYFILL@len</strong> to denote\r
+formal parameter inside of <strong>YYFILL</strong> body.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>re2c:define:YYFILL@len</strong> = &#8220;@@&#8221;; \r
+</dt>\r
+<dd>\r
+<p>\r
+Any occurence of this text inside of <strong>YYFILL</strong> will be replaced with the actual argument.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
 <strong>re2c:yyfill:parameter</strong> = 1; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to suppress parameter passing to <strong>YYFILL</strong> calls. If set to zero\r
-then no parameter is passed to <strong>YYFILL</strong>. However <strong>define:YYFILL@LEN</strong>\r
-allows to specify a replacement string for the actual length value. If set to\r
-a non zero value then <strong>YYFILL</strong> usage will be followed by the number of\r
-requested characters in braces unless <strong>re2c:define:YYFILL:naked</strong> is set.\r
-Also look at <strong>re2c:define:YYFILL:naked</strong> and <strong>re2c:define:YYFILL@LEN</strong>.\r
+Controls argument in braces after <strong>YYFILL</strong>.\r
+If zero, agrument is omitted.\r
+If non-zero, argument is generated unless <strong>re2c:define:YYFILL:naked</strong> is set to non-zero.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>re2c:define:YYFILL:naked</strong> = 0; \r
+</dt>\r
+<dd>\r
+<p>\r
+Controls argument in braces and semicolon after <strong>YYFILL</strong>.\r
+If zero, both agrument and semicolon are omitted.\r
+If non-zero, argument is generated unless <strong>re2c:yyfill:parameter</strong> is set to zero\r
+and semicolon is generated unconditionally.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
@@ -1915,124 +1943,121 @@ value to the actual code needed.
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYFILL</strong> = <strong>YYFILL</strong>; \r
+<strong>re2c:define:YYGETCONDITION</strong> = &#8220;YYGETCONDITION&#8221;; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to overwrite the define <strong>YYFILL</strong> and thus avoiding it by setting the\r
-value to the actual code needed.\r
+Substitution for <strong>YYGETCONDITION</strong>.\r
+Note that by default <strong>re2c</strong> generates braces after <strong>YYGETCONDITION</strong>.\r
+Set <strong>re2c:define:YYGETCONDITION:naked</strong> to non-zero to omit braces.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYFILL:naked</strong> = <strong>0</strong>; \r
+<strong>re2c:define:YYGETCONDITION:naked</strong> = 0; \r
 </dt>\r
 <dd>\r
 <p>\r
-When set to 1 neither braces, parameter nor semicolon gets emitted.\r
+Controls braces after <strong>YYGETCONDITION</strong>.\r
+If zero, braces are omitted.\r
+If non-zero, braces are generated.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYFILL@len</strong> = @@; \r
+<strong>re2c:define:YYSETCONDITION</strong> = &#8220;YYSETCONDITION&#8221;; \r
 </dt>\r
 <dd>\r
 <p>\r
-When using <strong>re2c:define:YYFILL</strong> and <strong>re2c:yyfill:parameter</strong> is 0 then\r
-any occurence of this text inside <strong>YYFILL</strong> will be replaced with the actual\r
-length value.\r
+Substitution for <strong>YYSETCONDITION</strong>.\r
+Note that by default <strong>re2c</strong> generates argument in braces and semicolon after <strong>YYSETCONDITION</strong>.\r
+If you need to make <strong>YYSETCONDITION</strong> an arbitrary statement rather than a call,\r
+set <strong>re2c:define:YYSETCONDITION:naked</strong> to non-zero and use <strong>re2c:define:YYSETCONDITION@cond</strong> to denote\r
+formal parameter inside of <strong>YYSETCONDITION</strong> body.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYGETCONDITION</strong> = <strong>YYGETCONDITION</strong>; \r
+<strong>re2c:define:YYSETCONDITION@cond</strong> = &#8220;@@&#8221;; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to overwrite the define <strong>YYGETCONDITION</strong>.\r
+Any occurence of this text inside of <strong>YYSETCONDITION</strong> will be replaced with the actual argument.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYGETCONDITION:naked</strong> = <strong>0</strong>; \r
+<strong>re2c:define:YYSETCONDITION:naked</strong> = 0; \r
 </dt>\r
 <dd>\r
 <p>\r
-When set to 1 neither braces, parameter nor semicolon gets emitted.\r
+Controls argument in braces and semicolon after <strong>YYSETCONDITION</strong>.\r
+If zero, both agrument and semicolon are omitted.\r
+If non-zero, both argument and semicolon are generated.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYGETSTATE</strong> = <strong>YYGETSTATE</strong>; \r
+<strong>re2c:define:YYGETSTATE</strong> = &#8220;YYGETSTATE&#8221;; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to overwrite the define <strong>YYGETSTATE</strong> and thus avoiding it by setting the\r
-value to the actual code needed.\r
+Substitution for <strong>YYGETSTATE</strong>.\r
+Note that by default <strong>re2c</strong> generates braces after <strong>YYGETSTATE</strong>.\r
+Set <strong>re2c:define:YYGETSTATE:naked</strong> to non-zero to omit braces.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYGETSTATE:naked</strong> = <strong>0</strong>; \r
+<strong>re2c:define:YYGETSTATE:naked</strong> = 0; \r
 </dt>\r
 <dd>\r
 <p>\r
-When set to 1 neither braces, parameter nor semicolon gets emitted.\r
+Controls braces after <strong>YYGETSTATE</strong>.\r
+If zero, braces are omitted.\r
+If non-zero, braces are generated.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYLIMIT</strong> = <strong>YYLIMIT</strong>; \r
+<strong>re2c:define:YYSETSTATE</strong> = &#8220;YYSETSTATE&#8221;; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to overwrite the define <strong>YYLIMIT</strong> and thus avoiding it by setting the\r
-value to the actual code needed.\r
+Substitution for <strong>YYSETSTATE</strong>.\r
+Note that by default <strong>re2c</strong> generates argument in braces and semicolon after <strong>YYSETSTATE</strong>.\r
+If you need to make <strong>YYSETSTATE</strong> an arbitrary statement rather than a call,\r
+set <strong>re2c:define:YYSETSTATE:naked</strong> to non-zero and use <strong>re2c:define:YYSETSTATE@cond</strong> to denote\r
+formal parameter inside of <strong>YYSETSTATE</strong> body.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYMARKER</strong> = <strong>YYMARKER</strong>; \r
+<strong>re2c:define:YYSETSTATE@state</strong> = &#8220;@@&#8221;; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to overwrite the define <strong>YYMARKER</strong> and thus avoiding it by setting the\r
-value to the actual code needed.\r
+Any occurence of this text inside of <strong>YYSETSTATE</strong> will be replaced with the actual argument.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYSETCONDITION</strong> = <strong>YYSETCONDITION</strong>; \r
-</dt>\r
-<dd>\r
-<p>\r
-Allows to overwrite the define <strong>YYSETCONDITION</strong>.\r
-</p>\r
-</dd>\r
-<dt class="hdlist1">\r
-<strong>re2c:define:YYSETCONDITION@cond</strong> = @@; \r
+<strong>re2c:define:YYSETSTATE:naked</strong> = <strong>0</strong>; \r
 </dt>\r
 <dd>\r
 <p>\r
-When using <strong>re2c:define:YYSETCONDITION</strong> then any occurence of this text\r
-inside <strong>YYSETCONDITION</strong> will be replaced with the actual new condition value.\r
+Controls argument in braces and semicolon after <strong>YYSETSTATE</strong>.\r
+If zero, both agrument and semicolon are omitted.\r
+If non-zero, both argument and semicolon are generated.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYSETSTATE</strong> = <strong>YYSETSTATE</strong>; \r
+<strong>re2c:define:YYLIMIT</strong> = <strong>YYLIMIT</strong>; \r
 </dt>\r
 <dd>\r
 <p>\r
-Allows to overwrite the define <strong>YYSETSTATE</strong> and thus avoiding it by setting the\r
+Allows to overwrite the define <strong>YYLIMIT</strong> and thus avoiding it by setting the\r
 value to the actual code needed.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-<strong>re2c:define:YYSETSTATE:naked</strong> = <strong>0</strong>; \r
-</dt>\r
-<dd>\r
-<p>\r
-When set to 1 neither braces, parameter nor semicolon gets emitted.\r
-</p>\r
-</dd>\r
-<dt class="hdlist1">\r
-<strong>re2c:define:YYSETSTATE@state</strong> = @@; \r
+<strong>re2c:define:YYMARKER</strong> = <strong>YYMARKER</strong>; \r
 </dt>\r
 <dd>\r
 <p>\r
-When using <strong>re2c:define:YYSETSTATE</strong> then any occurence of this text\r
-inside <strong>YYSETSTATE</strong> will be replaced with the actual new state value.\r
+Allows to overwrite the define <strong>YYMARKER</strong> and thus avoiding it by setting the\r
+value to the actual code needed.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
@@ -2434,14 +2459,14 @@ Ulya Trofimovich <a href="mailto:skvadrik@gmail.com">skvadrik@gmail.com</a>
 <div class="sect1">\r
 <h2 id="_version_information">VERSION INFORMATION</h2>\r
 <div class="sectionbody">\r
-<div class="paragraph"><p>This manpage describes <strong>re2c</strong>, version 0.14.1.dev, package date 17 Sep 2015.</p></div>\r
+<div class="paragraph"><p>This manpage describes <strong>re2c</strong>, version 0.14.1.dev, package date 28 Sep 2015.</p></div>\r
 </div>\r
 </div>\r
 </div>\r
 <div id="footnotes"><hr /></div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 2015-09-17 15:12:42 BST\r
+Last updated 2015-09-28 15:25:09 BST\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/re2c/bootstrap/doc/re2c.1 b/re2c/bootstrap/doc/re2c.1
index a41c3308be1d0ab13f501efddfd08ce656b9462a..f00638fc4ee4ec90f9a9ed8933d9c5c17647dd44 100644 (file)
--- a/re2c/bootstrap/doc/re2c.1
+++ b/re2c/bootstrap/doc/re2c.1
@@ -2,12 +2,12 @@
 .\"     Title: re2c
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
-.\"      Date: 09/17/2015
+.\"      Date: 09/28/2015
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "RE2C" "1" "09/17/2015" "\ \&" "\ \&"
+.TH "RE2C" "1" "09/28/2015" "\ \&" "\ \&"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -914,21 +914,44 @@ which becomes usefull when
 is always accessible\&.
 .RE
 .PP
-\fBre2c:yyfill:parameter\fR = 1;
+\fBre2c:define:YYFILL\fR = \(lqYYFILL\(rq;
 .RS 4
-Allows to suppress parameter passing to
-\fBYYFILL\fR
-calls\&. If set to zero then no parameter is passed to
-\fBYYFILL\fR\&. However
-\fBdefine:YYFILL@LEN\fR
-allows to specify a replacement string for the actual length value\&. If set to a non zero value then
+Substitution for
+\fBYYFILL\fR\&. Note that by default
+\fBre2c\fR
+generates argument in braces and semicolon after
+\fBYYFILL\fR\&. If you need to make
 \fBYYFILL\fR
-usage will be followed by the number of requested characters in braces unless
+an arbitrary statement rather than a call, set
 \fBre2c:define:YYFILL:naked\fR
-is set\&. Also look at
+to non\-zero and use
+\fBre2c:define:YYFILL@len\fR
+to denote formal parameter inside of
+\fBYYFILL\fR
+body\&.
+.RE
+.PP
+\fBre2c:define:YYFILL@len\fR = \(lq@@\(rq;
+.RS 4
+Any occurence of this text inside of
+\fBYYFILL\fR
+will be replaced with the actual argument\&.
+.RE
+.PP
+\fBre2c:yyfill:parameter\fR = 1;
+.RS 4
+Controls argument in braces after
+\fBYYFILL\fR\&. If zero, agrument is omitted\&. If non\-zero, argument is generated unless
 \fBre2c:define:YYFILL:naked\fR
-and
-\fBre2c:define:YYFILL@LEN\fR\&.
+is set to non\-zero\&.
+.RE
+.PP
+\fBre2c:define:YYFILL:naked\fR = 0;
+.RS 4
+Controls argument in braces and semicolon after
+\fBYYFILL\fR\&. If zero, both agrument and semicolon are omitted\&. If non\-zero, argument is generated unless
+\fBre2c:yyfill:parameter\fR
+is set to zero and semicolon is generated unconditionally\&.
 .RE
 .PP
 \fBre2c:startlabel\fR = 0;
@@ -1040,100 +1063,112 @@ Allows to overwrite the define
 and thus avoiding it by setting the value to the actual code needed\&.
 .RE
 .PP
-\fBre2c:define:YYFILL\fR = \fBYYFILL\fR;
-.RS 4
-Allows to overwrite the define
-\fBYYFILL\fR
-and thus avoiding it by setting the value to the actual code needed\&.
-.RE
-.PP
-\fBre2c:define:YYFILL:naked\fR = \fB0\fR;
+\fBre2c:define:YYGETCONDITION\fR = \(lqYYGETCONDITION\(rq;
 .RS 4
-When set to 1 neither braces, parameter nor semicolon gets emitted\&.
+Substitution for
+\fBYYGETCONDITION\fR\&. Note that by default
+\fBre2c\fR
+generates braces after
+\fBYYGETCONDITION\fR\&. Set
+\fBre2c:define:YYGETCONDITION:naked\fR
+to non\-zero to omit braces\&.
 .RE
 .PP
-\fBre2c:define:YYFILL@len\fR = @@;
+\fBre2c:define:YYGETCONDITION:naked\fR = 0;
 .RS 4
-When using
-\fBre2c:define:YYFILL\fR
-and
-\fBre2c:yyfill:parameter\fR
-is 0 then any occurence of this text inside
-\fBYYFILL\fR
-will be replaced with the actual length value\&.
+Controls braces after
+\fBYYGETCONDITION\fR\&. If zero, braces are omitted\&. If non\-zero, braces are generated\&.
 .RE
 .PP
-\fBre2c:define:YYGETCONDITION\fR = \fBYYGETCONDITION\fR;
+\fBre2c:define:YYSETCONDITION\fR = \(lqYYSETCONDITION\(rq;
 .RS 4
-Allows to overwrite the define
-\fBYYGETCONDITION\fR\&.
+Substitution for
+\fBYYSETCONDITION\fR\&. Note that by default
+\fBre2c\fR
+generates argument in braces and semicolon after
+\fBYYSETCONDITION\fR\&. If you need to make
+\fBYYSETCONDITION\fR
+an arbitrary statement rather than a call, set
+\fBre2c:define:YYSETCONDITION:naked\fR
+to non\-zero and use
+\fBre2c:define:YYSETCONDITION@cond\fR
+to denote formal parameter inside of
+\fBYYSETCONDITION\fR
+body\&.
 .RE
 .PP
-\fBre2c:define:YYGETCONDITION:naked\fR = \fB0\fR;
+\fBre2c:define:YYSETCONDITION@cond\fR = \(lq@@\(rq;
 .RS 4
-When set to 1 neither braces, parameter nor semicolon gets emitted\&.
+Any occurence of this text inside of
+\fBYYSETCONDITION\fR
+will be replaced with the actual argument\&.
 .RE
 .PP
-\fBre2c:define:YYGETSTATE\fR = \fBYYGETSTATE\fR;
+\fBre2c:define:YYSETCONDITION:naked\fR = 0;
 .RS 4
-Allows to overwrite the define
-\fBYYGETSTATE\fR
-and thus avoiding it by setting the value to the actual code needed\&.
+Controls argument in braces and semicolon after
+\fBYYSETCONDITION\fR\&. If zero, both agrument and semicolon are omitted\&. If non\-zero, both argument and semicolon are generated\&.
 .RE
 .PP
-\fBre2c:define:YYGETSTATE:naked\fR = \fB0\fR;
+\fBre2c:define:YYGETSTATE\fR = \(lqYYGETSTATE\(rq;
 .RS 4
-When set to 1 neither braces, parameter nor semicolon gets emitted\&.
+Substitution for
+\fBYYGETSTATE\fR\&. Note that by default
+\fBre2c\fR
+generates braces after
+\fBYYGETSTATE\fR\&. Set
+\fBre2c:define:YYGETSTATE:naked\fR
+to non\-zero to omit braces\&.
 .RE
 .PP
-\fBre2c:define:YYLIMIT\fR = \fBYYLIMIT\fR;
+\fBre2c:define:YYGETSTATE:naked\fR = 0;
 .RS 4
-Allows to overwrite the define
-\fBYYLIMIT\fR
-and thus avoiding it by setting the value to the actual code needed\&.
+Controls braces after
+\fBYYGETSTATE\fR\&. If zero, braces are omitted\&. If non\-zero, braces are generated\&.
 .RE
 .PP
-\fBre2c:define:YYMARKER\fR = \fBYYMARKER\fR;
+\fBre2c:define:YYSETSTATE\fR = \(lqYYSETSTATE\(rq;
 .RS 4
-Allows to overwrite the define
-\fBYYMARKER\fR
-and thus avoiding it by setting the value to the actual code needed\&.
+Substitution for
+\fBYYSETSTATE\fR\&. Note that by default
+\fBre2c\fR
+generates argument in braces and semicolon after
+\fBYYSETSTATE\fR\&. If you need to make
+\fBYYSETSTATE\fR
+an arbitrary statement rather than a call, set
+\fBre2c:define:YYSETSTATE:naked\fR
+to non\-zero and use
+\fBre2c:define:YYSETSTATE@cond\fR
+to denote formal parameter inside of
+\fBYYSETSTATE\fR
+body\&.
 .RE
 .PP
-\fBre2c:define:YYSETCONDITION\fR = \fBYYSETCONDITION\fR;
+\fBre2c:define:YYSETSTATE@state\fR = \(lq@@\(rq;
 .RS 4
-Allows to overwrite the define
-\fBYYSETCONDITION\fR\&.
+Any occurence of this text inside of
+\fBYYSETSTATE\fR
+will be replaced with the actual argument\&.
 .RE
 .PP
-\fBre2c:define:YYSETCONDITION@cond\fR = @@;
+\fBre2c:define:YYSETSTATE:naked\fR = \fB0\fR;
 .RS 4
-When using
-\fBre2c:define:YYSETCONDITION\fR
-then any occurence of this text inside
-\fBYYSETCONDITION\fR
-will be replaced with the actual new condition value\&.
+Controls argument in braces and semicolon after
+\fBYYSETSTATE\fR\&. If zero, both agrument and semicolon are omitted\&. If non\-zero, both argument and semicolon are generated\&.
 .RE
 .PP
-\fBre2c:define:YYSETSTATE\fR = \fBYYSETSTATE\fR;
+\fBre2c:define:YYLIMIT\fR = \fBYYLIMIT\fR;
 .RS 4
 Allows to overwrite the define
-\fBYYSETSTATE\fR
+\fBYYLIMIT\fR
 and thus avoiding it by setting the value to the actual code needed\&.
 .RE
 .PP
-\fBre2c:define:YYSETSTATE:naked\fR = \fB0\fR;
-.RS 4
-When set to 1 neither braces, parameter nor semicolon gets emitted\&.
-.RE
-.PP
-\fBre2c:define:YYSETSTATE@state\fR = @@;
+\fBre2c:define:YYMARKER\fR = \fBYYMARKER\fR;
 .RS 4
-When using
-\fBre2c:define:YYSETSTATE\fR
-then any occurence of this text inside
-\fBYYSETSTATE\fR
-will be replaced with the actual new state value\&.
+Allows to overwrite the define
+\fBYYMARKER\fR
+and thus avoiding it by setting the value to the actual code needed\&.
 .RE
 .PP
 \fBre2c:label:yyFillLabel\fR = \fByyFillLabel\fR;
@@ -1613,4 +1648,4 @@ skvadrik@gmail\&.com
 .RE
 .SH "VERSION INFORMATION"
 .sp
-This manpage describes \fBre2c\fR, version 0\&.14\&.1\&.dev, package date 17 Sep 2015\&.
+This manpage describes \fBre2c\fR, version 0\&.14\&.1\&.dev, package date 28 Sep 2015\&.

diff --git a/re2c/doc/re2c.ad.in b/re2c/doc/re2c.ad.in
index 9823a4280a0d787af06e415a0ca0361092f8817a..39bfb9c58af47ca18ab0168a6dab094dce5ecdeb 100644 (file)
--- a/re2c/doc/re2c.ad.in
+++ b/re2c/doc/re2c.ad.in
@@ -632,13 +632,26 @@ this behavior might introduce sever security issues to you programs.
 This can be set 0 to suppress output of the pre condition using *YYCURSOR* and
 *YYLIMIT* which becomes usefull when *$$YYLIMIT + max (YYFILL)$$* is always accessible.
 
+*re2c:define:YYFILL* = ``YYFILL''; ::
+Substitution for *YYFILL*.
+Note that by default *re2c* generates argument in braces and semicolon after *YYFILL*.
+If you need to make *YYFILL* an arbitrary statement rather than a call, 
+set *re2c:define:YYFILL:naked* to non-zero and use *re2c:define:YYFILL@len* to denote
+formal parameter inside of *YYFILL* body.
+
+*re2c:define:YYFILL@len* = ``@@''; ::
+Any occurence of this text inside of *YYFILL* will be replaced with the actual argument.
+
 *re2c:yyfill:parameter* = 1; ::
-Allows to suppress parameter passing to *YYFILL* calls. If set to zero 
-then no parameter is passed to *YYFILL*. However *define:YYFILL@LEN*
-allows to specify a replacement string for the actual length value. If set to
-a non zero value then *YYFILL* usage will be followed by the number of 
-requested characters in braces unless *re2c:define:YYFILL:naked* is set. 
-Also look at *re2c:define:YYFILL:naked* and *re2c:define:YYFILL@LEN*.
+Controls argument in braces after *YYFILL*.
+If zero, agrument is omitted.
+If non-zero, argument is generated unless *re2c:define:YYFILL:naked* is set to non-zero.
+
+*re2c:define:YYFILL:naked* = 0; ::
+Controls argument in braces and semicolon after *YYFILL*.
+If zero, both agrument and semicolon are omitted.
+If non-zero, argument is generated unless *re2c:yyfill:parameter* is set to zero
+and semicolon is generated unconditionally.
 
 *re2c:startlabel* = 0; ::
 If set to a non zero integer then the start label of the next scanner blocks 
@@ -701,30 +714,55 @@ value to the actual code needed.
 Allows to overwrite the define *YYDEBUG* and thus avoiding it by setting the
 value to the actual code needed.
 
-*re2c:define:YYFILL* = *YYFILL*; ::
-Allows to overwrite the define *YYFILL* and thus avoiding it by setting the
-value to the actual code needed.
-
-*re2c:define:YYFILL:naked* = *0*; ::
-When set to 1 neither braces, parameter nor semicolon gets emitted.
-
-*re2c:define:YYFILL@len* = @@; ::
-When using *re2c:define:YYFILL* and *re2c:yyfill:parameter* is 0 then
-any occurence of this text inside *YYFILL* will be replaced with the actual
-length value.
-
-*re2c:define:YYGETCONDITION* = *YYGETCONDITION*; ::
-Allows to overwrite the define *YYGETCONDITION*.
-
-*re2c:define:YYGETCONDITION:naked* = *0*; ::
-When set to 1 neither braces, parameter nor semicolon gets emitted.
-
-*re2c:define:YYGETSTATE* = *YYGETSTATE*; ::
-Allows to overwrite the define *YYGETSTATE* and thus avoiding it by setting the
-value to the actual code needed.
+*re2c:define:YYGETCONDITION* = ``YYGETCONDITION''; ::
+Substitution for *YYGETCONDITION*.
+Note that by default *re2c* generates braces after *YYGETCONDITION*.
+Set *re2c:define:YYGETCONDITION:naked* to non-zero to omit braces.
+
+*re2c:define:YYGETCONDITION:naked* = 0; ::
+Controls braces after *YYGETCONDITION*.
+If zero, braces are omitted.
+If non-zero, braces are generated.
+
+*re2c:define:YYSETCONDITION* = ``YYSETCONDITION''; ::
+Substitution for *YYSETCONDITION*.
+Note that by default *re2c* generates argument in braces and semicolon after *YYSETCONDITION*.
+If you need to make *YYSETCONDITION* an arbitrary statement rather than a call, 
+set *re2c:define:YYSETCONDITION:naked* to non-zero and use *re2c:define:YYSETCONDITION@cond* to denote
+formal parameter inside of *YYSETCONDITION* body.
+
+*re2c:define:YYSETCONDITION@cond* = ``@@''; ::
+Any occurence of this text inside of *YYSETCONDITION* will be replaced with the actual argument.
+
+*re2c:define:YYSETCONDITION:naked* = 0; ::
+Controls argument in braces and semicolon after *YYSETCONDITION*.
+If zero, both agrument and semicolon are omitted.
+If non-zero, both argument and semicolon are generated.
+
+*re2c:define:YYGETSTATE* = ``YYGETSTATE''; ::
+Substitution for *YYGETSTATE*.
+Note that by default *re2c* generates braces after *YYGETSTATE*.
+Set *re2c:define:YYGETSTATE:naked* to non-zero to omit braces.
+
+*re2c:define:YYGETSTATE:naked* = 0; ::
+Controls braces after *YYGETSTATE*.
+If zero, braces are omitted.
+If non-zero, braces are generated.
+
+*re2c:define:YYSETSTATE* = ``YYSETSTATE''; ::
+Substitution for *YYSETSTATE*.
+Note that by default *re2c* generates argument in braces and semicolon after *YYSETSTATE*.
+If you need to make *YYSETSTATE* an arbitrary statement rather than a call, 
+set *re2c:define:YYSETSTATE:naked* to non-zero and use *re2c:define:YYSETSTATE@cond* to denote
+formal parameter inside of *YYSETSTATE* body.
+
+*re2c:define:YYSETSTATE@state* = ``@@''; ::
+Any occurence of this text inside of *YYSETSTATE* will be replaced with the actual argument.
 
-*re2c:define:YYGETSTATE:naked* = *0*; ::
-When set to 1 neither braces, parameter nor semicolon gets emitted.
+*re2c:define:YYSETSTATE:naked* = *0*; ::
+Controls argument in braces and semicolon after *YYSETSTATE*.
+If zero, both agrument and semicolon are omitted.
+If non-zero, both argument and semicolon are generated.
 
 *re2c:define:YYLIMIT* = *YYLIMIT*; ::
 Allows to overwrite the define *YYLIMIT* and thus avoiding it by setting the
@@ -734,24 +772,6 @@ value to the actual code needed.
 Allows to overwrite the define *YYMARKER* and thus avoiding it by setting the
 value to the actual code needed.
 
-*re2c:define:YYSETCONDITION* = *YYSETCONDITION*; ::
-Allows to overwrite the define *YYSETCONDITION*.
-
-*re2c:define:YYSETCONDITION@cond* = @@; ::
-When using *re2c:define:YYSETCONDITION* then any occurence of this text 
-inside *YYSETCONDITION* will be replaced with the actual new condition value.
-
-*re2c:define:YYSETSTATE* = *YYSETSTATE*; ::
-Allows to overwrite the define *YYSETSTATE* and thus avoiding it by setting the
-value to the actual code needed.
-
-*re2c:define:YYSETSTATE:naked* = *0*; ::
-When set to 1 neither braces, parameter nor semicolon gets emitted.
-
-*re2c:define:YYSETSTATE@state* = @@; ::
-When using *re2c:define:YYSETSTATE* then any occurence of this text 
-inside *YYSETSTATE* will be replaced with the actual new state value.
-
 *re2c:label:yyFillLabel* = *yyFillLabel*; ::
 Allows to overwrite the name of the label *yyFillLabel*.