[PATCH 6/6] doc: use deffn to declare the list of %define variables

[Akim Demaille]

* doc/bison.texi (%define Summary): Use @deffn instead of @table, it
spares a lot of width, especially in PDF, and looks nicer in the other
formats too.
It is also more consistent with the rest of the document.
---
 doc/bison.texi | 93 +++++++++++++++++++++++++++-------------------------------
 1 file changed, 43 insertions(+), 50 deletions(-)

diff --git a/doc/bison.texi b/doc/bison.texi
index ba8a072..9708ad4 100644
--- a/doc/bison.texi
+++ b/doc/bison.texi
@@ -5521,12 +5521,9 @@ values, depend on the selected target language and/or 
the parser
 skeleton (@pxref{Decl Summary,,%language}, @pxref{Decl
 Summary,,%skeleton}).
 Unaccepted @var{variable}s produce an error.
-Some of the accepted @var{variable}s are:
+Some of the accepted @var{variable}s are described below.
 
address@hidden @code
address@hidden ================================================== api.namespace
address@hidden api.namespace
address@hidden %define api.namespace
address@hidden Directive {%define api.namespace} "@var{namespace}"
 @itemize
 @item Languages(s): C++
 
@@ -5574,11 +5571,11 @@ lexical analyzer function.  For example, if you specify:
 The parser namespace is @code{foo} and @code{yylex} is referenced as
 @code{bar::lex}.
 @end itemize
address@hidden namespace
address@hidden deffn
address@hidden api.namespace
 
 @c ================================================== api.location.type
address@hidden @code{api.location.type}
address@hidden %define api.location.type
address@hidden {Directive} {%define api.location.type} @var{type}
 
 @itemize @bullet
 @item Language(s): C++, Java
@@ -5594,10 +5591,10 @@ The parser namespace is @code{foo} and @code{yylex} is 
referenced as
 Introduced in Bison 2.7 for C, C++ and Java.  Introduced under the name
 @code{location_type} for C++ in Bison 2.5 and for Java in Bison 2.4.
 @end itemize
address@hidden deffn
 
 @c ================================================== api.prefix
address@hidden api.prefix
address@hidden %define api.prefix
address@hidden {Directive} {%define api.prefix} @var{prefix}
 
 @itemize @bullet
 @item Language(s): All
@@ -5611,10 +5608,10 @@ Introduced in Bison 2.7 for C, C++ and Java.  
Introduced under the name
 
 @item History: introduced in Bison 2.6
 @end itemize
address@hidden deffn
 
 @c ================================================== api.pure
address@hidden api.pure
address@hidden %define api.pure
address@hidden Directive {%define api.pure}
 
 @itemize @bullet
 @item Language(s): C
@@ -5659,13 +5656,13 @@ Reporting Function @code{yyerror}})
 @item History:
 the @code{full} value was introduced in Bison 2.7
 @end itemize
address@hidden deffn
 @c api.pure
 
 
 
 @c ================================================== api.push-pull
address@hidden api.push-pull
address@hidden %define api.push-pull
address@hidden Directive {%define api.push-pull} @var{kind}
 
 @itemize @bullet
 @item Language(s): C (deterministic parsers only)
@@ -5679,13 +5676,13 @@ More user feedback will help to stabilize it.)
 
 @item Default Value: @code{pull}
 @end itemize
address@hidden deffn
 @c api.push-pull
 
 
 
 @c ================================================== api.token.constructor
address@hidden api.token.constructor
address@hidden %define api.token.constructor
address@hidden Directive {%define api.token.constructor}
 
 @itemize @bullet
 @item Language(s):
@@ -5704,12 +5701,12 @@ Boolean.
 @item History:
 introduced in Bison 2.8
 @end itemize
address@hidden deffn
 @c api.token.constructor
 
 
 @c ================================================== api.token.prefix
address@hidden api.token.prefix
address@hidden %define api.token.prefix
address@hidden Directive {%define api.token.prefix} @var{prefix}
 
 @itemize
 @item Languages(s): all
@@ -5744,13 +5741,12 @@ empty
 @item History:
 introduced in Bison 2.8
 @end itemize
address@hidden deffn
 @c api.token.prefix
 
 
 @c ================================================== api.value.type
address@hidden %define api.value.type variant
address@hidden %define api.value.type variant
-
address@hidden Directive {%define api.value.type} @var{type}
 @itemize @bullet
 @item Language(s):
 C++
@@ -5759,26 +5755,25 @@ C++
 Request variant-based semantic values.
 @xref{C++ Variants}.
 
address@hidden FIXME: @item Accepted Values:
address@hidden FIXME: Boolean.
-
address@hidden @item Default Value:
address@hidden @code{false}
-@ @end itemize
address@hidden Default Value:
+FIXME:
address@hidden History:
+introduced in Bison 2.8.  Was introduced for Java only in 2.3b as
address@hidden
address@hidden itemize
address@hidden deffn
 @c api.value.type
 
 
 @c ================================================== location_type
address@hidden location_type
address@hidden %define location_type
address@hidden Directive {%define location_type}
 Obsoleted by @code{api.location.type} since Bison 2.7.
address@hidden namespace
address@hidden deffn
 
 
 @c ================================================== lr.default-reduction
 
address@hidden lr.default-reduction
address@hidden %define lr.default-reduction
address@hidden Directive {%define lr.default-reduction} @var{when}
 
 @itemize @bullet
 @item Language(s): all
@@ -5798,11 +5793,11 @@ feedback will help to stabilize it.)
 introduced as @code{lr.default-reduction} in 2.5, renamed as
 @code{lr.default-reduction} in 2.8.
 @end itemize
address@hidden deffn
 
 @c ============================================ lr.keep-unreachable-state
 
address@hidden lr.keep-unreachable-state
address@hidden %define lr.keep-unreachable-state
address@hidden Directive {%define lr.keep-unreachable-state}
 
 @itemize @bullet
 @item Language(s): all
@@ -5810,17 +5805,17 @@ introduced as @code{lr.default-reduction} in 2.5, 
renamed as
 remain in the parser tables.  @xref{Unreachable States}.
 @item Accepted Values: Boolean
 @item Default Value: @code{false}
address@hidden itemize
 @item History:
 introduced as @code{lr.keep_unreachable_states} in 2.3b, renamed as
 @code{lr.keep-unreachable-states} in 2.5, and as
 @code{lr.keep-unreachable-state} in 2.8.
address@hidden itemize
address@hidden deffn
 @c lr.keep-unreachable-state
 
 @c ================================================== lr.type
 
address@hidden lr.type
address@hidden %define lr.type
address@hidden Directive {%define lr.type} @var{type}
 
 @itemize @bullet
 @item Language(s): all
@@ -5833,18 +5828,16 @@ More user feedback will help to stabilize it.)
 
 @item Default Value: @code{lalr}
 @end itemize
-
address@hidden deffn
 
 @c ================================================== namespace
address@hidden namespace
address@hidden %define namespace
address@hidden Directive %define namespace @var{namespace}
 Obsoleted by @code{api.namespace}
 @c namespace
-
address@hidden deffn
 
 @c ================================================== parse.assert
address@hidden parse.assert
address@hidden %define parse.assert
address@hidden Directive {%define parse.assert}
 
 @itemize
 @item Languages(s): C++
@@ -5858,12 +5851,12 @@ destroyed properly.  This option checks these 
constraints.
 
 @item Default Value: @code{false}
 @end itemize
address@hidden deffn
 @c parse.assert
 
 
 @c ================================================== parse.error
address@hidden parse.error
address@hidden %define parse.error
address@hidden Directive {%define parse.error}
 @itemize
 @item Languages(s):
 all
@@ -5885,12 +5878,12 @@ However, this report can often be incorrect when LAC is 
not enabled
 @item Default Value:
 @code{simple}
 @end itemize
address@hidden deffn
 @c parse.error
 
 
 @c ================================================== parse.lac
address@hidden parse.lac
address@hidden %define parse.lac
address@hidden Directive {%define parse.lac}
 
 @itemize
 @item Languages(s): C (deterministic parsers only)
@@ -5900,11 +5893,11 @@ syntax error handling.  @xref{LAC}.
 @item Accepted Values: @code{none}, @code{full}
 @item Default Value: @code{none}
 @end itemize
address@hidden deffn
 @c parse.lac
 
 @c ================================================== parse.trace
address@hidden parse.trace
address@hidden %define parse.trace
address@hidden Directive {%define parse.trace}
 
 @itemize
 @item Languages(s): C, C++, Java
@@ -5922,8 +5915,8 @@ compiled.
 
 @item Default Value: @code{false}
 @end itemize
address@hidden deffn
 @c parse.trace
address@hidden table
 
 @node %code Summary
 @subsection %code Summary
-- 
1.8.0.2