Memoir is a flexible class for typesetting poetry, fiction,
non-fiction and mathematical works as books, reports, articles or
manuscripts. Documents can use 9pt, 10pt, 11pt, 12pt, 14pt, or 17pt as the
normal fontsize and, if you have scalable fonts, 20pt, 25pt, 30pt, 36pt,
48pt, or 60pt sizes, or even larger. Many methods are provided to let
you create your particular design. The class incorporates over 30 of the
more popular packages.
IF YOU HAVE ANY QUESTIONS PLEASE ASK THEM ON THE COMP.TEXT.TEX NEWSGROUP;
YOU ARE LIKELY TO GET FASTER AND BETTER ANSWERS THAN IF YOU EMAIL ME DIRECTLY
AS I AM AWAY MORE OFTEN THAN NOT.
(Lars Madsen <daleif+memoir@imf.au.dk> is gradually taking over
the support for memoir.)
NOTE: In order to provide fixes for any problems that may arise
between major releases, you may find a file called mempatch.sty
which contains any current fixes for the memoir class. The class
will automatically include this so DO NOT \usepackage{mempatch}.
The Change lists below do not neccessarily note each release of
the patch or addendum files.
NOTE: Similarly, there may be file(s) called memmanadd.(tex|pdf) which
provides amendments to the current version of the User Manual.
NOTE: If you are using the hyperref package dated earlier than 2006/11/15,
use the memhfixc package after the hyperref package, e.g.,
...
\usepackage[...]{hyperref}
\usepackage{memhfixc}
...
Later versions of the hyperref package automatically load the memhfixc package.
NOTE: The full User Manual (memman.pdf) is a large document of about
550 pages in total. You do not need to print all of it, especially if you
already have an earlier edition. Roughly speaking, the main portions are:
o Frontmatter: Preface, Toc, Introduction, Terminology ~ 40 pages
o Mainmatter:
Class commands and environments, etc. ~ 380 pages
o Appendices: (La)Tex programming, Errors and warnings ~ 40 pages
o Backmatter:
Command glossary ~ 40 pages
Bibliography, indexes ~ 50 pages
Changes (2010/02/20)
o Memoir v1.618033988c
-- fixed sporadic space in regular \footnote command
Changes (2010/02/17)
o Memoir v1.618033988b
-- fixed typo that broke \feetbelowfloats
Changes (2010/02/16)
o Memoir v1.618033988
-- changed internal toc handling, as not to open extra files if the
TOC is being used several times.
-- fixed bug in the emulation of ifpdf, ifxetex and ifluatex that
might cause memoir to crash in certain cases
-- added \clearmark and \clearplainmark to 'clear' mark commands when
defining specialised page styles
-- made \subcaptionref robust
-- added \letcountercounter and \unletcounter to let one counter act
as if it had another name
-- add possibility to have \footnote write in the margin by internally
use \marginpar
-- added a separate bottom aligned side footnote feature
-- added consistent interface for \marginpar, \sidepar, \sidebar,
and \sidefootnote for specifying into which margin the note should go
-- added feature that makes it easier for the side writing macros to
determine whether they are on the left or right of the text. The
defaults for \sidepar and \sidebar have been changed such that their
text now comes out flush up against the text.
-- added appendix about the picture environment. Apparently there is no
extensive freely available information about this environment. There
is now. The chapter stem from an abandoned book project.
-- extended the pagestyle changing macros such that they now warn if
the page style does not exist or if the page style is an alias
(trying to change an alias might lead to odd results)
-- added tocvsec2 to list of emulated packages (left out by mistake)
-- some undocumented hooks have been added to the toc building macros,
more about these later.
Changes (2009/11/17)
o Memoir v1.61803398c
-- fixed typo that broke \flushbottom. Please note that this fix WILL
change existing documents, potentially changing page breaks.
-- fixed a problem that might cause the addition of trimmarks to shift
the output box a bit downward. Thanks to Heiko Oberdiek for the
analysis and fix
-- fixed a typo in an example in the manual
-- changed \tmarkml, \tmarkmr, \tmarktm and \tmarkbm to place markers
for the middle parts of the text. Earlier they did nothing and had
to be defined by the user. Now the user can simply define them to do
nothing if needed.
-- added visual example to the manual showing the four trim mark types
-- changed the madsen chapter style such that it now have a better
unnumbered look
Earlier changes are noted at the end.
-------------------------------------------------------------------
Author: Peter Wilson (Herries Press) herries dot press at earthlink dot net
Copyright 2001--2010 Peter R. Wilson
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either
version 1.3 of this license or (at your option) any
later version.
The latest version of the license is in
http://www.latex-project.org/lppl.txt
and version 1.3 or later is part of all distributions of
LaTeX version 2003/06/01 or later.
This work has the LPPL maintenance status "author-maintained".
This work consists of the files:
README (this file)
memoir.dtx
memoir.ins
mempatch.dtx
mempatch.ins
and the derived files
memoir.cls
mem9.clo
mem10.clo
mem11.clo
mem12.clo
mem14.clo
mem17.clo
mem20.clo
mem25.clo
mem30.clo
mem36.clo
mem48.clo
mem60.clo
mempatch.sty
memhfixc.sty
basic.gst.
-------------------------------------------------------------------
The distribution consists of the following files:
README (this file)
memoir.(dtx|ins) Class source and installation files
mempatch.(dtx|ins) Source and installation for patch files
mempatch.sty Patch file for memoir class
memhfixc.sty Patch file for hyperref package
memman.tex LaTeX source for the user manual
(requires the memoir class and the alltt,
fixltx2e, layouts, graphicx, and url packages for
processing)
memman.pdf User manual in PDF
memmanadd.pdf Addendum (in PDF) to the User Manual (if required)
memsty.sty Style file for (memman|memmanadd).tex
memnoidxnum.tex Some default indexed elements for memman.tex
memfonts.sty Palatino/CMR(lmodern) font mix
memlays.sty Additional diagrammatic layouts
titlepages.sty Assorted title page definitions
anvil2.mps Herries Press logo
memman.ist MakeIndex style file for (memman|memmanadd).tex
memman.gst MakeIndex style file for (memman|memmanadd) glossary
To install the package:
o run: latex memoir.ins (which will generate memoir.cls,
a set of mem*.clo files,
and basic.gst for MakeIndex glossary files)
o Move memoir.cls, the mem*.clo files and any mem*.sty file to locations
where LaTeX will find them (typically in a local texmf tree at
/tex/latex/memoir) and refresh the file database.
See the FAQ on CTAN at help/uk-tex-faq
or http://www.tug.ac.uk/faq for more information on this.
To read the commented source code
o run: (pdf)latex memoir.dtx
For an index run: makeindex -s gind.ist memoir
o run: (pdf)latex memoir.dtx
o Print the result for a hardcopy of the documented code (which consists
of nearly 500 pages)
To process memman.tex (if you really want to do this and not just use
memman.pdf as supplied)
o Make sure you can use the memoir class and the alltt, fixltx2e,
layouts, graphicx, comment, and url (and perhaps some more) packages.
o Run (pdf)latex twice on memman.tex
o For an index run: makeindex -s memman.ist memman
o For an index of first lines run: makeindex lines
o For a glossary run: makeindex -s memman.gst -o memman.gls memman.glo
o Run (pdf)latex twice more on memman.tex
o Print the manual
-------------------------------------------------------------------
Changes (2009/09/21)
o Memoir v1.61803398b
-- fixed typo that broke \thanks
Changes (2009/09/10)
o Memoir v1.61803398
-- fixed bug with the upquotes package
-- added support for the bidi package
-- added a simple page style
-- added feature to \newlistof such that \KeepFromToc will locally change say
\tableofcontents into \tableofcontents*
-- Fixed bug, such that XeLaTeX will get the correct pages sizes
Changes (2009/08/23)
o Eighth edition of the User Manual covering memoir v1.61803398.
The design Part is now in a separate document, memdesign, which
should be available from CTAN in /info.
Changes (2009/07/24)
o Memoir v1.6180339h fixes minor typos in memoir.dtx and mempatch.dtx
Changes (2009/07/21)
o Memoir v1.6180339g fixes minor bugs in memoir and mempatch
Changes (2009/07/12)
o Memoir v1.6180339f fixes minor bugs and adds new commands
-- \begin{labelled}{name} A description list where \name is the labelling macro
-- \twocoltocetc - the ToC and friends will be set in two columns
-- \onecoltocetc - the ToC and friends will be set in one column (the default)
-- \doccoltocetc - the ToC and friends will be set according the class column option
-- \frontmatter, \mainmatter and \backmatter have had their float counter change
factored out such that users may now change these
o Memoir now automatically loads the etex package
o The manual includes a chapter giving some historical backround related
to typesetting and further information about fonts. There is a new
chapter describing an example implementation of a memoir-based package for
a US University thesis.
Changes (2009/02/06)
o Memoir v1.6180339d,e fixes a bug introduced by v1.6180339c
-- \makeheadwidth, \makerunningheadwidth and \makerunningfootwidth no longer
support the '+' syntax from the calc package.
-- under hyperref \nameref is now an alias for \titleref
Changes (2009/01/26)
o Memoir v1.6180339c released with minor bug fixes that could
not be done via the patch file, plus some new functionality. The
manual has NOT been updated and the changes are noted below.
-- New paper size options: `a0paper', `a1paper', `a2paper', `b0paper',
`b1paper', and `b2paper' for A0, A1, A2, B0,B1, and B2 size stock paper.
-- Macro \memoirpostopthook{} which is called after the options are
processed but before anything else is done (like setting the page layout).
As an example, you may define it as (before the \documentclass}
command):
\newcommand*{\memoirpostopthook}{%
\setlength{\stockwidth}{<wid>}\setlength{\stockheight}{<ht>}}
\documentclass[...]{memoir}
to specify a stock paper size of <wid> by <ht> that is not provided by the
defined options.
-- New `portrait' option (default, the opposite of `landscape').
-- New command \setbinding{<length>} for a binding offset of <length>.
-- New commands: \setpagetm, \setpagetr, \setpagemr, \setpagebr, \setpagebm,
\setpagecc to position a (smaller) page on a (larger) stock at the
top-middle, top-right, middle-right, bottom-right, bottom-middle, and
centered with respect to the stock.
The macros are to be used instead of \settrimmedsize taking the
same arguments.
-- New optional parameter in \makeheadwidth{<style>}[<footerwidth>]{<headerwidth>}
to set the width of the <style>'s headers to <headerwidth> and the footers
to <headerwidth> or, if given, to <footerwidth>. The two widths can also
be set individually using \makerunningheadwidth{<style>}{<length>}
and similarly with \makerunningfootwidth. The lengths, if needed
are stored in \styleheadrunwidth and \stylefootrunwidth.
-- New `showlocs' pagestyle, which is provided as an example of what can be
done to show the positions of headers, footers, and the textblock (lines
are drawn showing the header and footer vertical locations and a box is
drawn around the text block. It is implemented by two zero-sized pictures:
\framepichead which draws a line at the header location, and \framepictextfoot
which draws a frame around the textblock and a line at the footer location.
Following the declaration \showheadfootlocoff the header/footer lines
will not be drawn (\showheadfootlocon turns them on again), and following
the \showtextblocklocoff declaration the frame around the text block will
not be drawn (\showtextblocklocon turns it on again). If you want a box
around your text you could create your own pagestyle using \framepictextfoot
and with the showlocs code as a starting point.
-- New command \centerfloat is a version of \centering which centers a wide
float or other known width element with respect to the textblock. E.g.,
\begin{table} \centerfloat \caption{A wide table} ... \end{table}
-- New command \sourceatright[<length>]{<short text>}. Use at the end of a
paragraph to put <short text> flushright. If it is short enough it will
go at the end of the last line preceded by at least <length> (default 2em)
space, otherwise it is set (flushright) on the following line.
-- New macro \leftspringright{<lfrac>}{<rfrac>}{<ltext>}{<rtext>} sets
<ltext> as a flushleft column, width <lfrac> of the textwidth, and <rtext>
as a flushright column, width <rfrac> of the textwidth, with
(1.0 - <lfrac> - <rfrac>) textwidth space between them. E.g.,
\spring{0.4}{0.5}{On the left}{Right stuff}
-- Following the declaration \linenottooshort{<length>} paragraphs will be set:
As normal but the last line will not be shorter than <length> (default 4em)
-- Using \russianpar instead of \par to end a paragraph causes it to be set
following Russian typographic rules
-- Using \lastlinerulefill instead of \par to end a paragraph will be
cause any short line to be filled with a rule (\lastlineparrule) up to
the righthand margin.
-- Following the declaration \leftcenterright paragraphs will be set:
First line raggedright, the last line raggedleft, and the remainder
centered. If you use this shape, set \everypar{} afterwards.
-- Following the declaration \justlastraggedleft paragraphs will be set:
All lines normal except the last is raggedleft.
-- Following the declaration \raggedrightthenleft paragraphs will be set:
First line raggedright and remainder raggedleft.
-- If you use the above unusual paragraph shapes then using \\ to break
a line may give a surprising result. If so, you could try instead
\atcentercr (a memoir macro) or \break (a standard LaTeX macro) to see
if the result is any better for you. In addition, just in case, memoir
stores the original definitions of \\ and \par as \memorigdbs and
\memorigpar respectively.
-- \titleref have been extended with a \titleref*, which under
hyperref will provide the title but no link. Without hyperref, it
is the same as \titleref
-- added hooks around the internals used by sidecaption,
sidecontcaption, sidenamedlegend and sidelegend. They do nothing by
default but can be used for something like this
\makeatletter
\newenvironment{sidecaption*}{
\renewcommand\@mem@scap@beforehook{\checkoddpage\ifoddpage\else\raggedleft\fi}
\renewcommand\@mem@scap@afterhook{\par}
\begin{sidecaption}}
{\end{sidecaption}}
\makeatother
which, if the user has placed the sidecaption on the outside in an
twosided layout, then the figure will automatically be pushed
towards the spine margin.
Changes (2008/08/23)
o memhfixc v1.10 released to fix problem with tex4ht
o NO CHANGES TO ANYTHING ELSE
Changes (2008/08/07)
o Memoir v1.6180339a released to fix extraneous spaces in footnotes
o NO CHANGES TO ANYTHING ELSE
Changes (2008/07/23)
o Memoir v1.6180339 released to cater for non-compatible changes in
the hyperref package. It is highly unlikely that I will make any future
changes to memoir with respect to hyperref modifications, instead hyperref
can cater for memoir if necessary. All patches from mempatch v5.1 are
folded in.
o Mempatch package v6.0 released.
o INSIGNIFICANT CHANGES TO THE MANUAL (corrected typo in Figure 8.1 caption,
added two persons to the Acknowledgements)
Changes (2008/07/12)
o Mempatch package v5.1 released with bug fixes for \DisemulatePackage
and spacing of Part titles in the ToC.
o There was a mismatch between the general version of memman.pdf and the
tds version. These are now the same. I took the opportunity to fix
some very minor typos (perhaps no more than half a dozen words) in the
User Manual (if you have a printed copy of the seventh edition, it's not
worth printing the update)
o NO CHANGES TO THE CLASS
Changes (2008/06/02)
o Memoir class v1.618033 released with bug fixes for \feetbelowfloats
and sidebar layout for the larger font sizes.
o NO CHANGES TO THE USER MANUAL
Changes (2008/05/27)
o Memoir class v1.61803 released incorporating all patches and comments about
v1.61803 beta. Major extensions are extended, or arbitrary, document font
sizes and provision of several styles of section headings.
o User Manual (memman), edition 7 released incorporating the contents of the
Addendum. The part on typography has been extended and a glossary of memoir's
commands and environments has been added.
o New (empty) version of mempatch.sty.
This will be the last release for a considerable period of time. After 25
years in the USA we are moving back to the UK where there are grandchildren.
The process will probably involve at least 6 months in LaTeX limbo.
My definition of `considerable period' may imply decades.
Changes (2008/04/25)
o Beta version of memoir v1.61803 released incorporating all patches.
No major comments received.
o Beta version of the USER MANUAL released incorporating all of the
ADDENDUM. Minor comments received.
Changes (2006/12/23)
o New version (4.7) of mempatch.sty, fixing minor infelicities with v4.6
o NO CHANGES TO THE USER MANUAL OR ADDENDUM
Changes (2006/12/11)
o New version (1.9) of memhfixc.sty
o New version (4.6) of mempatch.sty, adding spacing commands,
about a dozen new built-in chapterstyles, new trimmarks,
some minor new commands, and bug fixes.
o New version of memmanadd.pdf
o NO CHANGES TO THE USER MANUAL
Changes (2006/08/09)
o New version 4.5 of mempatch.sty
o New version memmanadd.pdf
Changes (2005/09/25)
o New version of memoir.dtx which will generate the new
version v1.618 of memoir.cls, the *.clo files (which are unchanged),
and the basic.gst configuration file for MakeIndex to support
memoir's glossary code.
o Memoir.cls v1.618 incorporates all the patches from mempatch.sty
v3.12, and includes a code set for making glossaries.
o New version 4.0 of mempatch.sty (contains no code)
o New version of memmanadd.pdf
o NO CHANGES TO THE USER MANUAL
Changes (2004/05/24)
o New version (v1.6) of memhfixc.sty (fix for subappendices)
o New version (v2.3d) of mempatch.sty (fix for boxedverbatim)
Changes (2004/04/26)
o New release (2.3 again but with some code) of mempatch.sty
Changes (2004/04/05)
o New version of memoir.dtx which will generate the new
version v1.61 of memoir.cls and the *.clo files with minor
fixes for extraneous spaces and footnotes. Incorporates
the patches from mempatch 2.2.
o New version 2.3 of mempatch.sty (contains no code)
o NO CHANGES TO THE USER MANUAL
Changes (2004/03/01)
o New version 2.2 of mempatch.sty (fix indent after verbatim)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2004/02/11)
o New version 2.1 of mempatch.sty (fix for use of \linespread)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2004/01/31)
o New version of memoir.dtx which will generate the new
version v1.6 of memoir.cls incorporating all earlier patches
o New version v2.0 of mempatch.sty (which does nothing)
o New edition of the manual, incorporating all the material from
the Addendum, which is no more
Changes (2003/11/16)
o New version 1.9 of mempatch.sty (major extensions for typesetting
arrays and tabulars; hung paragraphs; reduced moans about using
deprecated font commands; bug fixes)
o New version of the Addendum (memmanadd.pdf)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/09/16)
o New version 1.8 of mempatch.sty (major extensions to footnoting,
e.g., multiple styles and multiple series; a `fixed marginpar';
and bug fixes)
o New version of the Addendum (memmanadd.pdf)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/07/23)
o New version 1.7 of mempatch.sty (improved odd/even page checking,
spacing in the bibliography, minor tweaks with the article option,
and bug fixes)
o New version of the Addendum (memmanadd.pdf)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/06/28)
o New version 1.6 of mempatch.sty (improved odd/even page checking,
page layout, and bug fixes)
o New version of the Addendum (memmanadd.pdf)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/04/28)
o New version 1.5 of mempatch.sty (improved frame boxes, footnotes,
and bug fixes)
o New version of the Addendum (memmanadd.pdf)
o APART FROM THIS FILE, NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/02/20)
o New version 1.3 of memhfixc.sty (fixes an appendices/hyperref problem)
o New version of the Addendum (mammanadd.pdf) with description of footnote styling
o NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/02/13)
o Reference sections, etc., by name as well as by number
o Now 3 `need space' macros
o New macros for `slash' fractions (fractions like 6/19)
o Use of \footnote in titling macros (e.g., \author) ignored
o New version 1.4 of mempatch.sty
o New version 1.2 of memhfixc.sty
o New version of the Addendum (memmanadd.pdf)
o NO CHANGES TO ANY OTHER DOCUMENTS
Changes (2003/01/22)
o Second optional argument to \section, etc, for page header text
o Formatting of numbers --- cardinals and ordinals, numeric and spelled out
o Better cooperation with natbib, chapterbib, nameref packages
o New version 1.3 of mempatch.sty
o New version 1.1 of memhfixc.sty
o New version of the Addendum
Changes in version 1.3a of memoir.cls (2002/11/22)
o Fixed nasty figure/table numbering gremlin that couldn't be done by
the patch file
Changes in version 1.3 of memoir.cls (2002/11/14)
o More flexibility in defining chapter styles, and the appearance of
chapter and part listings in the ToC
o \tableofcontents and friends can be used multiple times
o Major extensions for indexing, including multiple indexes
o Major extensions to the trim marks
o Can do N of M page numbering
o Added automatic inclusion of a patch file
o No change to the User Manual, but the Addendum has been revised
Changes in version 0.2a of mem12.clo (2002/08/27)
o Fixed scriptsize bug
Changes in version 1.2 (2002/08/10)
o Incorporated all fixes from memfixb.sty that applied to version 1.1
o Minor changes to *.clo files
o Added 17pt class option
o Boxes that break over pages and/or contain verbatim text
o Several ways of dealing with verbatim text
o Convenient methods for file input and output
o Additional \provide... commands
o User-specified footnote configuration, and footnotes that can include
verbatim text
o Additional optional argument to \chapter and \chapter* for short
header texts
Changes in version 1.1 (2002/03/28)
o Incorporated all fixes from memfixa.sty that applied to version 1.0
o Minor change to *.clo files
o Native support for subfigures
o Fixed incompatability with the natbib package
o Additional facilities for verse typesetting
o Experimental marginpar-like extensions
o New edition of the user manual
Changes (2002/03/28)
o Removed memfixa.sty
Changes (2002/01/23)
o Added memfixa.sty to distribution to fix problem if the
showtrims option and the calc package are used together.
Changes in version 1.0 (2001/11/17)
o First public production release
o Support for tipped in illustrations
o Fine control over chapter pages
o Support for continous page numbering even if switching between
numbering systems (e.g., roman to arabic)
o Minor change to *.clo files
o Extended Part I of the manual, and more examples in Part II
Changes in version 0.33 (2001/08/31)
o Added controllable chapter spacing in LoF and LoT
o Fixed bug in \appendixpage
o Provided dictionary style headers for the Index (memman.(tex|ist))
Changes in version 0.32 (2001/08/03)
o Further fixes for old versions of the amsmath package
Changes in version 0.31 (2001/07/24)
o Companion chapterstyle typesets correctly on verso pages
o Fixed odd interaction with the amsmaths package
Changes in version 0.3 (2001/07/14)
o Simulation of the article class
o Addition of configurable titles
o Addition of configurable abstract environment
o Improved cooperation with the subfigure package
Changes in version 0.2 (2001/06/03)
o First public beta release
o Major improvements
Changes in version 0.1 (2001/05/20)
o First public experimental alpha release
-------------------------------------------------------------------
2009/08/23
Peter Wilson
herries dot press at earthlink dot net