postgresql/src/backend
Tom Lane d6b059ec74 Document intentional violations of header inclusion policy.
Although there are good reasons for our policy of including postgres.h
as the first #include in every .c file, never from .h files, there are
two places where it seems expedient to violate the policy because the
alternative is to modify externally-supplied .c files.  (In the case
of the regexp library, the idea that it's externally-supplied is kind
of at odds with reality, but I haven't entirely given up hope that it
will become a standalone project some day.)  Add some comments to make
it explicit that this is a policy violation and provide the reasoning.

In passing, move #include "miscadmin.h" out of regcomp.c and into
regcustom.h, which is where it should be if we're taking this reasoning
seriously at all.

Discussion: https://postgr.es/m/CAEepm=2zCoeq3QxVwhS5DFeUh=yU6z81pbWMgfOB8OzyiBwxzw@mail.gmail.com
Discussion: https://postgr.es/m/11634.1488932128@sss.pgh.pa.us
2017-03-08 17:01:13 -05:00
..
access Put back <float.h> in a few files that need it for _isnan(). 2017-03-08 15:38:34 -05:00
bootstrap Move atooid() definition to a central place 2017-03-01 11:55:28 -05:00
catalog Fix segfault in ALTER PUBLICATION/SUBSCRIPTION RENAME 2017-03-07 22:44:59 -05:00
commands Expose explain's SUMMARY option 2017-03-08 15:14:03 -05:00
executor Silence compiler warnings in BitmapHeapNext(). 2017-03-08 12:43:39 -05:00
foreign Generate fmgr prototypes automatically 2017-01-17 14:06:07 -05:00
lib Fix overflow check in StringInfo; add missing casts 2017-01-10 11:41:13 -03:00
libpq Fix comments in SCRAM-SHA-256 patch. 2017-03-07 15:24:27 +02:00
main Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
nodes Support parallel bitmap heap scans. 2017-03-08 12:05:43 -05:00
optimizer Support parallel bitmap heap scans. 2017-03-08 12:05:43 -05:00
parser Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
po Translation updates 2016-08-08 11:08:00 -04:00
port Remove useless duplicate inclusions of system header files. 2017-02-25 16:12:55 -05:00
postmaster Support parallel bitmap heap scans. 2017-03-08 12:05:43 -05:00
regex Document intentional violations of header inclusion policy. 2017-03-08 17:01:13 -05:00
replication Prevent logical rep workers with removed subscriptions from starting. 2017-03-09 01:44:23 +09:00
rewrite Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
snowball Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
storage Prevent logical rep workers with removed subscriptions from starting. 2017-03-09 01:44:23 +09:00
tcop Disallow CREATE/DROP SUBSCRIPTION in transaction block 2017-03-03 23:29:13 -05:00
tsearch Fix typos in comments. 2017-02-06 11:33:58 +02:00
utils Suppress compiler warning in slab.c. 2017-03-08 16:19:37 -05:00
.gitignore Add .gitignore entries for AIX-specific intermediate build artifacts. 2015-07-08 20:44:22 -04:00
Makefile Fix parallel make issue with new fmgrprotos.h 2017-01-23 15:36:27 -05:00
common.mk Remove maintainer-check target, fold into normal build 2013-10-10 20:11:56 -04:00
nls.mk Remove trailing slashes from directories in find command 2015-09-18 22:06:54 -04:00