MISC. USEFUL LaTeX CLASS FILES AND PACKAGES

========================================================================

Written by William B. Thompson <thompson@cs.utah.edu>

------------------------------------------------------------------------
Class files:
------------------------------------------------------------------------

nsfprop

    A simple class file for typesetting NSF proposals.

    Default fonts and margins are for GPG09-1 (effective January, 2009):
    11pt Computer Modern fonts and 1.0" margins.

	Line spacing is ~5.25 lines / inch, well under the NSF limit of
	6 lines / inch for GPG09-1.  See below for the crowdlines and
	crowdlinesmax class options, which can cram more text onto the
	page without going over the NSF-imposed limits

    Class options:

	GPG07140

	    Use 2.5cm margins, as specified by GPG07-140 (effective
	    June, 2007).

	paragraphspacing

	    Switch from the default of indenting the start of each new
	    paragraph to an alternate format in which a blank line is
	    placed between paragraphs and there is no indenting at the
	    start of each paragraph. The default style allows more text
	    to fit within the 15 page NSF limit.

	timesfont

	    This option switches from 11pt Computer Modern to 11pt Times
	    Roman.  Times Roman is a denser font than ComputerModern in
	    both the characters themselves and the character spacing.
	    More text will fit within the 15 page limit with Times Roman
	    than with ComputerModern.  Line spacing is as for Computer
	    Modern.  You should probably not use this option if the
	    document uses mathematics (see immediately below).

	mathtimesfont

	    As with the timesfont option, except that mathematics is
	    also set in the times font.  See documentation on the
	    mathptmx package for information on when this might not
	    work.

	palatinofont

	    Typeset regular text and mathematics using 11 point
	    Palantino.  See documentation on the mathpazo package for
	    more information.  The Palantino font lays out similar to
	    ComputerModern but with substantially heavier glyphs.

	palatinofont10

	    Typeset regular text and mathematics using 10 point
	    Palantino.  See documentation on the mathpazo package for
	    more information.  This produces substantially denser text
	    (more text fitting into the 15 page limit) than does the
	    other options, but is allowed by GPG 09-1

	sfsectionfont

	    Switch to sans-serif font for section headings.

     	crowdlines
 
	    Reduce the spacing between lines to get more text into a
	    fixed number of pages.  This will make the document harder
	    to read.
 
	crowdlinesmax
 
	    Reduce the spacing between lines by the maximum allowed by
	    NSF.  This will make the document VERY hard to read.
	    (Readability is reduced to the MS Word level of typography!)

    Three standard LaTeX packages are loaded:

	cite	% Sort numeric references in citations
	version	% Mostly for the comment environment
	xspace	% Used in macro definitions (but not in this class file!)

    Unlike previous versions of this class, no graphics bundle is loaded
    automatically.

    The figure placement rules used by LaTeX are turned off to give more
    control to the user.

    One new environments is defined:

	\begin{localscope}

 		:

	\end{localscope}

	    The localscope environment produces no formatting changes on
	    its own, but makes it easy to confine the scope of
	    user-specified formatting commands to a specific range.

    One new command is defined:

	\boxtext{text}

	     Typeset the argument in a box prominently displayed on the
	     page.  Useful for notes that need to be addressed before
	     the document is finalized.

------------------------------------------------------------------------
Packages:
------------------------------------------------------------------------

acmtranscite

    Supports ACM transactions style citations in a document that does
    not use the ACM transactions class file (acmtrans2m.cls).  BibTeX
    must be provided acmtrans.bst (as is the case with acmtrans2m.cls).
    Use with \bibliographystyle{acmtrans} (also as is the case with
    acmtrans2m.cls).

------------------------------------------------------------------------

boxtext

    Defines the \boxtext{text} command.

    Typeset the argument in a box prominently displayed on the page.
    Useful for notes that need to be addressed before the document is
    finalized.

------------------------------------------------------------------------

dontdistribute

    Mark each page with "DO NOT DISTRIBUTE" in the left and right
    margins

------------------------------------------------------------------------

draftdatetime

    Mark each page with "DRAFT" and the date and time on the left margin

    This should be invoked before the \begin{document}

------------------------------------------------------------------------

forcefigurelayout

    Turn off efforts by LaTeX to layout figures sensibly.  Figure
    placement will more sensitive to where the figure declaration occurs
    in the source.

------------------------------------------------------------------------

localscope

    Definds the localscope environment

	\begin{localscope}
	    :
	\end{localscope}

    The localscope environment produces no formatting changes on its
    own, but makes it easy to confine the scope of user-specified
    formatting commands to a specific range.

------------------------------------------------------------------------

socletterhead

    Add the University of Utah School letterhead to the top of the page.
    No other formatting is specified by this package (and the default
    LaTeX letter package page layout is awful).

    Requires that socletterhead.eps and socletterhead.pdf must be
    somewhere in the TeX search path.

------------------------------------------------------------------------

specialbibsection

    Redefine "thebibliography" to remove the "References".  Document
    should use explicit \section command instead.

------------------------------------------------------------------------
Shell scripts (csh):
------------------------------------------------------------------------

runlatex

    Run latex at least once.  If there are undefined citations, run
    bibtex and then additional latex runs.  Keep going until most
    undefined references and label changes are gone.  Produces a
    postscript output file by default, with the ".tex" in the input file
    replaced by a ".ps".  Optionally, can instead produce a PDF output
    file.  See the shell script itself for options.

runpdflatex

    Same as runlatex, except that it executes pdflatex directly.

    latexmk <http://www.ctan.org/tex-archive/support/latexmk/> is a
    Perl script that provides the most of the same functionality as
    runlatex, and more.

texclean

    Clean up most (but not necessarily all) of the intermediate files
    produced by LaTeX.  This may need to be run before runlatex to force
    a re-run of bibtex in some circumstances.

========================================================================

From The Comprehensive TeX Archive Network (CTAN) <http://www.ctan.org/>.

------------------------------------------------------------------------

apacite [subdirectory]

    Supports APA-style citations and bibliography references.  See
    apacite.pdf for more information.  APA-style is sometimes useful for
    non-APA manuscripts.

    *** Now included as part of most TeX distributions, and so is no
    longer included here. ***

------------------------------------------------------------------------

apacls [subdirectory]

    Supports APA-style manuscript formatting.  Uses the apacite package
    for citations and bibliography references.

    *** apa.cls is now included as part of most TeX distributions, and
    so is no longer included here. ***

========================================================================
