summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-05-25 23:48:32 +0000
committerKarl Berry <karl@freefriends.org>2006-05-25 23:48:32 +0000
commit595900eb11650c10452ce044faf23b3312127dd1 (patch)
tree97ffe93a2ee52bb32dfb2ac8082a805018c6e9d8 /Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE
parent0a2ec794f03837e374b38c4952e23aa352461cf9 (diff)
gatech-thesis update (most files now in doc)
git-svn-id: svn://tug.org/texlive/trunk@1595 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE')
-rw-r--r--Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE812
1 files changed, 812 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE b/Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE
new file mode 100644
index 00000000000..138b0dbb31e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gatech-thesis/COMPLIANCE
@@ -0,0 +1,812 @@
+These notes are a running commentary on important points in
+the Office of Graduate Studies Style Manual. Get it, open it,
+and read along in that and in this file.
+
+Authorities:
+ OGS-SM: Office of Graduate Studies Style Manual
+ OGS: Office of Graduate Studies verbal confirmation
+
+We begin on page 7 of the OGS-SM:
+
+Copyright:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The current OGS-SM says that the copyright notice, if used,
+should look like this:
+ Copyright (c) Full Name Year
+on pages 7 and 13. However, on page 25, the example shows
+ Copyright (c) Year by Full Name
+According to OGS, either is fine; gatech-thesis uses the latter
+format.
+
+Fonts
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The OGS-SM only lists the following approved fonts (and sizes):
+ Arial (11) -- N/A on most TeX systems
+ Courier (11 or 12) -- available, but Why?
+ Century Gothic (11 or 12) -- N/A
+ Geneva (11) -- N/A
+ Helvetica (11 or 12) -- available, but poor math support
+ Times (12) -- available (use mathptmx or txfonts)
+But the OGS-SM doesn't mention Computer Modern, which is the
+default font for TeX, and which has the best math support.
+
+OGS has confirmed that Computer Modern, 11 or 12 point, is
+acceptable. (In TeX, unless you want to pay for proprietary
+fonts, your only other realistic choice of a font with decent
+support for mathematical symbles is Times, using the mathptmx
+package. See julesverne/bellswhistles/jules-verne.sty for more
+information.
+
+Margins
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+By default, the GATECH-THESIS class uses the "new" margin
+specification (1" on top, right, and bottom, 1.5" on left,
+major headings just inside that 1" top margin). To use the
+"old" margins (1" on bottom and right, 1.5" on left and top,
+except that pages with major headings have a 2" top margin),
+call gatech-thesis with the 'oldmargins' option:
+ \documentstyle[oldmargins]{gatech-thesis}
+But this is not recommended. Use the default, "new" margins.
+
+Spacing
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Line spacing is double throughout, except where the OGS-SM
+specifically says that it should be single (captions, within
+bibliography entries, etc). Don't change this.
+
+Page Numbers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The 'plain' pagestyle, which is used by GATECH-THESIS by
+default, places the page numbers at the center within the
+bottom margin, 0.5" from the bottom of the page. This is the
+OGS-SM specification. For official copies, this should not
+be changed.
+
+For personal copies ONLY:
+ You can use the 'tcplain' pagestyle which puts the page
+numbers at the upper right corner (upper outside corner for
+twosided printouts[*]).
+ You can also try the 'gtthesis' pagestyle, which for
+onesided printouts puts the pagenumber at the upper right,
+and the chapter title in the upper left (for twosided,
+the pagenumber is on the outside upper corner; the chapter
+title is on the upper inside corner of right-hand pages, and
+the section title is on the upper inside corner of left-hand
+pages). See the julesverne/bellswhistles/jules-verne.sty file
+for an example of how to do this.
+
+[*] 'twosided' doesn't simply mean that you happen to print
+on a duplex printer. It means that you invoke GATECH-THESIS
+with the 'twoside' option:
+ \documentclass[twoside]{gatech-thesis}
+Don't do this except for personal copies (it's the default
+in draft mode -- which are personal by definition).
+
+Footnotes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Nothing special here; use standard LaTeX tools (\footnote,
+\endnote) to do this.
+
+Preliminary Pages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The frontmatter pages will automatically obey the proper margin
+guidelines (especially the topmargin) depending on whether you
+use the default (1") margins, or choose the "old" margins (2" on
+major heading pages, like titlepage, etc).
+
+Title Page
+----------------
+Counts as page i, but not marked. Commands which can mmodify
+the appearance:
+
+\titlepagefalse (\titlepagetrue is the default)
+ Don't print a title page
+
+\documentclass[oldmargins]{gatech-thesis}
+ See the Margins section above.
+
+Volume I Title page
+----------------
+If your thesis spans multiple volumes, then you should invoke the
+\multivolumetrue command within your preamble. This will cause
+GATECH-THESIS to automatically generate the Volume I title page
+(which is separate from the "real" title page) immediately after
+the real title page.
+ Volume title pages are not numbered, and *do not count* in the
+page number sequence. So, oddly, you will have
+ titlepage i
+ volume title page -
+ approval page ii
+Just go with it; this weird behavior has been confirmed by OGS
+(even though it isn't all that clear in the OGS-SM)
+
+Commands which modiry the appearance:
+
+\multipagetrue (\multipagefalse is the default)
+ Print it.
+
+\documentclass[oldmargins]{gatech-thesis}
+ See the Margins section above.
+
+Approval page
+----------------
+Also known as the signature page, this is generated by default.
+To suppress, invoke the \signaturepagefalse command. The
+signature lines will be generated (in order) for each one of
+the following commands that have been invoked (uninvoked ones
+will be skipped):
+ \principaladvisor{a name}
+ \committeechair{a name}
+ \firstreader{a name}
+ \secondreader{a name}
+ \thirdreader{a name}
+ \fourthreader{a name}
+ \fifthreader{a name}
+ \sixthreader{a name}
+You don't need to invoke them all; just the ones you need.
+The \principaladvisor and \committechair ones are special;
+in addition to the names, the titles ("Committee Chair",
+"Advisor") are also printed.
+ If there are less than five signatures to be printed, then
+the signature lines will be in a single column. If there are
+more than five, then the signatures will be typeset in two
+columns, as per the OGS-SM. This page is number ii, but the
+page number is not printed (per OGS-SM).
+
+Commands which can modify the appearance:
+
+\signaturepagefalse (default is \signaturepagetrue)
+ suppress printing a signature page
+
+Dedication page
+----------------
+\begin{dedication}
+ ... dedication text ...
+\end{dedication}
+
+Text on this page will be automatically centered vertically, per
+the OGS-SM. However, that looks unbalanced; for personal copies
+you may wish to override the following two commands as follows:
+ \renewcommand{\dedicationtop}{\vspace*{\stretch{1}}
+ \renewcommand{\dedicationbottom{\vspace*{\stretch{3}}
+This positions the text at about 1/4 of the way down the page,
+which looks better in my opinion. But ONLY do this for personal
+copies.
+ Also, if you invoke the \dedicationheadingtrue command in your
+preamble, then the dedication page will have a big "DEDICATION"
+heading on it. Don't do this; it is only provided for backward-
+compatibility with the (very) old gtthesis.sty -- and this
+ugliness was required by the old OGS-SM (but no longer).
+
+Commands which can modify the appearance:
+
+\dedicationheadingtrue (default is \dedicationheadingfalse)
+ print a big "DEDICATION" title at the top of the page
+
+Acknowledgements page
+----------------
+\begin{acknowledgements}
+ ... acknowledgements text ...
+\end{acknowledgements}
+
+nothing special here
+
+About the next several sections (the 'Lists'): If you are using
+the hyperref package, you MUST use hyperref's breaklinks option.
+If you do not, and there is a section title or figure caption
+that spans multiple lines, hyperref will prevent it from breaking
+at the margin (it will stay all on one line, and go off the page).
+ \usepackage[breaklinks,<other options>]{hyperref}
+See julesverne/bellswhistles/jules-verne.sty for a good way
+to handle this.
+
+Table of Contents
+----------------
+\contents
+
+In general, this should "just work". By invoking the \contents
+command somewhere within the preliminary environment in your
+document, GATECH-THESIS will automatically create a Table of
+Contents (and List of Figures and List of Tables[*]) that matches
+the requirements of the OGS-SM. Specifically, that means
+ 1) Chapter titles, sections, subsections, and subsubsections
+ are listed (the OGS-SM requires at least chapters, sections,
+ and subsections)
+ 2) Each entry is singlespaced within, but doublespaced between
+
+[*] assuming the \tablespagefalse, \figurespagefalse commands were
+ not invoked.
+
+However, there are ways to customize the look of the TOC (but don't
+use them in official copies...)
+
+\contentspagefalse
+ don't print the TOC at all (bad idea...)
+
+\labelchaptersintableofcontents
+ inserts an entry into the TOC that says ``CHAPTERS''. Obviously,
+ you should invoke this just before you begin chapter 1. However,
+ there's a slight glitch due to a bug in LaTeX: see
+ julesverne/bellswhistles/hack-part.tex for more info.
+
+\labelappendicesintableofcontents
+ inserts an entry into the TOC that says ``APPENDICES''. Obviously,
+ you should invoke this just before you begin the first appendix
+ (before or after the '\appendix' command; it doesn't matter).
+ However, there's a slight glitch due to a bug in LaTeX: see
+ julesverne/bellswhistles/hack-part.tex for more info.
+
+\settocstring{a string}
+ change the name used for the Table of Contents (def: 'Table of Contents')
+
+
+\setchaptertocdepth{a number}
+ set how ``deep'' to number within chapters in the table of contents.
+ This defaults to '2', which means chapters, sections, and subsections,
+ You may wish to set this to '3' (thus adding subsubsections) -- but
+ don't use '0' or '1' because the OGS-SM requires that chapters,
+ sections, and subsections are listed in the TOC.
+
+\setappendixtocdepth{a number}
+ set how ``deep'' to number within appendices (chapter{}''s after
+ the \appendix command) in the table of contents. This defaults
+ to '0', which means list the Appendices themselves alone, with
+ no sections. This is the OGS-SM default; but you may list smaller
+ divisions as well by setting this to 1, 2, or 3.
+
+\settocdepth
+ temporarily change how "deep" to number in the table of
+ contents for current chapter/section. For example, you
+ usually include \subsection{}''s in the TOC (\setchaptertocdepth{2})
+ but in chapter 5 you want to include subsubsections as well:
+ \chapter{This is Chapter 5}\settocdepth{3}. In chapter 6 the
+ default depth of 2 is reasserted. Change the overall defaults using
+ the above two commands instead.
+
+\multivolumetrue
+\part{}
+ If \multivolumetrue is invoked in the preamble, then the very first
+ item in the TOC is the phrase "Volume I" centered (with no page number)
+ It is only inserted to show where the volume divisions are, but since
+ the volume title pages have no number, then neither do the volume
+ labels in the TOC. Also, another "Volume II" label (III, IV, ...)
+ is inserted into the TOC each time \part{} is invoked. But,
+ see julesverne/bellswhistles/hack-part.tex for information about
+ working around a LaTeX bug.
+ This particular bit of magic is not discussed at all in the OGS-SM,
+ but OGS has seen and approved the results.
+
+List of Tables
+----------------
+\contents
+
+In general, this should "just work". By invoking the \contents
+command somewhere within the preliminary environment in your
+document, GATECH-THESIS will automatically create a List of
+Tables (and List of Figures and Table of Contents[*]) that matches
+the requirements of the OGS-SM. Specifically, that means
+ 1) Each entry is singlespaced within, but doublespaced between
+ 2) OGS-SM requires that the entries in the List of Tables exactly
+ match the captions at each table. This means you should not
+ use the `\caption[short caption]{long caption}' construction;
+ just use `\caption{the caption}'.
+
+[*] assuming the \contentspagefalse, \figurepagesfalse commands were
+ not invoked.
+
+However, there are ways to customize the look of the LOT (but don't
+use them in official copies...)
+
+\setlotstring
+ change the name used for the List of Tables (def: 'List of Tables')
+
+List of Figures
+----------------
+\contents
+
+In general, this should "just work". By invoking the \contents
+command somewhere within the preliminary environment in your
+document, GATECH-THESIS will automatically create a List of
+Figures (and List of Tables and Table of Contents[*]) that matches
+the requirements of the OGS-SM. Specifically, that means
+ 1) Each entry is singlespaced within, but doublespaced between
+ 2) OGS-SM requires that the entries in the List of Figures exactly
+ match the captions at each table. This means you should not
+ use the `\caption[short caption]{long caption}' construction;
+ just use `\caption{the caption}'.
+
+[*] assuming the \contentspagefalse, \tablespagefalse commands were
+ not invoked.
+
+However, there are ways to customize the look of the LOF (but don't
+use them in official copies...)
+
+\setlofstring
+ change the name used for the List of Figures (def: 'List of Figures')
+
+List of Symbols or Abbreviations
+----------------
+\usepackage{gatech-thesis-losa}
+
+This is not generated by default, since it isn't widely used (but
+every thesis has tables and figures). Also, the implementation
+provided requires additional packages that are not included with
+this distribution.
+
+To generate a List of Symbols or Abbreviations (LOSA), you simply
+do the following in your preamble:
+ \usepackage{gatech-thesis-losa}
+ \losafiles{<database file, sans .bib suffix>}
+gatech-thesis-losa.sty depends on and automatically loads the
+gloss.sty package -- but you need to insure that gloss.sty is
+installed in your TeX system.
+
+By doing this, the LOSA will be automatically generated and included
+in the frontmatter, just after the LOF -- and it will be added to the
+TOC. Of course, you need actual *entries* in the symbols database
+file -- which must end in .bib; see the gloss.sty documentation
+for the appropriate format. You also need actual citations to those
+entries within your bodytext, like this:
+ \losa{key}.
+Note that \losa{<key>} typesets the <word> from the <key> entry of
+the losafile within the text, so there''s no need to do this:
+ (BAD) word\losa{key-for-word}
+Again, you should read the gloss.sty documentation for more info, but
+basically gatech-thesis-losa.sty makes it simple:
+ 1. insert the two commands above into your preamble
+ 2. create a database with your glossary definitions
+ 3. sprinkle \losa{} citations in your text
+ 4. run ``bibtex'' on the <rootfile>.losa.aux file created
+ after the first ``latex'' run. (But don''t include the
+ .aux extension. So say ``bibtex <rootfile>.losa'' You
+ can do this at the same time you run ``bibtex'' for your
+ references.
+ 5. run ``latex'' twice more
+
+To customize the List of Symbols or Abbreviations, you can use the
+following commands
+
+\setlosastring{a string}
+ change the name used for the List of Symbols or Abbreviations
+ (def: 'List of Symbols or Abbreviations')
+
+\setlength{\losahang}{a dimension}
+ The GSO prefers that the symbol descriptions are rigidly
+ separated from the symbols themselves. Sometimes, if you have
+ very long symbols/abbreviations, you may need to make
+ \losahang bigger than its default value of 2cm, by using a
+ command similar to the following, within your document preamble:
+ \setlength{\losahang}{4cm}
+
+Glossary
+----------------
+\usepackage{gatech-thesis-gloss}
+
+This is not generated by default, since it isn't widely used (but
+every thesis has tables and figures). Also, the implementation
+provided requires additional packages that are not included with
+this distribution. Finally, the current OGS-SM doesn't say
+anything about a Glossary or List of Nomenclature, so we're
+on our own, here. However, the old OGS-SM did mention it, briefly.
+
+To generate a Glossary or List of Nomenclature, you simply
+do the following in your preamble:
+ \usepackage{gatech-thesis-gloss}
+ \glossfiles{<database file, sans .bib suffix>}
+gatech-thesis-gloss.sty depends on and automatically loads the
+gloss.sty package -- but you need to insure that gloss.sty is
+installed in your TeX system.
+
+By doing this, the glossary will be automatically generated and
+included in the frontmatter, just after the LOF (or LOSA, if you
+have it) -- and it will be added to the TOC. Of course, you need
+actual *entries* in the glossary database file -- which must end
+in .bib; see the gloss.sty documentation for the appropriate format.
+You also need actual citations to those entries within your
+bodytext, like this:
+ \gloss{key}.
+Note that \gloss{<key>} typesets the <word> from the <key> entry of
+the glossfile within the text, so there''s no need to do this:
+ (BAD) word\gloss{keyforword}
+Read the gloss.sty documentation for more info, but basically
+gatech-thesis-gloss.sty makes it simple:
+ 1. insert the two commands above into your preamble
+ 2. create a glossfile with your glossary definitions
+ 3. sprinkle \gloss{} citations in your text
+ 4. run ``bibtex'' on the <rootfile>.gls.aux file created
+ after the first ``latex'' run. (But don''t include the
+ .aux extension. So say ``bibtex <rootfile>.gls'' You
+ can do this at the same time you run ``bibtex'' for your
+ references.
+ 5. run ``latex'' twice more
+
+To customize the Glossary or List of Nomenclature, you can use the
+following commands
+
+\setglossstring{a string}
+ change the name used for the List of Symbols or Abbreviations
+ (def: 'List of Symbols or Abbreviations')
+
+\setlength{\glosshang}{a dimension}
+ Unlike the \losahang comment above, it doesn't make sense to
+rigidly separate the description from the glossary terms; the
+glossary terms are usually too long for this to be aesthetic.
+However, this has NOT been confirmed by OGS. If you use a
+glossary, be sure to confirm that the current behavior is okay.
+If not, then you can use \setlength{\glosshang}{a dimension}
+to fix it.
+
+Summary
+----------------
+\begin{summary}
+ ... summary text ...
+\end{summary}
+
+Nothing special to say here
+
+Other frontmatter
+----------------
+
+Before we leave the "Preliminary pages" section (pg. 15 of the OGS-SM),
+there are a few additional environments that are provided by
+the GATECH-THESIS class, but are not discussed in the OGS-SM:
+
+The entire "frontmatter" section should be enclosed within the
+"preliminary" environment, like this:
+
+\begin{document}
+\begin{preliminary}
+ \begin{dedication} dedication text \end{dedication}
+ ... etc ...
+ \contents
+ \begin{summary} summary text \end{summary}
+\end{preliminary}
+... chapters ...
+
+Preface
+----------------
+\begin{preface}
+ ... preface text ...
+\end{preface}
+
+The (current) OGS-SM doesn't mention a preface, but if used it
+should go after the dedication. The old OGS-SM did mention it.
+
+Forward
+----------------
+\prefacesection{Forward}{%
+ ... forward text ...
+}
+
+The (current) OGS-SM doesn't mention a preface, but if used it
+should go after the dedication. The old OGS-SM did mention it.
+
+There is no 'Forward' envronment; you can use the \prefacesection
+command to create any frontmatter section you like, as follows:
+ \prefacesection{title of the section}{section text}
+
+Text Pages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+\chapter{chapter title}
+chapter text ...
+\chapter{the next chapter title}
+chapter text ...
+
+\appendix
+\chapter{appendix title}
+appendix text ...
+\chapter{the next appendix title}
+appendix text ...
+
+Section Heading Formats
+---------------
+The new OGS-SM no longer specifies what the section,
+subsection, or subsubsection headings should look like; according
+to OGS, they don't really care: as long as it looks professional
+and you are consistent. I chose to define these as follows:
+
+Sections: Large, Bold, Italic, Flush left
+SubSections: Bold, Flush left
+SubSubSections: Italic, indented
+
+If you wish to override and define your own formats, you can
+either \renewcommand{\section}{ ... } (see any good LaTeX book),
+or \usepackage{titlesec}. I recommend the latter. Actually,
+I recommend leaving it alone; concentrate on writing your
+dissertation and don't get distracted by messing around with
+formatting.
+
+You can use a number of special environments for specific
+purposes. The first two are useful; avoid the other four.
+
+\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''.
+
+
+Reference Material
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Nothing really special to say here.
+
+Appendices
+----------------
+See the 'Text Pages' section above, as well as the 'Table of
+Contents' discussion above.
+
+References
+----------------
+\bibfiles{a .bib database}% in the preamble
+\bibliographystyle{gatech-thesis}% just after \begin{document}
+\references% somewhere in the postliminary env.
+
+Within the \postliminary environment, execute the \references
+command to generate an OGS-SM compliant bibliography. The
+gatech-thesis.bst style is:
+
+ numeric labels, sorted, IEEE abbreviations (vol. not volume,
+ no. not number, authors' first names abbreviated), quotes
+ around article titles, commas separate all fields except after
+ book titles and before "notes". Authors names typeset
+ in small caps, surname first.
+
+This has been approved by OGS. You may also use the 'plain'
+bibliography style (\bibliographystyle{plain}), if you wish.
+
+Vita
+----------------
+\begin{vita}
+ ... vita text ...
+\end{vita}
+
+This should be the very last page of your disseration, and should come
+immediately before \end{postliminary}\end{document}.
+
+Index
+----------------
+\usepackage{gatech-thesis-index}
+
+This is not generated by default, since it isn't widely used (but
+every thesis has tables and figures). Also, the implementation
+provided requires additional packages that are not included with
+this distribution. Finally, the current OGS-SM doesn't say
+anything about an index; neither did the old OGS-SM.
+
+To generate an index, do the following in your preamble:
+ \usepackage{gatech-thesis-index}
+and execute
+ \gtindex
+somewhere in the postliminary environment of your thesis.
+Remember, VITA should be last, so \gtindex must precede it.
+
+gatech-thesis-index.sty depends on and automatically loads the
+index.sty package and the multicol.sty package -- but you need
+to insure that index.sty and multicol.sty are installed in your
+TeX system (index.sty is included in the `camel' package on
+MikTeX and CTAN).
+
+By doing this, the index will be automatically generated and
+included in the TOC. Of course, you need actual *index references*
+within your document, like this:
+ foo\index{foo}.
+Read the index.sty documentation for more info, but basically
+gatech-thesis-index.sty makes it simple:
+ 1. insert the \usepackage and \gtindex commands into your document
+ 2. sprinkle \index{} citations in your text
+ 3. run ``makeindex'' on the <rootfile>.idx file created
+ after the first ``latex'' run, like this:
+ makeindex -s gatech-thesis-index.ist <rootfile>.idx
+ This will create <rootfile>.ind (the gatech-thesis-index.ist
+ file is a format specification for the index). If you want
+ to customize the index format, copy gatech-thesis-index.ist to
+ ``myformat.ist'' and change the copy. Use ``-s myformat.ist''
+ instead of gatech-thesis-index.ist.
+ You can run the makeindex command at the same time you run `
+ `bibtex'' for your references and/or glossary.
+ 4. run ``latex'' twice more (the same ``twice more'' needed for
+ bibtex and gatech-thesis-gloss.sty)
+
+To customize the Index, you can use the following commands
+
+\setindexstring{a string}
+ change the name used for the Index (def: 'Index')
+
+Tables and Figures
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Some useful packages you might want to investigate include
+ subfigure -- place multiple figures within a single 'figure'
+ environment
+ floatingfigure -- for figures that do not take up the full
+ width of the page, you may issue this command between
+ paragraphs, and the next paragraph will be typeset
+ next to the narrow figure. OGS does accept this sort
+ of thing, but...
+ wrapfig -- ditto, but with a difference: you may issue this
+ command inside a paragraph, but LaTeX will NOT optimize
+ the figure's position -- which might lead to extra
+ whitespace, mostly empty pages, etc. Recommend against.
+ longtable -- for tables that extend beyond a single page (don't
+ use the supertab package, it can't handle secondary caption
+ properly)
+
+Captions:
+---------------
+ The OGS-SM requires that Table captions be placed before the
+ caption, and Figure captions be placed after the figure. You can
+ only do this manually; it can't be automatted. To create a
+ table, do this:
+
+ \begin{table}[tbp]
+ \caption{the caption}
+ \label{the label}% must come after the caption
+ \begin{center}
+ \begin{tabular}
+ ....
+ \end{tabular}
+ \end{center}
+ \end{table}
+
+ For a figure, do this:
+
+ \begin{figure}[tbp]
+ \begin{center}
+ \includegraphics[some options]{a graphics file}
+ \end{center}
+ \caption{the caption}
+ \label{the label}% must come after the caption
+ \end{table}
+
+ Notice that the \caption{} command comes before the actual
+ tabular in the table, but comes after the includegraphics in the
+ figure. This is the only way to insure that the captions go where
+ the OGS-SM requires.
+
+ The caption format is (by default) 'Figure X: caption-text', and
+ the 'Figure X:' part is typeset in bold, while the caption-text
+ is typeset in 'normal weight' like the rest of the body text.
+ To change this, use the caption2 package (note that
+ \usepackage[bf]{caption2}
+ will result in captions that are identical to the GATECH-THESIS
+ default). But for an official GT thesis, you want the default;
+ for personal copies, I like using san-serif bold like so:
+ (DON'T DO THIS) \usepackage[sf,bf]{caption2}
+
+Placement
+--------------
+LaTeX usually does a fairly decent job of obeying rational placement
+rules for 'floats' (e.g. tables and figures). If you need to force
+a float to a specific location (note that using the 'h' option for
+the figure/table environments does not do what you think it does; nor
+does using the '!' option),
+try the following:
+ \usepackage{float}
+ \restylefloat{figure}% or table
+ \begin{figure}[H]% <<< note the 'H' for 'Here'
+However, this can really get you into trouble: the H'ed figure
+could get placed before a non-H'ed one, even if it follows the
+non-H'ed figure in the document source. This will cause, for
+example, Figure 4 to be on a page before Figure 3!
+
+To work around this, you could *additionally*
+ \usepackage{afterpage}
+and use
+ \afterpage{\clearpage\begin{figure}[H]...\end{figure}}
+But THAT can lead to pages will very little text, and lots of
+empty white space -- which itself is a violation of the OGS-SM.
+
+Think about it. Do you REALLY care if a figure is 2 or 3 pages
+away from the text that references it? You're writing a 100+
+page document...messing with float placement is usually more
+trouble than it is worth. Don't.
+
+For more information, see section 6.2 in the LaTeX companion.
+
+If you need to turn a figure or table on its side (landscape),
+use the 'rotating' package.
+
+Numbering
+----------------
+LaTeX will handle the Figure # and Table # sequences for you.
+
+For tables that will extend over more than one page, use the
+'longtable' package. To follow the OGS-SM requirement that
+subsequent pages of the same page also have captions, and that
+these captions say only
+ Table XX (cont'd)
+you must pay careful attention when constructing the table (and
+the longtable environment is different from the table environment
+plus a tabular). However, the best we can do -- without massive
+TeX code, is that subsequent captions are
+ Table XX: (cont'd)
+(the ':' is not in the original requirements). However, to even
+get this far, you must do something like this:
+
+ \begin{longtable}[c]{|c|c|c|}
+ \caption{the `real' caption}
+ \\ \hline
+ Column A & Column B & Column C \\ \hline
+ \endfirsthead% the preceding will be invoked ONLY at the
+ % beginning of the table
+ \caption[]{(cont'd)}% <<<<< This is the magic caption
+ \\ \hline
+ column a & column b & column c \\ %\hline -- not necessary
+ % longtable takes care of it for us.
+ \endhead% the preceding will be invoked at the top
+ % of every page except the first one
+ % now we do the data...
+ 1 & 2 & 3 \\ \hline
+ 4 & 5 & 6 \\ \hline
+ ....
+ \end{longtable}
+
+The 'magic' caption[]{(cont'd)} statement within the header section
+means that every page (except the first) will get that caption --
+but since it has an empty optional argument, the '(con't)' will
+NOT get listed in the LOT, and the table counter will not be
+incremented. Which is what we want.
+
+Note that longtables are not floating; they will go exactly where
+you put them. (There is no need for a longtable to float; it is
+able to break at the pagebreak and continue on the next page).
+However, don't use longtable for everything tabular; a 4-line
+table will look really silly broken across two pages.
+
+You can also play games with 'continued on next page' and
+'continued from previous page' within the table itself, by
+using \endfoot and \endlastfoot commands and the multicolumn
+command. See the longtable documentation, and Chapter 5 of the
+LaTeX Companion.
+
+Citations of Tables and Figures
+----------------
+The OGS-SM states that you should always reference figures as
+'Figure 10' and tables as 'Table 4'. However, you don't want
+a linebreak (or worse, a page break) to occur betwen 'Table' and
+'4'; further, you don't want TeX to hyphenate 'Fig'-'ure'. So,
+in LaTeX, this means if you have a figure with the label
+{myfigure} and a table with the label {mytable}, you should
+cite them as:
+
+ \mbox{Figure~\ref{myfigure}}
+ \mbox{Table~\ref{mytable}}
+
+It's probably a good idea to simply define new commands in your
+preamble:
+
+ \newcommand{\figref}[1]{\mbox{Figure~\ref{#1}}}
+ \newcommand{\tabref}[1]{\mbox{Table~\ref{#1}}}
+
+because sooner or later, you WILL forget to type all that extra
+junk. Just define the new commands as you like, and then do
+
+ \figref{myfigure}
+ \tabref{mytable}
+
+and be done. Note that these commands are NOT provided by
+GATECH-THESIS; not being strictly necessary, I don't want to
+cramp any potential users' style by forcing my way. However,
+see the julesverne/bellswhistles/jules-verne.sty file...
+
+Multivolume Theses or Dissertations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+\multivolumetruee
+\part{}
+
+This was already covered in the Table of Contents section,
+above. One note, however: don't attempt to "name" your volumes.
+That is, use \part{}, not \part{Title of Volume II}
+
+GATECH-THESIS will handle it if you do name your volumes -- but
+the OGS-SM doesn't allow it, and there is no way short of
+redefining the entire 'preliminary' environment to give Volume I
+a name.
+
+