doc/latex

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

3 files changed, 517 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/ucthesis/README b/Master/texmf-dist/doc/latex/ucthesis/README
new file mode 100644
index 00000000000..330fc20ea31
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ucthesis/README
@@ -0,0 +1,237 @@
+This is the README file for the UCTHESIS class for LaTeX.  It
+corresponds to version 3.2 of the UCTHESIS class (19 December 2004).
+This README is public domain.
+
+The only change from 3.1 to 3.2 is to clarify the license as LPPL, per
+Daniel Gildea.  3.2 was prepared by Karl Berry.
+Version 3.1 was prepared by Daniel Gildea.
+
+NOTE: v3.0 is the first LaTeX2e version of UCTHESIS.  It is now a
+class that runs in native LaTeX2e mode.  It is functionally identical
+to UCTHESIS.STY v2.7 released on 30 October 1994 by Ethan V. Munson.
+Other than changes for compatibility (mostly having to do with font
+selection), and option selection, very little modification has been
+done to the style.  As a result, there are probably cleaner ways to
+implement a number of features.  That will have to wait for the next
+release.  (BBF 10/31/94)
+
+========================
+Using the UCTHESIS class
+========================
+
+Sample File
+-----------
+
+There is a sample dissertation (by the fictitious, but very
+irritating, Perry H Disdainful) in the file uctest.tex.  It also uses
+uctest.bib as its bibliography database (though the contents of the
+database are not important).  Mostly this is useful as an example of
+how to produce the front matter.  If you don't understand LaTeX at
+all, this file might help you get started, but, since you're going to
+be writing a 100+ page document, you should invest the $20 in a copy
+of the LaTeX manual (by Leslie Lamport the original author of LaTeX).
+This has recently been updated for LaTeX2e.
+
+The LaTeX Companion, by Goossens, Mittelbach, and Samarin (who have been
+involved in developping and supporting the new version of LaTeX) is also quite
+good.  It gives a lot of useful information if you are going to be writing
+or modifying classes,  and gives a lot of additional information on commonly
+available style packages.  It's about $35.
+
+Choosing the UCTHESIS class
+---------------------------
+
+To use the UCTHESIS class, make sure that the ucthesis.cls file is on
+your TEXINPUTS search path and use the following command at the start
+of your input file:
+
+\documentclass{ucthesis}
+
+============================
+What the UCTHESIS class does
+============================
+
+The UCTHESIS class is a port of the UCTHESIS style version 2.7 (the
+final 2.09 release) to LaTeX2e.  The UCTHESIS style is a modified
+version of the standard LaTeX REPORT style that is accepted for use
+with University of California PhD dissertations and Masters theses.
+The available commands are almost identical to those of the REPORT style,
+so your best starting point for documentation is the LaTeX manual written
+by Leslie Lamport.
+
+The key features of the class are:
+
+1) The primary modification to the REPORT style is the use of
+pseudo-double-spacing, since the UC system's rules are still designed
+for typewriters.  This is achieved by increasing the \baselinestretch
+parameter to 1.37.  The \baselinestretch is returned to a
+single-spaced value of 1.00 for elements like tables, captions, and
+footnotes and for all displayed text (quote, quotation, and verse
+environments).  Unfortunately, this is done with a macro called \ssp
+which resets the font size to \normalsize.  In LaTeX 2.09 this seems
+to be unavoidable, but it makes it very hard to create tables in
+different font sizes.
+
+2) Margins are 1.5 inches on the left, 1.0 inches elsewhere.
+
+3) Uses 11 point by default; you can use the 10pt or 12pt options for
+those sizes.
+
+4) Page numbers are in the top right corner for all pages.
+
+5) Complete, correct front matter for UC dissertations can be
+generated.  If you are not a UC student, you should make sure that the
+front matter is OK with your school.
+
+Options
+---------------
+
+There are five primary options:
+
+The "draft" style uses single-spacing throughout the document.
+
+The "final" style uses the correct pseudo-double-spacing.  This option
+is the default and is redundant, but is included for symmetry.
+
+The "10pt", "11pt", and "12pt" styles set the default font size to the
+obvious value.  The "11pt" option is the default and thus is
+redundant, but is safe to use anyway.
+
+The options are selected on the \documentclass line, e.g.:
+
+\documentclass[10pt,draft]{ucthesis}
+
+Page Headers
+------------
+
+If you want to use page headers or footers other than the default
+ones, you should try using "headerfooter.sty" or "fancyheadings.sty".
+The myheadings pagestyle doesn't work well and there is no workaround.
+The headerfooter and fancyheadings styles are widely distributed, well
+documented, and easy to use.
+
+============
+Front matter
+============
+
+The other key service provided by this class is that it generates
+correct front matter (title page, approval page, abstract, etc.) with
+a failrly simple set of commands.  This facility could be a little
+easier, but compared to an earlier state of affairs, it's pretty
+slick.  The format of the front matter is specified quite explicitly
+in the document "Guidelines for Submitting a Doctoral Dissertation or
+Master's Thesis" distributed by the UC Berkeley Graduate Division.
+The current version of the class is based on the 2001 version of
+this document.  
+
+A complete example of the use of the front matter commands can be
+found in the sample dissertation distributed with the class.
+
+Declarations
+------------
+
+To use the front matter macros and environments, you must first
+declare a number of text strings:
+
+\title		Dissertation title
+\author		Your name as registered with UC (usually w/ full
+		middle name)
+\degreeyear	Year your dissertation will be granted
+\degreesemester	Semester (or quarter) your dissertation will be granted
+\degree		The title of your degree (e.g. Doctor of Philosophy)
+\chair		Title and name of your committee chair
+		(e.g. "Professor Michael A. Harrison")
+\othermembers	The names of the other members of your committee
+		separated by linebreaks
+		(e.g. "Professor Susan L. Graham\\Professor Jim Pitman)
+\numberofmembers The number of members on your committee.  This defaults to
+		3 (and thus is optional) and can be any value between
+		3 and 6.  It affects the number of lines on the approval
+		page and the space between them.
+\prevdegrees	Your previous degrees
+		"B.A. (University of California, San Diego) 1978\\
+		B.A. (University of California, San Diego) 1986\\
+		M.S. (University of California, Berkeley) 1989"
+\field		The official title of your field.  This is usually
+		your department's name, but at Berkeley, most
+		Engineering degrees have a more complex name.
+		Be sure to check the guidelines for any special
+		twists on the name of your field.
+\campus		The name of your UC campus.  This should be capitalized.
+		(e.g. Berkeley)
+
+Title, Approval, and Copyright pages
+------------------------------------
+
+The title, approval, and copyright pages have extremely rigid formats
+that allow them to be generated automatically once the above
+declarations have been made.  To generate them, invoke the macros
+
+	\maketitle
+	\approvalpage
+	\copyrightpage
+
+You should probably invoke them in that order, because that's the
+order required by the guidelines.
+
+Abstract Environment
+--------------------
+
+Because you have to provide the text of the abstract, only the title
+can be generated automatically.  So, there is an abstract environment.
+It generates the title and numbers the abstract in arabic numerals and
+makes sure that it starts on new page.
+
+The UC system requires that your advisor sign the last page of your
+abstract.  Many students just let their advisor just sign at a random
+location on the page, but you can use the \abstractsignature command
+to generate a signature line with your advisor's name printed below
+it.  This command generates the signature line at the point it is
+invoked, so it should be placed at the end of the abstract.
+
+Other Front Matter
+------------------
+
+The remaining front matter (dedication, table of contents, lists of
+figures and tables, acknowledgements) MUST be put inside the
+"frontmatter" environment, which ensures that page-numbering is
+handled properly.  Within this frontmatter environment, you put the
+environments and commands for the rest of the front matter.  There are
+environments for "dedication" and "acknowledgements" and the standard
+LaTeX commands for producing \tableofcontents, \listoffigures, and
+\listoftables.  
+
+The standard LaTeX commands are well documented in the LaTeX manual.
+You will probably have to hand edit the .lof (list of figures) and
+.lot (list of tables) files to make verbose captions more suitable for
+this front matter.  Once you do this, remember to use the \nofiles
+macro to keep them from getting overwritten.
+
+The acknowledgements and dedication environments make their contents
+start on a new page.  The acknowledgements environment also put the
+word "Acknowledgements" in large, bold, centered text at the top of
+the page.  For formatting the dedication page, you're on your own.
+After all, the dedication is a kind of poetry and there's no
+predicting the right way to format poetry.
+
+=====================================================
+Other commands not found in the standard report style
+=====================================================
+
+The "smalltabular" and "smalltabular*" environments are equivalent to
+the "tabular" and "tabular*" environments, except that they use the
+\small font.  The "scriptsizetabular" and "scriptsizetabular*" use the
+\scriptsize font.
+
+=============================
+Installing the UCTHESIS class
+=============================
+
+To install the UCTHESIS class, you need to install four files:
+
+	ucthesis.cls
+	uct10.clo
+	uct11.clo
+	uct12.clo
+
+in your LaTeX class file repository.
diff --git a/Master/texmf-dist/doc/latex/ucthesis/uctest.bib b/Master/texmf-dist/doc/latex/ucthesis/uctest.bib
new file mode 100644
index 00000000000..ac07311bce1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ucthesis/uctest.bib
@@ -0,0 +1,153 @@
+%% uctest.bib 11/3/94
+%% Copyright (C) 1988-2004 Daniel Gildea, BBF, Ethan Munson.
+%
+% 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 this 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/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+% 
+% The Current Maintainer of this work is Daniel Gildea.
+
+@BOOK{knuth:tex,
+	AUTHOR = "Donald E. Knuth",
+	TITLE = "The {\TeX} Book",
+	PUBLISHER = {Addison-Wesley},
+	YEAR = "1984",
+	ADDRESS = {Reading, Massachusetts},
+	NOTE = {Reprinted as Vol. A of {\it Computers \& Typesetting\/}, 1986}
+}
+
+@BOOK{knuth:pgm,
+	AUTHOR = "Donald E. Knuth",
+	TITLE = "{\TeX}: The Program",
+	PUBLISHER = {Addison-Wesley},
+	YEAR = "1986",
+	VOLUME = {B},
+	SERIES = {Computers \& Typesetting},
+	ADDRESS = {Reading, Massachusetts}
+}
+
+@TECHREPORT{knuth:web,
+	AUTHOR = {Donald E. Knuth},
+	TITLE = {The {WEB} System for Structured Documentation, Version 2.3},
+	INSTITUTION = {Computer Science Department, Stanford University},
+	YEAR = {1983},
+	NUMBER = {STAN-CS-83-980},
+	ADDRESS = {Stanford, California},
+	MONTH = Sep
+}
+
+@ARTICLE{knuth:lp,
+	AUTHOR = {Donald E. Knuth},
+	TITLE = {Literate Programming},
+	JOURNAL = {The Computer Journal},
+	YEAR = {1984},
+	VOLUME = {27},
+	NUMBER = {2},
+	PAGES = {97--111},
+	MONTH = May
+}
+
+@TECHREPORT{knuth:tor,
+	AUTHOR = {Donald E. Knuth},
+	TITLE = {A Torture Test for {\TeX}, Version 1.3},
+	INSTITUTION = {Computer Science Department, Stanford University},
+	YEAR = {1984},
+	NUMBER = {STAN-CS-84-1027},
+	ADDRESS = {Stanford, California},
+	MONTH = Nov
+}
+
+@ARTICLE{furuta:pctex,
+	AUTHOR = "Richard K. Furuta and Pierre A. MacKay",
+	TITLE = "Two {\TeX} Implementations for the {IBM PC}",
+	JOURNAL = "Dr. Dobb's Journal",
+	YEAR = "1985",
+	VOLUME = "10",
+	NUMBER = "9",
+	PAGES = "80--91",
+	MONTH = Sep
+}
+
+@TECHREPORT{des:tex,
+	AUTHOR = {Jacques D{\'e}sarm{\'e}nien},
+	TITLE = {How to Run {\TeX} in French},
+	INSTITUTION = {Computer Science Department, Stanford University},
+	YEAR = {1984},
+	NUMBER = {SATN-CS-1013},
+	ADDRESS = {Stanford, California},
+	MONTH = Aug
+}
+
+@TECHREPORT{samuel:tex,
+	AUTHOR = "Arthur L. Samuel",
+	TITLE = "First Grade {\TeX}: A Beginner's {\TeX} Manual",
+	INSTITUTION = {Computer Science Department, Stanford University},
+	YEAR = "1983",
+	NUMBER = "SATN-CS-83-985",
+	ADDRESS = {Stanford, California},
+	MONTH = Nov
+}
+
+@BOOK{lamport:latex,
+	AUTHOR = {Leslie Lamport},
+	TITLE = {{\LaTeX}: A Document Preparation System. User's Guide and
+		 Reference Manual},
+	PUBLISHER = {Addison-Wesley},
+	YEAR = {1986},
+	ADDRESS = {Reading, Massachusetts}
+}
+
+@BOOK{spivak:ams,
+	AUTHOR = {Michael D. Spivak},
+	TITLE = {The Joy of {\TeX}},
+	PUBLISHER = {American Mathematical Society},
+	YEAR = {1985}
+}
+
+@MANUAL{patashnik:bibtex,
+	TITLE = "Bib{\TeX}ing",
+	AUTHOR = "Oren Patashnik",
+	ORGANIZATION = {Computer Science Department, Stanford University},
+	ADDRESS = {Stanford, California},
+	MONTH = jan,
+	YEAR = "1988",
+	NOTE = {Available in the Bib{\TeX} release}
+}
+
+@MANUAL{patashnik:bibhax,
+	TITLE = {Designing Bib{\TeX} Styles},
+	AUTHOR = {Oren Patashnik},
+	ORGANIZATION = {Computer Science Department, Stanford University},
+	MONTH = jan,
+	YEAR = {1988}
+}
+
+@ARTICLE{fuchs:dvi0,
+	AUTHOR = "David Fuchs",
+	TITLE = "The Format of {\TeX}'s {DVI} Files Version 1",
+	JOURNAL = "TUGboat",
+	YEAR = "1981",
+	VOLUME = "2",
+	NUMBER = "2",
+	PAGES = "12--16",
+	MONTH = Jul
+}
+
+@ARTICLE{fuchs:dvi,
+	AUTHOR = "David Fuchs",
+	TITLE = "Device Independent File Format",
+	JOURNAL = "TUGboat",
+	YEAR = "1982",
+	VOLUME = "3",
+	NUMBER = "2",
+	PAGES = "14--19",
+	MONTH = Oct
+}
+
+
diff --git a/Master/texmf-dist/doc/latex/ucthesis/uctest.tex b/Master/texmf-dist/doc/latex/ucthesis/uctest.tex
new file mode 100644
index 00000000000..1fdf0b7866a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ucthesis/uctest.tex
@@ -0,0 +1,127 @@
+%% uctest.tex 11/3/94
+%% Copyright (C) 1988-2004 Daniel Gildea, BBF, Ethan Munson.
+%
+% 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 this 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/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+% 
+% The Current Maintainer of this work is Daniel Gildea.
+
+\documentclass[11pt]{ucthesis}
+\def\dsp{\def\baselinestretch{2.0}\large\normalsize}
+\dsp
+\begin{document}
+
+% Declarations for Front Matter
+
+\title{The Elements of Theses}
+\author{Perry H. Disdainful}
+\degreeyear{1994}
+\degreesemester{Spring}
+\degree{Doctor of Philosophy}
+\chair{Professor Ignatius Arrogant}
+\othermembers{Professor Ivory Insular\\
+Professor General Reference}
+\numberofmembers{3}
+\prevdegrees{B.A. (University of Northern South Dakota at Hoople) 1978\\
+M.S. (Ed's School of Quantum Mechanics and Muffler Repair Shop) 1989}
+\field{Aboriginal Basketry}
+\campus{Berkeley}
+
+\maketitle
+\approvalpage
+\copyrightpage
+
+\begin{abstract}
+Theses have elements.  Isn't that nice?
+
+\abstractsignature
+\end{abstract}
+
+\begin{frontmatter}
+
+\begin{dedication}
+\null\vfil
+{\large
+\begin{center}
+To myself,\\\vspace{12pt}
+Perry H. Disdainful,\\\vspace{12pt}
+the only person worthy of my company.
+\end{center}}
+\vfil\null
+\end{dedication}
+
+
+\tableofcontents
+\listoffigures
+\listoftables
+\begin{acknowledgements}
+I want to ``thank'' my committee, without whose ridiculous demands, I
+would have graduated so, so, very much faster.
+\end{acknowledgements}
+
+\end{frontmatter}
+
+\part{First Part}
+
+\chapter{Introduction}
+
+Every dissertation should have an introduction.  You might not realize
+it, but the introduction should introduce the concepts, backgrouand,
+and goals of the dissertation.
+
+\begin{table}
+\begin{tabular}{|l|r|}
+  \hline 
+Title & Author \\
+\hline
+War And Peace & Leo Tolstoy \\
+The Great Gatsby & F. Scott Fitzgerald \\ \hline
+\end{tabular}
+\caption{A normalsize table.  There has been a complaint that table
+captions are not single-spaced.  This is odd because the code
+indicates that they should be.}
+\end{table}
+
+\begin{table}
+\caption{A small table.}
+\begin{scriptsizetabular}{|l|r|}
+  \hline 
+Title & Author \\
+\hline
+War And Peace & Leo Tolstoy \\
+The Great Gatsby & F. Scott Fitzgerald \\ \hline
+\end{scriptsizetabular}
+\end{table}
+
+\chapter{Previous Work}
+
+Some other research was once performed.
+
+\begin{figure}
+\caption{A first figure.}
+\end{figure}
+
+\begin{figure}
+\caption{A second figure.}
+\end{figure}
+
+\chapter{Conclusion}
+
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{uctest}
+
+\appendix
+\chapter{Some Ancillary Stuff}
+
+Ancillary material should be put in appendices, which appear after the
+bibliography. 
+
+\end{document}