<!-- Copyright (C) 2012 The Meme Factory, Inc.  http://www.karlpinc.com/
     Copyright (C) 2010, 2011, Karl O. Pinc  <kop@karlpinc.com>

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as published
  by the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.

Karl O. Pinc <kop@karlpinc.com>

XML entities that are used in multiple documentation files.

Often these are textual descriptions of m4 constants.
-->
          <!ENTITY  plusmn  "&#x00B1;"> <!-- recommended in case external
                                             entity not available -->

  <!-- Blurb to use for text columns. -->
  <!ENTITY emptytext
           "This column may not be empty; it must contain characters,
           and it must contain at least one non-whitespace character.">

  <!ENTITY notonlyspaces
           "This column may be empty; it need not contain characters,
           but it may not contain only whitespace characters.">

  <!ENTITY nospaces "This column may not contain whitespace characters.">

  <!ENTITY caseunique
          "This column must be unique when compared in a case-insensitive
          fashion.">

<!-- PostgreSQL stuff -->

  <!-- Hotlink the PostgreSQL name. -->
  <!ENTITY  postgresql 
           "&#x3C;ulink
            url=&#x22;http://www.postgresql.org&#x22;&#x3E;PostgreSQL&#x3C;/ulink&#x3E;">

  <!ENTITY  search_path
           "&#x3C;ulink
            url=&#x22;https://www.postgresql.org/docs/current/runtime-config-client.html&#x23;GUC-SEARCH-PATH&#x22;&#x3E;&#x3C;command&#x3E;search_path&#x3C;/command&#x3E;&#x3C;/ulink&#x3E;">

  <!ENTITY  schema
            "&#x3C;ulink
            url=&#x22;https://www.postgresql.org/docs/current/ddl-schemas.html&#x22;&#x3E;&#x3C;literal&#x3E;schema&#x3C;/literal&#x3E;&#x3C;/ulink&#x3E;">
  <!ENTITY extension
           "&#x3C;ulink
           url=&#x22;https://www.postgresql.org/docs/current/external-extensions.html&#x22;&#x3E;extension&#x3C;/ulink&#x3E;">

  <!ENTITY  pg_json_url
            "https://www.postgresql.org/docs/current/datatype-json.html">

  <!ENTITY  pg_cluster_url
            "https://www.postgresql.org/docs/17/glossary.html#GLOSSARY-DB-CLUSTER">

  <!ENTITY  server_url
            "https://en.wikipedia.org/wiki/Server_(computing)">

  <!ENTITY  name_type_description
           "Note that the &#x3C;literal&#x3E;name&#x3C;/literal&#x3E;
           data type casts (transparently) to
           &#x3C;literal&#x3E;TEXT&#x3C;/literal&#x3E;.">

<!-- Null stuff.  -->

  <!ENTITY notnull "This column may not be &null;.">

  <!-- This is the entity for docbook5, which introduces namespaces.
  - <!ENTITY null "&#x3C;literal xmlns=&#x22;http://docbook.org/ns/docbook&#x22;
  -                              version=&#x22;5.0&#x22;&#x3E;NULL&#x3C;/literal&#x3E;">
  -->
  <!ENTITY null "&#x3C;literal&#x3E;NULL&#x3C;/literal&#x3E;">

  <!-- TRUE and FALSE -->
  <!ENTITY true  "&#x3C;literal&#x3E;TRUE&#x3C;/literal&#x3E;">
  <!ENTITY false "&#x3C;literal&#x3E;FALSE&#x3C;/literal&#x3E;">

  <!-- Hotlink to the pg dollar quoting docs. -->
  <!ENTITY dollar_quoting
           "&#x3C;ulink
           url=&#x22;http://www.postgresql.org/docs/current/static/sql-syntax-lexical.html#SQL-SYNTAX-DOLLAR-QUOTING&#x22;&#x3E;dollar
           quoting&#x3C;/ulink&#x3E;">

  <!-- Docbook 5 version.
  - <!ENTITY true "&#x3C;literal xmlns=&#x22;http://docbook.org/ns/docbook&#x22;
  -                              version=&#x22;5.0&#x22;&#x3E;TRUE&#x3C;/literal&#x3E;">
  -
  - <!ENTITY false "&#x3C;literal xmlns=&#x22;http://docbook.org/ns/docbook&#x22;
  -                               version=&#x22;5.0&#x22;&#x3E;FALSE&#x3C;/literal&#x3E;">
  -  <!- - Hotlink to the pg dollar quoting docs. - ->
  -  <!ENTITY dollar_quoting
  -           "&#x3C;link
  -            xmlns=&#x22;http://docbook.org/ns/docbook&#x22;
  -            version=&#x22;5.0&#x22;
  -            xlink:href=&#x22;http://www.postgresql.org/docs/current/static/sql-syntax-lexical.html#SQL-SYNTAX-DOLLAR-QUOTING&#x22;&#x3E;dollar
  -            quoting&#x3C;/link&#x3E;">
  -->
