doc: clarify what a location is

Reported by Arthur Schwarz <aschwarz1309@att.net>
https://lists.gnu.org/r/help-bison/2013-12/msg00009.html

* doc/bison.texi (Location Type): here.
This commit is contained in:
Akim Demaille
2020-05-03 10:46:59 +02:00
parent 2a7a2c1d3a
commit ac2ba46053
2 changed files with 8 additions and 2 deletions

1
THANKS
View File

@@ -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

View File

@@ -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