doc/latex

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

2 files changed, 850 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/gatech-thesis/README b/Master/texmf-dist/doc/latex/gatech-thesis/README
new file mode 100644
index 00000000000..cce6c58c4d9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gatech-thesis/README
@@ -0,0 +1,736 @@
+This is the README file for the GATECH-THESIS class for LaTeX.
+It corresponds to version 1.5 of the GATECH-THESIS class 
+(17 August 2002)
+
+Copyright (c) 2002 by Charles S. Wilson. All rights reserved.
+
+GATECH-THESIS may be obtained from any of the following locations:
+
+   http://www.grad.gatech.edu/thesis/index.html
+     this is where the official version, approved by the Georgia
+     Tech Office of Graduate Studies, may be found.  Do NOT
+     attempt to use the old, out-of-date, LaTeX2.09 style file
+     (gtthesis.sty) that is STILL on cyberbuzz.
+
+   http://www.neuro.gatech.edu/users/cwilson/gatech-thesis/
+	  the most recent version, plus archives of all past versions
+	  will always be here.
+
+   http://www.ctan.org/tex-archive/macros/latex/contrib/supported/gatech-thesis/
+     and of course, CTAN.
+
+This class file can be used with the LaTeX typesetting system
+to produce dissertations that adhere to Georgia Tech's guidelines
+for publishing.  
+
+There are a number of files within this archive.  The important
+ones are 
+
+   gatech-thesis.cls
+   gatech-thesis.bst
+   gatech-thesis-gloss.sty
+   gatech-thesis-losa.sty
+   gatech-thesis-losa.bst
+   gatech-thesis-index.sty
+   gatech-thesis-index.ist
+
+Everything else is fluff: examples, licensing, documentation...
+
+=============================
+Using the GATECH-THESIS class
+=============================
+
+First, read this file.  Then read COMPLIANCE.  Then read
+INSTALL.  Take a peek a NEWS, and then (maybe) CHANGES.
+Then you can worry about the examples...
+
+Sample File
+-----------
+
+example-thesis.tex + example-thesis.bib
+
+There is a sample dissertation (by the fictitious, but very
+irritating, Perry H Disdainful) in the file example-thesis.tex.  It 
+also uses example-thesis.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 in a copy of the LaTeX manual (by Leslie Lamport, the 
+original author of LaTeX). This has recently been updated for 
+LaTeX2e (1, below).
+
+The LaTeX Companion, by Goossens, Mittelbach, and Samarin (who have been
+involved in developing and supporting LaTeX2e) 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 (2, below).
+
+Helpful books (in no particular order): 
+  (1) "LaTeX: A Document Preparation System" by Leslie Lamport
+  (2) "The LaTeX Companion" by Goossens, Mittelbach, and Samarin
+  (3) "A Guide to LaTeX" by Helmut Kopka and Patrick Daly
+  (4) "LaTeX: Line by Line" by Antoni Diller
+  (5) "The LaTeX Graphics Companion"
+  (6) "The TeXbook" by Donald Knuth
+
+Larger Sample
+-------------
+
+julesverne/basic/*
+
+This is a slightly more complicated, multi-file example.  The text
+is taken from the first five chapters of Jules Verne's ``20,000 
+Leagues Under the Sea'' which is in the public domain and is freely 
+redistributable. This example can be built with either latex (to 
+generate a .dvi file) or with pdflatex (to generate a .pdf file). 
+
+Gory, all-the-bells-and-whistles example:
+------------
+
+julesverne/bellswhistles/*
+
+This directory contains a reworked version of the jules-verne
+example "thesis".  However, all of the bells and whistles 
+provided by the gatech-thesis.cls class and associated styles
+are exercised, along with some suggestions for thesis document 
+structuring.
+
+Features:
+  *)  segregating preamble code into a document-specific style
+  *)  How to easily generate OGS format complant documents
+      and prettier, "personal" copies.
+  *)  Support for using hyperref (clickable links in the TOC,
+      when making a .pdf)
+  *)  Using postscript versions of fonts other than Computer Modern,
+      like Times, Courier, etc.  See extensive comments in
+      jules-verne.sty.
+  *)  Using the listings package for including program code
+      in appendices
+  *)  Using the add-on style gatech-thesis-gloss.sty for 
+      generating a glossary
+  *)  Using the add-on style gatech-thesis-losa.sty for
+      generating a "List of Symbols or Abbreviations"
+  *)  Using the add-on style gatech-thesis-index.sty for 
+      generating an index.  Typically a GT thesis doesn't
+      have one of these, but the style is provided just in case.
+  *)  Demonstrate the multivolume support, for those theses that
+      are over 2.5" thick (according to OGS Guidelines).
+  *)  Using \include instead of \input to incorporate subsidiary
+      files into the main document.  This lets you use \includeonly
+      to speed development of your document.
+
+This example requires some additional work to prepare your LaTeX 
+system, before you can compile it.  See the local documentation,
+julesverne/bellswhistles/00README.
+
+Building the Examples
+---------------------
+
+To compile the examples, you must first install the gatech-thesis 
+files (see the INSTALL document).  Also, the bells-and-whistles 
+example needs some additional preparation; see its local documentation
+in julesverne/bellswhistels/00README.
+
+However, once you have all of the required items installed, you can
+build the simplest example by executing the following commands:
+
+latex example-thesis.tex
+bibtex example-thesis
+latex example-thesis.tex
+latex example-thesis.tex
+dvips example-thesis
+  (generates a postscript file)
+
+To build the other examples, run the DO_* scripts.  For instance,
+if you are using a unix or unix-like system, cd to the julesverne/basic
+directory and execute:
+
+  ./DO_postscript.sh
+  
+to generate a postscript output (or ./DO_pdf.sh to generate a pdf).
+If, on the other hand, you are on a DOS-ish system, the execute 
+instead the file
+
+  DO_postscript.bat
+
+(or DO_pdf.bat)  To understand what the scripts do (especially the
+ones in the julesverne/bellswhistles/ directory) you really ought
+to read thru them...
+
+Choosing the GATECH-THESIS class
+--------------------------------
+
+To use the GATECH-THESIS class, make sure that the gatech-thesis.cls 
+file is on your TEXINPUTS search path and use the following command 
+at the start of your input file:
+
+\documentclass{gatech-thesis}
+
+To insure that gatech-thesis.cls is on your TEXINPUTS search path, 
+you can copy it into your localtexmf tree and then update the file
+database; or you can place it into the same directory as your
+thesis .tex files themselves.  This is also described in the INSTALL
+document.
+
+=================================
+What the GATECH-THESIS class does
+=================================
+
+The GATECH-THESIS class builds on the the standard LaTeX REPORT class,
+and is accepted for use with Georgia Institute of Technology PhD 
+dissertations and Masters theses.  The available commands are almost 
+identical to those of the REPORT class, 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 class is the use of
+pseudo-double-spacing, since Georgia Tech's rules are still designed
+for typewriters.  This is achieved by increasing the \baselinestretch
+parameter to 1.33.  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).  
+
+2) Margins are 1.5" on left, 1" on top, right and bottom (headers & 
+footers 1/4" from body)
+
+3) Use 11 point by default; you can use the 10pt or 12pt options
+
+4) Page numbers are in the center at the bottom of the page
+
+5) Complete, correct front matter for Georgia Tech dissertations can
+be generated.
+
+Options
+---------------
+
+There are a number of primary options.  However, if called without
+any options, the approved format -- 11pt, letterpaper, oneside,
+doublespaced, normalmargins, final -- will be generated.
+
+
+Any standard option for the LaTeX2e `report' class, including
+`10pt', `11pt', `12pt', `oneside', `twoside', etc. is valid.
+
+`singlespaced', `oneandahalfspaced', or `doublespaced': 
+   Set the entire document's default line spacing, except for 
+   notes, which are single-spaced by default.
+
+`spacednotes':  Let the line spacing of notes be determined
+   by the line spacing of the main document, instead of being
+   forced single-spaced.
+
+`normalmargins', `narrowmargins', `widemargins', `extrawidemargins'
+   or `oldmargins':  normalmargins is the default and Georgia Tech-
+   approved format.  Oldmargins is the OLD Georgia Tech format. 
+
+`draft':  Produce a draft copy (10pt font, double-sided,
+   double-spaced, normal margins, with the word ``DRAFT'' printed
+   at all four corners of every page, and current date printed in
+   a running header).
+
+`final': style uses the correct pseudo-double-spacing.  This option
+   is the default and is redundant, but is included for symmetry.
+
+`hyperref': Indicates that the document will \usepackage{hyperref}.
+   This is a kludge, but I didn't want to explicitly *require*
+   hyperref, so we must indicate to gatech-thesis.cls whether it should
+   define certain hyperref commands as dummies.  ALWAYS use this
+   option if you use the hyperref package.  NEVER use this option if
+   you do not also use the hyperref package.
+
+The options are selected on the \documentclass line, e.g.:
+
+\documentclass[10pt,hyperref,draft]{gatech-thesis}
+
+Thus, the default options:
+   \documentclass[11pt,letterpaper,oneside,
+                  doublespaced,normalmargins,final]{gatech-thesis}
+will generate a document that conforms to the graduate studies office
+and is identical to setting no options at all
+   \documentclass{gatech-thesis}
+
+Page Headers
+------------
+
+If you want to use page headers or footers other than the default
+ones, you should try using ``fancyheadings.sty''.  It is easy to use,
+widely distributed, and well documented.  However, the default headers
+and footers are the Georgia Tech-approved ones.  There are also
+some interesting variations defined within the gatech-thesis.cls 
+itself (tcplain, gtthesis), but those should ONLY be used for personal 
+copies, and NOT for your official version.  See the 
+julesverne/bellswhistles example.
+
+============
+Front matter
+============
+
+The other key service provided by this class is that it generates
+correct front matter (title page, approval page, dedication, etc.) with
+a fairly simple set of commands.  The format of the front matter is 
+specified quite explicitly in the document ``Manual for Graduate Theses:
+Georgia Institute of Technology'' distributed by Office of Graduate 
+Studies.
+
+A complete example of the use of the front matter commands can be
+found in any of the examples distributed with the class 
+(example-thesis.tex or julesverne/basic or julesversion/bellswhistles).
+
+Declarations
+------------
+
+To use the front matter macros and environments, you must first
+declare a number of text strings within the preamble of your document 
+(that is, these must be declared BEFORE the \begin{document} command.)
+
+\title{...}         Dissertation title
+
+\author{...}        Your name as registered with Georgia Tech
+
+\department{...}    Specify the name of the graduate department.
+      \dept{...}    synonym
+
+\degree{...}        Title of your degree (e.g. ``Doctor of Philosophy'')
+
+\gradyear{...}      Year your degree will be granted
+\copyrightyear{...} synonym
+
+Any or all of the \*reader{}, \committeechair, or \principaladvis?r{}
+commands may be ommitted -- but your signature page will look a little
+silly if you don't include SOME names.
+
+\principaladvisor{...} Name of your thesis advisor
+\principaladviser{...} if you prefer advisor spelled with an e)
+
+\committeechair{...}   Name of your committee chairperson
+
+\firstreader{...}   Name of other committee member
+\secondreader{...}  Name of other committee member 
+\thirdreader{...}   Name of other committee member
+\fourthreader{...}  Name of other committee member
+\fifthreader{...}   Name of other committee member
+\sixthreader{...}   Name of other committee member
+
+\bibfiles{...}      List of files to use when generating a bibliography 
+
+\submitdate{...}    Specify the ``month year'' in which dissertation 
+                    submitted
+
+\linespacing{...}   Use this to override the default double-spacing.  
+                    NOT recommended; the default is approved by the 
+                    Graduate Studies Office.  For draft/personal copies,
+                    use the ``draft'' or ``singlespace'' options in your
+                    documentclass statement, instead.
+\spacing{...}       compatibility synonym
+
+Switches
+------------
+
+Also, there are a number of ``true/false'' flags that can be used to 
+control the frontmatter generation.  However, the defaults will result 
+in the approved Georgia Tech format.  These flags, if specified, should 
+also be in the document preamble (BEFORE the \begin{document} command).
+
+\titlepagetrue or \titlepagefalse
+     - produce or don't produce a title page (TRUE by default)
+
+\signaturepagetrue or \signaturepagefalse
+     - produce or don't produce a signature page (TRUE by default)
+
+\copyrighttrue or \copyrightfalse
+     - place or don't place a copyright notice on the title page 
+       (FALSE by default)
+
+\figurespagetrue or \figurespagefalse
+     - produce or don't produce a List of Figures page (TRUE by default)
+
+\tablespagetrue or \tablespagefalse
+     - produce or don't produce a List of Tables page (TRUE by default)
+
+\contentspagetrue or \contentspagefalse
+     - produce or don't produce a Table of Contents page 
+       (TRUE by default)
+
+\bibpagetrue or \bibpagefalse
+     - produce or don't produce a Bibliography page (TRUE by default)
+
+\thesisproposaltrue or \thesisproposalfalse
+     - indicate ``Thesis Proposal'' or ``Thesis'' on the title page 
+       (FALSE by default -- e.g. default is to say ``Thesis'')
+
+\dedicationheadingtrue or \dedicationheadingfalse
+     - display ``DEDICATION'' heading on the dedication page 
+       (FALSE by default)
+
+\strictmarginstrue or \strictmarginsfalse
+     - if true, then obey the margin rules EVEN on the title and 
+       signature page. Default TRUE and REQUIRED by Graduate Studies 
+       Office, but not very appealing.  (under ``oldmargins'' an extra 
+       50p spacing is added so that the title page looks like the 
+       chapter headings.  In any case, \strictmarginsfalse looks better 
+       for personal copies but \strictmarginstrue is necessary for 
+       official ones.
+
+\multivolumetrue or \multivolumefalse
+     - if true, indicates that the thesis will span multiple volumes. 
+       triggers automatic generation of the first volume title page
+       (in addition to the ``entire work'' title page), but it''s up
+       to you to place the ``part{}'' commands in the appropriate
+       locations for volume 2, volume 3, etc.
+
+Frontmatter Environments
+------------------------
+GATECH-THESIS provides a number of specialized environments for the
+various frontmatter sections.  Of course, you don't have to use them
+all.  The provided environments include
+  
+  dedication:        \begin{dedication}
+                     text here
+                     \end{dedication}
+
+  preface:           \begin{preface}
+                     text here
+                     \end{preface}
+
+  acknowledgements:  \begin{acknowledgements}
+                     text here
+                     \end{acknowledgements}
+
+  abstract:          \begin{abstract}
+                     text here
+                     \end{abstract}
+ 
+  summary:           \begin{summary}
+                     text here
+                     \end{summary}
+
+And if that isn't enough for you, you can add your own:
+   \prefacesection{other-title}{...text...}
+Note that these add-a-sections aren't true environments (they do not 
+have \begin{} and \end{} statements.  So, for a ``forward'' section:
+
+   \prefacesection{forward}{text here}
+
+The ``Preliminary'' environment
+-----------------------------
+
+ALL of these preceeding environments MUST be enclosed within the
+``preliminary'' environment, which ensures that page-numbering is 
+handled properly (e.g. no page number on the title page or signature
+page, use lower case roman numerals to number the frontmatter pages, 
+reset the page numbers to start with arabic 1).  Within this preliminary 
+environment, you put the environments and commands for the rest of 
+the front matter.
+
+Each environment makes its contents start on a new page.  They also 
+emblazon the first page with a heading -- all except for the dedication
+environment.  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.  Actually, that's not entirely true:
+according to the OGS Guidelines, the dedication material should be
+centered vertically, so your text will be automatically centered.  If 
+you wish to override this centerring behavior, just redefine the 
+dedicationtop and dedicationbottom commands:
+         \renewcommand{\dedicationtop}{\vspace*{\stretch{1}}
+         \renewcommand{\dedicationbottom{\vspace*{\stretch{3}}
+Will position your dedication at about 1/4 of the way down the page.
+Also, if you *want* an ugly ``DEDICATION'' heading emblazoned in
+bold centered letters at the top of the page, you can use the 
+\dedicationheadingtrue switch within the preamble.
+
+  \begin{preliminary}
+    The other environments go in here, along with
+    \contents
+  \end{preliminary}
+
+Table of Contents, Figures, and Tables
+--------------------------------------
+
+\contents
+
+At the appropriate point within the frontmatter, generate these tables 
+by issuing the \contents command.  You can modify the look of the Table 
+of Contents with the following commands -- which should be executed 
+within the \begin{preliminary}...\end{preliminary} environment (see 
+below) but before the \contents command.
+
+If you also want a ``List of Symbols or Abbreviations'', you can
+use the gatech-thesis-losa.sty add-on package: in your preamble, just
+  \usepackage{gatech-thesis-losa}
+  \losafiles{your-symbols-database}
+And then sprinkle references to your symbols or abbreviations 
+within your text.  Read the header in gatech-thesis-losa.sty itself 
+for more information, and see how the julesverne/bellswhistles/ 
+example does it (and don't forget to read the documenation on the 
+`gloss' package, which is used by gatech-thesis-losa.sty).  You 
+also will need to run `bibtex' on the LOSA database; see the above 
+documentation.
+
+If you want a Glossary or ``List of Nomenclature'', you can
+use the gatech-thesis-gloss.sty add-on package: in your preamble, just
+  \usepackage{gatech-thesis-gloss}
+  \glossfiles{glossary-database}
+And then sprinkle references to your glossary terms 
+within your text.  Read the header in gatech-thesis-gloss.sty itself 
+for more information, and see how the julesverne/bellswhistles/ 
+example does it (and don't forget to read the documenation on the 
+`gloss' package, which is used by gatech-thesis-gloss.sty).  You 
+also will need to run `bibtex' on the glossary database; see the above 
+documentation.
+
+\labelchaptersintableofcontents 
+   inserts an entry into the TOC that says ``CHAPTERS'' just 
+   before Chapter 1. Not recommended.
+
+\labelappendicesintableofcontents
+   inserts an entry into the TOC that says ``APPENDICES'' just 
+   before Appendix A. Not recommended.
+
+\setchaptertocdepth
+   set the default for how ``deep'' to number within chapters
+   in the table of contents.  Defaults to subsections.
+
+\setappendixtocdepth
+   set the default for how ``deep'' to number within appendices
+   (chapter{}'s after the \appendix command} in the table of
+   contents.  Defaults to Appendices only (no sections or subs)
+
+\settocdepth
+   temporarily change how ``deep'' to number in the table of 
+   contents for current chapter/section.  For example, you
+   usually include \section{}'s in the TOC (\setchaptertocdepth{1})
+   but in chapter 5 you want to include subsection as well:
+   \chapter{This is Chapter 5}\settocdepth{2}.  In chapter 6 the
+   default depth of 1 is reasserted.
+  
+You should never need to call \setcounter{tocdepth}{..} directly.
+
+Use the following numbers with the various tocdepth commands above:
+   0 = chapter only
+   1 = chapter + sections
+   2 = chapter, section, subsection
+   3 = chapter, section, subsection, subsubsection
+
+
+==========
+End matter
+==========
+
+Similarly, the end matter components (bibliography, vita, index, 
+afterward, etc) MUST be enclosed in a ``postliminary'' environment.
+
+GATECH-THESIS provides a few (okay, one) specialized environments for 
+the various endmatter sections, as well.
+  
+  vita:    \begin{vita}
+           text here
+           \end{vita}
+
+And you want other sections (afterword, index), you can add them:
+   \postfacesection{other-title}{...text...}
+Note that these add-a-sections aren't true environments (they do not 
+have \begin{} and \end{} statements.  So, for a ``afterword'' section:
+
+   \postfacesection{afterword}{text here}
+
+Additionally, if you want an index, you can use the add-on style
+gatech-thesis-index.sty.  Read the comments in that file, and 
+see how the julesverne/bellswhistles/ example does it.  Basically,
+you just include the following command in your preamble
+  \usepackage{gatech-thesis-index}
+and sprinkle \index commands within your text.  Don't forget to
+read the documentation on the `index' package, on which the
+gatech-thesis-index.sty is based.  And you'll need to run makeindex
+on the index database -- but that's all explained in the 
+documentation and demonstrated by the example.
+
+Bibliography
+------------
+
+Also, within the postliminary environment, you should issue the 
+  \references
+command in order to generate a bibliography in the Georgia Tech-approved
+format.  There are a few tricks to getting the \references command to 
+work properly, though:
+
+  \bibpagetrue
+  \bibfiles{file1,file2,...}
+
+must be set in the preamble.  (Actually, since bibpagetrue is the
+default, you don't ACTUALLY need to specify it -- but don't say 
+\bibpagefalse and expect \references to work.)  Also, 
+
+  \bibliographystyle{...} 
+
+should be specified just after \begin{document}.  Yes, it's a bit 
+confusing, but see the example files (example-thesis.tex,
+julesverne/basic/jules-verne.tex, or 
+julesverne/bellswhistles/jules-verne.sty) and all will be clear.
+
+The updated GSO Guidelines is no longer very specific about the format
+of bibliographic entries (although the example bibliography IS sorted).
+I know of one thesis that was accepted using the``plain'' bibstyle 
+(which generates a sorted [not order-of-reference] bibliography). Then,
+of course, there's the gatech-thesis.bst bibliography format, which
+has been approved by the GSO.  So, you'll want to use
+
+  \bibliographystyle{gatech-thesis}
+or
+  \bibliographystyle{plain}
+
+=========
+Main Body
+=========
+
+See any book on LaTeX's report class for more information, but the 
+following deserves special mention:
+
+``\appendix'' is a global mode switch that changes the way ``chapter'' 
+headings and TOC entries are generated.
+  \chapter{last chapter title}
+  \appendix
+  \chapter{first appendix title}
+Note that you use the ``\chapter'' command to indicate new appendices --
+but only after switching the ``mode'' with the \appendix command.
+
+=====================================================
+Other commands not found in the standard report style
+=====================================================
+
+The GATECH-THESIS class also provides several other helpful environments
+and commands.  These include
+
+ignore{...}  or   comment{...}
+     Ignore the part of the file between { and } (can include
+     paragraph breaks); useful for commenting out large blocks.
+
+\begin{longquote}...\end{longquote}:
+     Single-spaced version of the `quote' environment
+
+\begin{longquotation}...\end{longquotation}:
+     Single-spaced version of the `quotation' environment.
+
+\begin{singlespaced}...\end{singlespaced}:
+     Format single-spaced paragraphs.
+
+\begin{oneandahalfspaced}...\end{oneandahalfspaced}:
+     Format 1 1/2-spaced paragraphs.
+
+\begin{doublespaced}...\end{doublespaced}:
+     Format double-spaced paragraphs.
+
+\begin{newspacing}{<n>}...\end{newspacing}:
+     Format paragraphs with an interline spacing of `n'.
+
+\clearemptydoublepage, \clearplaindoublepage, \cleargtplaindoublepage:
+     Same as \cleardoublepage except that it sets the pagestyle of
+     any inserted blank page to `empty' `plain' or `gtplain', 
+     respectively.
+
+Modifying the look of the document
+----------------------------------
+
+There are also a number of commands that can be used to change the
+look.  However, the default ``look'' is the one approved by 
+Georgia Tech's Graduate Studies Office, so don't use these 
+``look-altering'' commands for your official versions -- only for 
+personal copies.
+
+\setbodypagestyle{x}, where x = plain (the default and OGS approved), 
+   empty, headings, myheadings, gtthesis, or tcplain.  Avoid myheadings; 
+   use the fancyheaders package instead.
+
+\setfrontpagestyle{x} - set pagestyle for frontmatter
+\setbackpagestyle{x}   - set pagestyle for endmatter
+    
+The Graduate Studies Office approved pagestyle is plain for 
+the body, as well frontmatter and endmatter.  (However, pages are 
+numbered with roman numberals in the frontmatter and automatically 
+switch to arabic numbers in the body and endmatter, as required by GSO. 
+Don't try to change the pagenumbering style).  However:
+
+   - `gtthesis' pagestyle adds a running header on each page 
+     identifying the Chapter (and Section for twopage layouts).
+     This is a nice touch IMO for the body and endmatter, but 
+     use it ONLY for personal copies.
+
+   - note that you also need to add \pagestyle{gtthesis}
+     if you use \setbodypagestyle{gtthesis}.  See the 
+     julesverne/bellswhistles/jules-verne.sty for an example of 
+     how to handle this for unofficial copies.
+
+Chapter headings and the TOC use ROMAN numerals, but the running headers
+at the top of each page use ARABIC numbers for the Chapter number.  
+Thus, there are two separate formats that are used.
+
+   \thegtchapter is used for ROMAN chapter numbers
+   \thechapter is used for ARABIC chapter numbers
+
+If you wish all chapter headings to use ROMAN, then just redefine 
+\thechapter in your document:
+   \renewcommand{\thechapter}{\thegtchapter}
+Do the reverse if you want all ARABIC chapter numbers:
+   \renewcommand{\thegtchapter}{\thechapter} 
+
+==================================
+Installing the GATECH-THESIS class
+==================================
+
+See the INSTALL file
+
+===========
+Final Notes
+===========
+
+For more information about the GATECH-THESIS class and its options, 
+look inside the class file itself -- it is heavily commented.  Also, 
+the add-on styles contain helpful comments -- and you should read 
+all of the various READMEs and the comments within the ``root''
+example files:
+  example-thesis.tex
+  julesverne/basic/jules-verne.tex
+  julesverne/basic/00README
+  julesverne/bellswhistles/jules-verne.tex
+  julesverne/bellswhistles/jules-verne.sty
+  julesverne/bellswhistles/00README
+Also, it wouldn't hurt to read the NEWS file, the NOTES file, and the
+CHANGES file -- but I'd stay away from the ChangeLog unless you're a 
+real glutton for punishment.
+
+And read the COMPLIANCE file -- it is a blow-by-blow commentary
+on the Office of Graduate Studies Style Manual for Theses, and 
+how it relates/is implemented by GATECH-THESIS.
+
+Backward Compatibility
+----------------------
+
+There are a number of commands available within gatech-thesis.cls that
+are purely for backward compatibility with the older official 
+gt-thesis.sty style file that was previously provided by the Georgia 
+Tech Graduate Studies Office.  In theory, one could take a disseration
+that previously began:
+
+  documentstyle{report}
+  \usepackage{gt-thesis.sty}
+
+and replace those two commands with
+
+  documentclass{gatech-thesis}
+
+And it should ``just work''(tm).  These backwards compatibility commands
+are not recommended for NEW documents, and they are described only in
+the comments inside the gatech-thesis.cls file itself.
+
+=========================================
+MANIFEST  --  This archive should contain
+=========================================
+
+See these files:
+   MANIFEST
+   julesverne/basic/MANIFEST
+   julesverne/bellswhistles/MANIFEST
+
+
diff --git a/Master/texmf-dist/doc/latex/gatech-thesis/example-thesis.tex b/Master/texmf-dist/doc/latex/gatech-thesis/example-thesis.tex
new file mode 100644
index 00000000000..20417631cbc
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gatech-thesis/example-thesis.tex
@@ -0,0 +1,114 @@
+\documentclass{gatech-thesis}
+%%
+%% This example is adapted from ucthesis.tex, a part of the
+%% UCTHESIS class package...
+%%
+\title{The Elements of Thesis}
+\author{Perry H. Disdainful}
+\principaladviser{Professor Alpha Betic}
+\committeechair{Professor Ignatius Arrogant}
+\firstreader{Professor Ivory Insular}
+\secondreader{Professor General Reference\\(Another Department)}
+\thirdreader{Professor Earl Grey}
+\fourthreader{Professor Darjeeling Sweet}
+\department{School of Electrical and Computer Engineering}
+\degree{Doctor of Philosophy}
+\copyrightyear{2001}
+\submitdate{January 2001}
+\bibfiles{example-thesis}
+%% The following are the defaults
+%%    \titlepagetrue
+%%    \signaturepagetrue
+%%    \copyrightfalse
+%%    \figurespagetrue
+%%    \tablespagetrue
+%%    \contentspagetrue
+%%    \dedicationheadingfalse
+\bibpagetrue
+%%    \thesisproposalfalse
+%%    \strictmarginstrue
+\begin{document}
+\bibliographystyle{gatech-thesis}
+%%
+\begin{preliminary}
+\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}
+\begin{preface}
+Theses have elements.  Isn't that nice?
+\end{preface}
+\begin{acknowledgements}
+I want to ``thank'' my committee, without whose ridiculous demands, I
+would have graduated so, so, very much faster.
+\end{acknowledgements}
+% print table of contents, figures and tables here.
+\contents
+% if you need a "List of Symbols or Abbreviations" look into
+% gatech-thesis-gloss.sty.
+\begin{summary}
+Why should I provide a summary?  Just read the thesis.
+\end{summary}
+\end{preliminary}
+%%
+\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}
+\caption{A table, centered.}
+\begin{center}
+\begin{tabular}{|l|r|}
+  \hline 
+Title & Author \\
+\hline
+War And Peace & Leo Tolstoy \\
+The Great Gatsby & F. Scott Fitzgerald \\ \hline
+\end{tabular}
+\end{center}
+\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{*}
+%% We need this since this file doesn't ACTUALLY \cite anything...
+%%
+\appendix
+\chapter{Some Ancillary Stuff}
+
+Ancillary material should be put in appendices, which 
+appear just before the bibliography. 
+
+\begin{postliminary}
+\references
+\postfacesection{Index}{%
+%%             ... generate an index here
+%%         look into gatech-thesis-index.sty
+}
+\begin{vita}
+Perry H. Disdainful was born in an insignificant town
+whose only claim to fame is that it produced such a fine
+specimen of a researcher.
+\end{vita}
+\end{postliminary}
+\end{document}