1
0
mirror of https://github.com/postgres/postgres.git synced 2025-08-18 12:22:09 +03:00
Files
postgres/doc/src/sgml
Tom Lane bca409e5b1 Assert that we don't insert nulls into attnotnull catalog columns.
The executor checks for this error, and so does the bootstrap catalog
loader, but we never checked for it in retail catalog manipulations.
The folly of that has now been exposed, so let's add assertions
checking it.  Checking in CatalogTupleInsert[WithInfo] and
CatalogTupleUpdate[WithInfo] should be enough to cover this.

Back-patch to v10; the aforesaid functions didn't exist before that,
and it didn't seem worth adapting the patch to the oldest branches.
But given the risk of JIT crashes, I think we certainly need this
as far back as v11.

Pre-v13, we have to explicitly exclude pg_subscription.subslotname
and pg_subscription_rel.srsublsn from the checks, since they are
mismarked.  (Even if we change our mind about applying BKI_FORCE_NULL
in the branch tips, it doesn't seem wise to have assertions that
would fire in existing databases.)

Discussion: https://postgr.es/m/298837.1595196283@sss.pgh.pa.us
2020-07-21 12:38:08 -04:00
..
2020-04-11 21:07:20 -07:00
2019-09-08 10:27:29 +02:00
2020-07-05 15:38:14 +02:00
2019-09-08 10:27:29 +02:00
2020-07-18 22:43:41 +09:00
2020-02-26 13:05:30 -08:00
2020-03-29 11:15:11 +02:00
2018-10-11 11:43:56 -07:00
2020-07-18 22:43:41 +09:00
2019-09-08 10:27:29 +02:00
2020-07-18 22:43:41 +09:00
2018-06-20 16:06:03 +02:00
2020-07-05 15:38:14 +02:00
2020-07-05 15:38:14 +02:00
2020-06-07 13:18:36 +02:00
2020-07-18 22:43:41 +09:00
2020-07-05 15:38:14 +02:00
2019-10-25 20:39:41 +02:00
2020-07-18 22:43:41 +09:00
2020-07-18 22:43:41 +09:00
2020-01-01 12:21:45 -05:00
2019-09-08 10:27:29 +02:00
2020-07-05 15:38:14 +02:00
2020-06-15 13:12:28 +12:00
2020-07-18 22:43:41 +09:00
2019-09-08 10:27:29 +02:00
2020-07-18 22:43:41 +09:00
2020-07-18 22:43:41 +09:00
2020-04-15 11:15:12 +09:00
2020-07-15 21:01:29 +02:00
2020-07-18 22:43:41 +09:00
2019-09-08 10:27:29 +02:00
2019-08-13 08:40:17 +02:00
2019-03-27 23:10:23 +01:00
2019-09-08 10:27:29 +02:00
2019-09-08 10:27:29 +02:00

<!-- doc/src/sgml/README.links -->

Linking within DocBook documents can be confusing, so here is a summary:


Intra-document Linking
----------------------

<xref>
	use to get chapter/section number from the title of the target
	link, or xreflabel if defined at the target, or refentrytitle if target
        is a refentry;  has no close tag
	http://www.oasis-open.org/docbook/documentation/reference/html/xref.html

linkend=
	controls the target of the link/xref, required

endterm=
	for <xref>, allows the text of the link/xref to be taken from a
	different link target title

<link>
	use to supply text for the link, only uses linkend, requires </link>
	http://www.oasis-open.org/docbook/documentation/reference/html/link.html


External Linking
----------------

<ulink>
	like <link>, but uses a URL (not a document target);  requires
	</ulink>; if no text is specified, the URL appears as the link
	text
	http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html

url=
	used by <ulink> to specify the URL, required


Guidelines
----------

- For an internal link, if you want to supply text, use <link>, else
  <xref>.

- Specific nouns like GUC variables, SQL commands, and contrib modules
  usually have xreflabels.

- For an external link, use <ulink>, with or without link text.