diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/amscls/amsbooka.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/amscls/amsbooka.dtx | 334 |
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 |