new xelatex package fontwrap (8jun08)

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

14 files changed, 664 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/tufte-latex/History.txt b/Master/texmf-dist/doc/latex/tufte-latex/History.txt
new file mode 100644
index 00000000000..fb28daf9d80
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/History.txt
@@ -0,0 +1,61 @@
+== 2.0.0 / 2008-06-06
+
+* Added `sfsidenotes' option to set the sidenotes and captions in the sans
+  serif font.
+* Use the Palatino fonts if they're installed.
+* Created `marginfig' and `margintab' environments.
+* Added running heads.
+* Fixed the alignment of sidenote numbers.
+* Added \section and \subsection headings.
+* Uses the Bera Mono fonts if they're installed.
+* Added `symmetric' option to produce outside-margin sidenotes in two-sided
+  spreads.
+* Added `justified' option to set the text fully justified.
+* Rewrote sample-handout to illustrate the tufte-handout usage and serve as an
+  example of its features.
+
+== 1.2.3 / 2008-02-11
+
+* To remove References section from sample-handout.
+* Updated README.txt
+
+== 1.2.2 / 2008-02-09
+
+* Use footmisc package to set \footnotes as sidenotes
+* Use natbib package to set bibliography entries as sidenotes
+
+== 1.2.1 / 2007-10-21
+
+* To assure existing \footnotes become \sidenotes
+
+== 1.2.0 / 2007-10-20
+
+* Enhancements
+  * Added a4paper option (Kevin Godby)
+  * Have \margin{note,figure,table} use \@tufteh@marginfont
+* Bug fix
+  * \@tufteh@overhang typo in figure*, table*, and fullwidth environments (Kevin Godby)
+
+== 1.1.0 / 2007-10-18
+
+* To add some missing environments and commands:
+  * sidenote
+  * marginnote (no mark)
+  * marginfigure/table
+  * text-width figure/table (figure/table)
+  * page-width figure/table (figure*/table*)
+  * page-width environment (for custom minipage displays)
+* To namespace raggedright
+* To add margin font hook
+
+== 1.0.1 / 2007-09-24
+
+* To correct README instructions.
+
+== 1.0.0 / 2007-09-24
+
+* First public release
+
+== 0.1.0 / 2004-02-04
+
+* Birthday!
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/README b/Master/texmf-dist/doc/latex/tufte-latex/README
new file mode 100644
index 00000000000..741c5a32d3a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/README
@@ -0,0 +1,61 @@
+Hi,
+
+Welcome to the beginnings of Tufte LaTeX package to help you
+produce Tufte style handouts, reports, and notes.
+
+== Quick Start
+
+Try typesetting sample.tex with the following sequence
+of commands,
+
+ pdflatex sample-handout
+ bibtex   sample-handout
+ pdflatex sample-handout
+ pdflatex sample-handout
+
+The result should look like sample-handout.pdf.
+
+== Troubleshooting
+
+If you encounter errors of the form,
+
+ ! LaTeX Error: File `paralist.sty' not found.
+
+you will need to obtain missing packages from CTAN <http://ctan.org>.
+For package installation instructions and answers to many other
+questions, see the UK TeX FAQ,
+
+ http://www.tex.ac.uk/cgi-bin/texfaq2html?introduction=yes
+
+or search the news:comp.text.tex group via,
+
+ http://groups.google.com/group/comp.text.tex
+
+== Bugs/Features/Support
+
+For kudos, feature requests, patches, or support requests that you
+feel are /particular/ to this Tufte LaTeX package, i.e. not a general
+LaTeX issue, please use this project's issue tracker available at
+
+ http://tufte-latex.googlecode.com
+
+== Contributing
+
+Patches are most welcome via the issue tracker!  Submit a series of
+high quality patches, and you'll find yourself a developer on this project.
+
+== License
+
+Copyright 2007-2008 Bil Kleb, Bill Wood, and Kevin Godby
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy
new file mode 100644
index 00000000000..3d2ce8c9dc8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy
@@ -0,0 +1,25 @@
+import graph3;
+
+size(0,200);
+
+usepackage("palatino");
+usepackage("mathpazo");
+
+currentprojection=orthographic(4,6,3);
+
+real x(real t) {return cos(2pi*t);}
+real y(real t) {return sin(2pi*t);}
+real z(real t) {return t;}
+
+defaultpen(overwrite(SuppressQuiet));
+
+path3 p=graph(x,y,z,0,2.7,operator ..);
+bbox3 b=autolimits(min(p),max(p));
+aspect(b,1,1,1);
+
+xaxis(rotate(X)*"$x$",all=true,b,red,RightTicks(rotate(X)*Label,2,2));
+yaxis(rotate(Y)*"$y$",all=true,b,red,RightTicks(rotate(Y)*Label,2,2));
+zaxis("$z$",all=true,b,red,RightTicks);
+
+draw(p,Arrow);
+
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf
new file mode 100644
index 00000000000..b0b9116a041
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak
new file mode 100644
index 00000000000..3e781bd21e1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak
@@ -0,0 +1,43 @@
+\title{Hilbert Curves}
+\author{}
+\date{}
+
+\documentclass{tufte-handout}
+
+\usepackage{tikz}
+
+\usepackage[active,tightpage]{preview}
+\PreviewEnvironment{tikzpicture}
+\usetikzlibrary{lindenmayersystems,positioning}
+
+\begin{document}
+
+\pgfdeclarelindenmayersystem{Hilbert curve}{
+    \symbol{X}{\pgflsystemdrawforward}
+    \symbol{+}{\pgflsystemturnright} % Explicitly define + and - symbols.
+    \symbol{-}{\pgflsystemturnleft}
+    \rule{A -> +BX-AXA-XB+}
+    \rule{B -> -AX+BXB+XA-}
+}
+
+\def\scalefac{0.6}
+% Draw a hilbert curve of order n
+% Usage:
+%  \hilbertvurve[scale]{order}
+\newcommand\hilbertcurve[2][1]{
+\tikz \draw[scale=\scalefac*#1,rotate=90,lindenmayer system={Hilbert curve, axiom=A, order=#2,angle=90}]
+    lindenmayer system;
+}
+\maketitle
+
+\begin{figure}[h!]
+\begin{tikzpicture}[node distance=0cm,every path/.style={thin}]
+    \node[label={above:$n=1$}] (n1) {\hilbertcurve[18]{1}};
+    \node[label={above:$n=2$},right=of n1] (n2) {\hilbertcurve[6]{2}};
+    \node[label={above:$n=3$},right=of n2] (n3) {\hilbertcurve[2.6]{3}};
+    \node[label={above:$n=4$},right=of n3] (n4) {\hilbertcurve[1.2]{4}};
+    \node[label={above:$n=5$},right=of n4] (n5) {\hilbertcurve[0.58]{5}};
+\end{tikzpicture}
+\end{figure}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf
new file mode 100644
index 00000000000..737c921bef2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex
new file mode 100644
index 00000000000..dc30ec12893
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex
@@ -0,0 +1,72 @@
+% Draw Hilbert curves. 
+% Credits: Based on code by Marc van Dongen
+% See: http://www.fauskes.net/pgftikzexamples/hilbert-curve/
+\title{Hilbert Curves}
+\author{}
+\date{}
+
+\documentclass{tufte-handout}
+
+\usepackage{tikz}
+
+\usepackage[active,tightpage]{preview}
+\PreviewEnvironment{tikzpicture}
+\usetikzlibrary{positioning}
+
+\begin{document}
+
+\newdimen\HilbertLastX
+\newdimen\HilbertLastY
+\newcounter{HilbertOrder}
+
+\def\DrawToNext#1#2{%
+   \advance \HilbertLastX by #1
+   \advance \HilbertLastY by #2
+   \pgfpathlineto{\pgfqpoint{\HilbertLastX}{\HilbertLastY}}
+   % Alternative implementation using plot streams:
+   % \pgfplotstreampoint{\pgfqpoint{\HilbertLastX}{\HilbertLastY}}
+}
+
+% \Hilbert[right_x,right_y,left_x,left_x,up_x,up_y,down_x,down_y]
+\def\Hilbert[#1,#2,#3,#4,#5,#6,#7,#8] {
+  \ifnum\value{HilbertOrder} > 0%
+     \addtocounter{HilbertOrder}{-1}
+     \Hilbert[#5,#6,#7,#8,#1,#2,#3,#4]
+     \DrawToNext {#1} {#2}
+     \Hilbert[#1,#2,#3,#4,#5,#6,#7,#8]
+     \DrawToNext {#5} {#6}
+     \Hilbert[#1,#2,#3,#4,#5,#6,#7,#8]
+     \DrawToNext {#3} {#4}
+     \Hilbert[#7,#8,#5,#6,#3,#4,#1,#2]
+     \addtocounter{HilbertOrder}{1}
+  \fi
+}
+
+
+% \hilbert((x,y),order)
+\def\hilbert((#1,#2),#3){%
+   \advance \HilbertLastX by #1
+   \advance \HilbertLastY by #2
+   \pgfpathmoveto{\pgfqpoint{\HilbertLastX}{\HilbertLastY}}
+   % Alternative implementation using plot streams:
+   % \pgfplothandlerlineto
+   % \pgfplotstreamstart
+   % \pgfplotstreampoint{\pgfqpoint{\HilbertLastX}{\HilbertLastY}}
+   \setcounter{HilbertOrder}{#3}
+   \Hilbert[1mm,0mm,-1mm,0mm,0mm,1mm,0mm,-1mm]
+   \pgfusepath{stroke}%
+}
+
+\def\scalefac{1}
+\maketitle
+
+\begin{figure}[h!]
+\begin{tikzpicture}[node distance=0cm,every path/.style={thin}]
+    \node[label={above:$n=1$}] (n1) {\tikz[scale=\scalefac*18] \hilbert((0mm,0mm),1);};
+    \node[label={above:$n=2$},right=of n1] (n2) {\tikz[scale=\scalefac*6] \hilbert((0mm,0mm),2);};
+    \node[label={above:$n=3$},right=of n2] (n3) {\tikz[scale=\scalefac*2.6] \hilbert((0mm,0mm),3);};
+    \node[label={above:$n=4$},right=of n3] (n4) {\tikz[scale=\scalefac*1.2] \hilbert((0mm,0mm),4);};
+    \node[label={above:$n=5$},right=of n4] (n5) {\tikz[scale=\scalefac*0.58] \hilbert((0mm,0mm),5);};
+\end{tikzpicture}
+\end{figure}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png b/Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png
new file mode 100644
index 00000000000..2f1c324e679
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png b/Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png
new file mode 100644
index 00000000000..d9509bc791d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy
new file mode 100644
index 00000000000..6904735a10f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy
@@ -0,0 +1,16 @@
+import graph;
+
+usepackage("palatino");
+usepackage("mathpazo");
+
+size(7inches,3inches);
+scale(true);
+
+real f(real x) { return sin(x); }
+pair F(real x) { return (x, f(x)); }
+
+xaxis("$x$");
+yaxis("$y$");
+
+draw(graph(f,-10.,10,operator ..), red);
+
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf
new file mode 100644
index 00000000000..94331fabb79
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib
new file mode 100644
index 00000000000..81715a5dd0c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib
@@ -0,0 +1,57 @@
+@BOOK{Tufte2006,
+	author = {Edward R. Tufte},
+	title = {Beautiful Evidence},
+	year = {2006},
+	publisher = {Graphics Press, {LLC}},
+	month = {May},
+	edition = {First},
+	place = {Cheshire, Connecticut},
+	isbn = {0961392177}
+}
+
+@BOOK{Tufte2001,
+	author = {Edward R. Tufte},
+	title = {The Visual Display of Quantitative Information},
+	publisher = {Graphics Press},
+	year = {2001},
+	address = {Cheshire, Connecticut},
+	isbn = {0961392142}
+}
+
+@BOOK{Tufte1990,
+	author = {Edward R. Tufte},
+	title = {Envisioning Information},
+	publisher = {Graphics Press},
+	year = {1990},
+	address = {Cheshire, Connecticut},
+	isbn = {0961392118}
+}
+
+@BOOK{Tufte1997,
+	author = {Edward R. Tufte},
+	title = {Visual Explanations},
+	publisher = {Graphics Press},
+	year = {1997},
+	address = {Cheshire, Connecticut},
+	isbn = {0-9613921-2-6}
+}
+
+@BOOK{Bringhurst2005,
+	author = {Robert Bringhurst},
+	title = {The Elements of Typography},
+	publisher = {Hartley \& Marks},
+	year = {2005},
+	edition = {3.1},
+	isbn = {0-88179-205-5}
+}
+
+@BOOK{Mittelbach2004,
+	author = {Frank Mittelbach and Michel Goossens},
+	title = {The \LaTeX\ Companion},
+	publisher = {Addison--Wesley},
+	year = {2004},
+	edition = {Second},
+	isbn = {0-201-36299-6}
+}
+
+
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf
new file mode 100644
index 00000000000..c6eae315520
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf
diff --git a/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex
new file mode 100644
index 00000000000..d4e56b2ce77
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex
@@ -0,0 +1,329 @@
+\documentclass{tufte-handout}
+
+\usepackage{amsmath}
+
+% Set up the images/graphics package
+\usepackage{graphicx}
+\setkeys{Gin}{width=\linewidth,totalheight=\textheight,keepaspectratio}
+\graphicspath{{graphics/}}
+
+\usepackage{mcaption} % FIXME move to .cls file
+
+%\title{An Example of the Usage of the Tufte-Handout Style\thanks{Inspired by Edward~R. Tufte!}}
+\title{An Example of the Usage of the Tufte-Handout Style}
+\author{The Tufte-\LaTeX\ Developers}
+%\date{22 February 2008}  % if the \date{} command is left out, the current date will be used
+
+\usepackage{helvet}
+
+% The following package makes prettier tables.  We're all about the bling!
+\usepackage{booktabs}
+
+% The units package provides nice, non-stacked fractions and better spacing
+% for units.
+\usepackage{units}
+
+% The fancyvrb package lets us customize the formatting of verbatim
+% environments.  We use a slightly smaller font.
+\usepackage{fancyvrb}
+\fvset{fontsize=\normalsize}
+
+\usepackage{multicol}
+
+\usepackage[savepos]{zref}
+
+\usepackage{lipsum}
+
+\usepackage{url}
+\urldef{\asyurl}\url{http://asymptote.sf.net/}
+
+\begin{document}
+
+\maketitle % this prints the handout title, author, and date
+
+\begin{abstract}
+\noindent This document describes the Tufte handout \LaTeX\ document style.
+It also provides examples and comments on the style's use.
+\end{abstract}
+
+%\printclassoptions
+
+The \Verb|tufte-handout| document class defines a style similar to the
+style Edward Tufte uses in his books and handouts.  Tufte's style is known
+for its extensive use of sidenotes, tight integration of graphics with
+text, and well-set typography.  This document aims to be at once a
+demonstration of the features of the \Verb|tufte-handout| document class
+and a style guide to its use.
+
+\section{Page Layout}\label{sec:page-layout}
+\subsection{Headings}\label{sec:headings}
+This style provides \textsc{a}- and \textsc{b}-heads (that is,
+\Verb|\section| and \Verb|\subsection|) demonstrated above.
+
+If you need more than two levels of section headings, you'll have to define
+them yourself at the moment;\sidenote{See see ``Defining new sections'' on
+page~\pageref{sec:defining-sections} for help with defining more heading
+levels.} there are no pre-defined styles for anything below a
+\Verb|\subsection|.  As Bringhurst points out in \textit{The Elements of
+Typographic Style},\cite{Bringhurst2005} you should ``use as many levels of
+headings as you need: no more, and no fewer.''
+
+The Tufte-handout class will emit an error if you try to use
+\Verb|\subsubsection| and smaller headings.
+
+%\medskip
+%\begin{fullwidth}
+%\begin{Verbatim}
+%! Package tufte-handout Error: \subsubsection is undefined by this class.
+%(tufte-handout)                See Robert Bringhurst's _The Elements of 
+%(tufte-handout)                Typographic Style_, section 4.2.2. 
+%(tufte-handout)                \subsubsection was used.
+%\end{Verbatim}
+%\end{fullwidth}
+%\medskip
+
+% let's start a new thought -- a new section
+\newthought{In his later books},\cite{Tufte2006} Tufte
+starts each section with a bit of vertical space, a non-indented paragraph,
+and sets the first few words of the sentence in \textsc{small caps}.  To
+accomplish this using this style, use the \Verb|\newthought| command:  
+
+\Verb|\newthought{In his later books}, Tufte starts|\ldots
+
+\subsection{Sidenotes}\label{sec:sidenotes}
+One of the most prominent and distinctive features of this style is the
+extensive use of sidenotes.  There is a wide margin to provide ample room
+for sidenotes and small figures.  Any \Verb|\footnote|s will automatically
+be converted to sidenotes.\footnote{This is a sidenote that was entered
+using the \texttt{\textbackslash footnote} command.}  If you'd like to place ancillary
+information in the margin without the sidenote mark (the superscript
+number), you can use the \Verb|\marginnote| command.\marginnote{This is a
+margin note.  Notice that there isn't a number preceding the note, and
+there is no number in the main text where this note was written.}
+
+\subsection{References}
+References are placed alongside their citations as sidenotes,
+as well.  This can be accomplished using the normal \Verb|\cite|
+command.\footnote{The first paragraph of this document includes a citation.}
+
+The complete list of references may also be printed automatically by using
+the \Verb|\bibliography| command.  (See the end of this document for an
+example.)  If you do not want to print a bibliography at the end of your
+document, use the \Verb|\nobibliography| command in its place.  
+
+To enter multiple citations at one
+location,\cite{Tufte2006}\cite{Tufte1990} you will need to use multiple
+\Verb|\cite| commands: \Verb|\cite{Tufte2006}| \Verb|\cite{Tufte1990}|.  Each
+\Verb|\cite| command will generate its own sidenote and its own sidenote
+number. 
+
+
+\section{Figures and Tables}\label{sec:figures-and-tables}
+Images and graphics play an integral role in Tufte's work.
+In addition to the standard \Verb|figure| and \Verb|tabular| environments,
+this style provides special figure and table environments for full-width
+floats.
+
+Full page width figures and tables may be placed in \texttt{figure*} or
+\texttt{table*} environments.  To place figures or tables in the margin,
+use the \Verb|marginfigure| or \Verb|margintable| environments as follows
+(see figure~\ref{fig:marginfig}):
+\begin{marginfigure}
+  \includegraphics[width=\marginparwidth]{helix}
+  \caption{This is a margin figure.  The helix is defined by 
+    $x = \cos(2\pi z)$, $y = \sin(2\pi z)$, and $z = [0, 2.7]$.  The figure was
+    drawn using Asymptote (\asyurl).}
+  \label{fig:marginfig}
+\end{marginfigure}
+\begin{Verbatim}
+\begin{marginfigure}
+  \includegraphics{blah}
+  \caption{This figure is in the margin.}
+\end{marginfigure}
+\end{Verbatim}
+
+
+Figure~\ref{fig:fullfig} is an example of the \Verb|figure*|
+environment and figure~\ref{fig:textfig} is an example of the normal
+\Verb|figure| environment.
+\begin{figure*}
+  \includegraphics{sine.pdf}
+  \caption{This graph shows $y = \sin x$ from about $x = [-10, 10]$.
+  \emph{Notice that this figure takes up the full page width.}}
+  \label{fig:fullfig}
+  \zsavepos{pos:fullfig}
+\end{figure*}
+
+\begin{figure}
+  \includegraphics{hilbertcurves.pdf}
+  \caption{Hilbert curves of various degrees $n$.
+  \emph{Notice that this figure only takes up the main textblock width.}}
+  \label{fig:textfig}
+  \zsavepos{pos:textfig}
+\end{figure}
+
+Table~\ref{tab:normaltab} shows table created with the \texttt{booktabs}
+package.  Notice the lack of vertical rules---they serve only to clutter
+the table's data.
+
+\begin{table}[ht]
+  \centering
+  \begin{tabular}{ll}
+    \toprule
+    Margin & Length \\
+    \midrule
+    Paper width & \unit[8\nicefrac{1}{2}]{inches} \\
+    Paper height & \unit[11]{inches} \\
+    Textblock width & \unit[6\nicefrac{1}{2}]{inches} \\
+    Textblock/sidenote gutter & \unit[\nicefrac{3}{8}]{inches} \\
+    Sidenote width & \unit[2]{inches} \\
+    \bottomrule
+  \end{tabular}
+  \caption{Here are the dimensions of the various margins used in the Tufte-handout class.}
+  \label{tab:normaltab}
+  \zsavepos{pos:normaltab}
+\end{table}
+
+\section{Full-width text blocks}
+
+In addition to the new float types, there is a \texttt{fullwidth}
+environment that stretches across the main text block and the sidenotes
+area.
+
+\begin{Verbatim}
+\begin{fullwidth}
+Lorem ipsum dolor sit amet...
+\end{fullwidth}
+\end{Verbatim}
+
+\begin{fullwidth}
+\small\itshape\lipsum[1]
+\end{fullwidth}
+
+\section{Typography}\label{sec:typography}
+
+\subsection{Typefaces}\label{sec:typefaces}
+If the Palatino and Bera Mono typefaces are installed, this style will use
+them automatically.  Otherwise, we'll fall back on the Computer Modern
+typefaces.
+
+\subsection{Letterspacing}\label{sec:letterspacing}
+This document class includes two new commands and some improvements on
+existing commands for letterspacing.
+
+When setting strings of \allcaps{ALL CAPS} or \smallcaps{small caps}, the
+letterspacing---that is, the spacing between the letters---should be
+increased slightly.\cite{Bringhurst2005}  The \Verb|\allcaps| command has proper letterspacing for
+strings of \allcaps{FULL CAPITAL LETTERS}, and the \Verb|\smallcaps| command
+has letterspacing for \smallcaps{small capital letters}.  These commands
+will also automatically convert the case of the text to upper- or
+lowercase, respectively.
+
+The \Verb|\textsc| command has also been redefined to include
+letterspacing.  The case of the \Verb|\textsc| argument is left as is,
+however.  This allows one to use both uppercase and lowercase letters:
+\textsc{The Initial Letters Of The Words In This Sentence Are Capitalized.}
+
+
+\section{Customization}\label{sec:customization}
+\subsection{Document class options}\label{sec:options}
+The \Verb|tufte-handout| class is based on the \LaTeX\ \Verb|article|
+document class.  Therefore, you can pass any of the typical article
+options.  There are a few options that are specific to the
+\Verb|tufte-handout| document class, however.
+
+The \Verb|a4paper| option will set the paper size to \smallcaps{A4} instead of
+the default \smallcaps{US} letter size.
+
+The \Verb|sfsidenotes| option will set the sidenotes in a \textsf{sans
+serif} typeface instead of the default roman.
+
+The \Verb|twoside| option will modify the running heads so that the page
+number is printed on the outside edge (as opposed to always printing the page
+number on the right-side edge in \Verb|oneside| mode).  
+
+The \Verb|symmetric| option typesets the sidenotes on the outside edge of
+the page.  This is how books are traditionally printed, but is contrary to
+Tufte's book design which sets the sidenotes on the right side of the page.
+This option implicitly sets the \Verb|twoside| option.
+
+The \Verb|justified| option sets all the text fully justified (flush left
+and right).  The default is to set the text ragged right.  
+The body text of Tufte's books are set ragged right.  This prevents
+needless hyphenation and makes it easier to read the text in the slightly
+narrower column.
+
+\subsection{Defining new sections}\label{sec:defining-sections}
+As mentioned on page~\pageref{sec:headings}, the \Verb|tufte-handout|
+document class only defines \Verb|\section| and \Verb|\subsection|
+headings.  
+
+If you wanted to define, say, a \Verb|\paragraph| heading, you could do it
+as follows:
+
+\begin{Verbatim}
+\makeatletter
+\renewcommand\paragraph{\@startsection{paragraph}% the name of the new section
+  {4}% the section level number
+  {0em}% indentation amount
+  {\baselineskip}% amount of space to leave before heading
+  {-1.5em}% amount of space to leave after heading
+  {\normalfont\itshape}% style
+}
+\makeatother
+\end{Verbatim}
+
+Place that code in the preamble of your document and you'll now be able to use
+\Verb|\paragraph|.  
+
+For more details on defining section levels, see \textit{The \LaTeX\
+Companion},\cite{Mittelbach2004} or use the \Verb|titlesec| package.
+
+
+\section{Installation}\label{sec:installation}
+To install the \Verb|tufte-handout| class, simply drop the
+\Verb|tufte-handout.cls| file into the same directory as your \Verb|.tex|
+file.
+
+% TODO add instructions for installing it globally
+
+
+\section{Support}\label{sec:support}
+
+\subsection{Package Dependencies}\label{sec:dependencies}
+The following is a list of packages that the \Verb|tufte-handout| document
+class relies upon.  Packages marked with an asterisk are optional.
+\begin{multicols}{2}
+\begin{itemize}
+  \item geometry
+  \item ragged2e
+  \item chngpage
+  \item paralist
+  \item textcase
+  \item footmisc
+  \item natbib and bibentry
+  \item placeins
+  \item caption
+  \item fancyhdr 
+  \item microtype*
+  \item soul*
+  \item palatino*
+  \item beramono*
+\end{itemize}
+\end{multicols}
+
+\subsection{Tufte-\LaTeX\ Website}\label{sec:website}
+The website for the Tufte-\LaTeX\ packages is located at
+\url{http://code.google.com/p/tufte-latex/}.  On our website, you'll find
+links to our \smallcaps{svn} repository, mailing lists, bug tracker, and documentation.
+
+
+\bibliography{sample-handout}
+\bibliographystyle{plainnat}
+
+%\section{Float Positions---DEBUG}
+%Full figure: $x=\zposx{pos:fullfig}$, $y=\zposy{pos:fullfig}$
+%Text figure: $x=\zposx{pos:textfig}$, $y=\zposy{pos:textfig}$
+%Normal table: $x=\zposx{pos:normaltab}$, $y=\zposy{pos:normaltab}$
+
+\end{document}