texlive[63061] Master/texmf-dist: msu-thesis (17apr22)
commits+karl at tug.org
commits+karl at tug.org
Sun Apr 17 22:02:35 CEST 2022
Revision: 63061
http://tug.org/svn/texlive?view=revision&revision=63061
Author: karl
Date: 2022-04-17 22:02:35 +0200 (Sun, 17 Apr 2022)
Log Message:
-----------
msu-thesis (17apr22)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/msu-thesis/README.md
trunk/Master/texmf-dist/doc/latex/msu-thesis/msu-thesis.pdf
trunk/Master/texmf-dist/doc/latex/msu-thesis/msu-thesis.tex
trunk/Master/texmf-dist/doc/latex/msu-thesis/samples/MSU-thesis-template.tex
trunk/Master/texmf-dist/tex/latex/msu-thesis/msu-thesis.cls
Modified: trunk/Master/texmf-dist/doc/latex/msu-thesis/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/msu-thesis/README.md 2022-04-17 20:02:23 UTC (rev 63060)
+++ trunk/Master/texmf-dist/doc/latex/msu-thesis/README.md 2022-04-17 20:02:35 UTC (rev 63061)
@@ -1,6 +1,6 @@
-# MSU Thesis Class Version 3.1b 2022/03/25
+# MSU Thesis Class Version 3.2 2022/04/16
-Copyright 2009-2022 by Alan Munn <amunn at msu.edu>
+Copyright 2011-2022 by Alan Munn <amunn at msu.edu>
This is a class file for producing dissertations and theses according to
the Michigan State University Graduate School Guidelines for Electronic
Modified: trunk/Master/texmf-dist/doc/latex/msu-thesis/msu-thesis.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/msu-thesis/msu-thesis.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/msu-thesis/msu-thesis.tex 2022-04-17 20:02:23 UTC (rev 63060)
+++ trunk/Master/texmf-dist/doc/latex/msu-thesis/msu-thesis.tex 2022-04-17 20:02:35 UTC (rev 63061)
@@ -2,8 +2,8 @@
\documentclass[11pt]{article}
-\def\msuversion{3.1b}
-\def\msudate{2022/03/25}
+\def\msuversion{3.2}
+\def\msudate{2022/04/16}
\title{\textbf{Using the MSU Thesis Class}}
\author{\textbf{Alan Munn}\\Department of Linguistics, Languages, and Cultures\\Michigan State University\\\texttt{\href{mailto:amunn at msu.edu}{amunn at msu.edu}}}
\date{Version \msuversion\\\msudate}
@@ -105,7 +105,7 @@
\subsection{The \pkg{[lscape]} option}
The Formatting Guide requires that any lansdscape pages be numbered in landscape mode (i.e. along the long edge of the page) rather than in portrait mode, and rotated in the final PDF. The |[lscape]| option enables this. The option loads both the \pkg{pdflscape} package and \pkg{tikz}, and is implemented as a class option so that you are not required to load those packages if they are not needed.
\subsection{The \pkg{[chapterbib]} option}
-This option enables per-chapter bibliographies. Each chapter must have its own bibliography. If you are using \pkg{natbib} for bibliographies, per-chapter bibliographies can be implemented using the \pkg{chapterbib} package. Please read its documentation carefully, as it requires each chapter to be a separate file. An newer alternative which I highly recommend is to use \pkg{biblatex} for your bibliography, which makes per-chapter bibliographies very simple. If you have per-chapter bibliographies you cannot have a global bibliography.
+This option enables per-chapter bibliographies. Each chapter must have its own bibliography. If you are using \pkg{natbib} for bibliographies, per-chapter bibliographies can be implemented using the \pkg{chapterbib} package. Please read its documentation carefully, as it requires each chapter to be a separate file. A newer alternative which I highly recommend is to use \pkg{biblatex} for your bibliography, which makes per-chapter bibliographies very simple. If you have per-chapter bibliographies you cannot have a global bibliography.
\subsection{The \pkg{[chapterapp]} option}
This option enables per-chapter appendices. Any appendix must be associated with its own chapter. If you have per-chapter appendices you cannot have any global appendices.
\subsection{The contents options}
@@ -215,7 +215,7 @@
\end{quote}
\subsection{Algorithm packages\label{algorithms}}
-Because the various algorithm formatting packages such as \pkg{algorithm2e} and \pkg{algorithmicx} (or its related packages) sometimes create incompatibilities with the \pkg{memoir} float methods, the class provides you with a floating |{algorithm}| environment and the corresponding list of algorithms, so you do not have to create your own list of algorithms. Here are some specific important points about using \pkg{algorithm2e} and \pkg{algorithmicx}.
+Because the various algorithm formatting packages such as \pkg{algorithm2e} and \pkg{algorithmicx} (or its related packages) sometimes create incompatibilities with the \pkg{memoir} float methods, the class provides you with floating |{algorithm}| environment and the corresponding list of algorithms, so you do not have to create your own list of algorithms. Here are some specific important points about using \pkg{algorithm2e} and \pkg{algorithmicx}.
\begin{itemize}[label=\textbullet]
\item Do \emph{not} load the \pkg{algorithm} package.
\item If you use the \pkg{algorithm2e} package you \emph{must} load it with the |[algo2e]| option (along with any other options you need).
@@ -267,7 +267,7 @@
The |landscape| environment makes all pages within it landscape, so if you have multiple landscape figures in a row, you can put all of them inside a single |landscape| environment. This option correctly rotates the landscape pages within the pdf document itself, which the thesis office seems to require.
\subsection{Appendices}
-Appendices in a thesis are usually at the end of the document, but before the bibliography. MSU requires appendices to be preceded by a cover page which says either ``Appendix'' (if there is only one) or ``Appendices'' if there is more than one. The class implements this with two environments: |{appendix}| for a single appendix and |{appendices}| for multiple appendices. If your thesis organization requires appendices per-chapter, you must use the |[chapterapp]| class option. In either case, the code for appendices is identical.
+Appendices in a thesis are usually at the end of the document, but before the bibliography. MSU requires appendices to be preceded by a cover page which says either ``Appendix'' (if there is only one) or ``Appendices'' if there is more than one. The class implements this with two environments: |{appendix}| for a single appendix and |{appendices}| for multiple appendices. If your thesis organization requires appendices per-chapter, you must use the |[chapterapp]| class option. In either case, the code for appendices is identical, i.e., each appendix is introduced with the |\chapter| command.
\subsubsection{Single appendix}
If you have a single appendix, your code should look like this:
@@ -295,10 +295,10 @@
\end{quote}
\subsubsection{Appendices per chapter}
-If you need to add an appendix or appendices to a chapter, you must use the \pkg{[chapterapp]} class option. The code for the appendices themselves is exactly as described above. Note that per-chapter appendices should \emph{not} be preceded by the |\backmatter| command, which should only precede the global bibliography or appendices.
+If you need to add an appendix or appendices to a chapter, you must use the \pkg{[chapterapp]} class option. The code for the appendices themselves is exactly as described above. This means that the appendix itself is introduced by the |\chapter| command, \emph{not} a |\section| command (because the this seems to be how the thesis office wants things to look). Furthermore, per-chapter appendices should \emph{not} be preceded by the |\backmatter| command, which should only precede the global bibliography or appendices.
\subsection{Bibliographies}
-The class places no constraints on how you do your bibliography. If you have per-chapter bibliographies, you must use the |[chapterbib]| class option. Before any bibliography (whether global or per-chapter) you should use the |\makebibliographypage| command. Note that per-chapter bibliographies should \emph{not} be preceded by the |\backmatter| command, which should only precede the global bibliography or appendices.
+The class places no constraints on how you do your bibliography. It doesn't care whether you are using the \pkg{chapterbib} package with \pkg{natbib} or the per-chapter bibliography functionality provided by \pkg{biblatex}. If you have per-chapter bibliographies, however, you \emph{must} use the |[chapterbib]| class option. This option lets the class know that you are using per-chapter bibliographies. Before any bibliography (whether global or per-chapter) you should use the |\makebibliographypage| command. Note that per-chapter bibliographies should \emph{not} be preceded by the |\backmatter| command, which should only precede the global bibliography or appendices.
\subsubsection{Bibliography spacing}\label{bibspacing}
Please note that although bibliography entries must be single spaced, there must be a space between each entry. This parameter is set by your bibliography package and not by the class itself. If you are using \pkg{natbib} or \pkg{biblatex} these spacing parameters are set for you by the class. If you are using another package for your bibliography you are responsible for adjusting the relevant spacing parameters.
@@ -320,6 +320,7 @@
\item Make sure you pay attention to any ``Overfull hbox'' warnings when you are producing your final copy. You should make sure you eliminate all of them or else the thesis office is likely to reject your thesis. One common way to eliminate such warnings is to place the command |\sloppy| at the beginning of the paragraph that triggers the warning. You should only use this technique at the very end when you are completely done with everything. Alternatively, rewording the text may also fix things.
\item Remember to use the |\tableofcontents*| command so that your table of contents is not listed in the table of contents.
\item Remember to use the |{appendix}| environment for single appendices, and the |{appendices}| environment for multiple appendices. Do not use the standard LaTeX |\appendix| command.
+\item Remember also that \emph{all} appendices whether global or per-chapter should be |\chapter| commands in your source document.
\item Remember to add the |\makebibliographypage| command before any bibliography in your document.
\end{itemize}
\subsection{Master’s Theses}
@@ -331,9 +332,9 @@
\subsection{Archiving your thesis for the future}
Since the current version of the \pkg{msu-thesis} class satisfies the Graduate School requirements at any one time, as these requirements change, you may find that if you need to recompile your thesis after you have graduated that the formatting changes. To avoid this, I would recommend saving an archived version of the \pkg{msu-thesis.cls} file in the same folder as your thesis file. You only need to do this once you have completely finished your thesis however; there's no need to do it during the writing process.
\subsection{Version history}
-Previous versions of \pkg{msu-thesis} (versions 1.0--1.4b) were created for non-electronic submission and should not be used. Versions 1.5--1.6 (the first electronic submission versions) contained a |\makeabstract| command and a separate |msuabstract| environment. These have been removed as of version 1.7. Users who are upgrading from earlier versions to version 1.7 do not need to change these commands however but their use will trigger a warning.) Version 2.0 implemented landscape pages; version 2.1 added support for \pkg{hyperref}. Versions 2.2--2.5 mainly accommodated to the ever changing whims of the MSU Graduate School. Version 2.6 fixed some appendix bugs introduced by the previous whim accommodation. Version 2.7 fixed various small spacing issues, fixed a bug which prevented a new chapter page to be a landscape page, added support for the \pkg{apacite} package, and updated degree options. Version 2.8 fixed some spacing and capitalization issues and added support for the public abstract. Version 2.9 removed subscript/superscript size restrictions, added font size options and made small spacing changes to appease the thesis office. Version 3.0 added full support for per-chapter bibliographies and appendices, and automated bibliography spacing for |natbib| and |biblatex| produced bibliographies. Version 3.1 added support for an |{algorithm}| environment and a list of algorithms to combat incompatibilities with the \pkg{algorithm} and \pkg{algorithm2e} packages.
+Previous versions of \pkg{msu-thesis} (versions 1.0--1.4b) were created for non-electronic submission and should not be used. Versions 1.5--1.6 (the first electronic submission versions) contained a |\makeabstract| command and a separate |msuabstract| environment. These have been removed as of version 1.7. Users who are upgrading from earlier versions to version 1.7 do not need to change these commands however but their use will trigger a warning.) Version 2.0 implemented landscape pages; version 2.1 added support for \pkg{hyperref}. Versions 2.2--2.5 mainly accommodated to the ever changing whims of the MSU Graduate School. Version 2.6 fixed some appendix bugs introduced by the previous whim accommodation. Version 2.7 fixed various small spacing issues, fixed a bug which prevented a new chapter page to be a landscape page, added support for the \pkg{apacite} package, and updated degree options. Version 2.8 fixed some spacing and capitalization issues and added support for the public abstract. Version 2.9 removed subscript/superscript size restrictions, added font size options and made small spacing changes to appease the thesis office. Version 3.0 added full support for per-chapter bibliographies and appendices, and automated bibliography spacing for |natbib| and |biblatex| produced bibliographies. Version 3.1 added support for an |{algorithm}| environment and a list of algorithms to combat incompatibilities with the \pkg{algorithm} and \pkg{algorithm2e} packages. Version 3.2 fixed some lingering problems with per-chapter appendices.
\section{Acknowledgements}
-Thanks to Lars Madsen, Ulrike Fischer and Peter Wilson for help with setting up parts of the memoir code for versions 1.0--1.4 (now eliminated due to changed requirements). Thanks to Wolfgang Sternefeld for supplying the \pkg{linguex} spacing fix code, Leo Liu for the landscape page numbering code, which greatly simplified my original version, and Florent Chervet for the \pkg{hyperref} code. Thanks also to the following students who have reported problems over the years: Irina Agafonova, Ali Al-jiboory, Julian Blank, Dmitriy Bryndin, Greg Christian, Kyle Crayne, Ciaron Hamilton, Matt Husband, Changkuk Jung, Adam Liter, William Muir, Alicia Parrish, Neil ver Planck, Adam Soliman, Erik Stitt, Eremey Valetov, Matthew Vincent, Michael Wojcik, Stephen Yuwono, and Yisu Zhou. A special thank you to Non Thongprong who graciously provided a copy of his entire thesis which allowed me to debug some especially subtle spacing inconsistencies.
+Thanks to Lars Madsen, Ulrike Fischer and Peter Wilson for help with setting up parts of the memoir code for versions 1.0--1.4 (now eliminated due to changed requirements). Thanks to Wolfgang Sternefeld for supplying the \pkg{linguex} spacing fix code, Leo Liu for the landscape page numbering code, which greatly simplified my original version, and Florent Chervet for the \pkg{hyperref} code. Thanks also to the following students who have reported problems over the years: Irina Agafonova, Ali Al-jiboory, Julian Blank, Dmitriy Bryndin, Greg Christian, Kyle Crayne, Ciaron Hamilton, Matt Husband, Changkuk Jung, Adam Liter, William Muir, Alicia Parrish, Neil ver Planck, Adam Soliman, Erik Stitt, Eremey Valetov, Matthew Vincent, Michael Wojcik, Stephen Yowono, and Yisu Zhou. A special thank you to Non Thongprong who graciously provided a copy of his entire thesis which allowed me to debug some especially subtle spacing inconsistencies.
\appendix
\renewcommand{\thesection}{Appendix \Alph{section}}
Modified: trunk/Master/texmf-dist/doc/latex/msu-thesis/samples/MSU-thesis-template.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/msu-thesis/samples/MSU-thesis-template.tex 2022-04-17 20:02:23 UTC (rev 63060)
+++ trunk/Master/texmf-dist/doc/latex/msu-thesis/samples/MSU-thesis-template.tex 2022-04-17 20:02:35 UTC (rev 63061)
@@ -150,9 +150,14 @@
%
% If each chapter has its own set of appendices, then load the class with the [chapterapp] option
% and put your {appendix} or {appendices} environments at the end of each chapter.
-% You should not use the \backmatter command before per-chapter material
+%
+%
+% Even though it is very unintuitive, per-chapter appendices are STILL \chapter commands
+% in your document! If you use \section it will not work properly.
%
-% There should only be ONE \backmatter command in your document, and it should separate only the thesis from the bibliography
+% You should not use the \backmatter command before per-chapter material!
+% There should only be ONE \backmatter command in your document,
+% and it should separate only the thesis from the bibliography
\backmatter
% The next lines add the dots back into the References/Bibliography heading
% of the TOC. Only uncomment this if you need to put the dots back in having removed them for Chapter headings.
Modified: trunk/Master/texmf-dist/tex/latex/msu-thesis/msu-thesis.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/msu-thesis/msu-thesis.cls 2022-04-17 20:02:23 UTC (rev 63060)
+++ trunk/Master/texmf-dist/tex/latex/msu-thesis/msu-thesis.cls 2022-04-17 20:02:35 UTC (rev 63061)
@@ -158,11 +158,12 @@
% Version 3.0b 2021/07/14 Added msu at hchap counter for hyperref targets in appendices (unreleased)
% Version 3.1 2022/03/03 Added support for List of Algorithms plus fixes for algorithm2e and algorithmicx etc
% Version 3.1b 2022/03/25 Fixed numbering problem for single global appendix
+% Version 3.2 2022/04/16 Fixed TOC formatting problem for per-chapter appendices
%
% Report bugs/problems/questions to <amunn at msu.edu>
%
-\def\msu at version{3.1b}
-\def\msu at date{2022/03/25}
+\def\msu at version{3.2}
+\def\msu at date{2022/04/16}
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{msu-thesis}[\msu at date\space Michigan State University Thesis Class version \msu at version]
\newif\ifmsu at dissertation\msu at dissertationtrue % added v2.7 boolean for \msu at thesistype
@@ -399,6 +400,10 @@
\cftinsertcode{CHAPAPPR}{
\cftsetindents{section}{1.5em}{2.3em}
+\setlength{\cftchapterindent}{0em}
+\setlength{\cftbeforechapterskip}{1.0em \@plus\p@}
+ \renewcommand\cftchapterfont{\msu at chapfont}
+ \renewcommand\cftchapterpagefont{\msu at chapfont}
}
% This code resets the changes made in the APP code back to normal
% so that the bibliography will appear correctly in the TOC
@@ -584,7 +589,6 @@
\interlinepenalty \@M
\normalfont
\printparttitle{\appendixpagename}\par}%
- \cftinserthook{toc}{CHAPAPPR} % reset added 2021/06/10
\@endpart}
%
@@ -600,14 +604,19 @@
{\renewcommand{\appendixname}{Appendix}
\renewcommand{\appendixtocname}{Appendix}
\renewcommand{\appendixpagename}{Appendix}
- \ifmsu at chapterapp\else\msu at singleappendixtrue\fi% make sure single appendix doesn't have a number if global 3.1b
+% It's not clear if this should apply to per-chapter appendices also
+% I think it probably should, even though it leads to ambiguity.
+% Changing this in 3.2 2022/04/16
+% \ifmsu at chapterapp\else
+ \msu at singleappendixtrue
+% \fi% make sure single appendix doesn't have a number if global 3.1b (always 3.2)
\msu at apppage\settocdepth{part}\@resets at pp\anappendixtrue}%
- {\@ppsaveapp\@pprestoresec\anappendixfalse}
+ {\@ppsaveapp\@pprestoresec\anappendixfalse\cftinserthook{toc}{CHAPAPPR}} % reset aded 2022/04/16
\renewenvironment{appendices}%
{\msu at apppage\settocdepth{chapter}
\@resets at pp\anappendixtrue}%
- {\@ppsaveapp\@pprestoresec\anappendixfalse}
+ {\@ppsaveapp\@pprestoresec\anappendixfalse\cftinserthook{toc}{CHAPAPPR}} % reset added 2022/04/16
% The default numbering that memoir assumes is for appendices
% is sequential throughout the document; the thesis office
More information about the tex-live-commits
mailing list.