diff options
author | Karl Berry <karl@freefriends.org> | 2010-07-03 23:29:05 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-07-03 23:29:05 +0000 |
commit | b01586837ca3abfe2028b61c24b2b7c0a048f358 (patch) | |
tree | 7e4125b14cfeebc91f9df5bbdb92b0808e8f32a6 /Master/texmf-dist/doc/latex/memoir/memman.tex | |
parent | b4c1a1eed2c9c758ec934a2085344fa9e5bcc9d3 (diff) |
memoir update (1jul10)
git-svn-id: svn://tug.org/texlive/trunk@19217 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/memoir/memman.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/memoir/memman.tex | 546 |
1 files changed, 421 insertions, 125 deletions
diff --git a/Master/texmf-dist/doc/latex/memoir/memman.tex b/Master/texmf-dist/doc/latex/memoir/memman.tex index 1813bf62886..3030655a60c 100644 --- a/Master/texmf-dist/doc/latex/memoir/memman.tex +++ b/Master/texmf-dist/doc/latex/memoir/memman.tex @@ -3,12 +3,11 @@ % memman.tex Memoir class user manual (Part II only) last updated 2009/09/07 % Author: Peter Wilson % Copyright 2001, 2002, 2003, 2004, 2008, 2009 Peter R. wilson +% %\listfiles \documentclass[10pt,letterpaper,extrafontsizes]{memoir} \listfiles \usepackage{comment} -\usepackage[nofancy]{svninfo} -\svnInfo $Id: memman.tex 189 2010-03-12 17:02:55Z daleif $ % For (non-printing) notes \PWnote{date}{text} @@ -46,13 +45,68 @@ %%%% extra index for first lines \makeindex[lines] + +% this 'if' is used to determine whether we are compiling the memoir +% master in the subversion repository, or the public memman.tex +\newif\ifMASTER +\MASTERfalse +%\MASTERtrue + +\ifMASTER +% private package, not in circulation +% enables us to gather svn information on a single file basis +\usepackage[filehooks]{svn-multi-private} + +% \svnidlong +% {} +% {$LastChangedDate: 2010-07-01 00:21:04 +0200 (Thu, 01 Jul 2010) $} +% {$LastChangedRevision: 244 $} +% {$LastChangedBy: daleif $} + + + +\makeatletter +\newcommand\addRevisionData{% + \begin{picture}(0,0)% + \put(0,-20){% + \tiny% + \expandafter\@ifmtarg\expandafter{\svnfiledate}{}{% + \textit{\textcolor{darkgray}{Chapter last updated \svnfileyear/\svnfilemonth/\svnfileday + \enspace (revision \svnfilerev)}} + }% + }% + \end{picture}% +} +\makeatother + +% we add this to the first page of each chapter + +\makepagestyle{chapter} +\makeoddfoot{chapter}{\addRevisionData}{\thepage}{} +\makeevenfoot{chapter}{\addRevisionData}{\thepage}{} + +\else +% disable svn info collecting +\newcommand\svnidlong[4]{} +\fi + + + %% end preamble %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %#% extend + \begin{document} + + %#% extstart input intro.tex + + + + + \tightlists %%%%\firmlists \midsloppy @@ -158,7 +212,9 @@ Ninth impression, with additions and corrections: & 8 July 2009 \\ Eighth edition: & August 2009 \\ \end{tabular} \end{center} -Last changed \svnInfoDate +\ifMASTER +Manual last changed \svnyear/\svnmonth/\svnday +\fi \endgroup @@ -232,6 +288,13 @@ Last changed \svnInfoDate %#% extstart include preface.tex %\chapter{Foreword} + +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \chapter{Preface} From personal experience and also from lurking on the \url{comp.text.tex} @@ -1150,6 +1213,12 @@ been answered. %#% extstart include intro-8.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-07-01 00:45:30 +0200 (Thu, 01 Jul 2010) $} +{$LastChangedRevision: 246 $} +{$LastChangedBy: daleif $} + \chapter{Introduction to the eighth edition} The \Lclass{memoir} class and this manual have seen many changes since @@ -1714,7 +1783,7 @@ Carsten Heinz, % code Florence Henry, Peter Heslin, Timo Hoenig, % thank you letter -Morton H{\o}gholm, % code +Morten H{\o}gholm, % code Henrik Holm, Vladimir Ivanovich, Martin J{\o}rgensen, % bug report @@ -1728,17 +1797,17 @@ Matthew Lovell, Daniel Luecking, % codef Anders Lyhne, % chapterstyle Lars Hendrik Gam Madsen, % extra space in Part title in ToC -Lars Madsen, % code +Lars~Madsen, % code Vittorio De Martino, Ben McKay, % errors in pagenote instructions -Frank Mittelbach, % code +Frank~Mittelbach, % code Wilhelm M\"{u}ller, % bugs & suggested extensions -Vilar Camara Neto, +Vilar~Camara~Neto, Rolf Niepraschk, Patrik Nyman, -Heiko Oberdiek, % code -Scott Pakin, -Adriano Pascoletti, +Heiko~Oberdiek, % code +Scott~Pakin, +Adriano~Pascoletti, Paul, % bug report Ted Pavlic, % typo report Troels Pedersen, % chapterstyle @@ -1752,6 +1821,7 @@ Ren{\'e}, % correction (paper folding) Alan Ristow, % request for \leavespergathering Robert, Chris Rowley, +Gary Ruben, % bug report Robert Schlicht, % code Doug Schenck, Dirk Schlimm, @@ -1774,6 +1844,8 @@ and David Wilson. + + If I have inadvertently left anyone off the list I apologise, and please let me know so that I can correct the omisssion.\footnote{I am currently occasionably reachable via email @@ -1828,9 +1900,20 @@ than correspond directly with the supporter, who might well be away for some considerable time and perhaps not notice your email after having returned to base. +Then dealing with memoir issues on \url{comp.text.tex}, please include +the word \texttt{memoir} in the subject. That will help the memoir +maintainer keep track of memoir related matters. + + %#% extend %#% extstart include terminology.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{Terminology} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -2030,6 +2113,13 @@ an em, often a quad is 1em. %#% extstart include start-off.tex + +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \chapter{Starting off} \label{chap:starting} @@ -2630,6 +2720,13 @@ want to put \cmd{\raggedbottom} in the preamble\index{preamble}. \pagestyle{ruled} %#% extstart include laying-out-page.tex + +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \chapter{Laying out the page} \label{chap:layingpage} @@ -4363,6 +4460,13 @@ effect. %#% extstart include text-and-fonts.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + + \chapter{Text and fonts} Presumably you will be creating a document that contains at least some @@ -5452,6 +5556,13 @@ odd line or to reword the text. %#% extend %#% extstart include titles.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + + \chapter{Titles} The standard classes provide little in the way of help in setting @@ -6278,6 +6389,11 @@ and thanks notes are meant to be different. %#% extstart include abstracts.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} \chapter{Abstracts} @@ -6544,6 +6660,11 @@ optional argument of the \cmd{\twocolumn} command. In fact, %#% extend %#% extstart include document-divisions.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-06-09 14:51:45 +0200 (Wed, 09 Jun 2010) $} +{$LastChangedRevision: 222 $} +{$LastChangedBy: daleif $} %%%%%%%%%%%%%%%%%%%%%%%%%%%%% % chapter style @@ -8411,6 +8532,7 @@ on recto pages. \index{chapterstyle|)} \subsection{Chapter precis} +\label{sec:chapter-precis} \index{chapter!precis|(} @@ -8497,21 +8619,37 @@ are defined as: \end{lcode} Any or all of these can be changed if another style of typesetting is required. - +\LMnote{2010/06/09}{Changed a bit, and moved the glossary stuff here + where it naturally belong} +Next the following macros control the formatting of the precis text in +the ToC. \begin{syntax} -\cmd{\precistoctext}\marg{text} \cmd{\precistocfont} \\ +\cmd{\precistoctext}\marg{text} \cmd{\precistocfont} \cmd{\precistocformat} \\ \end{syntax} -The \cmd{\chapterprecistoc} macro puts the macro \cmd{\precistoctext} into -the \ixfile{toc} file. The default definition is +\glossary(precistoctext)% + {\cs{precistoctext}\marg{text}}% + {ToC entry for chapter precis \meta{text}} +\glossary(precistocfont)% + {\cs{precistocfont}}% + {Font for typesetting \cs{precistoctext}.} +\glossary(precistocformat)% + {\cs{precistocformat}}% + {Format for typesetting \cs{precistoctext}.} +The \cmd{\chapterprecistoc} macro puts \cmd{\precistoctext}\marg{text} into +the \pixfile{toc} file. The default definition similar to (but not +exactly\footnote{Internally we use a different name for \cs{leftskip} + and \cs{rightskip} to make it easier to do right to left document +with the class and the \texttt{bidi} package.}) \begin{lcode} \DeclareRobustCommand{\precistoctext}[1]{% - {\leftskip \cftchapterindent\relax - \advance\leftskip \cftchapternumwidth\relax - \rightskip \@tocrmarg\relax - \precistocfont #1\par}} + {\nopagebreak\leftskip \cftchapterindent\relax + \advance\leftskip \cftchapternumwidth\relax + \rightskip \@tocrmarg\relax + \precistocformat\precistocfont #1\par}} \end{lcode} Effectively, in the \toc{} \cmd{\precistoctext} typesets its argument like -a chapter title using the \cmd{\precistocfont} (default \cmd{\itshape}). +a chapter title using the \cmd{\precistocfont} (default +\cmd{\itshape}), and \cmd{\precistocformat} (default \cmd{\noindent}). \index{chapter!precis|)} @@ -9417,6 +9555,11 @@ normal size by the time subsubsection heads are reached, or before. %#% extend %#% extstart include pagination-and-headers.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-06-25 13:34:23 +0200 (Fri, 25 Jun 2010) $} +{$LastChangedRevision: 236 $} +{$LastChangedBy: daleif $} \chapterstyle{demo3} @@ -9941,6 +10084,16 @@ particular pagestyle. The code normally defines the marks, if any, that will be used in the headers\index{header} and footers\index{footer}. +\LMnote{2010/06/25}{Added a mentioning of \cs{makeheadfootstrut}} +\begin{syntax} + \cmd{\makeheadfootstrut}\marg{style}\marg{head strut}\marg{foot strut} +\end{syntax} +The headers and footers are each made up of three separate +entities. At the front and end of these a special \meta{style} related +strut is inserted. By default \cmd{\makepagestyle} will initialize +them to \cmd{\strut} (except the \pstyle{empty} style where the struts +are empty). One can use the macro above to change these struts to +something different. \subsection{Example pagestyles} @@ -10625,7 +10778,9 @@ like: \end{picture}% } \makeatother -\makepagestyle{chapter} % make chapter a real pagestyle not just an alias +% chapter is normally an alias to the plain style, we want to change +% it, so make it a real pagestyle +\makepagestyle{chapter} \makeoddfoot{chapter}{\addRevisionData}{\thepage}{} \makeevenfoot{chapter}{\addRevisionData}{\thepage}{} \end{lcode} @@ -10634,6 +10789,12 @@ like: %#% extend %#% extstart include paragraphs-and-lists.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -11819,6 +11980,11 @@ other environments. %#% extstart include content-lists.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-06-09 15:19:40 +0200 (Wed, 09 Jun 2010) $} +{$LastChangedRevision: 225 $} +{$LastChangedBy: daleif $} %%%%%%%%%%%%%%%%%%%%%%%%%% %%\chapterstyle{section} @@ -11883,7 +12049,7 @@ can be changed by using \cmd{\setcounter} or \cmd{\settocdepth}. {\cs{addcontentsline}\marg{file}\marg{kind}\marg{text}}% {Writes heading/caption data to the \meta{file} in the form of the \cs{contentsline} macro.} - \ltx\ generates a \ixfile{toc} file if the document contains a + \ltx\ generates a \pixfile{toc} file if the document contains a \cmd{\tableofcontents} command. The sectioning commands\footnote{For figures and tables it is the \cmd{\caption} command @@ -11910,7 +12076,7 @@ can be changed by using \cmd{\setcounter} or \cmd{\settocdepth}. For example, if \verb?\section{Head text}? was typeset as `\textbf{3.4 Head text}' on page 27, then there would be the following -entry in the \ixfile{toc} file: +entry in the \pixfile{toc} file: \begin{lcode} \contentsline{section}{\numberline{3.4} Head text}{27} \end{lcode} @@ -13093,6 +13259,12 @@ captions\index{caption} are not too exotic, use the \cmd{\legend} command (see later). If the illustration\index{illustration} is numbered, use \cmd{\cftaddnumtitleline} instead of \cmd{\cftaddtitleline}. + +\LMnote{2010/06/09}{Thought we needed a break here} +\subsubsection{Inserting stuff into the content lists} +\label{sec:inserting-stuff-into} + + The next functions were suggested by Lars\index{Madsen, Lars} Madsen who found them useful if, for example, you had two versions of the \toc\ and you needed some aspects to be formatted differently. @@ -13139,26 +13311,17 @@ harm will come if a matching \cmd{\cftinserthook} is never used. No harm occures either if you call \cmd{\cftinserthook} and there is no prior matching \cmd{\cftinsertcode}. + +\LMnote{2010/06/09}{Ineffective to have this seceral places in the manual.} +\subsubsection{Extra chapter material in the ToC} +\label{sec:extra-chapt-mater} + \begin{syntax} -\cmd{\precistoctext}\marg{text} \cmd{\precistocfont} \\ +\cmd{\precistoctext}\marg{text} \cmd{\precistocfont} \cmd{\precistocformat}\\ \end{syntax} -\glossary(precistoctext)% - {\cs{precistoctext}\marg{text}}% - {ToC entry for chapter precis \meta{text}} -\glossary(precistocfont)% - {\cs{precistocfont}}% - {Font for typesetting \cs{precistoctext}.} -The \cmd{\chapterprecistoc} macro puts the macro \cmd{\precistoctext} into -the \ixfile{toc} file. The default definition is -\begin{lcode} -\DeclareRobustCommand{\precistoctext}[1]{% - {\leftskip \cftchapterindent\relax - \advance\leftskip \cftchapternumwidth\relax - \rightskip \@tocrmarg\relax - \precistocfont #1\par}} -\end{lcode} -Effectively, in the \toc{} \cmd{\precistoctext} typesets its argument like -a chapter title using the \cmd{\precistocfont} (default \cmd{\itshape}). +The \cmd{\chapterprecistoc} macro puts \cmd{\precistoctext}\marg{text} into +the \pixfile{toc} file. Further information as to the definition of +this macro can be found in section~\ref{sec:chapter-precis}. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -13756,76 +13919,81 @@ printed folios\index{folio} or \cmd{\caption}s. - \section{Chapter precis} - -\index{chapter!precis|(} - - Some old style novels, and even some modern text - books,\footnote{For example, Robert Sedgewick, \textit{Algorithms}, - Addison-Wesley, 1983.} include a short synopsis of the contents of - the chapter either immediately - after the chapter heading\index{heading!chapter} or in the \toc, or in both places. - -\begin{syntax} -\cmd{\chapterprecis}\marg{text} \\ -\end{syntax} - The command \cmd{\chapterprecis} prints its argument - both at the - point in the document where it is called, and also adds it to the \file{.toc} - file. For example: - \begin{lcode} - ... - \chapter{} first chapter - \chapterprecis{Our hero is introduced; family tree; early days.} - ... - \end{lcode} - -\begin{syntax} -\cmd{\chapterprecishere}\marg{text} \\ -\cmd{\chapterprecistoc}\marg{text} \\ -\end{syntax} - The \cmd{\chapterprecis} command calls these two commands to print the - \meta{text} in the document (the \cmd{\chapterprecishere} command) - and to put it into the \toc{} (the \cmd{\chapterprecistoc} command). - These can be used individually if required. - -\begin{syntax} -\cmd{\prechapterprecis} \cmd{\postchapterprecis} \\ -\end{syntax} -The \cmd{\chapterprecishere} macro is intended for use immediately after -a \cmd{\chapter}. The \meta{text} argument is typeset in -italics in a \Ie{quote} environment. The macro's definition is: -\begin{lcode} -\newcommand{\chapterprecishere}[1]{% - \prechapterprecis #1\postchapterprecis} -\end{lcode} -where \cmd{\prechapterprecis} and \cmd{\postchapterprecis} are defined -as: -\begin{lcode} -\newcommand{\prechapterprecis}{% - \vspace*{\prechapterprecisshift}% - \begin{quote}\normalfont\itshape} -\newcommand{\postchapterprecis}{\end{quote}} -\end{lcode} -The \cmd{\prechapterprecis} and \cmd{\postchapterprecis} macros can be -changed if another style of typesetting is required. - -\begin{syntax} -\cmd{\precistoctext}\marg{text} \cmd{\precistocfont} \\ -\end{syntax} -The \cmd{\chapterprecistoc} macro puts the macro \cmd{\precistoctext} into -the \ixfile{toc} file. The default definition is -\begin{lcode} -\DeclareRobustCommand{\precistoctext}[1]{% - {\leftskip \cftchapterindent\relax - \advance\leftskip \cftchapternumwidth\relax - \rightskip \@tocrmarg\relax - \precistocfont #1\par}} -\end{lcode} -Effectively, in the \toc{} \cmd{\precistoctext} typesets its argument like -a chapter title using the \cmd{\precistocfont} (default \cmd{\itshape}). +\LMnote{2010/06/09}{Why do we have this exact section in two different +chapters? No this links to the version i document-divisions.tex } +\section{Chapter precis} + +See section~\ref{sec:chapter-precis} on page~\pageref{sec:chapter-precis}. + + +% \index{chapter!precis|(} + +% Some old style novels, and even some modern text +% books,\footnote{For example, Robert Sedgewick, \textit{Algorithms}, +% Addison-Wesley, 1983.} include a short synopsis of the contents of +% the chapter either immediately +% after the chapter heading\index{heading!chapter} or in the \toc, or in both places. + +% \begin{syntax} +% \cmd{\chapterprecis}\marg{text} \\ +% \end{syntax} +% The command \cmd{\chapterprecis} prints its argument +% both at the +% point in the document where it is called, and also adds it to the \file{.toc} +% file. For example: +% \begin{lcode} +% ... +% \chapter{} first chapter +% \chapterprecis{Our hero is introduced; family tree; early days.} +% ... +% \end{lcode} + +% \begin{syntax} +% \cmd{\chapterprecishere}\marg{text} \\ +% \cmd{\chapterprecistoc}\marg{text} \\ +% \end{syntax} +% The \cmd{\chapterprecis} command calls these two commands to print the +% \meta{text} in the document (the \cmd{\chapterprecishere} command) +% and to put it into the \toc{} (the \cmd{\chapterprecistoc} command). +% These can be used individually if required. + +% \begin{syntax} +% \cmd{\prechapterprecis} \cmd{\postchapterprecis} \\ +% \end{syntax} +% The \cmd{\chapterprecishere} macro is intended for use immediately after +% a \cmd{\chapter}. The \meta{text} argument is typeset in +% italics in a \Ie{quote} environment. The macro's definition is: +% \begin{lcode} +% \newcommand{\chapterprecishere}[1]{% +% \prechapterprecis #1\postchapterprecis} +% \end{lcode} +% where \cmd{\prechapterprecis} and \cmd{\postchapterprecis} are defined +% as: +% \begin{lcode} +% \newcommand{\prechapterprecis}{% +% \vspace*{\prechapterprecisshift}% +% \begin{quote}\normalfont\itshape} +% \newcommand{\postchapterprecis}{\end{quote}} +% \end{lcode} +% The \cmd{\prechapterprecis} and \cmd{\postchapterprecis} macros can be +% changed if another style of typesetting is required. + +% \begin{syntax} +% \cmd{\precistoctext}\marg{text} \cmd{\precistocfont} \\ +% \end{syntax} +% The \cmd{\chapterprecistoc} macro puts the macro \cmd{\precistoctext} into +% the \pixfile{toc} file. The default definition is +% \begin{lcode} +% \DeclareRobustCommand{\precistoctext}[1]{% +% {\leftskip \cftchapterindent\relax +% \advance\leftskip \cftchapternumwidth\relax +% \rightskip \@tocrmarg\relax +% \precistocfont #1\par}} +% \end{lcode} +% Effectively, in the \toc{} \cmd{\precistoctext} typesets its argument like +% a chapter title using the \cmd{\precistocfont} (default \cmd{\itshape}). -\index{chapter!precis|)} +% \index{chapter!precis|)} \section{Contents lists and bookmarks} @@ -13846,9 +14014,25 @@ this is to add \end{lcode} just before the material you would like to pull out of the part tree. +\LMnote{2010/06/09}{Heikos own recommendation} +A better solution is the \Lpack{bookmark} package, add it to the +preamble, and add +\begin{lcode} + \bookmarksetup{startatroot} +\end{lcode} +before the stuff you want to have moved out of, say, a part. + + %#% extend %#% extstart include flosts-and-captions.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%\chapterstyle{hangnum} @@ -16489,6 +16673,12 @@ footnote\index{footnote!text} text. %#% extstart include rows-and-columns.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%% Original memman @@ -18454,6 +18644,12 @@ illustrate these points. %#% extend %#% extstart include page-notes.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \chapter{Page notes} \label{chap:mnotes} The standard classes provide the \cmd{\footnote} command for notes @@ -19793,6 +19989,11 @@ In the margin you will find the result of the following code: %#% extstart include decorative-text.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} %%%%% end membook @@ -20241,6 +20442,11 @@ for epigraphs after the title (or the equivalents for \cmd{\book} pages). %#% extend %#% extstart include poetry.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %\clearpage @@ -21396,6 +21602,11 @@ and the result is shown on the next page. %#% extend %#% extstart include boxes-verbatims-and-files.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%% membook @@ -23358,6 +23569,12 @@ in the text must be \cmd{\protect}ed.\index{protect} %#% extend %#% extstart include cross-referencing.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{Cross referencing} \label{chap:xref} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -23719,6 +23936,17 @@ will require the use of \cmd{\titleref} and so the declaration %#% extend %#% extstart include backmatter.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-06-09 14:23:37 +0200 (Wed, 09 Jun 2010) $} +{$LastChangedRevision: 219 $} +{$LastChangedBy: daleif $} + + +\LMnote{2010/06/09}{Several \cs{ixfile}'s changed to \cs{pixfile}, + with \cs{ixfile} only, no text appears in the output } + + \chapter{\prBackmatter} \label{chap:backmatter} The \pixbackmatter\ consists of reference and supportive elements for @@ -24341,7 +24569,7 @@ but could be redefined like, say, {Report attempts to use an \file{idx} file that has not been declared by \cs{makeindex}.} Following the declaration \cmd{\ignorenoidxfile}, which is the default, -LaTeX will silently pass over attempts to use an \ixfile{idx} file which has +LaTeX will silently pass over attempts to use an \pixfile{idx} file which has not been declared via \cmd{\makeindex}. After the declaration \cmd{\reportnoidxfile} LaTeX will whinge about any attempts to write to an unopened file. @@ -25010,7 +25238,7 @@ macro \cmd{\citeindexfile}. This is initially defined as: \newcommand{\citeindexfile}{\jobname} \end{lcode} That is, the citation entries will be written to the default -\ixfile{idx} file. +\pixfile{idx} file. This may be not what you want so you can change this, for example to: \begin{lcode} \renewcommand{\citeindexfile}{names} @@ -25578,7 +25806,7 @@ file has an \pixfile{ent} extension, like the table of contents file has a \pixfile{toc} extension. You have to put \cmd{\makepagenote} in your preamble if you want -endnotes. This will open the \ixfile{ent} note file which is called +endnotes. This will open the \pixfile{ent} note file which is called \verb?\jobname.ent?. In the body of the text use use \cmd{\pagenote} to create an endnote, just @@ -25611,12 +25839,12 @@ the listing. For one set of endnotes covering the whole document put \cmd{\printpagenotes} where you want them printed, typically before any bibliography or index. The \cmd{\printpagenotes} macro inputs the -\ixfile{ent} endnote file for printing and then closes it to any further +\pixfile{ent} endnote file for printing and then closes it to any further notes. For notes at the end of each chapter put \cmd{\printpagenotes*}, which inputs -the \ixfile{ent} file for printing then empties it ready for more notes, +the \pixfile{ent} file for printing then empties it ready for more notes, at the end of each chapter. The simple use is like this: @@ -25697,7 +25925,7 @@ be put in your preamble. Because of how TeX writes information to files, when the \cmd{\notepageref} declaration is used there must be no notes on the page where -\cmd{\printnotes} or \cmd{\printnotes*} closes the \ixfile{ent} file. +\cmd{\printnotes} or \cmd{\printnotes*} closes the \pixfile{ent} file. If necessary, a \cmd{\clearpage} or similar must be used before the print command. @@ -25720,7 +25948,7 @@ as: \newcommand*{\notedivision}{\chapter{\notesname}} \end{lcode} In other words, it will print out a heading for the notes that will be read -from the \file{ent} file. \verb?\print...? then closes the \ixfile{ent} file +from the \file{ent} file. \verb?\print...? then closes the \pixfile{ent} file for writing and after this \verb?\input?s it to get and process the notes. @@ -25766,7 +25994,7 @@ of a note. The default definitions are: {\cs{postnoteinnotes}}% {Called by \cs{noteentry} to finish the printing of an endnote.} The \cmd{\pagenote} macro writes \cmd{\noteentry}, with the appropriate -values for the arguments, to the \ixfile{ent} file, +values for the arguments, to the \pixfile{ent} file, where \meta{notenum} is the note number (from the \Icn{pagenote} counter), \meta{id} and \meta{text} are as supplied to \cmd{\pagenote}, and if the \cmd{\notepageref} declaration option is used, @@ -25850,7 +26078,7 @@ and is used to print the text of a note. \glossary(addtonotes)% {\cs{addtonotes}\marg{text}}% {Inserts \meta{text} into the endnotes \file{ent} file.}% -The macro \cmd{\addtonotes} inserts \meta{text} into the \ixfile{ent} +The macro \cmd{\addtonotes} inserts \meta{text} into the \pixfile{ent} file. For example, before the first note in a chapter, \cmd{\addtonotes} is used to write the \cmd{\pagenotesubhead} command to the file. @@ -25875,7 +26103,7 @@ using \cmd{\protect} and see if they go away. {Starred chapter title for \cs{pagenotesubhead}. Defaults to the regular title.} The macro \cmd{\pagenotesubhead} typesets the subheadings in an endnote -list. It is inserted into the \ixfile{ent} file via \cmd{\addtonotes}. +list. It is inserted into the \pixfile{ent} file via \cmd{\addtonotes}. The \meta{chapapp} argument is normally \cmd{\chaptername} but if the notes are from an appendix then \cmd{\appendixname} is used instead. \meta{num} is the number of the chapter, or blank if there is no number. Lastly, @@ -25918,6 +26146,12 @@ ignored as for \cmd{\pagenote} it can be arbitrary text whereas for %#% extend %#% extstart include miscellaneous.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-07-01 01:49:45 +0200 (Thu, 01 Jul 2010) $} +{$LastChangedRevision: 250 $} +{$LastChangedBy: daleif $} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %\clearpage %\pagestyle{Ruled} @@ -27826,7 +28060,7 @@ package includes the actual code for \meta{package}. \Mname\ does include code from several packages and uses a similar internal command to ensure that the packages are not loaded following some later \cmd{\usepackage} command. The names of the -emulated packages are written to the \ixfile{log} file. At the time +emulated packages are written to the \pixfile{log} file. At the time of writing the emulated packages are: \Lpack{abstract}, \Lpack{appendix}, \Lpack{array}, \Lpack{booktabs}, \Lpack{ccaption}, \Lpack{chngcntr}, \Lpack{crop}, \Lpack{dcolumn}, @@ -28203,6 +28437,17 @@ The arguments are: (1) `\Margi', (2) `\Margii', (3) `\Margiii', \end{lcode} The arguments are: (1) `\Margi', (2) `\Margii', (3) `\Margiii', (4) `\Margiv', (5) `\Margv'. + +\LMnote{2010/07/01}{This is a large problem with subsubsection titles + if the \cs{memsecinfo} above is used, added a warning, and made sure + the test stops here.} +\fancybreak{} + +\textbf{Warning:} Be very careful with the fifth argument of this +macro when using \Lpack{hyperref}, this argument will then contain a +hyper link anchor, whih may cause problems when used out of context. + +\renewcommand\memsecinfo[5]{} \section{Documenting \ltx\ commands} @@ -28270,6 +28515,12 @@ The macro \cs{parg}\marg{arg} prints \parg{arg} for a parenthesized argument. %#% extend %#% extstart include for-package-users.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-07-01 01:44:23 +0200 (Thu, 01 Jul 2010) $} +{$LastChangedRevision: 249 $} +{$LastChangedBy: daleif $} + \chapter{For package users} \label{chap:packageusers} Many packages work just as well with \Pclass{memoir} as with any of the @@ -28416,6 +28667,20 @@ of the standard commands needs to be replaced. + +%#% extend +%#% extstart include an-example-book-design.tex + +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-07-01 01:44:23 +0200 (Thu, 01 Jul 2010) $} +{$LastChangedRevision: 249 $} +{$LastChangedBy: daleif $} + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\LMnote{2010/07/01}{This belongs here} \clearpage \makeatletter @@ -28489,11 +28754,7 @@ of the standard commands needs to be replaced. \makeatother -%#% extend -%#% extstart include an-example-book-design.tex - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \cleardoublepage \pagestyle{bringhurst} %%%\chapterstyle{bringhurst} @@ -28990,6 +29251,12 @@ in your document's preamble\index{preamble}. %#% extstart include an-example-thesis-design.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \PWnote{2009/07/05}{Added thesis design chapter} \PWnote{2009/07/08}{Revised thesis design chapter} \chapter{An example thesis design} \label{chap:thesis} @@ -30012,6 +30279,12 @@ than Archibald Smythe University will permit. %#% extstart include packages-and-maros.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \chapter{Packages and macros} The \Mname\ class does not provide for everything that you @@ -30242,6 +30515,12 @@ serves my needs. %#% extstart include sniplets.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + \LMnote{2010/02/09}{Started the sniplet chapter} \chapter{Sniplets} \label{cha:sniplets} @@ -30378,6 +30657,11 @@ trim marks Rolf Niepraschk suggested the following trick %#% extend %#% extstart include pictures.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -31745,6 +32029,13 @@ exactly how many blobs to use for the curve. %#% extend %#% extstart include latex-and-tex.tex +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} + + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{\ltx\ and \tx} \label{appendix:alltex} @@ -33108,7 +33399,11 @@ but in this case the best place to look for further information is in the %#% extend %#% extstart include the-terrors-of-errors.tex - +\svnidlong +{$Ignore: $} +{$LastChangedDate: 2010-05-13 17:10:00 +0200 (Thu, 13 May 2010) $} +{$LastChangedRevision: 210 $} +{$LastChangedBy: daleif $} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -35570,6 +35865,7 @@ recognized. %#% extstart input backend.tex + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%\endinput %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |