postgresql/src/backend/parser
Tom Lane 382ceffdf7 Phase 3 of pgindent updates.
Don't move parenthesized lines to the left, even if that means they
flow past the right margin.

By default, BSD indent lines up statement continuation lines that are
within parentheses so that they start just to the right of the preceding
left parenthesis.  However, traditionally, if that resulted in the
continuation line extending to the right of the desired right margin,
then indent would push it left just far enough to not overrun the margin,
if it could do so without making the continuation line start to the left of
the current statement indent.  That makes for a weird mix of indentations
unless one has been completely rigid about never violating the 80-column
limit.

This behavior has been pretty universally panned by Postgres developers.
Hence, disable it with indent's new -lpl switch, so that parenthesized
lines are always lined up with the preceding left paren.

This patch is much less interesting than the first round of indent
changes, but also bulkier, so I thought it best to separate the effects.

Discussion: https://postgr.es/m/E1dAmxK-0006EE-1r@gemulon.postgresql.org
Discussion: https://postgr.es/m/30527.1495162840@sss.pgh.pa.us
2017-06-21 15:35:54 -04:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
check_keywords.pl Post-PG 10 beta1 pgperltidy run 2017-05-17 19:01:23 -04:00
gram.y Fix ALTER SUBSCRIPTION grammar ambiguity 2017-06-05 21:43:25 -04:00
Makefile Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_agg.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_clause.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_coerce.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_collate.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_cte.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_enr.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_expr.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_func.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_node.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_oper.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_param.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_relation.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_target.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_type.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parse_utilcmd.c Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
parser.c Change representation of statement lists, and add statement location info. 2017-01-14 16:02:35 -05:00
README Move keywords.c/kwlookup.c into src/common/. 2016-03-23 20:22:08 -04:00
scan.l Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
scansup.c Update copyright via script for 2017 2017-01-03 13:48:53 -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.