From 2f49cd5b7330bba006adf103a4951406c2e80de9 Mon Sep 17 00:00:00 2001
From: "Karl O. Pinc kop@karlpinc.com" <kop@karlpinc.com>
Date: Fri, 27 Feb 2026 20:09:25 +0000
Subject: [PATCH] Create a separate section for tables populated automatically

---
 doc/src/analyzed.m4                       | 34 +++++++++++++++++++++++
 doc/src/{tables => analyzed}/sightings.m4 |  0
 doc/src/index.m4                          |  1 +
 doc/src/tables.m4                         |  7 +++--
 4 files changed, 40 insertions(+), 2 deletions(-)
 create mode 100644 doc/src/analyzed.m4
 rename doc/src/{tables => analyzed}/sightings.m4 (100%)

diff --git a/doc/src/analyzed.m4 b/doc/src/analyzed.m4
new file mode 100644
index 0000000..b3dcb04
--- /dev/null
+++ b/doc/src/analyzed.m4
@@ -0,0 +1,34 @@
+.. Copyright (C) 2026  The Meme Factory, Inc.  www.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/>.
+
+.. M4 setup
+include(constants.m4)dnl
+include(macros.m4)dnl
+sdb_rst_quotes(`on')dnl
+sdb_generated_rst()dnl
+
+
+.. _analyzed_tables:
+
+Analyzed Tables
+===============
+
+The tables listed contain derived data that is the result of at least
+a rudimentary analytical process.
+
+.. toctree::
+   :maxdepth: 3
+
+   analyzed/sightings.rst
diff --git a/doc/src/tables/sightings.m4 b/doc/src/analyzed/sightings.m4
similarity index 100%
rename from doc/src/tables/sightings.m4
rename to doc/src/analyzed/sightings.m4
diff --git a/doc/src/index.m4 b/doc/src/index.m4
index af8e191..1589306 100644
--- a/doc/src/index.m4
+++ b/doc/src/index.m4
@@ -34,6 +34,7 @@ Technical Documentation
    er_diagrams.rst
    code_tables.rst
    tables.rst
+   analyzed.rst
    views.rst
    functions.rst
    appendices.rst
diff --git a/doc/src/tables.m4 b/doc/src/tables.m4
index 71523cf..b61113d 100644
--- a/doc/src/tables.m4
+++ b/doc/src/tables.m4
@@ -1,4 +1,4 @@
-.. Copyright (C) 2023, 2024  The Meme Factory, Inc.  www.karlpinc.com
+.. Copyright (C) 2023-2026  The Meme Factory, Inc.  www.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
@@ -25,6 +25,10 @@ sdb_generated_rst()dnl
 Data Tables
 ===========
 
+The tables listed here come from primary data sources, in contrast to
+the :ref:`tables that are automatically constructed <analyzed_tables>`
+and are therefore the result of at least a rudimentary analytical process.
+
 .. toctree::
    :maxdepth: 3
 
@@ -40,5 +44,4 @@ Data Tables
    tables/humans.rst
    tables/roles.rst
    tables/non_brec_sighting_sources.rst
-   tables/sightings.rst
    tables/species_present.rst
-- 
2.34.1