Polish docstrings for the documentation site: fix silent mis-rendering, fill missing docstrings, add module intros

[roed-math]

A docstring-polish pass following up on the documentation site: the -W build gate catches reST that warns, but plenty renders silently wrong. This PR fixes everything found by auditing the built HTML for bad-render artifacts (plus an AST scan of the sources for their causes), and fills the documentation gaps the site made visible. No code changes — docstrings, comments and one docstring typo only.

Silent mis-rendering, all fixed (verified by re-scanning the built pages):

• 22 single-backtick spans rendered as italic "title references" instead of code (`x` vs ``x`` in reST) — in reload_all, cleanup_all, create_table, search, reload_final_swap, the stats methods, DelayCommit, filter_sql_injection, and others. Now 0 <cite> artifacts on the API pages (was 21) and 0 bare spans anywhere in the sources.
• 6 mis-indented blocks rendered as stray blockquotes: reload_all's INPUT section (over-indented bullets plus a floating "INPUTS passed to reload" fragment — rewritten as one proper list), the list_indexes/list_constraints NOTE bullets, and the PostgresStatsTable schema documentation (over-indented list continuations plus two literal blocks missing their ::). Now 0 (was 6).
• Three foreign !obj fragments on the encoding page: our Dumper.dump overrides had no docstrings, so autodoc inherited psycopg's, whose role-suppression markup only renders inside psycopg's own docs. Fixed by documenting the overrides.

Missing docstrings filled — every class-level public member autodoc renders now has one:

• PostgresSearchTable itself (the class users actually hold) — a real class docstring describing the dictionary-query interface and pointing at the guides.
• The meta export/reload/revert family on PostgresTable (copy_to_meta/copy_to_indexes/copy_to_constraints, reload_*, revert_* — documenting the _hist versioning contract) and finalize_changes (honestly labeled a placeholder).
• The encoding protocol methods (including the Sage-only RealEncoder/dumper classes), setup_connection, NumericLoader.load, jsonb_idx, LockError, range_formatter, QueryLogFilter.filter, Configuration.get_postgresql_default.

Seven module docstrings added — base, config, database, searchtable, statstable, table, utils had none, so their API pages opened with a bare heading. Each now begins with a short orientation paragraph (what lives here, how it relates to the rest).

Small content fixes along the way: filter_sql_injection's INPUT listed a valid_cols parameter that doesn't exist (dropped); a markdown-style link in _parse_projection became prose; "supset"/"werefalse" typos; the PostgresStatsTable intro now mentions table.stats and marks the lmfdb.utils.display_stats reference as the LMFDB integration point.

Verified: sphinx -W --keep-going clean; 0 <cite> / 0 <blockquote> artifacts across all API pages (from 21/6); 0 bare single-backtick spans by AST scan; ruff check . clean.

Not in this PR (the agreed separate follow-up): modernizing the EXAMPLES:: blocks — 137 sage: prompts, 21 docstrings still importing lmfdb — to >>> with psycodict-only setup, optionally as real doctests against the CI Postgres service.

🤖 Generated with Claude Code

[read-the-docs-community]

Documentation build overview

📚 psycodict | 🛠️ Build #33702376 | 📁 Comparing 6fc140d against latest (01dd850)

  🔍 Preview build  

16 files changed · ± 16 modified

± Modified

• api/base.html
• api/config.html
• api/database.html
• api/encoding.html
• api/searchtable.html
• api/statstable.html
• api/table.html
• api/utils.html
• _modules/psycodict/base.html
• _modules/psycodict/config.html
• and 6 more...