summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/amscls/amsbooka.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/amscls/amsbooka.dtx')
-rw-r--r--Master/texmf-dist/source/latex/amscls/amsbooka.dtx334
1 files changed, 270 insertions, 64 deletions
diff --git a/Master/texmf-dist/source/latex/amscls/amsbooka.dtx b/Master/texmf-dist/source/latex/amscls/amsbooka.dtx
index d57f8d19b0b..4ff8e24ae73 100644
--- a/Master/texmf-dist/source/latex/amscls/amsbooka.dtx
+++ b/Master/texmf-dist/source/latex/amscls/amsbooka.dtx
@@ -1,52 +1,48 @@
-%%% ====================================================================
-%%% @LaTeX-file{
-%%% filename = "amsbooka.dtx",
-%%% version = "2.06",
-%%% date = "2008/05/19",
-%%% time = "09:46:14 EDT",
-%%% author = "American Mathematical Society",
-%%% copyright = "Copyright 1995, 2008 American Mathematical Society.
-%%% Licensed under the LaTeX Project Public License
-%%% version 1.3c or (at your option) any later version.
-%%% The latest version of this license is in
-%%% http://www.latex-project.org/lppl.txt
-%%% If you make any changes, please rename it to
-%%% some other name.",
-%%% address = "American Mathematical Society,
-%%% Publications Technical Group,
-%%% 201 Charles Street,
-%%% Providence, RI 02904-2294,
-%%% USA",
-%%% telephone = "401-455-4080 or (in the USA and Canada)
-%%% 800-321-4AMS (321-4267)",
-%%% FAX = "401-331-3842",
-%%% checksum = "07052 384 1313 12859",
-%%% email = "tech-support@ams.org",
-%%% codetable = "ISO/ASCII",
-%%% keywords = "latex, amslatex, ams-latex, monograph",
-%%% supported = "yes",
-%%% abstract = "This is part of the AMS-\LaTeX{} distribution.
-%%% It contains code to augment the AMS-\LaTeX{}
-%%% monograph document classes, providing the ability
-%%% to include an author's name along with a chapter
-%%% title, and to pass the author information along
-%%% for inclusion in the table of contents",
-%%% docstring = "The checksum field above contains a CRC-16
-%%% checksum as the first value, followed by the
-%%% equivalent of the standard UNIX wc (word
-%%% count) utility output of lines, words, and
-%%% characters. This is produced by Robert
-%%% Solovay's checksum utility.",
-%%% }
-%%% ====================================================================
+% \def\filename{amsbooka.dtx}
+% \def\fileversion{2.08}
+% \def\filedate{2014/07/11}
+%
+% \iffalse meta-comment
+%
+% American Mathematical Society
+% Technical Support
+% Publications Technical Group
+% 201 Charles Street
+% Providence, RI 02904
+% USA
+% tel: (401) 455-4080
+% (800) 321-4267 (USA and Canada only)
+% fax: (401) 331-3842
+% email: tech-support@ams.org
+%
+% Copyright 1995, 2008, 2014 American Mathematical Society.
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3c
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3c or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is the American Mathematical
+% Society.
+%
+% \fi
+%
% \iffalse
%<*driver>
\documentclass{amsdtx}
+
+\CodelineIndex
+
\begin{document}
\title{The \pkg{amsbooka} package}
\author{American Mathematical Society\\Barbara Beeton}
\date{Version \fileversion, \filedate}
-\hDocInput{amsbooka.dtx}
+\DocInput{amsbooka.dtx}
\end{document}
%</driver>
% \fi
@@ -62,6 +58,9 @@
% with a part or chapter title of a monograph, and automatically pass
% the author information on to the table of contents for presentation
% in a style compatible with the regular (series-specific) TOC style.
+% It also provides facilities to add elements often associated with
+% separately authored chapters, including a copyright notice,
+% uunumbered footnotes, and a section-level bibliography.
%
% This package may become part of the \amslatex/ collection of
% document classes and related packages.
@@ -71,46 +70,145 @@
% Standard file identification.
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}% LaTeX 2.09 can't be used (nor non-LaTeX)
-[1994/12/01]% LaTeX date must December 1994 or later
-\ProvidesPackage{amsbooka}[2008/05/19 v2.06 monograph part/chapter authors]
+[1995/06/01]% LaTeX date must be June 1995 or later
+\ProvidesPackage{amsbooka}[2014/07/11 v2.08 monograph part/chapter authors]
% \end{macrocode}
%
% \section{User instructions}
%
+% \textbf{Getting started:} The front matter of the book must include
+% (at least) a \cn{title} and \cn{\maketitle}. If these are absent,
+% an unintelligible error message will result. This is caused by
+% the redefinition of the \cn{author} command, which is ordinarily
+% expected to occur only in the book's front matter.
+%
+% \subsection{Chapter and part headings}
+%
% A part or chapter with no associated author is input in the usual
-% way:\\
-% \verb|\part{full title}|\\
-% \verb|\chapter[short title]{full title}|\\
+% way:\\[2pt]
+% \verb|\part{|\<full title>\verb|}|\\
+% \verb|\chapter[|\<short title>\verb|]{|\<full title>\verb|}|\\[2pt]
% The part or chapter title will be set in the regular style for
% the series.
%
% If an author is to be associated with a chapter, then the short
% title \emph{must} be provided, and the author is included within
-% the full title, thus:\\
-% \verb|\chapter[short title]{full title \author{author name}}|\\
+% the full title, thus:\\[2pt]
+% \verb|\chapter[|\<short title>\verb|]{|\<full title>%
+% \verb| \author{|\<author name>\verb|}}|
+%
+% \vspace{2pt}
+%
% This works for both \verb|\chapter| and \verb|\chapter*|.
% Similarly, a part title with an associated author must include
-% the author as follows:\\
-% \verb|\part{full title \author{author name}}|\\
+% the author as follows:\\[2pt]
+% \verb|\part{|\<full title>\verb| \author{|\<author name>\verb|}}|\\[2pt]
% No short title is required for a part title with author.
%
% The author name will be set following the title and also included
% in the table of contents, both in the appropriate style for the
% series.
%
-% The front matter of the book must include (at least) a \cn{title}
-% and \cn{\maketitle}. If these are absent, an unintelligible error
-% message will result.
+% When an author is specified for a chapter, the left-hand running
+% head will be the author name; the right-hand running head will
+% be the chapter title, taken from the short title. For a chapter
+% with no specified author, the running heads will be the same as
+% for an ``ordinary'' monograph: chapter title on the left and
+% section heading on the right, except that, if the chapter has
+% no sections, the chapter title will also appear on the right.
+%
+% By default, ``authored'' chapters will be numbered, but chapter
+% numbers will be omitted from the running heads. (Most volumes
+% encountered so far in this style are essentially collections.)
+% Chapter numbers can be restored to the running heads by using the
+% documentclass option \opt{[rhchapnum]}. In the present version
+% of \pkg{amsbooka} this is an all-or-nothing proposition, but
+% this decision may be reconsidered if an example emerges in which
+% there is justification for including chapter numbers in some
+% running heads but not in others.
+%
+% Similarly, the ``standard'' monograph running heads (chapter on
+% the left, section on the right) can be forced for all authored
+% chapters by specifying the documentclass option \opt{[rhchapsec]}.
+% With this option, chapter numbers will not be suppressed. Again,
+% this is an all-or-nothing choice.
+%
+% \subsection{Elements at the bottom of the first page}
+%
+% If information such as a previous publication or an alternate
+% source is noted, this should appear on the first page of the
+% chapter as an unnumbered footnote. Enter this immediately
+% after the \verb|\chapter| title, using this command:\\[2pt]
+% \verb|\barefootnote{|\<footnote text>\verb|}|
+%
+% \vspace{2pt}
%
+% If a separate copyright notice is required for a chapter,
+% enter it as follows:\\[2pt]
+% \verb|\copyrightinfo{|\<year>\verb|}{|\<copyright holder>\verb|}|\\[2pt]
+% If this command is not input for a chapter, no notice will appear.
+%
+% \subsection{Bibliography within a chapter}
+%
+% The bibliography of a monograph usually appears as a separate chapter.
+% However, for collections addressed by the present package, each
+% individual chapter may have its own reference list, which should
+% be treated as a section.
+%
+% If the chapter bibliography has been prepared for \pkg{amsrefs},
+% specify \env{bibsection} to obtain the proper format. (See the
+% \pkg{amsrefs} documentation for details.)
+%
+% If the chapter bibliography has been prepared using \BibTeX,
+% substitute\\[2pt]
+% \verb|\begin{inchapterbibliography}|\\
+% \verb|...|\\
+% \verb|\end{inchapterbibliography}|\\[2pt]
+% for the usual \env{thebibliography} environment. The actual contents
+% of the bibliography should be included within the chapter file,
+% not read in from a separate \fn{.bbl} file. If the heading of
+% this section needs to be changed,\\[2pt]
+% \verb|\renewcommand{\bibname}{...}|
+%
%
% \section{Implementation}
%
% This package is meant for use with all AMS monograph series.
% Two series, GSM and STML, have special requirements, so provide
-% matching strings that can be used to identify them.
+% matching strings that can be used to identify them. Other series
+% may be added to this list, so also provide a switch that can be
+% used to identify them collectively.
% \begin{macrocode}
\def\@gsm{gsm-l}
\def\@stml{stml-l}
+\newif\if@ruledchapterhead
+\@ruledchapterheadfalse
+\ifx\@classname\@gsm \@ruledchapterheadtrue
+ \else\ifx\@classname\@stml \@ruledchapterheadtrue
+ \fi
+\fi
+% \end{macrocode}
+%
+% Some ramifications with running heads are best addressed with
+% defaults that can be overridden by options.
+%
+% First option: force ``standard'' (chapter/section) running heads.
+% \begin{macrocode}
+\newif\if@rhchapnum
+\@rhchapnumfalse
+\DeclareOption{rhchapnum}{\@rhchapnumtrue}
+% \end{macrocode}
+%
+% Next option: force ``standard'' (chapter/section) running heads.
+% This also turns on chapter numbers in the running heads.
+% \begin{macrocode}
+\newif\if@rhchapsec
+\@rhchapsecfalse
+\DeclareOption{rhchapsec}{\@rhchapsectrue \@rhchapnumtrue}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\ProcessOptions\relax
% \end{macrocode}
%
% \subsection{Chapter headings}
@@ -166,16 +264,28 @@
% \end{macro}
%
% \begin{macro}{@makeplainchapterhead}
-% \begin{macro}{@makeplainschapterhead}
+% \begin{macro}{@makeschapterhead}
% The ``plain'' chapter head style is used for nearly all AMS
% monograph series. The title is set in the usual style, with
-% the author name centered below in small caps.
+% the author name centered below in small caps.\\
+% The author name is set up to be the left-hand running head,
+% as it would be for a journal or proceedings article. This
+% will be effected only for chapters with an \cn{author}.
+% It can also be suppressed with the \opt{[rhchapsec]} option.\\
+% If a copyright notice is included, suppress it for the next
+% chapter.
% \begin{macrocode}
\def\@makeplainchapterhead#1{%
\global\topskip 7.5pc\relax
+ \@setcopyright
+ \let\copyrightyear\@empty
\begingroup
\def\title{}%
- \def\author##1{\vskip1pc\fontsize{\@xiipt}{14}\mdseries\textsc{##1}}%
+ \def\author##1{%
+ \if@rhchapsec
+ \else \markleft{\MakeUppercase{##1}}%
+ \fi
+ \vskip1pc\fontsize{\@xiipt}{14}\mdseries\textsc{##1}}%
\fontsize{\@xivpt}{18}\bfseries\centering
\ifnum\c@secnumdepth>\m@ne
\leavevmode \hskip-\leftskip
@@ -188,10 +298,17 @@
\skip@34\p@ \advance\skip@-\normalbaselineskip
\vskip\skip@
}
-\def\@makeschapterhead#1{\global\topskip 7.5pc\relax
+\def\@makeschapterhead#1{%
+ \global\topskip 7.5pc\relax
+ \@setcopyright
+ \let\copyrightyear\@empty
\begingroup
\def\title{}%
- \def\author##1{\vskip1pc\fontsize{\@xiipt}{14}\mdseries\textsc{##1}}%
+ \def\author##1{%
+ \if@rhchapsec
+ \else \markleft{\MakeUppercase{##1}}%
+ \fi
+ \vskip1pc\fontsize{\@xiipt}{14}\mdseries\textsc{##1}}%
\fontsize{\@xivpt}{18}\bfseries\centering
#1\par \endgroup
\skip@34\p@ \advance\skip@-\normalbaselineskip
@@ -210,7 +327,11 @@
\def\@makeruledchapterhead#1{%
\global\topskip\normaltopskip
\begingroup
- \def\author##1{\\ \hfil \\ \@chapauthorstyle ##1}%
+ \def\author##1{%
+ \if@rhchapsec
+ \else \markleft{##1}%
+ \fi
+ \\ \hfil \\ \@chapauthorstyle ##1}%
\vbox to\topskip{%
\chapter@number
\vss
@@ -228,7 +349,11 @@
\def\@makeruledschapterhead#1{%
\global\topskip\normaltopskip
\begingroup
- \def\author##1{\\ \hfil \\ \@chapauthorstyle ##1}%
+ \def\author##1{%
+ \if@rhchapsec
+ \else \markleft{##1}%
+ \fi
+ \\ \hfil \\ \@chapauthorstyle ##1}%
\@chapheadstyle \raggedright
\noindent #1\par \endgroup
\if@index
@@ -273,10 +398,10 @@
% \end{macrocode}
% \end{macro}
%
+% \begin{macro}{@makestmlchapterhead}
% The style for STML is similar to that for GSM, except for the
% smaller page size and the author information set in lightface
% in the LARGE size.
-% \begin{macro}{@makestmlchapterhead}
% \begin{macrocode}
\def\@makestmlchapterhead#1{%
\def\@chapheadstyle{\fontsize\@xxpt{22}\selectfont\bfseries\hsize 21pc
@@ -303,6 +428,25 @@
% \end{macrocode}
% \end{macro}
%
+% \subsection{Running heads}
+%
+% \begin{macro}{chapterrunhead}
+% Unless overridden by the \opt{[]} option, omit chapter numbers
+% from the right-hand running head with chapter title. (Explicit
+% line breaks with \verb|\\| are converted to spaces.)
+% \begin{macrocode}
+\if@rhchapnum
+\else
+ \def\chapterrunhead#1#2#3{%
+ \def\@tempa{#3}%
+ \begingroup \def\\{ \ignorespaces}%
+ \uppercasenonmath\@tempa\@tempa
+ \endgroup
+ }
+\fi
+% \end{macrocode}
+% \end{macro}
+%
% \subsection{Part headings}
%
% \begin{macro}{@plainpart}
@@ -372,6 +516,68 @@
% \end{macrocode}
% \end{macro}
%
+% \subsection{Other features}
+%
+% \subsubsection{Copyright notice}
+% A copyright notice is sometimes wanted on separately authored
+% chapters of a ``composite'' monograph or volume of collected works.
+% Provide the ability to add this feature if required, using the
+% same command, \cn{copyrightinfo}, used for journal and proceedings
+% articles. \cn{copyrightinfo} is present in \cls{amsbook}, so it
+% suffices to set an appropriate default to suppress it unless it
+% is requested explicitly.
+% \begin{macrocode}
+\let\copyrightyear\@empty
+% \end{macrocode}
+%
+% For now, don't allow a copyright notice for GSM or STML or other
+% books with a similar design. The need is unlikely, but the more
+% important reason is that the style needs rethinking if such a
+% notice is to be included.
+% \begin{macrocode}
+\if@ruledchapterhead \def\copyrightinfo#1#2{}\fi
+% \end{macrocode}
+%
+% \begin{macro}{barefootnote}
+% \subsubsection{``Bare'' footnotes}
+% Unnumbered footnotes (such as those that appear on the first page
+% of a journal or proceedings article) are needed to provide information
+% regarding earlier publication and the like.
+% \begin{macrocode}
+\newcommand{\barefootnote}[1]{{%
+ \let\@makefnmark\relax \let\@thefnmark\relax
+ \@footnotetext{#1}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{inchapterbibliography}
+% \subsubsection{Chapter-specific bibliography}
+% Separately authored chapters often have individual bibliographies,
+% which should be presented as sections, not chapters. For now,
+% disable the mark for the section header (copying the code from
+% the initial value in \cls{amsbook}); it should not appear as
+% the right-hand running head if the author/chapter title headers
+% are in effect. Still to be determined is whether the section title
+% ``Bibliography'' should appear in the running head if no author is
+% specified and the ``standard'' running heads are used.
+% \begin{macrocode}
+\newenvironment{inchapterbibliography}[1]{%
+ \let\sectionmark\@gobble
+ \@xp\section\@xp*\@xp{\bibname}%
+ \normalfont\footnotesize\labelsep .5em\relax
+ \renewcommand\theenumiv{\arabic{enumiv}}\let\p@enumiv\@empty
+ \list{\@biblabel{\theenumiv}}{\settowidth\labelwidth{\@biblabel{#1}}%
+ \leftmargin\labelwidth \advance\leftmargin\labelsep
+ \usecounter{enumiv}}%
+ \sloppy \clubpenalty\@M \widowpenalty\clubpenalty
+ \sfcode`\.=\@m
+}{%
+ \def\@noitemerr{\@latex@warning{Empty `inchapterbibliography' environment}}%
+ \endlist
+}
+% \end{macrocode}
+% \end{macro}
+%
% \subsection{Boilerplate}
%
% The usual \cs{endinput} to ensure that random garbage at the end of
@@ -380,5 +586,5 @@
\endinput
% \end{macrocode}
%
-% \CheckSum{438}
+% \CheckSum{566}
% \Finale