summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/apa
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-05-28 14:04:33 +0000
committerKarl Berry <karl@freefriends.org>2008-05-28 14:04:33 +0000
commite00ea5b1556452ef59e0c4c2175bc09831680873 (patch)
treedb5e511ab909eea269b130740e09e6583bf0b6ad /Master/texmf-dist/doc/latex/apa
parent5e8ce5cf4648e54b0595ab535cc91875d37cde1e (diff)
apa update (long ago)
git-svn-id: svn://tug.org/texlive/trunk@8384 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/apa')
-rw-r--r--Master/texmf-dist/doc/latex/apa/CHANGELOG.txt314
-rw-r--r--Master/texmf-dist/doc/latex/apa/LICENCE13
-rw-r--r--Master/texmf-dist/doc/latex/apa/README53
-rw-r--r--Master/texmf-dist/doc/latex/apa/apacls.html659
-rw-r--r--Master/texmf-dist/doc/latex/apa/apacls.txt84
-rw-r--r--Master/texmf-dist/doc/latex/apa/apaexample.tex71
-rw-r--r--Master/texmf-dist/doc/latex/apa/endfloat.cfg86
-rw-r--r--Master/texmf-dist/doc/latex/apa/examplebib.bib14
-rw-r--r--Master/texmf-dist/doc/latex/apa/examples.txt42
9 files changed, 1280 insertions, 56 deletions
diff --git a/Master/texmf-dist/doc/latex/apa/CHANGELOG.txt b/Master/texmf-dist/doc/latex/apa/CHANGELOG.txt
new file mode 100644
index 00000000000..7da05c6c795
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/apa/CHANGELOG.txt
@@ -0,0 +1,314 @@
+
+Alteration log for apa.cls (v1.3.2, January 2006)
+
+1.00 --> 1.01
+July 5, 1996: \r@headl now defaults to \r@headr in [doc] (used to complain)
+
+1.01 --> 1.02
+October 28, 1996:Changed \rhead to \markright in [doc]
+
+1.02 --> 1.1
+July 15, 1997: Removed citation section, loading apacite.sty instead
+ Added three and four authors/affiliations
+ Added bibliographystyle{apacite}
+
+August 20, 1997: Removed call to twocolumn.sty (not needed in 2e)
+ Added notimes and nosf options for jou and man, respectively
+ Changed \typeout to \ClassWarning where appropriate
+ Set \textfraction to 0 for the man mode
+
+August 21, 1997: Fixed date stamp on previous alteration :-) and in the
+ \ProvidesClass command.
+ Changed author size in jou from \Large to \large
+ Added \journal, \volume, \ccoppy, \copnum for first page header
+
+August 22, 1997: Changed \footnoterule to be \columnwidth wide
+ Moved author, title, etc. checking (& warnings) to a single block
+ Added appropriate behavior for undefined abstracts in doc & man
+ Removed line numbers from warnings about missing title, author, etc.
+ Added check for matching number of authors/affiliations
+
+October 30, 1997: Fix version to 1.1 and upload to CTAN
+
+1.1 --> 1.2
+December 16, 1997: Changed \evensidemargin from -0.15in to -0.1in to match \oddsidemargin
+
+May 15, 1998: In man mode, do not print a footnote page if no footnotes exist
+ Changed footnoterule length back to 0.5in as seen in latest JEP:HPP
+ Used ftnright in jou (if available) so that all footnotes appear
+ under the right column (canceling other appeareance changes in ftnright)
+ Used fancyhdr to display journal etc. at the header of the first page
+ Added conditional compilation macros: \ifapamodeman{}{}, \ifapamodejou{}{},
+ and \ifapamodedoc{}{} (first parameter when true, second when false); also
+ \ifapamode{}{}{} with separate options for man, jou, and doc mode.
+
+May 18, 1998: Added \fitfigure for loading eps files and automatically determine dimensions
+ by trying width=\columnwidth and switching to height=\textheight if the result
+ is too high. In man mode it rotates the figure if width is greater than height.
+
+May 19, 1998: Adjusted skips above and below captions separately for tables and figures
+ Added \fitbitmap that doesn't scale eps in man mode (as \fitfigure does).
+ Will load pslatex instead of times and mathptm if available
+
+May 20, 1998: Changed \columnwidth to \linewidth within \fitfigure nad \fitbitmap to handle
+ double-column figures (thanks to Donald Arseneau and Heiko Oberdiek)
+
+May 27, 1998: Defined \put@one@authaffil and \put@two@authaffil to unclutter \maketitle
+ in jou mode.
+ Copied the footnotemark definitions from article.cls and adjusted dimensions
+ Adjusted sizes, distances, and dimensions of all sorts in jou mode
+
+June 3, 1998: When two author-affiliation boxes are displayed side by side and one is wider
+ than \columnwidth but not by more than 25 then no lines are broken and
+ \hfill is used to separate the two boxes from each other and from the margins
+ provided that at least .4in of ``breathing space'' is left between the two
+ (thanks to Donald Arsenau for suggesting the use of tabular)
+
+ Thanks to Mike Tarr for testing and for suggesting features
+
+June 10, 1998: Checked and adjusted dimensions in jou format
+ Implemented the fignum option that prints the short title and the figure
+ number in the header of figure pages in man mode
+ Defined \thickline for horizontal separator between caption and table
+ Made footnote separators (and ack box rule separator) thinner in all modes
+
+June 12, 1998: Set tabular to occupy the full \linewidth in jou mode
+ Option notab can be specified to override this and revert to standard tabular
+
+June 13, 1998: Freeze features and call it a beta.
+
+July 28, 1998: Fix version to 1.2, rename .doc files to .txt, and upload to CTAN
+ (version datestamp is 8/1/98)
+
+1.2 --> 1.21
+August 1, 1998: Added nobf option to have section headers displayed in regular (not bold)
+ weight (effective in man mode only)
+
+August 3, 1998: Set endnotes ragged-right in man (thanks to Bob Damber for noticing)
+ Left-flushed figure captions and underlined period after ``Figure'' in man
+
+1.21 --> 1.22
+September 2, 1998: Set running head (lowercase `h') on title page of man mode to flush left
+
+1.22 --> 1.23
+January 5, 1999: Fixed bug in \headinglevels (thanks to John Vokey for pointing it out)
+
+January 13,1999: Included all options in the class warning message on unknown option
+
+January 27,1999: Changed \rlap to \hbox in \@makefnmark (thanks to Michael Erickson)
+
+February 9,1999: Added vertical fill around included figures in man mode (fitfigure,fitbitmap)
+ Added \long to the conditional compilation (mode checking) definitions
+
+April 18,1999: Pass unknown options on to article.cls (thanks to Robin Fairbairns)
+
+June 1, 1999: Fix version to 1.23 and upload to CTAN (version datestamp is 5/1/99)
+
+1.23 --> 1.24
+March 10, 2000: Save regular \footnote definition to \oldfootnote before changing to
+ \endnote and restore after printing endnotes so that footnotes in the
+ tables will appear correctly in man mode (thanks to Franck Ramus for
+ pointing out the problem).
+
+ Defined \tabfnm and \tabfnt to create footnote marks in tables without
+ messing up vertical alignment (centering). Used with a single argument,
+ the footnote mark (e.g., \tabfnm{a} in the tabular environment and
+ \tabfnt{a}{blabla} right before or after \end{tabular} for the note text.
+
+July 17, 2000: Added second set of braces around \em in cap@style to get citations in
+ table captions in man mode (thanks to John Vokey for noticing)
+
+ Added @dummy@box with an accented character so that the first accent does
+ not occur inside a citation, because in that case LaTeX complains
+ (recent distributions only, something about apacite+OT1 -- babel bug?)
+
+July 18,2000 Added Michael Erickson's patch to handle appendix section & float numbering
+ Revised and set default to one unnumbered appendix for backwards compatibility
+
+July 27,2000 Added floatmark option for those who still want figure and table in-text
+ markers ("Insert table/figure X here"). These are not required in the 4th
+ edition of the manual and will now by default not appear.
+ (Thanks to Michael Erickson for pointing it out and helping correct this)
+
+ Defined \appendix* and \appendixes (no difference between the two)
+ for more than one appendices, to be numbered A, B, C, ...
+ Individual appendices are treated as sections, in the standard LaTeX manner
+
+1.24 --> 1.25
+October 20,2000 Added flushend.sty in jou mode (optional)
+
+ Language portability: abstractname, refname/bibname, acksname, notesname
+ figurecaptionsname, appendixname, figurename, tablename
+
+ Added \apavector based on p. 114 of the APA manual
+
+ Fixed appendix headings, used old@tabular to center in jou mode
+ \appendix* and \appendices no longer necessary since the number is detected
+ and adjustments are made automatically -- removed, only \appendix remains
+
+July 5, 2001 Do not print "Figure captions" page when there are no figures
+ (added @figure@written definition as flag in endfloat code)
+
+ Fixed check for Greek language so that \GreekDefs is expanded correctly
+
+ Changed \uppercase to \MakeUppercase to work in every language
+
+1.25 --> 1.26
+February 27,2002:Quick fix for APA manual 5th edition (man mode only):
+ (a) do not load ulem.sty since italics are OK and no underlining is needed
+ (b) hanging indent in bibliography as in other modes (and apacite default)
+
+ Removed some calls to \rm that prevented use of the default font family
+ Declared font options: helv for helvetica and tt for typewriter
+ The \helvetica command now only produces a warning to use the helv option
+
+ Got longtable to work with apa.cls. Must be used as option to apa.cls
+ and not loaded as regular package (due to precedence requirements for
+ proper endfloat function and cross-definitions). ONLY for man mode
+ (longtable does not work unless in single-column). Unfortunately the
+ ifapamode commands won't work to keep a single table body and mode-specific
+ table or longtable environment because if cross-nests with environment
+ begin/end. In fact the table environment won't even work inside in
+ ifapamode argument, which makes it impossible to have a single file
+ that can be processed for both man and jou. Defeats the purpose of apa.cls...
+
+ Sent out as v1.26 to a bunch of users for testing and feedback
+
+1.26 --> 1.27
+March 15, 2002: Commented out forgotten \old@endtabular etc @ ~ l. 720 because the \relax
+ caused an extra line after the end of tabular (thanks to Jacob Feldman
+ for noticing)
+
+1.27 --> 1.28
+March 31, 2002: Fixed appendix headers which were in a tabular parbox centered in a
+ column shifted right by 4em (the \leftskip of the section header, \leveltwo).
+ Thanks to Jeff Miller for pointing out the bug.
+
+April 1, 2002: \@figure@written should be defined globally to be visible at end document
+ Thanks to Olivier Crouzet for noticing that figure captions weren't printing
+
+ Fixed (I hope) vertical placement of appendix section header by removing
+ extra vertical space (presumably added in the making of the tabular box)
+
+1.28 --> 1.2.9
+July 20, 2002: Changed \columnwidth to \linewidth in the journal format table caption
+ to handle wide captions (thanks to Ragnar Steingrimsson for noticing)
+
+ Changed \underline to \em in man mode figure caption page for "Figure #."
+ (thanks to Ragnar Steingrimsson for noticing)
+
+ Changed version numbering to the correct 1.2.x (instead of 1.2x)
+
+ Now using \refstepcounter to increase appendix number so that appendices
+ can be referenced via label/ref (add \label{app:X} after appendix \section
+ command and reference anywhere in text using Appendix~\ref{app:X})
+
+ Fixed appendix section title centering by removing tabular intra-box space
+
+August 21, 2002: Set parsep to 0em for biblist in man mode because some editor complained
+ that the references were separated by more than regular line skip.
+ (I can't quite thank Steve Finney for bringing it up...). Then commented
+ out the change because the ref list was much easier to read before.
+
+August 30, 2002: Fix version to 1.3.0 and upload to CTAN
+
+1.3.0 --> 1.3.1
+September 24, 2004: Load babel from within apa.cls because it must precede apacite
+ (apacite fixes problems due to incompatibility)
+
+July 23, 2005: Remove bibliography adjustments now handled by apacite;
+ Call apacite with [bibnewpage] option in man mode
+
+ Removed Greek language definitions, to be handled by apacite
+
+ Added definitions to support distinction in citation form between
+ regular text (requiring "and") and table captions (requiring "&")
+
+July 25, 2005: Combined longtable & sideways floats into a single endfloat.cfg
+
+July 26, 2005: Set txfonts as default typeface for jou mode, if available, after Erik
+ Meijer's suggestion; added notxfonts option in case this is undesirable
+
+ Added xkeyval support for specifying babel language options;
+ added special babelmain option to specify the main document language
+
+ Reactivated Greek language definitions for strings defined and used
+ exclusively by apa.cls (Running head, Author note, Figure captions,
+ Footnotes)
+
+ Removed code long ago commented out, to clean up the file a bit
+
+1.3.1 --> 1.3.2
+December 28, 2005: Removed xkeyval and special babel options, because Erik Meijer pointed
+ out that any additional options are automatically passed on to babel
+ without the need for any special action, so one may call apa.cls with
+ \documentclass[man,fignum,babel,greek,english]{apa}, for example, and
+ this loads babel with [greek,english] options, as desired (same order)
+
+ Added \iint and related definitions that prevent txfonts (loaded by
+ apa.cls automatically) to clash with amsmath (if loaded by the user).
+ The problem was noticed and solved by Erik Meijer, who contributed the
+ solution code.
+
+ Incorporated improved definition of apavector, as provided by Erik Meijer,
+ which uses package bm and redefines (upright) Greek letters so that most
+ vector cases are handled appropriately (displayed in bold; or with tilde
+ at the same distance)
+
+December 30, 2005: Switched to external language strings with the same system as apacite
+ Defined english.apa and greek.apa containing the 4 necessary macros
+
+ Sent out as beta version (1.3.2b) for some external testing
+
+January 2, 2006: Fixed warning about missing language definitions (thanks to Erik Meijer)
+ Added dutch.apa supplied by Erik Meijer
+
+ Erik Meijer noticed that tables (tabular environments) in doc mode weren't
+ centered and did not follow the proper citation form (& instead of "and")
+ A special apatabular-style macro was created to fix both problems
+
+January 3, 2006: Tried \@topnum and \@botnum definitions to keep tables from ugly front-page
+ placement in doc mode (noted by Erik Meijer). Decided against it because it
+ messes with placement of acknowledgements on first page. Since it is unlikely
+ that a manuscript will reference table on the first page, in the rare case
+ when it happens the author will have to move it manually later in the text.
+
+ Added separate tabular/endtabular redefinitions for the doc mode, activated
+ through \maketitle after document beginning, to ensure table centering.
+ Might interfere with array.sty if loaded.
+
+January 5, 2006: Added \fiveauthors and \fiveaffiliations, contributed by Aaaron Geller,
+ including corresponding changes to \maketitle for each of the three modes;
+ Completed tests for consistent number of author/affiliation definitions
+
+ Added \sixauthors and \sixaffiliations, including corresponding changes
+ to \maketitle and tests for consistent definitions
+
+January 10, 2006: Tried \@topnum=\z@ and \@botnum=\@ne so that tables do not appear on the
+ first page in doc mode (the acknowledgements is the "one" float allowed on
+ the title page, if defined).
+
+
+%%%%%%%%%%%%%%%%
+
+TO DO FOR v2.0: Is continuation note at page end required with long tables? (5.21/p. 301)
+ Stop messing with captions and use a standard package (caption2, ccaption)
+ Stop messing with endfloat and use loflot or something for the captions page
+ Use fancyhdr for all headings in all modes (instead of markboth/markright)
+ Appendices should be set in smaller typeface, including headings
+ Tabular footnotes should be automated -- not practical because it varies
+ dont' know how to keep expanding list of footnotes to display at \endtabular
+ Follow manual guidelines for table "Note" vs. probabilities (3.70/p. 170)
+ Wide tables should be turned sideways automatically -- how?
+ Fix Greek definitions according to babel conventions -- check babel docs
+ Clean up the font act -- remove rm/hrm/hsl etc.
+ Use geometry package to set margins taking into account paper size (A4)
+ Add contact information command and field for first page (man mode only)
+
+PROBLEMS: flushend.sty seems to mess up the last column if there is a float in it.
+
+ array.sty redefines tabular/endtabular and so it is not compatible with the
+ \apatabular definitions.
+
+ There may not be enough space on the title page for notes in case of more
+ than four author-affiliation pairs -- need smarter layout setup
diff --git a/Master/texmf-dist/doc/latex/apa/LICENCE b/Master/texmf-dist/doc/latex/apa/LICENCE
new file mode 100644
index 00000000000..44f68a0b040
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/apa/LICENCE
@@ -0,0 +1,13 @@
+
+%% LICENCING TERMS
+%%
+%% apa.cls
+%% version 1.3.2
+%% January 2006
+%% by Athanassios Protopapas
+%% protopap@ilsp.gr
+%%
+%% This package may be distributed under the terms of the LaTeX Project Public
+%% License, as described in lppl.txt in the base LaTeX distribution. Either
+%% version 1.0 or, at your option, any later version.
+
diff --git a/Master/texmf-dist/doc/latex/apa/README b/Master/texmf-dist/doc/latex/apa/README
index e629e11b5bd..f6b5014d0f3 100644
--- a/Master/texmf-dist/doc/latex/apa/README
+++ b/Master/texmf-dist/doc/latex/apa/README
@@ -1,24 +1,57 @@
+apa.cls LaTeX2e document class; version 1.3.2 of January 2006
+
apa.cls is a LaTeX2e class file that makes your document conform to
-the APA Publication Manual (Fifth Edition, 2001) specifications for
-manuscripts or to the APA journal look found in journals like the
-Journal of Experimental Psychology etc. In addition, it provides a
-regular LaTeX-like output with a few enhancements and APA-motivated
-changes.
+the American Psychological Association (APA) Publication Manual (Fifth
+Edition, 2001) specifications for manuscripts or to the APA journal
+look found in journals like the Journal of Experimental Psychology.
+In addition, it provides a regular LaTeX-like output with a few
+enhancements and APA-motivated changes.
-This is a document *class* which uses (and modifies) some packages to
+This is a document *class* which uses (and modifies) other packages to
achieve strictly defined formatting results and also uses the apacite
package (sty & bst) for citations and references. If you only want
-APA-like citation for other kinds of documents (e.g., a thesis) use
-apacite.sty with an appropriate class.
+APA-like citation for other kinds of documents use apacite.sty with
+an appropriate class. In particular, apa.cls is *NOT* appropriate for
+your thesis; don't even consider using it for that purpose.
In order to use this document class you need some packages that may
not be present in your LaTeX distribution. Please read apacls.txt
carefully to understand what you need to install and what is possible
with apa.cls, then read examples.txt carefully to understand how to
-use apa.cls (macros and instructions).
+use apa.cls (macros and instructions). Check out apaexample.tex, a
+minimal example file that produces actual manuscript-like output.
+
+apa.cls is not in any way connected to, endorsed by, or probably known
+at all at the American Psychological Association. APA does not even
+accept manuscript submissions in LaTeX source. The author of apa.cls
+has made every effort to achieve typesetting results conforming to
+the APA manual, because he uses it for his manuscripts. However, he
+is not responsible if the editor does not approve of a manuscript
+typeset with apa.cls, if your computer blows up while processing your
+manuscript with apa.cls, or for anything else that may go wrong with
+apa.cls, or with anything else for that matter.
Athanassios Protopapas
protopap@ilsp.gr
-August 2002
+January 2006
+
+======================
+
+List of files in distribution:
+
+README This file
+LICENCE apa.cls terms of distribution and use
+apa.cls The APA-style document class
+CHANGELOG.txt A text file documenting apa.cls updates
+apacls.txt Instructions for using apa.cls (plain text)
+apacls.html Description of apa.cls and usage instructions (HTML)
+apaenum.txt Instructions for using APA list environments
+examples.txt Guide with examples of correct apa.cls macro usage
+apaexample.tex Sample APA-style manuscript using apa.cls
+examplebib.bib Sample bibliography file accompanying apaexample.tex
+endfloat.cfg Configuration file to make endfloat aware of longtable
+ and sideways table floating environments
+*.apa Language-specific definitions of special APA-style
+ strings (section headings)
diff --git a/Master/texmf-dist/doc/latex/apa/apacls.html b/Master/texmf-dist/doc/latex/apa/apacls.html
new file mode 100644
index 00000000000..b435a0e66a4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/apa/apacls.html
@@ -0,0 +1,659 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML lang="en">
+
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
+<TITLE>apa.cls</TITLE>
+</HEAD>
+
+<BODY>
+
+<H1><A NAME="top"><TT>apa.cls</TT></A></H1>
+
+<H2><A NAME="contents">Contents</A></H2>
+
+<UL>
+<LI><A HREF="#intro">Introduction</A>
+<LI><A HREF="#authver">Author and version</A>
+<LI><A HREF="#maint">Maintainance and request for help</A>
+<LI><A HREF="#acks">Acknowledgments</A>
+<LI><A HREF="#sysreq">System requirements</A>
+<LI><A HREF="#instr">Instructions for using <TT>apa.cls</TT></A>
+<UL type="none">
+ <LI><A HREF="#titlhead">Title and headers</A>
+ <LI><A HREF="#sect">Sectioning</A>
+ <LI><A HREF="#enumser">Enumeration and seriation</A>
+ <LI><A HREF="#floats">Figures and tables</A>
+ <LI><A HREF="#condcomp">Conditional compilation</A>
+ <LI><A HREF="#fonts">Fonts</A>
+ <LI><A HREF="#bibcit">Bibliography and citations</A>
+ <LI><A HREF="#append">Appendices</A>
+ <LI><A HREF="#babel">Non-English documents</A>
+</UL>
+<LI><A HREF="#comlist">List of <TT>apa.cls</TT> commands</A>
+<LI><A HREF="#optlist">List of options to <TT>apa.cls</TT></A>
+<LI><A HREF="#problems">Possible problems</TT></A>
+</UL>
+
+<H2><A NAME="intro">Introduction</A></H2>
+
+<TT>apa.cls</TT> is a document class for typesetting manuscripts with LaTeX
+according to the rules of the 5th edition (2001) of the
+<A HREF="http://www.apastyle.org/">Publication Manual</A> of the
+<A HREF="http://www.apa.org/">American Psychological Association</A>.
+It simplifies writing of the manuscript, taking
+care of appearance and leaving only the content to the author (in true
+LaTeX fashion) and it also allows both for manuscript look and journal
+look with a simple option to the class-loading command. <P>
+
+<I>Note:</I>
+<TT>apa.cls</TT> is not in any way connected to, endorsed by, or even
+ probably known at all at the American Psychological Association.<P>
+
+An <A HREF="pdf/Protopapas_1998_Eutupon1.pdf">article</A> (in Greek) about <TT>apa.cls</TT>
+can be found in the first issue of
+<A HREF="http://obelix.ee.duth.gr/eft/english/eutupon.html">Eutupon</A>, the
+magazine of the
+<A HREF="http://obelix.ee.duth.gr/eft/english/index.html">Greek Tex Friends Group</A>.
+An English article is in preparation to appear some time in 2006.
+
+<H3>Manuscript look (man mode)</H3>
+In man mode, <TT>apa.cls</TT> typesets a title page, abstract page, text body, then
+references, appendices, author notes, footnotes, tables, figure captions, and
+figures. All text is double spaced. The title page contains
+the (centered) title, author name, affiliation, short title, and the
+running head (automatically capitalized). A note may be inserted in
+place of each table and figure in the text.
+The title is printed as a heading at the beginning of the text. <TT>\leftheader</TT>
+is ignored while the contents of <TT>\note</TT> are printed under the author
+names and affiliations, typically the date of submission. The &ldquo;Author
+Notes&rdquo; page contains the contents of <TT>\acknowledgements</TT>. A footnote
+page is produced if there is at least one footnote in the text.
+
+<H3>Printed journal look (jou mode)</H3>
+In jou mode, <TT>apa.cls</TT> typesets the text in double-sided, double column format, with
+an appropriately centered title, author names, affiliations, note,
+and abstract. The contents of acknowledgements are printed as
+footnotes in a box at the lower left corner of the first page.
+Journal-like headers can also be produced on the first page.
+Dimensions and overall &ldquo;look&rdquo; are modeled after
+<A HREF="http://www.apa.org/journals/xhp.html">JEP:HPP</A>. The purpose
+of this format is to produce readable and reasonably condensed output
+for double-sided printing and distribution.
+
+<H3>Regular LaTeX look (doc mode)</H3>
+In doc mode, <TT>apa.cls</TT> typesets the text in single-sided,
+single-column format, with
+an appropriately centered title, author names, affiliations, note,
+and abstract on the first page. The contents of acknowledgements are
+printed at the bottom of the first page. Section headings and
+enumeration follow the APA guidelines and floats (figures and tables)
+are inserted in the text where they are defined, as in regular LaTeX
+articles.
+The purpose of this format is to provide hardcopies during the
+development of articles that are later going to be submitted (using
+the manuscript format) and distrubuted (using the journal
+format). The advantage over using a regular article class is that all
+the extra definitions are supported and no changes need thus be made
+to the text other than the format parameter.
+
+<H2><A NAME="authver">Author and version</A></H2>
+
+<TT>apa.cls</TT> is written and maintained by
+<A HREF="mailto:protopap@ilsp.gr">Athanassios Protopapas</A>, who currently works at the
+<A HREF="http://www.ilsp.gr">Institute for Language &amp; Speech Processing</A> in Athens, Greece.
+The current version is 1.3.2, released on January 31st, 2006. It can found
+on <A HREF="http://www.ctan.org/tex-archive/macros/latex/contrib/other/apa/">CTAN</A>,
+the LaTeX <A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/apa.html">Catalogue</A>,
+or it may be <A HREF="dl/apa.tar.gz">downloaded from here</A>. There are no more recent
+&ldquo;working&rdquo; versions at this time.
+<P>
+<TT>apa.cls</TT> is distributed under the terms of the
+<A HREF="http://www.ctan.org/tex-archive/macros/latex/base/lppl.txt">LaTeX Project Public License</A>
+(lppl). In short, this means that the software is copyright but you are granted
+&ldquo;a license which gives you, the &lsquo;user&rsquo; of the software,
+legal permission to copy, distribute, and/or modify the software.
+However, if you modify the software and then distribute it (even just
+locally) you must change the name of the software to avoid confusion&rdquo;
+(quoted from <A HREF="http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html">
+The TeX Catalogue License Definitions</A>).
+<P>
+The history of <TT>apa.cls</TT> revisions can be found in the <A HREF="dl/apa/CHANGELOG.txt"><TT>CHANGELOG</TT></A> file.
+
+
+<H2><A NAME="maint">Maintainance and request for help</A></H2>
+
+There is still a lot of work to be done before <TT>apa.cls</TT> can be considered
+sufficiently complete. Unfortunately I don't have much time to devote to
+it any more, so updates are few and far between. I am quite ready to hand over the honor
+of maintaining <TT>apa.cls</TT> to someone fresh and willing. If you think <TT>apa.cls</TT> is
+worth some of your time and you would like to contribute to it, be sure
+to <A HREF="mailto:protopap@ilsp.gr">let me know</A>. Alternatively,
+feel free to work on one of the following topics (or something else you think is
+missing or in need of improvement) and send me the result:
+<UL>
+<LI>Stop messing with captions and use a standard package such as <TT>caption2</TT> or <TT>ccaption</TT> for all cases
+<LI>Stop messing with <TT>endfloat</TT> and use <TT>loflot</TT> or other appropriate package for the captions page
+<LI>Use <TT>fancyhdr</TT> for all headings in all modes
+<LI>Set entire appendix in smaller font size (including headings)
+<LI>Follow manual guidelines for table "Note" vs. probabilities (3.70/p. 170)
+<LI>Turn wide tables sideways automatically
+<LI>Clean up the font act &mdash; remove <TT>rm</TT>/<TT>hrm</TT>/<TT>hsl</TT> etc.
+<LI>Use the <TT>geometry</TT> package to set margins taking into account paper size (letter, A4)
+<LI>Add contact information command and field for first page (man mode only)
+<LI>Confirm need for continuation note at page end required with long tables (5.21/p. 301) and modify accordingly.
+</UL>
+<P>
+Although this is a purely &ldquo;free time&rdquo; project for me, in general
+I have tried to be responsive about requests related to <TT>apa.cls</TT> and
+especially when bugs or other problems are involved. Please do not hesitate
+to <A HREF="mailto:protopap@ilsp.gr">contact me</A> if you encounter
+difficulties or unexpected (or unacceptable) behavior when using <TT>apa.cls</TT>.
+However, I do ask that you make sure you have searched
+<A HREF="dl/apa/apacls.txt"><TT>apacls.txt</TT></A> and
+<A HREF="dl/apa/examples.txt"><TT>examples.txt</TT></A>
+and failed to find an answer to your problem in there before
+you send that e-mail message.
+<P>
+<TT>apa.cls</TT> has a well defined scope and purpose, and I'm already too busy for it.
+Please don't request modifications or features that are not related to the
+stated purpose (which is to create manuscripts suitable for submission to APA journals
+and to typeset these same manuscripts in true journal look). For example, if you
+want the figures in the manuscript text but the rest as in man mode, then you're
+on your own as to how you might modify <TT>apa.cls</TT> (or not) to achieve that.
+In particular, <B>if you want to write your thesis, <TT>apa.cls</TT> is not for you</B>.
+Please do not write to me asking for help with this; your message will be ignored.
+Use <TT>apacite</TT> for APA-style citations and write your own typesetting code or
+search for a thesis class suitable for your University.
+
+
+<H2><A NAME="acks">Acknowledgments</A></H2>
+
+<TT>apa.cls</TT> was created a long time ago out of stylefile mutations based on
+<A HREF="http://www.ctan.org/tex-archive/macros/latex209/contrib/theapa/"><TT>theapa</TT></A>
+style by Young U. Ryu. Some of Young Ryu's code still survives in the current
+version, in particular the sectioning and seriation/enumeration commands.
+Many people have contributed to the development of <TT>apa.cls</TT> through bug reports,
+suggestions and requests for features and improvements, and even some actual code!
+The name of every contributor is mentioned in the <A HREF="dl/apa/CHANGELOG.txt"><TT>CHANGELOG</TT></A> and
+I am grateful to them all.
+
+
+<H2><A NAME="sysreq">System requirements</A></H2>
+
+Other than a running LaTeX2e installation and the
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/apacite.html"><TT>apacite</TT></A>
+package for APA style citations (<TT>sty</TT> and <TT>bst</TT>), there isn't much you need in order
+to use <TT>apa.cls</TT>. Required packages for man mode are
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/endfloat.html"><TT>endfloat</TT></A> and
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/endnotes.html"><TT>endnotes</TT></A>.
+For jou mode there are no required packages, but
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/fancyhdr.html"><TT>fancyhdr</TT></A>,
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/ftnright.html"><TT>ftnright</TT></A>,
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/txfonts.html"><TT>txfonts</TT></A> (or
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/pslatex.html"><TT>pslatex</TT></A>, or
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/times.html"><TT>times</TT></A> and
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/mathptm.html"><TT>mathptm</TT></A>), and
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/flushend.html"><TT>flushend</TT></A> are nice to have
+(after all, you want your article to really look like published, don't you?).
+
+
+<H2><A NAME="instr">Instructions for using <TT>apa.cls</TT></A></H2>
+
+<TT>apa.cls</TT> is distributed with two files you must read carefully before trying to use it,
+<A HREF="dl/apa/apacls.txt"><TT>apacls.txt</TT></A> and
+<A HREF="dl/apa/examples.txt"><TT>examples.txt</TT></A>. An online version of those instructions follows. You may also examine <A HREF="dl/apa/apaexample.tex"><TT>apaexample.tex</TT></A> (and the accompanying bibliography file <A HREF="dl/apa/examplebib.bib"><TT>examplebib.bib</TT></A>), which contains a minimal complete sample &ldquo;article&rdquo; that can be processed using <TT>apa.cls</TT> to produce an APA-style manuscript.
+<P>
+To use <TT>apa.cls</TT>, include one of the following at the top of your document preamble:<P>
+<TT>
+\documentclass[jou]{apa}<BR>
+\documentclass[man]{apa}<BR>
+\documentclass[doc]{apa}<BR>
+</TT>
+<P>
+You should not load the <TT>article</TT> class because it is automatically called by <TT>apa.cls</TT>.
+You should also <STRONG>not</STRONG> load any of the required or optional packages mentioned above
+using the command <TT>\usepackage</TT> because they are automatically loaded by
+<TT>apa.cls</TT> in the appropriate order.
+
+
+<H3><A NAME="titlhead">Title and header information</A></H3>
+
+In the preamble of your document, define the basic manuscript information:<P>
+<TT>
+\author{First Author and Second Author}<BR>
+\affiliation{Department of Both Authors\\ University}<BR>
+</TT>
+<P>
+If there is only one author or more than one author but all in the same department, use
+the <TT>\author</TT> command as in the above example, with all names in its argument; and use the <TT>\affiliation</TT> command for the department.
+If there are people from two different departments, use the <TT>\twoauthors</TT>
+and <TT>\twoaffiliations</TT> commands to group them appropriately:<P>
+<TT>
+\twoauthors{First Author(s)}{Second Author(s)}<BR>
+\twoaffiliations{Affiliation of 1st Author(s)}{Affiliation of 2nd Author(s)}<BR>
+</TT>
+<P>
+For three affiliations use <TT>\threeauthors</TT> and <TT>\threeaffiliations</TT>,
+and for four affiliations there's <TT>\fourauthors</TT> and <TT>\fouraffiliations</TT>. Five and six affiliations (and corresponding authors or author groups) are similarly supported (<TT>\fiveauthors</TT> and so on). If there
+are more than six departments involved you're out of luck with <TT>apa.cls</TT> and I doubt they would fit on the title page anyways.
+<P>
+In addition to authors and their affiliations, you should also define the following:<P>
+<TT>
+\abstract{Text of your abstract...}<BR>
+\acknowledgements{Author notes, acknowledgements, contact information...}<BR>
+\rightheader{Running head for journal look}<BR>
+\shorttitle{Short title for manuscript header}<BR>
+\leftheader{Left head for journal look}<BR>
+</TT>
+<P>
+These fields are not technically necessary for the document to pass through LaTeX, though they
+are obligatory for any real APA-style manuscript. If you don't define a right header
+or short title, they default to the title; if you don't define a left header, it
+defaults to the author name(s).<P>
+
+You may also define a note if you want:<P>
+<TT>
+\note{Date of current draft; or status; or additional address information...}<BR>
+</TT>
+<P>
+If you really want your document to have the journal look, you should also define
+the fields for the first page header, which in the journals hold
+reference and copyright information. In <TT>apa.cls</TT> there are:<P>
+<TT>
+\journal{Journal name}<BR>
+\volume{Volume, number, pages}<BR>
+\ccoppy{Copyright notice}<BR>
+\copnum{Serial number or other reference}<BR>
+</TT>
+<P>
+The content of these definitions is ignored in man mode (manuscript look),
+of course.
+<P>
+After these definitions in the preamble, you begin your manuscript in the
+regular LaTeX way and invoke the command to make the title page:<P>
+<TT>
+\begin{document}<BR>
+\maketitle<BR>
+</TT>
+<P>
+Do not leave a blank line between these two commands. Also, do
+<STRONG>not</STRONG> leave a blank line between <TT>\maketitle</TT>
+and the beginning of your (introduction) text, either. This is
+important for the correct typesetting of the first manuscript page.
+
+
+<H3><A NAME="sect">Sectioning</A></H3>
+
+The default sectioning for <TT>apa.cls</TT> maps the standard LaTeX sectioning
+commands <TT>\section</TT>, <TT>\subsection</TT>, and <TT>\subsubsection</TT> to
+the three-level heading definitions of the APA manual. See
+<A HREF="dl/apa/examples.txt"><TT>examples.txt</TT></A> for usage examples.<P>
+
+If you need
+more or fewer heading levels, you can use the command <TT>\headinglevels{four}</TT>
+(or any number between one and five&mdash;spelled out&mdash;instead of four)
+and then use <TT>\paragraph</TT> and <TT>\subparagraph</TT> for the lower-level
+sectioning.
+
+Actually, if you need fewer than three levels you don't really need to do anything
+other than use only <TT>\section</TT> and <TT>\subsection</TT>, but if you do
+invoke the <TT>\headinglevels</TT> command, then the appearance of the manuscript
+will strictly conform to the APA guidelines for the fewer levels.
+<P>
+<I>Note:</I> Don't bother to <TT>\label</TT> your sections; since they are not
+numbered according to APA style, they cannot be referenced elsewhere in the document
+using <TT>\ref</TT>, so there is no point in labeling them.
+
+
+<H3><A NAME="enumser">Enumeration and seriation</A></H3>
+
+See file <A HREF="dl/apa/apaenum.txt"><TT>apaenum.txt</TT></A> in the
+<TT>apa.cls</TT> distribution. Enumeration and seriation are taken without
+modification from Young U. Ryu's code. In short, there are three kinds
+of environments, called <TT>seriate</TT>, <TT>enumerate</TT>, and
+<TT>itemize</TT>. They are used in the same way the standard LaTeX environments
+<TT>enumerate</TT> and <TT>itemize</TT> are used, but produce output according
+to the APA style. The <TT>seriate</TT>
+environment is used for inline enumeration, when you want to say, for example
+(a) one thing, (b) another thing, and (c) maybe a third thing, all in APA style.
+
+
+<H3><A NAME="floats">Float placement, loading, and content</A></H3>
+
+Floats, that is, figures and tables, are used in the regular LaTeX way,
+through the <TT>figure</TT> and <TT>table</TT> environments, respectively.
+You can use the <TT>t</TT> and <TT>b</TT> options for selectively putting
+a float at the top or bottom of a page. Always include <TT>p</TT> after
+<TT>t</TT> or <TT>b</TT> so that you won't risk
+running out of space if a float is too big. The <TT>h</TT> option for
+in-text figures is not recommended because it's not used in APA journals.
+<P>
+Remember to use <TT>\label</TT> for floats <STRONG>after</STRONG> the caption
+(and not inside it!)
+
+<H4>Images</H4>
+I assume that in figures we most often want to include an image for some graph
+or other kind of picture which is stored in a separate image file of
+the right kind (<TT>eps</TT> if we use <TT>latex</TT> with <TT>dvips</TT>,
+<TT>pdf</TT> if we use <TT>pdflatex</TT> or <TT>latex</TT> with <TT>dvipdfm</TT>).
+<P>
+An image can be included in any way you like, but <TT>apa.cls</TT> provides
+a way to deal automatically with fitting encapsulated postscript (EPS)
+files without worrying about dimensions or mode. Just use the command
+<TT>\fitfigure</TT> instead of <TT>\includegraphics</TT>.
+For example, if you want to include a graph from file <TT>graph1.eps</TT>, the
+simplest (and recommended) way is:<P>
+<TT>
+\begin{figure}[tp]<BR>
+\fitfigure{graph1}<BR>
+\caption{This is the caption of the figure.}<BR>
+\label{fig:fig1}<BR>
+\end{figure}<BR>
+</TT><P>
+You may include the image file extension (<TT>.eps</TT> in this case)
+in the <TT>\fitfigure</TT> or <TT>\includegraphics</TT> command,
+but if you omit it (as in the example), then if you happen to use <TT>pdflatex</TT> it
+will automatically load the corresponding <TT>.pdf</TT> graphic file (assuming
+you have made one with <TT>eps2pdf</TT>), while <TT>dvips</TT> will load the
+<TT>.eps</TT> file. In short, you don't need the extension, and leaving it out
+may make your life easier.
+<P>
+In case of a bitmap eps (as opposed to a graph or line drawing), you
+probably don't want it scaled in man mode, for best reproduction, so
+use <TT>\fitbitmap</TT> instead.
+<P>
+<I>Note:</I> If you want to include images in your manuscript, don't forget the command
+<TT>\usepackage{graphicx}</TT> in your preamble! You should
+<STRONG>not</STRONG> use
+<TT>epsfig</TT> or <TT>graphics</TT> instead of <TT>graphicx</TT>.
+
+<H4>Tables</H4>
+
+Tables are stretched to occupy the corresponding text width and are placed with
+appropriate typefaces etc., but it is your responsibility to format the
+tabular environments
+in accordance with the APA guidelines (e.g., no vertical lines, and so on).
+You should always <STRONG>precede</STRONG> the actual table body with its
+caption (i.e., use <TT>\caption</TT> before <TT>\begin{tabular}</TT>)
+or the results won't be conforming to the APA requirements for tables. <P>
+<P>
+To match the APA-journal look you can use <TT>\thickline</TT> (instead of
+<TT>\hline</TT>) for the top separator (right after starting the <TT>tabular</TT>
+environment).
+<P>
+Because a paragraph break is inserted in manuscript mode (optionally with an
+&ldquo;insert table/figure&rdquo; note), don't define tables in the middle of a
+paragraph.
+
+<H4>Wide (two-column) tables and figures</H4>
+When an image or table is too wide for a single column, use a double-column
+float, noted with an asterisk after the float environment designation (see
+the LaTeX book). For a wide (two-column) figure, use <TT>\begin{figure*}</TT>
+and <TT>\end{figure*}</TT>, instead of beginning and ending <TT>{figure}</TT>.
+For a two-column table, similary, begin and end a <TT>table*</TT> environment.
+<P>
+When using double column figures, it looks better in <TT>jou</TT> mode
+if you use <TT>\centeredcaption</TT> instead of caption, with the first parameter
+about equal to the width of the float (table or figure). This makes no difference in
+<TT>man</TT> mode.
+<P>
+If your table is too wide to fit upright on a manuscript page, load the <TT>rotating</TT>
+package and use a <TT>sidewaystable</TT> environment (instead of <TT>table</TT>). You
+need the special configuration file
+<A HREF="dl/apa/endfloat.cfg"><TT>endfloat.cfg</TT></A>, supplied with <TT>apa.cls</TT>,
+for this to work.
+
+<H4>Long tables</H4>
+
+By popular demand,
+<A HREF="http://www.ctan.org/tex-archive/help/Catalogue/entries/longtable.html"><TT>longtable</TT></A> now (sort of) works with
+<TT>apa.cls</TT>. You must <STRONG>not</STRONG> load the <TT>longtable</TT>
+package yourself, due to precedence requirements for proper endfloat
+function and cross-definitions. Instead, pass the <TT>longtable</TT>
+option to <TT>apa.cls</TT>. See the
+<A HREF="http://www.cmis.csiro.au/Graham.Williams/TeX/docs/longtable.pdf"><TT>longtable</TT> documentation</A> or
+the <A HREF="http://www.awprofessional.com/catalog/product.asp?product_id={32316FC4-94F5-4616-815D-F8691C44BC2B}">LaTeX Companion</A> for instructions on using <TT>longtable</TT>.
+<P>
+Since <TT>longtable</TT> only works in single-column documents it can only be
+used with <TT>man</TT> mode. Unfortunately the conditional compilation
+(<TT>ifapamode</TT>) commands won't work
+to keep a single table body and apply a mode-specific (<TT>table</TT> or
+<TT>longtable</TT>) environment because of illegal cross-nesting with
+environment begin/end. In fact the table environment won't even work
+inside in <TT>ifapamode</TT> argument, which makes it impossible to have a
+single file that can be processed for both <TT>man</TT> and <TT>jou</TT>. This defeats
+ the purpose of <TT>apa.cls</TT>, so only resort to <TT>longtable</TT> if you absolutely
+ have to.
+You will need the supplied <A HREF="dl/apa/endfloat.cfg"><TT>endfloat.cfg</TT></A> to use it.
+
+<H4>Notes in tables</H4>
+There is a simple way to include notes in
+tables such as, for example, to indicate levels of significance. The
+command <TT>\tabfnm{X}</TT> inside a table cell (tabular environment) produces
+the note mark. Use <TT>\tabfnt{X}{Note text}</TT> immediately before or after
+<TT>\end{tabular}</TT> inside the table environment to produce the note text.
+ See <A HREF="dl/apa/examples.txt"><TT>examples.txt</TT></A>. It is not possible
+to number the notes automatically, but since it is frequently necessary to refer
+to the same note repeatedly within a table (e.g., for a level of significance),
+automatic numbering would create more problems than it would solve.
+
+
+<H3><A NAME="condcomp">Conditional compilation</A></H3>
+
+You can have some text appear differently in each mode, or only appear
+in some mode(s). You can also modify the appearance of tables,
+figures, or equations between modes of compilation. Here's an
+unexciting example:<P>
+<TT>
+\ifapamodeman{This is printed in man mode only}{This is not man mode}
+</TT><P>
+You can also use the three-way switch:<P>
+<TT>The current mode is \ifapamode{man}{jou}{doc}</TT>
+
+
+<H3><A NAME="fonts">Document typefaces</A></H3>
+
+The journal format (<TT>jou</TT> mode) uses Times Roman by default (it does look like
+published after all). If you don't have <TT>txfonts.sty</TT> or <TT>pslatex.sty</TT> or <TT>times.sty</TT>, or
+if you just prefer computer modern fonts, add <TT>notimes</TT> after the <TT>jou</TT> option
+in the class line: <TT>\documentclass[jou,notimes]{apa}</TT> (<TT>notimes</TT> has no
+effect in modes other than <TT>jou</TT> and may be left in when switching).<P>
+
+The manuscript format (<TT>man</TT> mode) uses Computer Modern by default but can use
+Helvetica or typewriter look by using the options <TT>helv</TT> or <TT>tt</TT>,
+respectively. I find the result with either of these much more
+&ldquo;manuscript&rdquo;-like looking, especially using <TT>tt</TT>
+(<TT>\documentclass[man,tt]{apa}</TT>), but that's a matter of taste.
+These options have no effect in modes other than <TT>man</TT>
+and may be left in when switching.<P>
+
+In the document format (<TT>doc</TT> mode), Computer Modern are used be default
+and should probably be used all the time since, after all, this is supposed to
+be the most &ldquo;regular&rdquo; LaTeX-like format.
+
+
+<H3><A NAME="bibcit">Bibliography and citations</A></H3>
+
+
+<TT>apa.cls</TT> uses the
+<A HREF="http://www.ctan.org/tex-archive/biblio/bibtex/contrib/apacite/"><TT>apacite</TT></A>
+package by Erik Meijer for citations because it offers the complete coverage and excellent conformance
+to APA guidelines. Moreover, <TT>apacite</TT> has been recently updated (in 2005) and now
+handles electronic sources as well as non-English language forms.
+<P>
+You should count on using <TT>bibTeX</TT> with the corresponding
+<A HREF="http://www.ctan.org/tex-archive/biblio/bibtex/contrib/apacite/apacite.bst"><TT>apacite.bst</TT></A>
+style file for your bibliography. Citation commands include the standard <TT>bibtex</TT>
+options such as <TT>\cite</TT> but there are substantial extensions to cover other needs
+such as contracted <I>vs.</I> full author lists, author name only or year only for complex
+constructions, text preceding or following reference list in parentheses etc.
+For instructions on using the various citation forms and output examples get
+<A HREF="http://www.ctan.org/tex-archive/biblio/bibtex/contrib/apacite/apacite.tex"><TT>apacite.tex</TT></A>,
+<A HREF="http://www.ctan.org/tex-archive/biblio/bibtex/contrib/apacite/testAPA.tex"><TT>testAPA.tex</TT></A>, and
+<A HREF="http://www.ctan.org/tex-archive/biblio/bibtex/contrib/apacite/readme.apa"><TT>readme.apa</TT></A>
+from the CTAN mirror near you.
+<P>
+At the end of your document, before any appendices, issue the <TT>\bibliography</TT>
+command with the file names of the relevant <TT>bib</TT> files (standard <TT>bibtex</TT> usage). Do not use a
+<TT>\bibliographystyle</TT> command, because <TT>apacite</TT>
+is selected and loaded automatically (however, for backwards compatibility,
+any existing <TT>\bibliographystyle</TT> command is nicely ignored with a warning).
+
+
+<H3><A NAME="append">Appendices</A></H3>
+
+
+The appendix part comes last, that is, after the references section.
+Consistent with standard LaTeX usage, the command <TT>\appendix</TT> is used once,
+at the point where your (first) appendix starts, to signal the change from
+regular matter to appendix matter. From that point on, regular sectioning
+commands refer to appendix sections. In particular, each use of the <TT>\section</TT>
+command starts a new appendix. Use, for example<P>
+<TT>
+\section{Appendix Title}<BR>
+</TT><P>
+to start an appendix (even if there is only one). Each appendix has its title,
+while numbering (&ldquo;Appendix A,&rdquo; &ldquo;Appendix B&rdquo; etc.) is
+taken care of automatically in case there are more than one appendices.
+<P>
+You are free to
+use figures and tables in the usual way in the appendix(es). <TT>apa.cls</TT>
+will number them correctly and include them in the table and figure lists where they
+belong.
+<P>
+You may use
+cross-references to appendixes, because they are numbered, if there
+are more than one. A command such as <TT>\label{app:xxx}</TT> after the appendix
+<TT>\section</TT> sets the label. Then you may refer to this appendix with <P>
+<TT>Appendix~\ref{app:xxx}</TT><P>
+from anywhere in your manuscript.
+
+
+<H3><A NAME="babel">Non-English documents</A></H3>
+
+As of 2005, <TT>apa.cls</TT> and <TT>apacite</TT> can handle non-English documents with <TT>babel</TT>. Because there are potential conflicts between <TT>apacite</TT> and <TT>babel</TT>, you may not load <TT>babel</TT> from your document, but must pass it as an option to <TT>apa.cls</TT>, so that it can be loaded in the appropriate order and handled correctly. Desired languages are listed as additional options to <TT>apa.cls</TT>, and will be passed on to <TT>babel</TT> automatically when loaded. Remember that the main language of your document is the one listed <I>last</I>. For example, if your article is written in Dutch, use
+<PRE>
+\documentclass[man,babel,english,dutch]{apa}
+</PRE>
+If, however, your article is in English but you need support for Greek, for example to cite certain passages using <TT>\textgreek</TT>, then use
+<PRE>
+\documentclass[man,babel,greek,english]{apa}
+</PRE>
+instead.
+<P>
+<TT>apa.cls</TT> produces certain strings in the manuscript, mostly as titles to obligatory sections (pages): &ldquo;Running head,&rdquo; &ldquo;Author note,&rdquo; &ldquo;Figure captions,&rdquo; and &ldquo;Footnotes&rdquo; (other strings, such as &ldquo;Abstract,&rdquo; &ldquo;References,&rdquo; and the float labels &ldquo;Table&rdquo; and &ldquo;Figure&rdquo; are handled by <TT>babel</TT> and/or <TT>apacite</TT>). These strings are defined in external files, so new ones can easily be added. These files are named with the language name (as known by <TT>babel</TT>) and the extension <TT>.apa</TT> (for example, <TT>greek.apa</TT>). If the definitions for your languages are not supplied with <TT>apa.cls</TT>, copy <TT>english.apa</TT> with the new file name for your language, and edit the macro definitions inside the new file to display the correct strings in the new language. Send me the new file so it can be included with future distributions of <TT>apa.cls</TT>.
+
+<H3><A NAME="misc">Miscellaneous</A></H3>
+
+
+If you use vectors, the command \apavector{X} will make your life easier.
+<P>
+If you need to use additional options for <TT>article.cls</TT>, list them as <TT>apa.cls</TT> options and they will be automatically passed along to
+<TT>article.cls</TT>.
+
+
+<H2><A NAME="comlist">List of <TT>apa.cls</TT> commands</A></H2>
+
+In the following alphabetical list of commands you can see the number
+and kind of parameters needed for the use of each one:<P>
+<PRE>
+ \abstract{Abstract text}
+ \acknowledgements{Author notes etc.}
+ \affiliation{Department\\ University}
+ \twoaffiliations{Affiliation of 1st Author(s)}{Affil. of 2nd Author(s)}
+ \threeaffiliations{...}{...}{...}
+ \fouraffiliations{...}{...}{...}{...}
+ \fiveaffiliations{...}{...}{...}{...}{...}
+ \sixaffiliations{...}{...}{...}{...}{...}{...}
+ \apamatrix{M}
+ \apavector{A}
+ \appendix
+ \author{Author Name(s)}
+ \twoauthors{First Author(s)}{Second Author(s)}
+ \threeauthors{...}{...}{...}
+ \fourauthors{...}{...}{...}{...}
+ \fiveauthors{...}{...}{...}{...}{...}
+ \sixauthors{...}{...}{...}{...}{...}{...}
+ \ccoppy{Copyright notice}
+ \centeredcaption{width}{caption-text}
+ \copnum{Serial number}
+ \fitbitmap[optional-height]{eps-filename}
+ \fitfigure[optional-height]{eps-filename}
+ \ifapamode{man-code}{jou-code}{doc-code}
+ \ifapamodeman{man-mode-code}{doc-or-jou-code}
+ \ifapamodejou{jou-mode-code}{doc-or-man-code}
+ \ifapamodedoc{doc-mode-code}{man-or-jou-code}
+ \leftheader{Author name list}
+ \journal{Journal name}
+ \maketitle
+ \note{Draft/submission date, etc.}
+ \rightheader{Running head}
+ \shorttitle{Short title}
+ \tabfnm{a}
+ \tabfnt{a}{Note text}
+ \thickline
+ \title{Title}
+ \volume{Volume, number, pages}
+</PRE>
+
+
+<H2><A NAME="optlist">List of options to <TT>apa.cls</TT></A></H2>
+
+<DL>
+<DT><TT>babel</TT>
+ <DD>Loads <TT>babel</TT> to support hyphenation and features for languages other
+ than English. Desired languages should be listed as additional options
+ after <TT>babel</TT>.
+<DT><TT>fignum</TT>
+ <DD>Effective in <TT>man</TT> mode, adds figure numbering to the figure pages.
+ Makes it easier to refer to figures and I recommend it for the
+ reviewers' copies, but for the original figures you need to have
+ them printed without this and write the number with pencil on the back.
+<DT><TT>floatmark</TT>
+ <DD>Effective in <TT>man</TT> mode, inserts placeholders for floats in text
+ (&ldquo;Insert Figure X about here&rdquo; &ndash; no longer required by APA)
+<DT><TT>helv</TT>
+ <DD>Effective in <TT>man</TT> mode, uses Helvetica as the base typeface
+<DT><TT>longtable</TT>
+ <DD>Only usable in <TT>man</TT> mode, loads <TT>longtable.sty</TT> if
+ you <EM>really</EM> must use long tables in your manuscript.
+<DT><TT>nobf</TT>
+ <DD>Effective in <TT>man</TT> mode, turns off boldface in section headers for strict
+ conformance to APA style.
+<DT><TT>nosf</TT>
+ <DD>Effective in <TT>man</TT> mode, neutralizes the <TT>\helvetica</TT> command. <EM>This is
+ only included for backwards compatibility and should not be used any more since
+ the <TT>\helvetica</TT> command is not supported now.</EM>
+<DT><TT>notab</TT>
+ <DD>Effective in <TT>jou</TT> mode, cancels the automatic stretching of tabular
+ environments to the width of their enclosing float.
+<DT><TT>notimes</TT>
+ <DD>Effective in <TT>jou</TT> mode, cancels loading <TT>pslatex</TT> (or <TT>times</TT>) and
+ uses computer modern fonts.
+<DT><TT>notxfonts</TT>
+ <DD>Effective in <TT>jou</TT> mode, ignores search for <TT>txfonts</TT> and tries to load
+ <TT>pslatex</TT> (or <TT>times</TT>) in order to typeset with Times Roman.
+<DT><TT>tt</TT>
+ <DD>Effective in <TT>man</TT> mode, uses a typewriter base typeface
+</DL>
+
+<I>Note:</I> Options may be left in the <TT>\documentclass</TT> line when compiling
+any mode, since they are quietly ignored when they are not effective.<P>
+
+
+<H2><A NAME="problems">Possible problems</A></H2>
+
+
+If you follow the instructions you shouldn't really have any problems.
+In terms of restrictions, you should keep in mind that only up to six
+affiliations (for article author(s)) are supported, and that there is no
+provision for A4 paper dimensions (but see
+<A HREF="dl/apa/examples.txt"><TT>examples.txt</TT></A> for a workaround).<P>
+
+<CENTER><I>Last updated on January 10<SUP>th</SUP>, 2006<BR>by
+<A HREF="mailto:protopap@ilsp.gr">Athanassios Protopapas</I></CENTER>
+
+</BODY>
+
+</HTML> \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/apa/apacls.txt b/Master/texmf-dist/doc/latex/apa/apacls.txt
index c05f8ae7b00..83cae21ff64 100644
--- a/Master/texmf-dist/doc/latex/apa/apacls.txt
+++ b/Master/texmf-dist/doc/latex/apa/apacls.txt
@@ -1,7 +1,7 @@
This is file apacls.txt, which contains instructions for using the
APA LaTeX2e class file apa.cls
- Athanassios Protopapas ******* Version 1.3.0 August 2002
+ Athanassios Protopapas ******* Version 1.3.2 January 2006
Introduction
@@ -14,6 +14,11 @@ Introduction
changes. The headings and enumeration/seriation code is taken from
theapa.sty by Young U. Ryu.
+Note
+
+ apa.cls is not in any way connected to, endorsed by, or even
+ probably known at all at the American Psychological Association.
+
Description
@@ -43,7 +48,7 @@ Description
Journal-like headers can also be produced on the first page.
Dimensions and overall "look" are modeled after JEP:HPP. The purpose
of this mode is to produce readable and reasonably condensed output
- for double-sided xeroxing and distribution.
+ for double-sided printing and distribution.
c) Document mode (doc)
@@ -59,32 +64,32 @@ Description
development of articles that are later going to be submitted (using
the manuscript format) and distrubuted (using the journal
format). The advantage over using a regular article class is that all
- the extra definitions are supported and no changes need thus be made
+ the extra definitions related to APA style are supported (or simply
+ ignored without producing errors), so no changes need to be made
to the text other than the format parameter.
-Known bugs and restrictions:
+Known restrictions:
- - Up to four affiliations (for article author(s)) are supported.
- - There seems to be an incompatibility between apacite and babel.
- Since apacite is necessary, you may not be able to use babel.
+ - Up to six affiliations (for article author(s)) are supported.
- No provision for A4 paper. See examples for a workaround.
Other necessary files:
- For all modes you need apacite.sty and apacite.bst.
+ For all modes you need apacite.sty and apacite.bst. Download the
+ most recent version (June 2005 or later) for full compatibility.
For manuscript mode, you need endnotes.sty and endfloat.sty
- For journal mode, you need, optionally, pslatex.sty (or times.sty and
- mathptm.sty), ftnright.sty, fancyhdr.sty (for first page headers),
- and flushend.sty
+ For journal mode, optional packages include txfonts (or pslatex,
+ or times.sty and mathptm.sty), ftnright.sty, fancyhdr.sty (for
+ first page headers), and flushend.sty
To use this class, include one of the following
- \documentclass[jou]{apa} for the two-column output (Times-Roman default)
+ \documentclass[jou]{apa} for the two-column output (txfonts default)
\documentclass[man}{apa} for the manuscript (double-spaced) output
\documentclass[doc]{apa} for regular document (in computer modern)
@@ -100,10 +105,11 @@ To use this class, include one of the following
is ignored and a warning is issued).
The journal format uses Times Roman by default (it does look like
- published after all); if you don't have pslatex.sty or times.sty, or
- if you just prefer computer modern, add notimes after the jou option
- in the class line: \documentclass[jou,notimes]{apa} (notimes has no
- effect in modes other than jou and may be left in when switching)
+ published after all); if you don't have txfonts or pslatex or
+ times.sty, or if you just prefer computer modern, add notxfonts
+ after the jou option in the class line:
+ \documentclass[jou,notxfonts]{apa}
+ (this has no effect in modes other than jou and may be left in)
Manuscript format uses Computer Modern by default but can use
Helvetica or typewriter look by using the options helv or tt,
@@ -121,10 +127,14 @@ The following commands are defined and should/may be used:
or \twoauthors{First Author(s)}{Second Author(s)}
or \threeauthors{John and Jim}{Mary and Sue}{Nick}
or \fourauthors{Helen}{Dick}{Tracy and Larry}{James Bond}
+ or \fiveauthors{...}{...}{...}{...}{...}
+ or \sixauthors{...}{...}{...}{...}{...}{...}
\affiliation{Department\\ University}
or \twoaffiliations{Affiliation of 1st Author(s)}{Affil. of 2nd Author(s)}
or \threeaffiliations{U of A}{U of B}{U of C}
or \fouraffiliations{My Company}{Your Department}{Heaven}{Earth}
+ or \fiveaffiliations{...}{...}{...}{...}{...}
+ or \sixaffiliations{...}{...}{...}{...}{...}{...}
\maketitle % right after \begin{document}
@@ -138,7 +148,7 @@ The following commands are defined and should/may be used:
3. Optional, possibly helpful
- \note{Draft/submission date, etc.} % To add notes on first page
+ \note{Draft/submission date, etc.} % To add notes on first page
\thickline % Use in tables for the top line
\centeredcaption{width}{caption-text} % Used with double-column figures
% to create centered captions
@@ -154,7 +164,7 @@ The following commands are defined and should/may be used:
\ifapamode{man-code}{jou-code}{doc-code} % Do different things depending on
\ifapamodeman{man-mode-code}{doc-or-jou-code} % mode---you shouldn't have to use
\ifapamodejou{jou-mode-code}{doc-or-man-code} % any of these but they're here if
- \ifapamodedoc{doc-mode-code}{man-or-jou-code} % you want them. Parameters can
+ \ifapamodedoc{doc-mode-code}{man-or-jou-code} % you want them. Arguments can
% be left empty to do nothing
\journal{Journal name or other note} % Top left header on page one in
@@ -163,29 +173,34 @@ The following commands are defined and should/may be used:
\ccoppy{Copyright notice etc.} % Top right header in jou/doc p. 1
\copnum{Your hovercraft is full of eels} % Top right, under content of \ccoppy
- \tabfnm{a} % Put a note mark inside a table cell
+ \tabfnm{a} % Put a note mark inside a table cell
\tabfnt{a}{Note text} % Put the mark and text for a table note
\apavector{A} % Format a symbol as vector by APA rules
- \appendix % Standard LaTeX usage, starts off
- % appendix section(s)
+ \appendix % Standard LaTeX usage, starts off
+ % appendix section(s)
The following options are available:
These options must be combined with one of jou, man, doc.
- notimes : Effective in jou mode, cancels loading pslatex (or times) and
- uses computer modern fonts.
+ notxfonts: Effective in jou mode, prevents txfonts from loading, in case
+ pslatex (or times) is preferable for some reason
+ notimes : Effective in jou mode, cancels loading txfonts or pslatex or
+ times and uses computer modern fonts.
nosf : Effective in man mode, neutralizes the \helvetica command.
fignum : Effective in man mode, adds figure numbering to the figure pages.
Makes it easier to refer to figures and I recommend it for the
- reviewers' copies, but for the original figures you need to have
- them printed without this and write the number with pencil on the back.
+ reviewers' copies, but for the original figures you may have
+ to print them without this and write the number on the back.
notab : Effective in jou mode, cancels the automatic stretching of tabular
environments to the width of their enclosing float.
nobf : Effective in man mode, turns off boldface in section headers
- helv : Effective in man mode, uses Helvetica as the base typeface
- tt : Effective in man mode, uses a typewriter base typeface
+ helv : Effective in man mode, uses Helvetica as the base typeface
+ tt : Effective in man mode, uses a typewriter base typeface
+ babel : Effective every mode, loads babel to support languages other than
+ English. List the desired languages as additional options to
+ apa.cls after babel. The last language listed is the main one.
longtable: Only usable in man mode, loads longtable.sty if you *really* must
use long tables in your manuscript. See special note below
floatmark: Effective in man mode, inserts placeholders for floats in text
@@ -197,8 +212,8 @@ Notes on usage:
the \author command with all names and the \affiliation command. If
there are people from two different departments, use the \twoauthors
and \twoaffiliations commands to group them appropriately. For three
- affiliations use \threeauthors and \threeaffiliations, and guess what
- for four.
+ affiliations use \threeauthors and \threeaffiliations, and so on for
+ four, five, or six affiliations (and corresponding author groups).
Default sectioning maps \section, \subsection, and \subsubsection to
the three-level heading definitions of the APA manual. If you need
@@ -266,6 +281,9 @@ Notes on usage:
the purpose of apa.cls, so only resort to longtable if you absolutely
have to. You will need the supplied endfloat.cfg to use it.
+ Sideways tables: Use the rotating package and \sidewaystable. You will
+ need the supplied endfloat.cfg in your document directory for it to work.
+
Feedback:
@@ -275,10 +293,12 @@ Feedback:
Example of usage:
- See file examples.txt...
+ See examples.txt and apaexample.tex
PLEASE, read file examples.txt, it will probably solve your problems.
+ Online information: http://www.ilsp.gr/homepages/protopapas/apacls.html
+
-Thanassi Protopapas
-August 30, 2002
+Athanassios Protopapas
+January 5, 2005
diff --git a/Master/texmf-dist/doc/latex/apa/apaexample.tex b/Master/texmf-dist/doc/latex/apa/apaexample.tex
new file mode 100644
index 00000000000..81638b4bfed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/apa/apaexample.tex
@@ -0,0 +1,71 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% %
+% Athanassios Protopapas, October 2005 %
+% Mini-example for using apa.cls %
+% %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\documentclass[man]{apa}
+
+\title{Example of an APA-style manuscript}
+\author{Athanassios Protopapas}
+\affiliation{Institute for Language \& Speech Processing\\ Athens, Greece}
+
+\abstract{This is an example of a minimal ``manuscript'' using the \LaTeX\ apa.cls document class to typeset manuscripts according to the Americal Psychological Association (APA) manual, fifth edition.}
+
+\acknowledgements{Written at the request of the Prac\TeX\ journal editors.
+
+Comments may be sent to the author at protopap@ilsp.gr.}
+
+\shorttitle{APA style manuscript}
+\rightheader{APA style manuscript}
+\leftheader{A.\ Protopapas}
+
+\begin{document}
+\maketitle
+Here goes the text of the article. Note that the content begins immediately after \texttt{maketitle} and there is no blank line between the title command and the article text. This first section of the article is typically the introduction and, according to APA style, should not bear a section heading.\footnote{That is, there is no ``Introduction'' section.} Subsequent sections, however, are titled according to the psychological conventions.
+
+\section{Experiment 1}
+Manuscripts in APA style often contain descriptions of experiments. The APA manual specifications for referring to experiments are to use a lowercase ``e'' when speaking generally, as in the previous phrase, but an uppercase ``E'' when mentioning a particular experiment (as in the following phrase), such as Experiment~1.
+
+\subsection{Method}
+The ``method'' is a subsection of the experimental presentation in which all the details of setting up and conducting the experiment are described. There a number of more or less standard components to a method, shown below.
+\subsubsection{Participants}
+Psychological experiments are conducted with participants, usually humans. Note that these used to be called ``subjects'' but apparently APA now finds it inappropriate to refer to people with this term. Here we mention how many participants there were, their ages and other information about them.
+\subsubsection{Apparatus}
+Sometimes it is necessary to give the apparatus a special section.
+\subsubsection{Stimuli}
+What the subjects saw, heard, or felt.
+\subsubsection{Procedure}
+What happened to the poor subjects.
+\subsection{Results}
+In this subsection, one shows numbers and statistical analyses. Students are especially unlikely to read this section, but seasoned researchers often avoid it in the first reading, especially if the article is not of particular interest for their own research.
+\subsection{Discussion}
+If the results of the experiment mean anything, this is the place to talk about it.
+
+\section{Experiment 2}
+Usually one experiment is not enough to convince anyone; you need additional control experiments to make your point.
+\subsection{Method}
+The method can be the same as for the previous experiment, since here we are simply interested in showing the structure of the manuscript.
+\subsection{Results \& Discussion}
+This is a good point to show an example of a table following APA conventions. Note that we don't use any vertical separators and that columns can be grouped with partial horizontal lines.
+Also keep in mind that the caption must precede the table. The label is entirely optional, but useful for referring to the table in the text, for example this one would be Table~\ref{tab:tab1}.
+\begin{table}[tbp]
+\caption{Some numbers that could be experimental data.}
+\label{tab:tab1}
+\begin{tabular}{lcc}\hline
+ & \multicolumn{2}{c}{Factor 2} \\ \cline{2-3}
+Factor 1 & Condition A & Condition B \\ \hline
+First & 586 (231) & 649 (255) \\
+ & 2.2 & 7.5 \\
+Second & 590 (195) & 623 (231) \\
+ & 2.8 & 2.5 \\ \hline
+\end{tabular}
+\end{table}
+
+\section{General Discussion}
+In psychological articles there is usually some point to the whole experimental exercise, and in the end we get to discuss how important it all is. Although literature is supposed to have been covered in the introduction, for this example we can illustrate the use of bibliographic citations in this final section \cite{art1}. The accompanying package ``apacite'' by Erik Meijer provides everything an APA-style writer needs for citations, such as in-text citations in which one can claim that \citeA{boo1} mentioned or failed to mention something.
+
+\bibliography{examplebib}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/apa/endfloat.cfg b/Master/texmf-dist/doc/latex/apa/endfloat.cfg
new file mode 100644
index 00000000000..8584249f13b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/apa/endfloat.cfg
@@ -0,0 +1,86 @@
+%%
+%% This is file `endfloat.cfg',
+%% modifed from the original supplied with the endfloat package
+%% to handle both sideways floats and longtable
+%%
+%% Athanassios Protopapas <protopap@ilsp.gr>
+%% July 2005
+%%
+%% Original authors: James Darrell McCauley <jdm5548@diamond.tamu.edu>,
+%% Jeff Goldberg <j.goldberg@cranfield.ac.uk>
+%% Original version: Version 2.4i <October 1995>
+%%
+\RequirePackage{rotating}
+\let\efsaved@sidewaysfigure\sidewaysfigure
+\let\efsaved@sidewaystable\sidewaystable
+\let\efsaved@longtable\longtable
+\AtBeginTables{\let\sidewaystable=\efsaved@sidewaystable\relax}
+\AtBeginTables{\let\longtable=\efsaved@longtable\relax}
+\AtBeginFigures{\let\sidewaysfigure=\efsaved@sidewaysfigure\relax}
+\def\sidewaystable{\efloat@condopen{ttt}
+ \efloat@iwrite{ttt}{\string\begin{sidewaystable}}%
+ \if@domarkers
+ \addtocounter{posttbl}{1}
+ \tableplace
+ \fi
+ \def\@currenvir{efloat@float}%
+ \begingroup
+ \let\do\ef@makeinnocent \dospecials
+ \ef@makeinnocent\^^L% and whatever other special cases
+ \endlinechar`\^^M \catcode`\^^M=12 \ef@xsidetable}
+{\catcode`\^^M=12 \endlinechar=-1 %
+ \gdef\ef@xsidetable#1^^M{\def\test{#1}
+ \ifx\test\ef@endsidetabletest
+ \efloat@foundend{ttt}{sidewaystable}
+ \else
+ \efloat@iwrite{ttt}{#1}%
+ \let\next\ef@xsidetable
+ \fi \next}
+}
+\def\sidewaysfigure{\efloat@condopen{fff}
+ \efloat@iwrite{fff}{\string\begin{sidewaysfigure}}%
+ \if@domarkers
+ \addtocounter{postfig}{1}
+ \figureplace
+ \fi
+ \def\@currenvir{efloat@float}%
+ \begingroup
+ \let\do\ef@makeinnocent \dospecials
+ \ef@makeinnocent\^^L% and whatever other special cases
+ \endlinechar`\^^M \catcode`\^^M=12 \ef@xsidefigure}
+{\catcode`\^^M=12 \endlinechar=-1 %
+ \gdef\ef@xsidefigure#1^^M{\def\test{#1}
+ \ifx\test\ef@endsidefiguretest
+ \efloat@foundend{fff}{sidewaysfigure}
+ \else
+ \efloat@iwrite{fff}{#1}%
+ \let\next\ef@xsidefigure
+ \fi \next}
+}
+\def\longtable{\efloat@condopen{ttt}
+ \efloat@iwrite{ttt}{\string\begin{longtable}}%
+ \if@domarkers
+ \addtocounter{posttbl}{1}
+ \tableplace
+ \fi
+ \def\@currenvir{efloat@float}%
+ \begingroup
+ \let\do\ef@makeinnocent \dospecials
+ \ef@makeinnocent\^^L% and whatever other special cases
+ \endlinechar`\^^M \catcode`\^^M=12 \ef@xlongtable}
+{\catcode`\^^M=12 \endlinechar=-1 %
+ \gdef\ef@xlongtable#1^^M{\def\test{#1}
+ \ifx\test\ef@endlongtabletest
+ \efloat@foundend{ttt}{longtable}
+ \else
+ \efloat@iwrite{ttt}{#1}%
+ \let\next\ef@xlongtable
+ \fi \next}
+}
+{\escapechar=-1%
+ \xdef\ef@endsidefiguretest{\string\\end\string\{sidewaysfigure\string\}}%
+ \xdef\ef@endsidetabletest{\string\\end\string\{sidewaystable\string\}}
+ \xdef\ef@endlongtabletest{\string\\end\string\{longtable\string\}}}%
+\endinput
+%%
+%% End of file `endfloat.cfg'.
diff --git a/Master/texmf-dist/doc/latex/apa/examplebib.bib b/Master/texmf-dist/doc/latex/apa/examplebib.bib
new file mode 100644
index 00000000000..9449a4044f0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/apa/examplebib.bib
@@ -0,0 +1,14 @@
+@article{art1,
+author="First Last",
+title="A fictitious journal article",
+year=1900,
+journal="Journal of nothingness",
+volume=2,
+pages="1-2"}
+
+@book{boo1,
+author="Respectable Writer",
+title="A silly book",
+year=2000,
+publisher="PublishCo",
+address="Somewhere"}
diff --git a/Master/texmf-dist/doc/latex/apa/examples.txt b/Master/texmf-dist/doc/latex/apa/examples.txt
index d8600da334a..c6560368863 100644
--- a/Master/texmf-dist/doc/latex/apa/examples.txt
+++ b/Master/texmf-dist/doc/latex/apa/examples.txt
@@ -1,26 +1,40 @@
%
-% Athanassios Protopapas, August 2002
-% Examples for using apa.cls v1.3.0
+% Athanassios Protopapas, January 2006
+% Examples for using apa.cls v1.3.2
%
% This file contains examples of using the commands defined in apa.cls
-% It is not recommended that you use this as a sample document because
-% of its very short length, which makes for very awkward formatting.
-% In fact this file will not compile because of the commands that
-% are embedded in the text (unescaped backslashes all over the place)
+% Do not use this file as a sample document! It is only meant to show
+% how to use the macros appropriately, and will not even pass through
+% LaTeX successfully, because of many commands that are embedded in
+% the text (unescaped backslashes all over the place).
% Just use the examples of the commands you need.
%
+% See apaexample.tex if you want a file that will run through LaTeX and
+% produce sample output compatible with APA style.
+%
% The class command goes at the top
%
-\documentclass[fignum,jou]{apa}
+\documentclass[man]{apa}
%
% Change jou to man/doc for the other modes:
%
-%\documentclass[fignum,man]{apa}
-%\documentclass[fignum,doc]{apa}
+%\documentclass[jou]{apa}
+%\documentclass[doc]{apa}
%
% Here's what I use:
%\documentclass[nobf,fignum,tt,man]{apa}
%
+%If you need support for languages other than English, use babel.
+% Do not load babel with \usepackage from your document, because it will
+% clash with apacite. Pass the "babel" option to apa.cls to load along with
+% the language(s) you need.
+% If the main language of your document is different from English,
+% then list it last in the options list. For example, if the paper is in Dutch:
+%\documentclass[man,babel,english,dutch]{apa} % text in Dutch; English available
+% If the main language of your document is English but you need support
+% for another language (e.g., for short passages in Greek using \textgreek):
+%\documentclass[man,babel,greek,english]{apa} % text in English; Greek available
+%
% If you have postscript graphics to include, load the graphicx package
%
\usepackage{graphicx}
@@ -61,7 +75,7 @@
% Optional journal-like looking headers
%
\journal{Journal of nothing}\volume{First and Last Volume}
-\ccoppy{Copyright 2002 by Myself}\copnum{Some serial number}
+\ccoppy{Copyright 2006 by Myself}\copnum{Some serial number}
%
% End of definitions, begin document with title and then main text
%
@@ -124,7 +138,7 @@ A figure can be included in any way you like, but this class provides
a way to deal automatically with fitting encapsulated postscript (EPS)
files without worrying about dimensions or mode. Start your figure or
figure* environment as usual (see the LaTeX book) and then instead of
-\epsfig or \includegraphics use the new command \fitfigure:
+\includegraphics use the new command \fitfigure.
An example of a figure that loads a postscript file. You can use the
t and b options for selectively putting a figure at the top or bottom
@@ -132,7 +146,7 @@ of a page. Always include p after t or b so that you won't risk
running out of space if a figure is too big. The h option for
inserted figures is not recommended because it's not used in APA
journals. Don't forget \usepackage{graphicx} in your preamble!
---- not epsfig, not graphics.
+(not epsfig, not graphics).
\begin{figure}[tp]
\fitfigure{fig1} %% You could use {fig1.eps} here but see note below
@@ -165,7 +179,7 @@ probably don't want it scaled in man mode, for best reproduction, so
use \fitbitmap instead:
\begin{figure}[tp]
-\fitbitmap{bm1.eps} %% .eps not necessary -- see note above
+\fitbitmap{bm1.eps} %% ".eps" not necessary -- see note above
\caption{This is the caption of the figure.}
\label{fig:fig2}
\end{figure}
@@ -246,7 +260,7 @@ belong. Isn't apa.cls wonderful?
Just to show that another appendix is really just another section.
Also, it's a good opportunity to show how longtable should be used.
Remember, you must include the longtable option with the apa class if
-you need to use longtable. Also, remember, it only works in man mode.
+you need to use longtable. Also, keep in mind, it only works in man mode.
\begin{longtable}{lcc}
\caption{One sample caption for the sample long table.}