postgresql/src/backend/parser
Tom Lane 3d7df87c4b Rename parser token REF to REF_P to avoid a symbol conflict.
In the latest version of Apple's macOS SDK, <sys/socket.h>
fails to compile if "REF" is #define'd as something.
Apple may or may not agree that this is a bug, and even if
they do accept the bug report I filed, they probably won't
fix it very quickly.  In the meantime, our back branches will all
fail to compile gram.y.  v15 and HEAD currently escape the problem
thanks to the refactoring done in 98e93a1fc, but that's purely
accidental.  Moreover, since that patch removed a widely-visible
inclusion of <netdb.h>, back-patching it seems too likely to break
third-party code.

Instead, change the token's code name to REF_P, following our usual
convention for naming parser tokens that are likely to have symbol
conflicts.  The effects of that should be localized to the grammar
and immediately surrounding files, so it seems like a safer answer.

Per project policy that we want to keep recently-out-of-support
branches buildable on modern systems, back-patch all the way to 9.2.

Discussion: https://postgr.es/m/1803927.1665938411@sss.pgh.pa.us
2022-10-16 15:27:04 -04:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Fix alias matching in transformLockingClause(). 2022-07-07 13:07:57 +01:00
check_keywords.pl Update copyright for 2019 2019-01-02 12:44:25 -05:00
gram.y Rename parser token REF to REF_P to avoid a symbol conflict. 2022-10-16 15:27:04 -04:00
Makefile Revert MERGE patch 2018-04-12 11:22:56 +01:00
parse_agg.c Fix check_agg_arguments' examination of aggregate FILTER clauses. 2021-08-18 18:12:51 -04:00
parse_clause.c Catch stack overflow when recursing in transformFromClauseItem(). 2022-08-13 15:21:28 -04:00
parse_coerce.c Ensure casting to typmod -1 generates a RelabelType. 2021-12-16 15:36:02 -05:00
parse_collate.c Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
parse_cte.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_enr.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_expr.c In transformRowExpr(), check for too many columns in the row. 2022-07-29 13:30:50 -04:00
parse_func.c Require the schema qualification in pg_temp.type_name(arg). 2019-08-05 07:48:45 -07:00
parse_node.c In transformRowExpr(), check for too many columns in the row. 2022-07-29 13:30:50 -04:00
parse_oper.c Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
parse_param.c Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
parse_relation.c Check maximum number of columns in function RTEs, too. 2022-08-01 12:22:35 -04:00
parse_target.c Remove bogus assertion in transformExpressionList(). 2021-10-19 11:35:15 -04:00
parse_type.c Require the schema qualification in pg_temp.type_name(arg). 2019-08-05 07:48:45 -07:00
parse_utilcmd.c In extensions, don't replace objects not belonging to the extension. 2022-08-08 11:12:31 -04:00
parser.c Replace the data structure used for keyword lookup. 2019-01-06 17:02:57 -05:00
README Move keywords.c/kwlookup.c into src/common/. 2016-03-23 20:22:08 -04:00
scan.l Replace the data structure used for keyword lookup. 2019-01-06 17:02:57 -05:00
scansup.c Update copyright for 2019 2019-01-02 12:44:25 -05:00

src/backend/parser/README

Parser
======

This directory does more than tokenize and parse SQL queries.  It also
creates Query structures for the various complex queries that are passed
to the optimizer and then executor.

parser.c	things start here
scan.l		break query into tokens
scansup.c	handle escapes in input strings
gram.y		parse the tokens and produce a "raw" parse tree
analyze.c	top level of parse analysis for optimizable queries
parse_agg.c	handle aggregates, like SUM(col1),  AVG(col2), ...
parse_clause.c	handle clauses like WHERE, ORDER BY, GROUP BY, ...
parse_coerce.c	handle coercing expressions to different data types
parse_collate.c	assign collation information in completed expressions
parse_cte.c	handle Common Table Expressions (WITH clauses)
parse_expr.c	handle expressions like col, col + 3, x = 3 or x = 4
parse_func.c	handle functions, table.column and column identifiers
parse_node.c	create nodes for various structures
parse_oper.c	handle operators in expressions
parse_param.c	handle Params (for the cases used in the core backend)
parse_relation.c support routines for tables and column handling
parse_target.c	handle the result list of the query
parse_type.c	support routines for data type handling
parse_utilcmd.c	parse analysis for utility commands (done at execution time)

See also src/common/keywords.c, which contains the table of standard
keywords and the keyword lookup function.  We separated that out because
various frontend code wants to use it too.