Tom Lane [Sun, 16 Jul 2006 00:52:05 +0000 (00:52 +0000)]
Improve error message wording.
Tom Lane [Sat, 15 Jul 2006 15:47:17 +0000 (15:47 +0000)]
Put back some more not-so-unused-as-all-that #includes. This un-breaks
the EXEC_BACKEND code on my machines, so hopefully it will fix the
Windows buildfarm members.
Tom Lane [Sat, 15 Jul 2006 15:27:14 +0000 (15:27 +0000)]
Fix some pgcrypto portability issues, per Marko Kreen.
Tom Lane [Sat, 15 Jul 2006 03:35:21 +0000 (03:35 +0000)]
Fix some missing inclusions identified with new pgcheckdefines tool.
Tom Lane [Sat, 15 Jul 2006 03:33:14 +0000 (03:33 +0000)]
Fix some makefiles that fail to yield good results from 'make -qp'.
This doesn't really matter for ordinary building of Postgres, but it's
useful for automated checks, such as my just-committed pgcheckdefines.
Tom Lane [Sat, 15 Jul 2006 03:27:42 +0000 (03:27 +0000)]
Create a tool to catch #include omissions that might not result in any
compiler warning, specifically #ifdef or #if defined tests on symbols
that are defined in a file not included. The results are a bit noisy
and require care to interpret, but it's a lot better than no tool at all.
Tom Lane [Fri, 14 Jul 2006 19:05:52 +0000 (19:05 +0000)]
Fix misguided removal of access/tuptoaster.h inclusion, per Kris Jurka.
I'm going to insist on reversion of this entire patch unless pgrminclude
is upgraded to a less broken state, but in the meantime let's get contrib
passing regression again.
Tom Lane [Fri, 14 Jul 2006 17:47:40 +0000 (17:47 +0000)]
In PGP public key tests, encrypt the secret key with AES not CAST5,
so that the test passes with or without OpenSSL. Marko Kreen
Tom Lane [Fri, 14 Jul 2006 16:59:19 +0000 (16:59 +0000)]
Fix another passel of include-file breakage. Kris Jurka, Tom Lane
Tom Lane [Fri, 14 Jul 2006 16:45:43 +0000 (16:45 +0000)]
Add dependency to fix parallel-make race condition. Alexander Dupuy
Bruce Momjian [Fri, 14 Jul 2006 14:59:00 +0000 (14:59 +0000)]
Have find_static skip main() functions.
Bruce Momjian [Fri, 14 Jul 2006 14:52:27 +0000 (14:52 +0000)]
Remove 576 references of include files that were not needed.
Tom Lane [Fri, 14 Jul 2006 05:28:29 +0000 (05:28 +0000)]
Fix a passel of recently-committed violations of the rule 'thou shalt
have no other gods before c.h'. Also remove some demonstrably redundant
#include lines, mostly of <errno.h> which was added to c.h years ago.
Bruce Momjian [Fri, 14 Jul 2006 04:59:30 +0000 (04:59 +0000)]
Revert part of recent include patch not ready for application.
Bruce Momjian [Fri, 14 Jul 2006 04:44:46 +0000 (04:44 +0000)]
Add additional includes needed on some platforms.
Bruce Momjian [Fri, 14 Jul 2006 01:05:14 +0000 (01:05 +0000)]
Move CFLAGS for pginclude to the end of the command line.
Neil Conway [Fri, 14 Jul 2006 00:13:05 +0000 (00:13 +0000)]
Minor doc tweak: replace a "--" with "—".
Neil Conway [Thu, 13 Jul 2006 23:59:47 +0000 (23:59 +0000)]
Reorder the entries in the function section of the manual, to ensure they
are alphabetically ordered. I believe the tables were correctly ordered in
the past, but some of them had subsequently regressed.
Bruce Momjian [Thu, 13 Jul 2006 20:14:12 +0000 (20:14 +0000)]
Move math.h after postgresql.h
Bruce Momjian [Thu, 13 Jul 2006 18:25:09 +0000 (18:25 +0000)]
Skip stripping postgres_fe.h include file.
Bruce Momjian [Thu, 13 Jul 2006 18:01:02 +0000 (18:01 +0000)]
More include file adjustments.
Bruce Momjian [Thu, 13 Jul 2006 17:47:02 +0000 (17:47 +0000)]
More include file adjustments.
Bruce Momjian [Thu, 13 Jul 2006 16:57:31 +0000 (16:57 +0000)]
Adjust /contrib for new include file contents.
Bruce Momjian [Thu, 13 Jul 2006 16:49:20 +0000 (16:49 +0000)]
Allow include files to compile own their own.
Strip unused include files out unused include files, and add needed
includes to C files.
The next step is to remove unused include files in C files.
Bruce Momjian [Thu, 13 Jul 2006 16:39:20 +0000 (16:39 +0000)]
Improve pginclude tools to process include file usage by other include files.
Neil Conway [Thu, 13 Jul 2006 15:09:57 +0000 (15:09 +0000)]
Remove trailing comma from CreateStmtLikeOption enum definition. This
is harmless, but it causes a warning with Tru64's cc.
Peter Eisentraut [Thu, 13 Jul 2006 14:44:33 +0000 (14:44 +0000)]
Be consistent about not using ECHO_N/ECHO_C (seems unnecessary on Linux).
Neil Conway [Thu, 13 Jul 2006 04:52:51 +0000 (04:52 +0000)]
Fix C++-style comment.
Neil Conway [Thu, 13 Jul 2006 04:15:25 +0000 (04:15 +0000)]
"Annual" pgcrypto update from Marko Kreen:
Few cleanups and couple of new things:
- add SHA2 algorithm to older OpenSSL
- add BIGNUM math to have public-key cryptography work on non-OpenSSL
build.
- gen_random_bytes() function
The status of SHA2 algoritms and public-key encryption can now be
changed to 'always available.'
That makes pgcrypto functionally complete and unless there will be new
editions of AES, SHA2 or OpenPGP standards, there is no major changes
planned.
Bruce Momjian [Wed, 12 Jul 2006 16:28:27 +0000 (16:28 +0000)]
Fix pgrminclude to work for stripping include files.
Bruce Momjian [Wed, 12 Jul 2006 15:37:10 +0000 (15:37 +0000)]
Update schema USAGE permission description.
Joe Conway [Wed, 12 Jul 2006 02:31:56 +0000 (02:31 +0000)]
Clean up for warning:
fe-auth.c:573: warning: passing argument 1 of 'free' discards qualifiers
from pointer target type
pg_krb5_authname used to return a (const char *) to memory allocated by
krb. Somewhere along the lines this was changed so that a copy was
made, returned, and freed instead. However the const modifier was never
removed.
Alvaro Herrera [Tue, 11 Jul 2006 21:21:59 +0000 (21:21 +0000)]
Apply entab fix from Marko Kreen for these problems:
- halt.c did not include stdlib.h, thus missed exit() prototype
- Makefile ignores BINDIR for install.
- Makefile calls install with user/group args, thus failing for regular user.
While trying it I noticed that the Makefile does not support VPATH builds ...
Tom Lane [Tue, 11 Jul 2006 21:05:57 +0000 (21:05 +0000)]
Tweak fillfactor code as per my recent proposal. Fix nbtsort.c so that
it can handle small fillfactors for ordinary-sized index entries without
failing on large ones; fix nbtinsert.c to distinguish leaf and nonleaf
pages; change the minimum fillfactor to 10% for all index types.
Bruce Momjian [Tue, 11 Jul 2006 20:51:25 +0000 (20:51 +0000)]
Improve pginclude tests.
Bruce Momjian [Tue, 11 Jul 2006 20:12:29 +0000 (20:12 +0000)]
Improve pginclude compile flags.
Bruce Momjian [Tue, 11 Jul 2006 19:52:12 +0000 (19:52 +0000)]
Update pginclude documentation.
Teodor Sigaev [Tue, 11 Jul 2006 19:49:14 +0000 (19:49 +0000)]
Add support to GIN for =(anyarray,anyarray) operation
Bruce Momjian [Tue, 11 Jul 2006 19:45:16 +0000 (19:45 +0000)]
Have pgrminclude process include files too.
Bruce Momjian [Tue, 11 Jul 2006 19:34:34 +0000 (19:34 +0000)]
Add $CFLAGS support to pgrminclude.
Bruce Momjian [Tue, 11 Jul 2006 19:31:29 +0000 (19:31 +0000)]
Move pgrminclude debug code to be more effective.
Bruce Momjian [Tue, 11 Jul 2006 19:30:05 +0000 (19:30 +0000)]
Improve shell script wrapping.
Bruce Momjian [Tue, 11 Jul 2006 19:25:41 +0000 (19:25 +0000)]
Add comments to pgrminclude.
Neil Conway [Tue, 11 Jul 2006 19:11:26 +0000 (19:11 +0000)]
Correct the description of the pg_get_viewdef() function. Do some nearby
SGML cleanup: sort table entries alphabetically.
Bruce Momjian [Tue, 11 Jul 2006 18:26:11 +0000 (18:26 +0000)]
Alphabetically order reference to include files, "S"-"Z".
Bruce Momjian [Tue, 11 Jul 2006 17:26:59 +0000 (17:26 +0000)]
Alphabetically order reference to include files, "N" - "S".
Bruce Momjian [Tue, 11 Jul 2006 17:04:13 +0000 (17:04 +0000)]
Alphabetically order reference to include files, "G" - "M".
Bruce Momjian [Tue, 11 Jul 2006 17:02:16 +0000 (17:02 +0000)]
Add URL of code presentation to developers FAQ.
Teodor Sigaev [Tue, 11 Jul 2006 16:55:34 +0000 (16:55 +0000)]
GIN improvements
- Replace sorted array of entries in maintenance_work_mem to binary tree,
this should improve create performance.
- More precisely calculate allocated memory, eliminate leaks
with user-defined extractValue()
- Improve wordings in tsearch2
Bruce Momjian [Tue, 11 Jul 2006 16:35:33 +0000 (16:35 +0000)]
Sort reference of include files, "A" - "F".
Tom Lane [Tue, 11 Jul 2006 16:14:50 +0000 (16:14 +0000)]
Remove no-longer-needed configure test for krb5_encrypt(), per Jim Gates.
Teodor Sigaev [Tue, 11 Jul 2006 16:00:44 +0000 (16:00 +0000)]
Fix bug corrupting query in gist consistent function.
Thank to Mario Weilguni <mweilguni@sime.com> to discover a bug.
Tom Lane [Tue, 11 Jul 2006 14:25:09 +0000 (14:25 +0000)]
Reverse inclusion order of <ws2tcpip.h> and <winsock2.h>, per Dave Page.
Bruce Momjian [Tue, 11 Jul 2006 13:54:25 +0000 (13:54 +0000)]
Allow each C include file to compile on its own by including any needed
header files.
Bruce Momjian [Tue, 11 Jul 2006 02:01:24 +0000 (02:01 +0000)]
Add libpq include directory to script.
Tom Lane [Mon, 10 Jul 2006 22:10:39 +0000 (22:10 +0000)]
Fix ALTER TABLE to check pre-existing NOT NULL constraints when rewriting
a table. Otherwise a USING clause that yields NULL can leave the table
violating its constraint (possibly there are other cases too). Per report
from Alexander Pravking.
Bruce Momjian [Mon, 10 Jul 2006 22:06:11 +0000 (22:06 +0000)]
Allow /contrib include files to compile on their own.
Bruce Momjian [Mon, 10 Jul 2006 21:03:58 +0000 (21:03 +0000)]
Add #include code to prevent multiple inclusion.
Bruce Momjian [Mon, 10 Jul 2006 18:53:29 +0000 (18:53 +0000)]
Move pthread-win32.h to /port, modify bcc/msvc makefiles.
Bruce Momjian [Mon, 10 Jul 2006 18:40:16 +0000 (18:40 +0000)]
Remove a few baby-C macros in fuzzystrmatch. Add a few missing includes.
Bruce Momjian [Mon, 10 Jul 2006 18:39:32 +0000 (18:39 +0000)]
Improve compile line for tool.
Bruce Momjian [Mon, 10 Jul 2006 17:13:34 +0000 (17:13 +0000)]
Update usage documention for pginclude
Bruce Momjian [Mon, 10 Jul 2006 17:11:43 +0000 (17:11 +0000)]
Add $CFLAGS handling to pgcompinclude.
Bruce Momjian [Mon, 10 Jul 2006 17:08:38 +0000 (17:08 +0000)]
Fix 'find' args for pgcompinclude tool.
Bruce Momjian [Mon, 10 Jul 2006 16:48:46 +0000 (16:48 +0000)]
Update schema GRANT USAGE description.
Bruce Momjian [Mon, 10 Jul 2006 16:45:44 +0000 (16:45 +0000)]
Improve tool coding.
Alvaro Herrera [Mon, 10 Jul 2006 16:20:52 +0000 (16:20 +0000)]
Improve vacuum code to track minimum Xids per table instead of per database.
To this end, add a couple of columns to pg_class, relminxid and relvacuumxid,
based on which we calculate the pg_database columns after each vacuum.
We now force all databases to be vacuumed, even template ones. A backend
noticing too old a database (meaning pg_database.datminxid is in danger of
falling behind Xid wraparound) will signal the postmaster, which in turn will
start an autovacuum iteration to process the offending database. In principle
this is only there to cope with frozen (non-connectable) databases without
forcing users to set them to connectable, but it could force regular user
database to go through a database-wide vacuum at any time. Maybe we should
warn users about this somehow. Of course the real solution will be to use
autovacuum all the time ;-)
There are some additional improvements we could have in this area: for example
the vacuum code could be smarter about not updating pg_database for each table
when called by autovacuum, and do it only once the whole autovacuum iteration
is done.
I updated the system catalogs documentation, but I didn't modify the
maintenance section. Also having some regression tests for this would be nice
but it's not really a very straightforward thing to do.
Catalog version bumped due to system catalog changes.
Bruce Momjian [Mon, 10 Jul 2006 16:07:24 +0000 (16:07 +0000)]
Improve script by processing only C files.
Alvaro Herrera [Mon, 10 Jul 2006 15:50:02 +0000 (15:50 +0000)]
Testing commit stuff
Bruce Momjian [Mon, 10 Jul 2006 15:44:31 +0000 (15:44 +0000)]
Test commit.
Alvaro Herrera [Sat, 8 Jul 2006 20:45:38 +0000 (20:45 +0000)]
Fix typo in comment.
Bruce Momjian [Thu, 6 Jul 2006 02:18:07 +0000 (02:18 +0000)]
Add index information to /contrib/pgstattuple:
This is an extension of pgstattuple to query information from indexes.
It supports btree, hash and gist. Gin is not supported. It scans only
index pages and does not read corresponding heap tuples. Therefore,
'dead_tuple' means the number of tuples with LP_DELETE flag.
Also, I added an experimental feature for btree indexes. It checks
fragmentation factor of indexes. If an leaf has the right link on the
next adjacent page in the file, it is assumed to be continuous (not
fragmented). It will help us to decide when to REINDEX.
ITAGAKI Takahiro
Bruce Momjian [Thu, 6 Jul 2006 02:12:32 +0000 (02:12 +0000)]
WIN32 fixes:
I take out patch for this as a promise. This is client-build support of
MS-VC6+.
Fix for different getaddrinfo structure ordering on Win32 for IPv6.
Hiroshi Saito
Bruce Momjian [Thu, 6 Jul 2006 01:57:25 +0000 (01:57 +0000)]
Backpatch dbmirror fix for escape handling.
> Upstream confirmed my reply in the last mail in [1]: the complete
> escaping logic in DBMirror.pl is seriously screwew.
>
> [1] http://archives.postgresql.org/pgsql-bugs/2006-06/msg00065.php
I finally found some time to debug this, and I think I found a better
patch than the one you proposed. Mine is still hackish and is still a
workaround around a proper quoting solution, but at least it repairs
the parsing without introducing the \' quoting again.
I consider this a band-aid patch to fix the recent security update.
PostgreSQL gurus, would you consider applying this until a better
solution is found for DBMirror.pl?
Olivier, can you please confirm that the patch works for you, too?
Backpatched to 8.0.X.
Martin Pitt
Bruce Momjian [Thu, 6 Jul 2006 01:55:51 +0000 (01:55 +0000)]
Attached patch is required ot build with the CRT that comes with Visual
Studio 2005. Basically MS defined errcode in the headers with a typedef,
so we have to #define it out of the way.
While at it, fix a function declaration in plpython that didn't match
the implementation (volatile missing).
Magnus Hagander
Bruce Momjian [Thu, 6 Jul 2006 01:46:38 +0000 (01:46 +0000)]
Please find attached two patches for documentation and regression tests
for the usage of full time zone names.
Joachim Wieland
Michael Meskes [Wed, 5 Jul 2006 10:49:56 +0000 (10:49 +0000)]
Fixed remaining Coverity bugs.
Tom Lane [Tue, 4 Jul 2006 18:07:24 +0000 (18:07 +0000)]
Documentation fixes for FILLFACTOR patch. Minor other editorialization.
Bruce Momjian [Tue, 4 Jul 2006 13:22:41 +0000 (13:22 +0000)]
Modify:
< o -Add PQescapeIdentifier()
> o Add PQescapeIdentifierConn()
Bruce Momjian [Tue, 4 Jul 2006 13:22:15 +0000 (13:22 +0000)]
Remove libpq's PQescapeIdentifier(), not safe from injection attacks.
Neil Conway [Tue, 4 Jul 2006 04:35:49 +0000 (04:35 +0000)]
Fix typos in comments.
Tom Lane [Mon, 3 Jul 2006 22:45:41 +0000 (22:45 +0000)]
Code review for FILLFACTOR patch. Change WITH grammar as per earlier
discussion (including making def_arg allow reserved words), add missed
opt_definition for UNIQUE case. Put the reloptions support code in a less
random place (I chose to make a new file access/common/reloptions.c).
Eliminate header inclusion creep. Make the index options functions safely
user-callable (seems like client apps might like to be able to test validity
of options before trying to make an index). Reduce overhead for normal case
with no options by allowing rd_options to be NULL. Fix some unmaintainably
klugy code, including getting rid of Natts_pg_class_fixed at long last.
Some stylistic cleanup too, and pay attention to keeping comments in sync
with code.
Documentation still needs work, though I did fix the omissions in
catalogs.sgml and indexam.sgml.
Tom Lane [Mon, 3 Jul 2006 16:43:14 +0000 (16:43 +0000)]
Fix broken markup.
Neil Conway [Sun, 2 Jul 2006 05:17:26 +0000 (05:17 +0000)]
Do a pass of code review for the ALTER TABLE ADD INHERITS patch. Keep
the read lock we hold on the table's parent relation until commit.
Update equalfuncs.c for the new field in AlterTableCmd. Various
improvements to comments, variable names, and error reporting.
There is room for further improvement here, but this is at least
a step in the right direction.
Bruce Momjian [Sun, 2 Jul 2006 02:23:23 +0000 (02:23 +0000)]
Add FILLFACTOR to CREATE INDEX.
ITAGAKI Takahiro
Bruce Momjian [Sun, 2 Jul 2006 02:22:39 +0000 (02:22 +0000)]
Done:
> * -Add fillfactor to control reserved free space during index creation
Bruce Momjian [Sun, 2 Jul 2006 01:59:46 +0000 (01:59 +0000)]
Done:
< o Add ALTER TABLE tab ADD/DROP INHERITS parent
<
< This allows tables to be added/removed from an inheritance
< hierarchy. This is particularly useful for table partitioning.
< http://archives.postgresql.org/pgsql-hackers/2006-05/msg00988.php
<
> o -Add ALTER TABLE tab INHERIT / NO INHERIT parent
Bruce Momjian [Sun, 2 Jul 2006 01:58:36 +0000 (01:58 +0000)]
ALTER TABLE ... ADD/DROPS INHERIT (actually INHERIT / NO INHERIT)
Open items:
There were a few tangentially related issues that have come up that I think
are TODOs. I'm likely to tackle one or two of these next so I'm interested in
hearing feedback on them as well.
. Constraints currently do not know anything about inheritance. Tom suggested
adding a coninhcount and conislocal like attributes have to track their
inheritance status.
. Foreign key constraints currently do not get copied to new children (and
therefore my code doesn't verify them). I don't think it would be hard to
add them and treat them like CHECK constraints.
. No constraints at all are copied to tables defined with LIKE. That makes it
hard to use LIKE to define new partitions. The standard defines LIKE and
specifically says it does not copy constraints. But the standard already has
an option called INCLUDING DEFAULTS; we could always define a non-standard
extension LIKE table INCLUDING CONSTRAINTS that gives the user the option to
request a copy including constraints.
. Personally, I think the whole attislocal thing is bunk. The decision about
whether to drop a column from children tables or not is something that
should be up to the user and trying to DWIM based on whether there was ever
a local definition or the column was acquired purely through inheritance is
hardly ever going to match up with user expectations.
. And of course there's the whole unique and primary key constraint issue. I
think to get any traction at all on this you have a prerequisite of a real
partitioned table implementation where the system knows what the partition
key is so it can recognize when it's a leading part of an index key.
Greg Stark
Tom Lane [Sat, 1 Jul 2006 22:07:23 +0000 (22:07 +0000)]
Fix oversight in planning for multiple indexscans driven by
ScalarArrayOpExpr index quals: we were estimating the right total
number of rows returned, but treating the index-access part of the
cost as if a single scan were fetching that many consecutive index
tuples. Actually we should treat it as a multiple indexscan, and
if there are enough of 'em the Mackert-Lohman discount should kick in.
Tom Lane [Sat, 1 Jul 2006 18:38:33 +0000 (18:38 +0000)]
Revise the planner's handling of "pseudoconstant" WHERE clauses, that is
clauses containing no variables and no volatile functions. Such a clause
can be used as a one-time qual in a gating Result plan node, to suppress
plan execution entirely when it is false. Even when the clause is true,
putting it in a gating node wins by avoiding repeated evaluation of the
clause. In previous PG releases, query_planner() would do this for
pseudoconstant clauses appearing at the top level of the jointree, but
there was no ability to generate a gating Result deeper in the plan tree.
To fix it, get rid of the special case in query_planner(), and instead
process pseudoconstant clauses through the normal RestrictInfo qual
distribution mechanism. When a pseudoconstant clause is found attached to
a path node in create_plan(), pull it out and generate a gating Result at
that point. This requires special-casing pseudoconstants in selectivity
estimation and cost_qual_eval, but on the whole it's pretty clean.
It probably even makes the planner a bit faster than before for the normal
case of no pseudoconstants, since removing pull_constant_clauses saves one
useless traversal of the qual tree. Per gripe from Phil Frost.
Alvaro Herrera [Fri, 30 Jun 2006 16:55:35 +0000 (16:55 +0000)]
Fix memory leak introduced in the prior commit, detected by Tom Lane.
Alvaro Herrera [Fri, 30 Jun 2006 15:06:05 +0000 (15:06 +0000)]
Fix use-after-free error reported by Neil Conway.
Bruce Momjian [Fri, 30 Jun 2006 15:04:32 +0000 (15:04 +0000)]
Update item for GUID:
< * Add 128-bit Universally Unique Identifier (UUID)
> * Add Globally/Universally Unique Identifier (GUID/UUID)
Tom Lane [Thu, 29 Jun 2006 20:00:08 +0000 (20:00 +0000)]
Remove the separate 'stats buffer' process, letting backend stats messages
be delivered directly to the collector process. The extra process context
swaps required to transfer data through the buffer process seem to outweigh
any value the buffering might have. Per recent discussion and tests.
I modified Bruce's draft patch to use poll() rather than select() where
available (this makes a noticeable difference on my system), and fixed
up the EXEC_BACKEND case.
Tom Lane [Thu, 29 Jun 2006 16:07:29 +0000 (16:07 +0000)]
Change TRUNCATE's method for searching for foreign-key references so that
the order in which it visits tables is not dependent on the physical order
of pg_constraint entries, and neither are the error messages it gives.
This should correct recently-noticed instability in regression tests.
Bruce Momjian [Thu, 29 Jun 2006 03:04:59 +0000 (03:04 +0000)]
Change URL for SITC:
< http://momjian.us/cgi-bin/pgsitc
> http://archives.postgresql.org/pgsql-hackers/2006-06/msg01534.php
Bruce Momjian [Thu, 29 Jun 2006 01:33:36 +0000 (01:33 +0000)]
Add:
> * Add 128-bit Universally Unique Identifier (UUID)
Neil Conway [Wed, 28 Jun 2006 22:11:01 +0000 (22:11 +0000)]
Add missing #include directive: pg_constraint.h declares some functions
whose prototypes include the "List" type, so it ought to include the
list header file.
Neil Conway [Wed, 28 Jun 2006 22:05:37 +0000 (22:05 +0000)]
Fix typo in comment.
Neil Conway [Wed, 28 Jun 2006 22:01:52 +0000 (22:01 +0000)]
Editorialization for the additions to the CREATE TABLE reference page
made as part of the recent INCLUDING CONSTRAINTS patch. The text could
stand further improvement, but this is at least a step in the right
direction.