From ac2ba46053e3ccecda23f654ccec4d93b1484256 Mon Sep 17 00:00:00 2001 From: Akim Demaille Date: Sun, 3 May 2020 10:46:59 +0200 Subject: [PATCH] doc: clarify what a location is Reported by Arthur Schwarz https://lists.gnu.org/r/help-bison/2013-12/msg00009.html * doc/bison.texi (Location Type): here. --- THANKS | 1 + doc/bison.texi | 9 +++++++-- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/THANKS b/THANKS index 805c744f..48b31ea9 100644 --- a/THANKS +++ b/THANKS @@ -20,6 +20,7 @@ Anthony Heading ajrh@ajrh.net Antonio Silva Correia amsilvacorreia@hotmail.com Arnold Robbins arnold@skeeve.com Art Haas ahaas@neosoft.com +Arthur Schwarz aschwarz1309@att.net Askar Safin safinaskar@mail.ru Balázs Scheidler balazs.scheidler@oneidentity.com Baron Schwartz baron@sequent.org diff --git a/doc/bison.texi b/doc/bison.texi index 32d41924..7a00069f 100644 --- a/doc/bison.texi +++ b/doc/bison.texi @@ -4505,12 +4505,17 @@ typedef struct YYLTYPE @} YYLTYPE; @end example +While default locations represent a range in the source file(s), this is not +a requirement. It could be a single point or just a line number, or even +more complex structures. + When @code{YYLTYPE} is not defined, at the beginning of the parsing, Bison initializes all these fields to 1 for @code{yylloc}. To initialize @code{yylloc} with a custom location type (or to chose a different initialization), use the @code{%initial-action} directive. @xref{Initial Action Decl}. + @node Actions and Locations @subsection Actions and Locations @cindex location actions @@ -14735,8 +14740,8 @@ In semantic actions, it stores the location of the lookahead token. @end deffn @deffn {Type} YYLTYPE -Data type of @code{yylloc}; by default, a structure with four members. -@xref{Location Type}. +Data type of @code{yylloc}. By default in C, a structure with four members +(start/end line/column). @xref{Location Type}. @end deffn @deffn {Variable} yylval