achemso update

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

5 files changed, 119 insertions, 21 deletions

diff --git a/Master/texmf-dist/doc/latex/achemso/achemso-demo.tex b/Master/texmf-dist/doc/latex/achemso/achemso-demo.tex
index b5477d5855d..850c67228ce 100644
--- a/Master/texmf-dist/doc/latex/achemso/achemso-demo.tex
+++ b/Master/texmf-dist/doc/latex/achemso/achemso-demo.tex
@@ -1,13 +1,16 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% This is a (brief) model paper using the achemso class
 %% The document class accepts keyval options, which should include
-%% the target journal and optionally the macuscript tye
+%% the target journal and optionally the macuscript type.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \documentclass[journal=jacsat,manuscript=article]{achemso}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% Place any additional packages needed here.  Only include packages
-%% which are essential, to avoid problems later.
+%% which are essential, to avoid problems later. Do NOT use any
+%% packages which require e-TeX (for example etoolbox): the e-TeX
+%% extensions are not currently available on the ACS conversion
+%% servers.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \usepackage[version=3]{mhchem} % Formula subscripts using \ce{}
 
@@ -20,7 +23,7 @@
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% Place any additional macros here.  Please use \newcommand* where
-%% possible, and avoid layout changing macros (which are not used
+%% possible, and avoid layout-changing macros (which are not used
 %% when typesetting).
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \newcommand*{\mycommand}[1]{\texttt{\emph{#1}}}
@@ -41,6 +44,8 @@
 %% will typically be something like "University of Somewhere".
 %%
 %% The \altaffiliation macro should be used for new address, etc.
+%% On the other hand, \alsoaffiliation is used on a per author basis
+%% when authors are associated with multiple institutions.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \author{Andrew N. Other}
 \author{Fred T. Secondauthor}
@@ -50,6 +55,8 @@ Germany}
 \email{i.k.groupleader@unknown.uu}
 \affiliation[Unknown University]
 {Department of Chemistry, Unknown University, Unknown Town}
+\alsoaffiliation[Second University]
+{Department of Chemistry, Second University, Nearby Town}
 \author{Susanne K. Laborator}
 \email{s.k.laborator@bigpharma.co}
 \affiliation[BigPharma]
@@ -57,6 +64,8 @@ Germany}
 \author{Kay T. Finally}
 \affiliation[Unknown University]
 {Department of Chemistry, Unknown University, Unknown Town}
+\alsoaffiliation[Second University]
+{Department of Chemistry, Second University, Nearby Town}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% The document title should be given as usual
@@ -108,16 +117,19 @@ given if these should not be present.
 \subsection{References}
 
 The class makes various changes to the way that references are
-handled.  The class loads \textsf{natbib}, and also the appropriate
-bibliography style.  References can be made using the normal method;
-the citation should be placed before any punctuation, as the class
-will move it if using a superscript citation style
-\cite{Mena2000,Abernethy2003}. The use of \textsf{natbib} allows the
-use of the various citation commands of that package:
-\citeauthor{Abernethy2003} have shown something, or in
-\citeyear{Cotton1999}.  Long lists of authors will be automatically
-truncated in most article formats, but not in supplementary
-information or reviews \cite{Pople2003}.
+handled.  The class loads \textsf{natbib}, and also the
+appropriate bibliography style.  References can be made using
+the normal method; the citation should be placed before any
+punctuation, as the class will move it if using a superscript
+citation style \cite{Mena2000,Abernethy2003}. The use of
+\textsf{natbib} allows the use of the various citation commands
+of that package: \citeauthor{Abernethy2003} have shown
+something, in \citeyear{Cotton1999}, or as given by
+Ref.~\citenum{Mena2000}.  Long lists of authors will be
+automatically truncated in most article formats, but not in
+supplementary information or reviews \cite{Pople2003}. If you
+encounter problems with the citation macros, please check that
+your copy of \textsf{natbib} is up to date.
 
 Multiple citations to be combined into a list can be given as
 a single citation.  This uses the \textsf{mciteplus} package
@@ -149,6 +161,25 @@ illustrated, the float is ``here'' if possible.
   \label{sch:example}
 \end{scheme}
 
+\begin{figure}
+  As well as the standard float types \texttt{table}\\
+  and \texttt{figure}, the class also recognises\\
+  \texttt{scheme}, \texttt{chart} and \texttt{graph}.
+  \caption{An example figure}
+  \label{fgr:example}
+\end{figure}
+
+Charts, figures and schemes do not necessarily have to be labelled or
+captioned.  However, tables should always have a title. It is
+possible to include a number and label for a graphic without any
+title, using an empty argument to the \texttt{\textbackslash caption}
+macro.
+
+The use of the different floating environments is not required, but
+it is intended to make document preparation easier for authors. In
+general, you should place your graphics where they make logical
+sense; the production process will move them if needed.
+
 \subsection{Math(s)}
 
 The \textsf{achemso} class does not load any particular additional
@@ -157,6 +188,18 @@ support for mathematics.  If the author \emph{needs} things like
 the basics should work fine.  Some inline material $ y = mx + c$
 followed by some display. \[ A = \pi r^2 \]
 
+It is possible to label equations in the usual way.
+\begin{equation}
+  \frac{\mathrm{d}}{\mathrm{d}x} r^2 = 2r
+\end{equation}
+This can also be used to have equations containing graphical
+content.
+\begin{equation}
+  \textrm{Some content}
+  %\includegraphics{graphic}
+  \label{eqn:graphic}
+\end{equation}
+
 \section{Experimental}
 
 The usual experimental details should appear here.  This could
@@ -179,6 +222,29 @@ production.
   \end{tabular}
 \end{table}
 
+Adding notes to tables can be complicated.  Perhaps the easiest
+method is to generate these using the basic
+\texttt{\textbackslash textsuperscript} and
+\texttt{\textbackslash emph} macros, as illustrated
+(\ref{tbl:notes}).
+\begin{table}
+  \caption{A table with notes}
+  \label{tbl:notes}
+  \begin{tabular}{ll}
+    \hline
+    Header one & Header two \\
+    \hline
+    Entry one\textsuperscript{\emph{a}}
+      & Entry two \\
+    Entry three\textsuperscript{\emph{b}}
+      & Entry four \\
+  \hline
+  \end{tabular}
+
+  \textsuperscript{\emph{a}} Some text;
+  \textsuperscript{\emph{b}} Some more text.
+\end{table}
+
 The example file also loads the \textsf{mhchem} package, so
 that formulas are easy to input: \texttt{\textbackslash
 \ce\{H2SO4\}} gives \ce{H2SO4}.  See the use in the
@@ -190,28 +256,60 @@ not interfere with the production process.  For example,
 \texttt{\textbackslash mycommand} has been defined in this example,
 to give italic, monospaced text: \mycommand{some text}.
 
+\section{Extra information when writing JACS Communications}
+
+When producing communications for \emph{J.~Am.\ Chem.\ Soc.}, the
+class will automatically lay the text out in the style of the
+journal. This gives a guide to the length of text that can be
+accommodated in such a publication. There are some points to bear in
+mind when preparing a JACS Communication in this way.  The layout
+produced here is a \emph{model} for the published result, and the
+outcome should be taken as a \emph{guide} to the final length. The
+spacing and sizing of graphical content is an area where there is
+some flexibility in the process.  You should not worry about the
+space before and after graphics, which is set to give a guide to the
+published size. This is very dependant on the final published layout.
+
+You should be able to use the same source to produce a JACS
+Communication and a normal article.  For example, this demonstration
+file will work with both \texttt{type=article} and
+\texttt{type=communication}. Sections and any abstract are
+automatically ignored, although you will get warnings to this effect.
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% The "Acknowledgement" section can be given in all manuscript
-%% classes.  Rather than use \section, an appropriate macro is
-%% provided that will always work.
+%% classes.  This should be given within the "acknowledgement"
+%% environment, which will make the correct section or running title.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\acknowledgement
+\begin{acknowledgement}
+
+Please use ``The authors thank \ldots'' rather than ``The
+authors would like to thank \ldots''.
+
+The author thanks Mats Dahlgren for version one of \textsf{achemso},
+and Donald Arseneau for the code taken from \textsf{cite} to move
+citations after punctuation.
 
-Thanks to Mats Dahlgren for version one of \textsf{achemso},
-and Donald Arseneau for the code taken from \textsf{cite} to
-move citations after punctuation.
+\end{acknowledgement}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% The same is true for Supporting Information, which should use the
-%% \suppinfo macro.
+%% suppinfo environment.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\suppinfo
+\begin{suppinfo}
+
+This will usually read something like: ``Experimental procedures and
+characterization data for all new compounds. This material is
+availble free of charge via the Internet at
+\url{http://pubs.acs.org}.''
 
 The entire \textsf{achemso} bundle is generated by running
 \texttt{achemso.dtx} through \TeX. Running \LaTeX\ on the same file
 will generate the general documentation for both the class and
 package files.
 
+\end{suppinfo}
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% The appropriate \bibliography command should be placed here.
 %% Notice that the class file automatically sets \bibliographystyle
diff --git a/Master/texmf-dist/doc/latex/achemso/achemso-manual.pdf b/Master/texmf-dist/doc/latex/achemso/achemso-manual.pdf
deleted file mode 100644
index 40faaf8fcdd..00000000000
--- a/Master/texmf-dist/doc/latex/achemso/achemso-manual.pdf
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/achemso/achemso.pdf b/Master/texmf-dist/doc/latex/achemso/achemso.pdf
index 0f0f245b884..830422a1bc3 100644
--- a/Master/texmf-dist/doc/latex/achemso/achemso.pdf
+++ b/Master/texmf-dist/doc/latex/achemso/achemso.pdf
diff --git a/Master/texmf-dist/doc/latex/achemso/natmove-manual.pdf b/Master/texmf-dist/doc/latex/achemso/natmove-manual.pdf
deleted file mode 100644
index c6d0fa39495..00000000000
--- a/Master/texmf-dist/doc/latex/achemso/natmove-manual.pdf
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/achemso/natmove.pdf b/Master/texmf-dist/doc/latex/achemso/natmove.pdf
index b55909d3a95..10ae5a47162 100644
--- a/Master/texmf-dist/doc/latex/achemso/natmove.pdf
+++ b/Master/texmf-dist/doc/latex/achemso/natmove.pdf