From 6d137ba9b10fea617c9daeba9ae1e5254129e978 Mon Sep 17 00:00:00 2001
From: "Karl O. Pinc kop@karlpinc.com" <kop@karlpinc.com>
Date: Sat, 20 Jun 2026 00:35:44 +0000
Subject: [PATCH] Create and document MATING_SOURCES

---
 db/schemas/codes/tables/Makefile              |  1 +
 .../codes/tables/create/mating_sources.m4     | 28 +++++++++++++
 doc/src/code_tables.m4                        | 42 +++++++++++++++++++
 doc/src/epilog.inc.m4                         |  7 ++++
 4 files changed, 78 insertions(+)
 create mode 100644 db/schemas/codes/tables/create/mating_sources.m4

diff --git a/db/schemas/codes/tables/Makefile b/db/schemas/codes/tables/Makefile
index 7c519f7..7f0d679 100644
--- a/db/schemas/codes/tables/Makefile
+++ b/db/schemas/codes/tables/Makefile
@@ -35,6 +35,7 @@ ORDER := agg_severities \
          food_parts \
          le_certainties \
          location_origins \
+         mating_sources \
          parities \
          people \
          obs_periods \
diff --git a/db/schemas/codes/tables/create/mating_sources.m4 b/db/schemas/codes/tables/create/mating_sources.m4
new file mode 100644
index 0000000..347b25b
--- /dev/null
+++ b/db/schemas/codes/tables/create/mating_sources.m4
@@ -0,0 +1,28 @@
+dnl Copyright (C) 2026 The Meme Factory, Inc., http://www.karlpinc.com/
+dnl
+dnl   This program is free software: you can redistribute it and/or modify
+dnl   it under the terms of the GNU Affero General Public License as published
+dnl   by the Free Software Foundation, either version 3 of the License, or
+dnl   (at your option) any later version.
+dnl
+dnl   This program is distributed in the hope that it will be useful,
+dnl   but WITHOUT ANY WARRANTY; without even the implied warranty of
+dnl   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+dnl   GNU Affero General Public License for more details.
+dnl
+dnl   You should have received a copy of the GNU Affero General Public License
+dnl   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+dnl
+dnl Karl O. Pinc <kop@karlpinc.com>
+dnl
+dnl
+dnl m4 includes
+include(`copyright.m4')dnl
+include(`constants.m4')dnl
+include(`tablemacros.m4')dnl
+include(`grants.m4')dnl
+
+support_table(`MATING_SOURCES', `Source', `TEXT', `
+           emptytext_check(`Source')
+           uppercase_check(`Source')'
+)
diff --git a/doc/src/code_tables.m4 b/doc/src/code_tables.m4
index fb1eb5d..536ad73 100644
--- a/doc/src/code_tables.m4
+++ b/doc/src/code_tables.m4
@@ -773,6 +773,48 @@ Description
 |LOCATION_ORIGINS.Description_summary| |emptytext| |notnull|
 
 
+.. _MATING_SOURCES:
+
+MATING_SOURCES
+--------------
+
+.. |MATING_SOURCES_summary| replace::
+   Contains one row for each source of mating information.
+
+|MATING_SOURCES_summary|
+
+
+Special Values
+``````````````
+
+None.
+
+
+Column Descriptions
+```````````````````
+
+.. _MATING_SOURCES.Source:
+
+Source
+''''''
+
+.. |MATING_SOURCES.Source_summary| replace::
+   A code identifying a source of data for mating information.
+
+|MATING_SOURCES.Source_summary|  |caseuniquekeycol| |uppercase|
+
+
+.. _MATING_SOURCES.Description:
+
+Description
+'''''''''''
+
+.. |MATING_SOURCES.Description_summary| replace::
+   A description of the source of mating data.
+
+|MATING_SOURCES.Description_summary| |emptytext| |notnull|
+
+
 .. _OBS_PERIODS:
 
 OBS_PERIODS (Obsevervation Periods)
diff --git a/doc/src/epilog.inc.m4 b/doc/src/epilog.inc.m4
index 45190a9..68a4956 100644
--- a/doc/src/epilog.inc.m4
+++ b/doc/src/epilog.inc.m4
@@ -541,6 +541,13 @@ sdb_generated_rst()dnl
 .. |LOCATION_ORIGINS.Description| replace::
    :ref:`Description <LOCATION_ORIGINS.Description>`
 
+.. |MATING_SOURCES| replace::
+   :ref:`MATING_SOURCES <MATING_SOURCES>`
+.. |MATING_SOURCES.Source| replace::
+   :ref:`Source <MATING_SOURCES.Source>`
+.. |MATING_SOURCES.Description| replace::
+   :ref:`Description <MATING_SOURCES.Description>`
+
 .. |NON_BREC_SIGHTING_SOURCES| replace::
    :ref:`NON_BREC_SIGHTING_SOURCES <NON_BREC_SIGHTING_SOURCES>`
 .. |NON_BREC_SIGHTING_SOURCES.ID| replace::
-- 
2.34.1