memoir update (27jan09)

git-svn-id: svn://tug.org/texlive/trunk@11997 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 117 insertions, 3 deletions

diff --git a/Master/texmf-dist/doc/latex/memoir/README b/Master/texmf-dist/doc/latex/memoir/README
index 4ffba1fa0cf..c0164884cb8 100644
--- a/Master/texmf-dist/doc/latex/memoir/README
+++ b/Master/texmf-dist/doc/latex/memoir/README
@@ -7,7 +7,7 @@ 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 FASER AND BETTER ANSWERS THAN IF YOU EMAIL ME DIRECTLY
+YOU ARE LIKELY TO GET FASTER AND BETTER ANSWERS THAN IF YOU EMAIL ME DIRECTLY
 AS I AM AWAY MORE OFTEN THAN NOT.
 
     NOTE: In order to provide fixes for any problems that may arise
@@ -40,6 +40,120 @@ o Backmatter:
     Command glossary                                    ~  40 pages
     Bibliography, indexes                               ~  50 pages
 
+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
@@ -292,7 +406,7 @@ o First public experimental alpha release
 
 ------------------------------------------------------------------- 
   Author: Peter Wilson (Herries Press) herries dot press at earthlink dot net
-  Copyright 2001--2005 Peter R. Wilson
+  Copyright 2001--2009 Peter R. Wilson
  
   This work may be distributed and/or modified under the
   conditions of the LaTeX Project Public License, either
@@ -383,6 +497,6 @@ o Print the manual
   
 
 
-2008/08/23
+2009/01/25
 Peter Wilson
 herries dot press at earthlink dot net