From b096ab31b50d3637288badcf682b1d37b782fd4c Mon Sep 17 00:00:00 2001
From: Ray Zimmerman <rz10@cornell.edu>
Date: Tue, 7 May 2024 16:20:33 -0600
Subject: [PATCH] Tweak Sphinx-generated PDF manuals.

- Eliminate creation of non-existent User's Manual.
- Update author name.
- Add copyright to back of title page.
- Allow chapters to start on any page.
---
 docs/sphinx/source/conf.py | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/docs/sphinx/source/conf.py b/docs/sphinx/source/conf.py
index d7454aa1..d1897018 100644
--- a/docs/sphinx/source/conf.py
+++ b/docs/sphinx/source/conf.py
@@ -119,25 +119,25 @@
 
 latex_logo = 'MATPOWER-md.png'
 latex_documents = [
-    (   'users-manual/index',
-        'matpower_users_manual.tex',
-        '\\matpower{} \\textrm{User\'s Manual}',
-        'Ray Zimmerman',
-        'manual'),
+#     (   'users-manual/index',
+#         'matpower_users_manual.tex',
+#         '\\matpower{} \\textrm{User\'s Manual}',
+#         'Ray D. Zimmerman, Carlos E. Murillo-Sánchez, Hongye Wang, et. al.',
+#         'manual'),
     (   'dev-manual/index',
         'matpower_dev_manual.tex',
         '\\matpower{} \\textrm{Developers\'s Manual}',
-        'Ray Zimmerman',\
+        'Ray D. Zimmerman, et. al.',\
         'manual'),
     (   'ref-manual/index',
         'matpower_ref_manual.tex',
         '\\matpower{} \\textrm{Reference Manual}',
-        'Ray Zimmerman',\
+        'Ray D. Zimmerman, et. al.',\
         'manual'),
 #     (   'users-manual-legacy/index',
 #         'matpower_users_manual_legacy.tex',
 #         '\\matpower{} \\textrm{User\'s Manual (Legacy)}',
-#         'Ray Zimmerman',
+#         'Ray D. Zimmerman, Carlos E. Murillo-Sánchez',
 #         'manual'),
 ]
 latex_additional_files = ["mp-docs-shared/preamble.tex.txt", "mp-docs-shared/mathCmds.tex.txt"]
@@ -147,6 +147,8 @@
     'fncychap': r'\usepackage[Bjornstrup]{fncychap}',
     'printindex': r'\footnotesize\raggedright\printindex',
     'maxlistdepth': '8',
+    'extraclassoptions': 'openany',     # chapters can start on any page
+    'maketitle': r'\date{May 7, 2024}\newcommand\sphinxbackoftitlepage{\begin{center}{~\vfill\copyright~1996--2024~\PSERC\\All Rights Reserved}\end{center}}\sphinxmaketitle',
     'extrapackages': r"""\usepackage{bm}
 \usepackage{upgreek}
 \usepackage{amsfonts}