summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chem
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-08-20 14:54:32 +0000
committerKarl Berry <karl@freefriends.org>2011-08-20 14:54:32 +0000
commitfd5003bc0c73a154ca4fc2b76847cbda78a2148e (patch)
tree4b8ea489ab8155f921c3df17a059e384357c425e /Master/texmf-dist/doc/latex/biblatex-chem
parentb413025d048f633cd317a6ebeb85a0c212e974c1 (diff)
biblatex-chem (18aug11)
git-svn-id: svn://tug.org/texlive/trunk@23617 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chem')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.pdfbin371105 -> 311835 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.tex61
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.pdfbin355115 -> 296017 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.tex58
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.pdfbin355874 -> 296447 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.tex59
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.pdfbin352681 -> 293259 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.tex58
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.pdfbin309631 -> 376749 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex150
10 files changed, 137 insertions, 249 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.pdf b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.pdf
index ba8ae471ef2..21b9a70ea2d 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.tex b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.tex
index 161caba9994..1afe0afe3a7 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-acs.tex
@@ -10,7 +10,7 @@
\documentclass[a4paper]{ltxdoc}
\usepackage[T1]{fontenc}
-\usepackage[style=chem-acs]{biblatex}
+\usepackage[style=chem-acs,biblabel=dot]{biblatex}
\usepackage[final]{microtype}
\usepackage{csquotes,lmodern}
\usepackage{hyperref}
@@ -23,16 +23,11 @@
\href{mailto:joseph.wright@morningstar2.co.uk}
{\texttt{joseph.wright@morningstar2.co.uk}}}}
\title{The \pkg{chem-acs} bibliography style for \pkg{biblatex}%
- \footnote{This file describes v1.1a, last revised 2011/08/16.}}
-\date{Released 2011/08/16}
+ \footnote{This file describes v1.1c, last revised 2011/08/17.}}
+\date{Released 2011/08/17}
-\providecommand*\opt[1]{\texttt{#1}}
\providecommand*\pkg[1]{\textsf{#1}}
-\let\DescribeOption\DescribeEnv
-
-\RecordChanges
-
\begin{document}
\maketitle
@@ -48,60 +43,12 @@ style should be loaded in the usual way
\end{verbatim}
The References section of this document demonstrates the format
generated by the package using the \texttt{biblatex-chem.bib} database
-of example citations.
-
-\DescribeOption{doi}
-\DescribeOption{url}
-The standard \opt{doi} and \opt{url} options for bibliographies are supported
-by \texttt{chem-acs}, but as standard are set \opt{false}.
-
-\DescribeOption{articletitle}
-The use of article titles varies between individual journals. The
-boolean option \opt{articletitle} is available is control this behaviour,
-and is set \opt{false} as standard.
-
-\DescribeOption{chaptertitle}
-\citetitle{Coghill2006} leaves open the choice of whether to include the
-title for chapters when part of a book is cited. The option boolean
-\opt{chaptertitle} option is provided to allow flexiblity in this behaviour:
-the standard setting follows \emph{Journal of the American Chemical Society}
-and does not include chapter titles.
-
-\DescribeOption{pageranges}
-The use of full page ranges varies between journals and indeed between
-different papers in individual journals. The \opt{pageranges} boolean option
-is available to turn on and off printing of full page ranges, thus allowing
-printing of only the first page even when the database contains the full
-page range. This option is set \opt{true} as standard.
-
-Suggestions for improvement and bug reports can be logged in the package
-issue database, found at
-\url{https://bitbucket.org/josephwright/biblatex-chem/issues}, or can
-be sent by e-mail to
-\href{mailto:joseph.wright@morningstar2.co.uk}
- {\texttt{joseph.wright@morningstar2.co.uk}}.
+of example records.
\nocite{*}
\printbibliography
-\changes{v1.0}{2010/11/20}{First stable release}
-\changes{v1.0a}{2010/12/22}{Format \enquote{\emph{et al.}}~in italics
- when using \texttt{chem-rsc} style}
-\changes{v1.0b}{2011/01/10}{Require \pkg{biblatex} v1.1}
-\changes{v1.0b}{2011/01/10}{Use new \texttt{maxbibnames} option such
- that bibliographies print all authors but citations use truncated
- lists when necessary}
-\changes{v1.0c}{2011/01/11}{Add version history for stable releases}
-\changes{v1.0d}{2011/01/17}{Corrections for formatting of
- optionally-included article and chapter titles}
-\changes{v1.0d}{2011/01/17}{Include additional punctuation tracker
- corrections for non-English bibliographies}
-\changes{v1.1}{2011/08/15}{Styles revised to work with \pkg{biblatex} v1.6}
-\changes{v1.1a}{2011/08/16}{Turn off standard \opt{url} option by default}
-
-\PrintChanges
-
\end{document}
%%
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.pdf b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.pdf
index ff40e514062..546cca60e10 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.tex b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.tex
index 7f9f2c05720..a8ea458bac0 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-angew.tex
@@ -23,16 +23,11 @@
\href{mailto:joseph.wright@morningstar2.co.uk}
{\texttt{joseph.wright@morningstar2.co.uk}}}}
\title{The \pkg{chem-angew} bibliography style for \pkg{biblatex}%
- \footnote{This file describes v1.1a, last revised 2011/08/16.}}
-\date{Released 2011/08/16}
+ \footnote{This file describes v1.1c, last revised 2011/08/17.}}
+\date{Released 2011/08/17}
-\providecommand*\opt[1]{\texttt{#1}}
\providecommand*\pkg[1]{\textsf{#1}}
-\let\DescribeOption\DescribeEnv
-
-\RecordChanges
-
\begin{document}
\maketitle
@@ -47,59 +42,12 @@ loaded in the usual way
\end{verbatim}
The References section of this document demonstrates the format
generated by the package using the \texttt{biblatex-chem.bib} database
-of example citations.
-
-\DescribeOption{doi}
-\DescribeOption{url}
-The standard \opt{doi} and \opt{url} options for bibliographies are supported
-by \texttt{chem-angew}, but as standard are set \opt{false}.
-
-\DescribeOption{articletitle}
-The use of article titles varies between individual journals. The
-boolean option \opt{articletitle} is available is control this behaviour,
-and is set \opt{false} as standard.
-
-\DescribeOption{chaptertitle}
-The option boolean \opt{chaptertitle} option is provided to allow flexibility
-for the inclusion of chapter titles for \texttt{inbook} and \texttt{incollection}
-entries. The standard setting leaves this option off.
-
-\DescribeOption{pageranges}
-The use of full page ranges varies between journals and indeed between
-different papers in individual journals. The \opt{pageranges} boolean option
-is available to turn on and off printing of full page ranges, thus allowing
-printing of only the first page even when the database contains the full
-page range. This option is set \opt{true} as standard.
-
-Suggestions for improvement and bug reports can be logged in the package
-issue database, found at
-\url{https://bitbucket.org/josephwright/biblatex-chem/issues}, or can
-be sent by e-mail to
-\href{mailto:joseph.wright@morningstar2.co.uk}
- {\texttt{joseph.wright@morningstar2.co.uk}}.
+of example records.
\nocite{*}
\printbibliography
-\changes{v1.0}{2010/11/20}{First stable release}
-\changes{v1.0a}{2010/12/22}{Format \enquote{\emph{et al.}}~in italics
- when using \texttt{chem-rsc} style}
-\changes{v1.0b}{2011/01/10}{Require \pkg{biblatex} v1.1}
-\changes{v1.0b}{2011/01/10}{Use new \texttt{maxbibnames} option such
- that bibliographies print all authors but citations use truncated
- lists when necessary}
-\changes{v1.0c}{2011/01/11}{Add version history for stable releases}
-\changes{v1.0d}{2011/01/17}{Corrections for formatting of
- optionally-included article and chapter titles}
-\changes{v1.0d}{2011/01/17}{Include additional punctuation tracker
- corrections for non-English bibliographies}
-\changes{v1.1}{2011/08/15}{Styles revised to work with \pkg{biblatex} v1.6}
-\changes{v1.1a}{2011/08/16}{Turn off standard \opt{url} option by default}
-\changes{v1.1a}{2011/08/16}{Reintroduce \opt{chaptertitle} option}
-
-\PrintChanges
-
\end{document}
%%
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.pdf b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.pdf
index bbbc14ee065..310a5862d18 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.tex b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.tex
index db1abe02a48..e3005c28cd2 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-biochem.tex
@@ -23,16 +23,11 @@
\href{mailto:joseph.wright@morningstar2.co.uk}
{\texttt{joseph.wright@morningstar2.co.uk}}}}
\title{The \pkg{chem-biochem} bibliography style for \pkg{biblatex}%
- \footnote{This file describes v1.1a, last revised 2011/08/16.}}
-\date{Released 2011/08/16}
+ \footnote{This file describes v1.1c, last revised 2011/08/17.}}
+\date{Released 2011/08/17}
-\providecommand*\opt[1]{\texttt{#1}}
\providecommand*\pkg[1]{\textsf{#1}}
-\let\DescribeOption\DescribeEnv
-
-\RecordChanges
-
\begin{document}
\maketitle
@@ -48,60 +43,12 @@ style should be loaded in the usual way
\end{verbatim}
The References section of this document demonstrates the format
generated by the package using the \texttt{biblatex-chem.bib} database
-of example citations.
-
-\DescribeOption{doi}
-\DescribeOption{url}
-The standard \opt{doi} and \opt{url} options for bibliographies are supported
-by \texttt{chem-biochem}, but as standard are set \opt{false}.
-
-\DescribeOption{articletitle}
-The use of article titles varies between individual journals. The
-boolean option \opt{articletitle} is available is control this behaviour,
-and is set \opt{false} as standard.
-
-\DescribeOption{chaptertitle}
-\citetitle{Coghill2006} leaves open the choice of whether to include the
-title for chapters when part of a book is cited. The option boolean
-\opt{chaptertitle} option is provided to allow flexiblity in this behaviour:
-the standard setting follows \emph{Journal of the American Chemical Society}
-and does not include chapter titles.
-
-\DescribeOption{pageranges}
-The use of full page ranges varies between journals and indeed between
-different papers in individual journals. The \opt{pageranges} boolean option
-is available to turn on and off printing of full page ranges, thus allowing
-printing of only the first page even when the database contains the full
-page range. This option is set \opt{true} as standard.
-
-Suggestions for improvement and bug reports can be logged in the package
-issue database, found at
-\url{https://bitbucket.org/josephwright/biblatex-chem/issues}, or can
-be sent by e-mail to
-\href{mailto:joseph.wright@morningstar2.co.uk}
- {\texttt{joseph.wright@morningstar2.co.uk}}.
+of example records.
\nocite{*}
\printbibliography
-\changes{v1.0}{2010/11/20}{First stable release}
-\changes{v1.0a}{2010/12/22}{Format \enquote{\emph{et al.}}~in italics
- when using \texttt{chem-rsc} style}
-\changes{v1.0b}{2011/01/10}{Require \pkg{biblatex} v1.1}
-\changes{v1.0b}{2011/01/10}{Use new \texttt{maxbibnames} option such
- that bibliographies print all authors but citations use truncated
- lists when necessary}
-\changes{v1.0c}{2011/01/11}{Add version history for stable releases}
-\changes{v1.0d}{2011/01/17}{Corrections for formatting of
- optionally-included article and chapter titles}
-\changes{v1.0d}{2011/01/17}{Include additional punctuation tracker
- corrections for non-English bibliographies}
-\changes{v1.1}{2011/08/15}{Styles revised to work with \pkg{biblatex} v1.6}
-\changes{v1.1a}{2011/08/16}{Turn off standard \opt{url} option by default}
-
-\PrintChanges
-
\end{document}
%%
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.pdf b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.pdf
index 96834f99094..c42b58bd959 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.tex b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.tex
index 90ced143b0a..18fd88544e0 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem-rsc.tex
@@ -23,16 +23,11 @@
\href{mailto:joseph.wright@morningstar2.co.uk}
{\texttt{joseph.wright@morningstar2.co.uk}}}}
\title{The \pkg{chem-rsc} bibliography style for \pkg{biblatex}%
- \footnote{This file describes v1.1a, last revised 2011/08/16.}}
-\date{Released 2011/08/16}
+ \footnote{This file describes v1.1c, last revised 2011/08/17.}}
+\date{Released 2011/08/17}
-\providecommand*\opt[1]{\texttt{#1}}
\providecommand*\pkg[1]{\textsf{#1}}
-\let\DescribeOption\DescribeEnv
-
-\RecordChanges
-
\begin{document}
\maketitle
@@ -47,59 +42,12 @@ loaded in the usual way
\end{verbatim}
The References section of this document demonstrates the format
generated by the package using the \texttt{biblatex-chem.bib} database
-of example citations.
-
-\DescribeOption{doi}
-\DescribeOption{url}
-The standard \opt{doi} and \opt{url} options for bibliographies are supported
-by \texttt{chem-rsc}, but as standard are set \opt{false}.
-
-\DescribeOption{articletitle}
-The use of article titles varies between individual journals. The
-boolean option \opt{articletitle} is available is control this behaviour,
-and is set \opt{false} as standard.
-
-\DescribeOption{chaptertitle}
-The option boolean \opt{chaptertitle} option is provided to allow flexibility
-for the inclusion of chapter titles for \texttt{inbook} and \texttt{incollection}
-entries. The standard setting leaves this option off.
-
-\DescribeOption{pageranges}
-The use of full page ranges varies between journals and indeed between
-different papers in individual journals. The \opt{pageranges} boolean option
-is available to turn on and off printing of full page ranges, thus allowing
-printing of only the first page even when the database contains the full
-page range. This option is set \opt{true} as standard.
-
-Suggestions for improvement and bug reports can be logged in the package
-issue database, found at
-\url{https://bitbucket.org/josephwright/biblatex-chem/issues}, or can
-be sent by e-mail to
-\href{mailto:joseph.wright@morningstar2.co.uk}
- {\texttt{joseph.wright@morningstar2.co.uk}}.
+of example records.
\nocite{*}
\printbibliography
-\changes{v1.0}{2010/11/20}{First stable release}
-\changes{v1.0a}{2010/12/22}{Format \enquote{\emph{et al.}}~in italics
- when using \texttt{chem-rsc} style}
-\changes{v1.0b}{2011/01/10}{Require \pkg{biblatex} v1.1}
-\changes{v1.0b}{2011/01/10}{Use new \texttt{maxbibnames} option such
- that bibliographies print all authors but citations use truncated
- lists when necessary}
-\changes{v1.0c}{2011/01/11}{Add version history for stable releases}
-\changes{v1.0d}{2011/01/17}{Corrections for formatting of
- optionally-included article and chapter titles}
-\changes{v1.0d}{2011/01/17}{Include additional punctuation tracker
- corrections for non-English bibliographies}
-\changes{v1.1}{2011/08/15}{Styles revised to work with \pkg{biblatex} v1.6}
-\changes{v1.1a}{2011/08/16}{Turn off standard \opt{url} option by default}
-\changes{v1.1a}{2011/08/16}{Reintroduce \opt{chaptertitle} option}
-
-\PrintChanges
-
\end{document}
%%
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.pdf b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.pdf
index 5c016ee0450..f6d3c600228 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
index bb4fa789878..45646f48ff2 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
@@ -21,51 +21,143 @@
{\texttt{joseph.wright@morningstar2.co.uk}}}}
\title{\pkg{biblatex-chem} -- A set of \pkg{biblatex} implementations of
chemistry-related bibliography styles%
- \footnote{This file describes v1.1a, last revised 2011/08/16.}}
-\date{Released 2011/08/16}
+ \footnote{This file describes v1.1c, last revised 2011/08/17.}}
+\date{Released 2011/08/17}
\providecommand*\opt[1]{\texttt{#1}}
\providecommand*\pkg[1]{\textsf{#1}}
+\let\DescribeOption\DescribeEnv
+
\RecordChanges
\begin{document}
\maketitle
-The \pkg{biblatex-chem} bundle is a set of styles for creating bibliographies
-using \pkg{biblatex} in the style of a number common chemistry journals. The
-bundle comprises styles based on the conventions of the Royal Society of
-Chemistry, American Chemical Society and \emph{Angewandte Chemie}. It therefore
-covers the journal styles of, for example:
-\begin{itemize}
- \item \emph{Angewandte Chemie}
- \item \emph{Biochemistry}
- \item \emph{Chemical Communications}
- \item \emph{Chemistry~--~A European Journal}
- \item \emph{Dalton Transactions}
- \item \emph{Journal of the American Chemical Society}
- \item \emph{Organic \& Biomolecular Chemistry}
-\end{itemize}
-amongst others.
+\begin{abstract}
+ The \pkg{biblatex-chem} bundle is a set of styles for creating bibliographies
+ using \pkg{biblatex} in the style of a number common chemistry journals. The
+ bundle comprises styles based on the conventions of the Royal Society of
+ Chemistry, American Chemical Society and \emph{Angewandte Chemie}. It
+ therefore covers the journal styles of, for example:
+ \begin{itemize}
+ \item \emph{Angewandte Chemie}
+ \item \emph{Biochemistry}
+ \item \emph{Chemical Communications}
+ \item \emph{Chemistry~--~A European Journal}
+ \item \emph{Dalton Transactions}
+ \item \emph{Journal of the American Chemical Society}
+ \item \emph{Organic \& Biomolecular Chemistry}
+ \end{itemize}
+ amongst others.
+\end{abstract}
+
+\section{Introduction}
+
+The \pkg{biblatex} package introduces a completely new method for controlling
+the creation of bibliographies using \BibTeX{}. This makes a great deal of
+flexibility available when creating bibliographies, most of which is much more
+difficult with traditional \BibTeX{} styles.
+
+In order to use \pkg{biblatex}, an entirely new set of appropriate supporting
+styles are needed. This bundle provides a number of styles for chemistry,
+following the rules of some of the most important journals in the field.
+
+\section{The styles}
The bundle currently contains four \pkg{biblatex} style files, each of
-which has its own documentation:
+which has its own demonstration document:
\begin{itemize}
- \item The \href{file:biblatex-chem-acs.pdf}{\texttt{chem-acs}} style,
+ \item The \href{file:biblatex-chem-acs.pdf}{\pkg{chem-acs}} style,
which covers most American Chemistry Society journals.
- \item The \href{file:biblatex-chem-angew.pdf}{\texttt{chem-angew}} style,
+ \item The \href{file:biblatex-chem-angew.pdf}{\pkg{chem-angew}} style,
which covers \emph{Angewandte Chemie}
\emph{Chemistry~--~A European Journal}.
- \item The \href{file:biblatex-chem-biochem.pdf}{\texttt{chem-biochem}}
+ \item The \href{file:biblatex-chem-biochem.pdf}{\pkg{chem-biochem}}
style, which covers \emph{Biochemistry} and a small number of other
American Chemistry Society journals.
- \item The \href{file:biblatex-chem-rsc.pdf}{\texttt{chem-rsc}} style,
+ \item The \href{file:biblatex-chem-rsc.pdf}{\pkg{chem-rsc}} style,
which covers all Royal Society of Chemistry journals.
\end{itemize}
-Suggestions for improvement and bug reports can be logged in the package
-issue database, found at
+The four styles can be used to follow the current layout rules of all of the
+journals currently published by the American Chemical Society and the Royal
+Society of Chemistry, plus the journals published by Wiley which use the
+\emph{Angewandte Chemie} format.
+
+The styles use the standard \pkg{biblatex} database requirements. This means
+that a database designed for traditional \pkg{biblatex} use may need some
+editing for optimal output. The accompanying example database
+\texttt{biblatex-chem.bib} shows examples of all of the supported entry types
+with common fields filled in.
+
+\section{Style options}
+
+All of the styles here add a small number of package options to the standard
+set provided by \pkg{biblatex}. This allows the styles to cover the variations
+seen between different journals without needing a very large number of files:
+the American Chemical Society in particular varies the exact details between
+journals.
+
+\DescribeOption{doi}
+\DescribeOption{eprint}
+\DescribeOption{isbn}
+\DescribeOption{url}
+The standard style options \opt{doi}, \opt{eprint} \opt{isbn} and
+\opt{eprint}, as described in the \pkg{biblatex} manual. However, these
+options are turned off as standard by the styles in the \pkg{biblatex-chem}
+bundle. This reflects the fact that these entries may be present in reference
+databases but are not generally included in published bibliographies. Note
+that \textsc{doi} values are printed for journal articles with no pages
+given, even if the \opt{doi} option is \opt{false}
+
+\DescribeOption{subentry}
+In common with the standard \pkg{biblatex} numeric styles, all of the styles
+in the bundle support the boolean \texttt{subentry} option. With this set
+\opt{true}, entries of type \texttt{set} are given individual labels within
+the bibliography.
+
+\DescribeOption{articletitle}
+The use of article titles varies between individual journals. The
+boolean option \opt{articletitle} is available is control this behaviour.
+The standard settings for the \pkg{chem-acs}, \pkg{chem-angew}
+and \pkg{chem-rsc} styles have this option turned off, while the
+\pkg{chem-biochem} sets this option \opt{true}.
+
+\DescribeOption{biblabel}
+The format of the numbers used in the bibliography (the \enquote{bibliography
+label}) varies from journal to journal even if the same general style is used.
+The \opt{biblabel} option allows the user to easily set the format used. This
+option takes a value from the list: \opt{parens}, \opt{brackets}, \opt{plain}
+and \opt{dot}.
+
+\DescribeOption{chaptertitle}
+The option boolean \opt{chaptertitle} option is provided to allow flexibility
+for the inclusion of chapter titles for \texttt{inbook} and
+\texttt{incollection} entries. The standard setting is \opt{false} for all
+styles in the bundle.
+
+\DescribeOption{pageranges}
+The use of full page ranges varies between journals and indeed between
+different papers in individual journals. The \opt{pageranges} boolean option
+is available to turn on and off printing of full page ranges, thus allowing
+printing of only the first page even when the database contains the full
+page range. This option is set \opt{true} as standard.
+
+\section{New styles}
+
+The current set of styles here is intended to form a strong base for chemists.
+However, there will be the need for other styles to be created. The package
+author welcomes suggestions for other styles for inclusion. It would also be
+good to keep all chemistry-related \pkg{biblatex} styles in one bundle. Others
+working on chemistry styles for \pkg{biblatex} are welcome to send them to the
+bundle maintainer so they can be incorporated here.
+
+\section{Errors and omissions}
+
+Suggestions for improvement and bug reports can be logged in the package issue
+database, found at
\url{https://bitbucket.org/josephwright/biblatex-chem/issues}, or can
be sent by e-mail to
\href{mailto:joseph.wright@morningstar2.co.uk}
@@ -75,7 +167,7 @@ be sent by e-mail to
\changes{v1.0a}{2010/12/22}{Format \enquote{\emph{et al.}}~in italics
when using \texttt{chem-rsc} style}
\changes{v1.0b}{2011/01/10}{Require \pkg{biblatex} v1.1}
-\changes{v1.0b}{2011/01/10}{Use new \texttt{maxbibnames} option such
+\changes{v1.0b}{2011/01/10}{Use new \opt{maxbibnames} option such
that bibliographies print all authors but citations use truncated
lists when necessary}
\changes{v1.0c}{2011/01/11}{Add version history for stable releases}
@@ -86,7 +178,13 @@ be sent by e-mail to
\changes{v1.1}{2011/08/15}{Styles revised to work with \pkg{biblatex} v1.6}
\changes{v1.1a}{2011/08/16}{Turn off standard \opt{url} option by default}
\changes{v1.1a}{2011/08/16}{Reintroduce \opt{chaptertitle} option for
- \texttt{chem-angew} and \texttt{chem-rsc} styles}
+ \pkg{chem-angew} and \pkg{chem-rsc} styles}
+\changes{v1.1a}{2011/08/16}{Turn off standard \opt{eprint}
+ and \opt{isbn} options by default}
+\changes{v1.1b}{2011/08/16}{Further documentation improvements}
+\changes{v1.1b}{2011/08/16}{Re-introduce the \opt{biblabel} option}
+\changes{v1.1c}{2011/08/17}{Correct bug in entries with no date in
+ \pkg{chem-acs} and \pkg{chem-acs} styles}
\PrintChanges