From 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:49:07 +0000 Subject: doc/latex git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/ucthesis/README | 237 ++++++++++++++++++++++++ Master/texmf-dist/doc/latex/ucthesis/uctest.bib | 153 +++++++++++++++ Master/texmf-dist/doc/latex/ucthesis/uctest.tex | 127 +++++++++++++ 3 files changed, 517 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/ucthesis/README create mode 100644 Master/texmf-dist/doc/latex/ucthesis/uctest.bib create mode 100644 Master/texmf-dist/doc/latex/ucthesis/uctest.tex (limited to 'Master/texmf-dist/doc/latex/ucthesis') 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} -- cgit v1.2.3