Initial commit

1 files changed, 126 insertions, 0 deletions

diff --git a/macros/latex/contrib/mciteplus/README b/macros/latex/contrib/mciteplus/README
new file mode 100644
index 0000000000..7618ccbd14
--- /dev/null
+++ b/macros/latex/contrib/mciteplus/README
@@ -0,0 +1,126 @@
+
+
+September 13, 2013
+
+The mciteplus LaTeX package is an enhanced reimplementation of
+Thorsten Ohl's mcite package:
+
+http://www.ctan.org/tex-archive/macros/latex/contrib/mcite/
+
+which provides support for the grouping of multiple citations together
+as is often done in physics journals. An extensive set of features
+provide for other applications such as reference sublisting.
+
+Mciteplus offers the following features, many of which are not available
+with the original mcite:
+
+ 1. Entry punctuation can be controlled by the bibstyle (.bst) as well
+    as the user.
+
+ 2. No "double periods" when an entry already ends with a period
+    (e.g., an abbreviated journal name).
+
+ 3. Support for sublists.
+
+ 4. Support for multiple bibliographies and/or auxiliary files.
+
+ 5. The bibliography sample label width is automatically updated to
+    account for the changes in the numbering due to the grouped entries.
+    Maximum label width information is available to user.
+
+ 6. Compatible with the natbib package. (The bibstyle must support both
+    mciteplus as well as natbib.)
+
+ 7. Compatible with the REVTeX4 class. (The bibstyle must support both
+    mciteplus as well as natbib.)
+
+ 8. Support for the optional argument of \cite[]{}.
+
+ 9. Provides a means to allow users to use almost any cite command via
+    custom command wrappers and the ability to manually disable all
+    automatic internal hooks.
+
+10. Mciteplus compatible sorting bibstyles are possible via the use of a
+    "mcitetail" field in the BibTeX database entries.
+
+
+Please note that existing mcite bibstyles (.bst files) are not compatible
+with mciteplus. They will have to be remodified as explained in the
+mciteplus documentation.
+
+See the mciteplus_doc.pdf user manual for full details.
+
+For helpful tips, answers to frequently asked questions and other support,
+visit the Mciteplus home page at my website:
+
+http://www.michaelshell.org/tex/mciteplus/
+
+
+Enjoy!
+
+Michael Shell
+
+
+*******
+Version 1.2 (2013/09/13) changes:
+
+ 1) Add support for \citenum of natbib version 8.0 and later.
+    Thanks to Joseph Wright for reporting this.
+
+ 2) Corrected bug with cross-referenced entries with backref.sty.
+    Thanks to Martin Böttcher for reporting this problem.
+
+********************************** Files **********************************
+
+README              - This file.
+
+changelog.txt       - Version history.
+
+mciteplus.sty       - The mciteplus LaTeX package.
+
+mciteplus_doc.pdf   - The mciteplus user manual.
+
+mciteplus_doc.tex   - LaTeX source code for the user manual.
+
+mciteplus_code.txt  - Selected .bst modification and other code listings.
+
+apsrevM.bst         - An mciteplus compatible version of REVTeX4's 
+                      apsrev.bst.
+
+apsrmpM.bst         - An mciteplus compatible version of REVTeX4's 
+                      apsrmp.bst. Note: This is a sorting style. For it to
+                      work properly, you must set the "mcitetail" BibTeX
+                      database field for every tail entry.
+
+IEEEtranM.bst       - An mciteplus compatible version of IEEEtran.bst.
+
+IEEEtranMN.bst      - An mciteplus compatible version of IEEEtranN.bst
+                      (natbib compatible).
+
+***************************************************************************
+Legal Notice:
+This code is offered as-is without any warranty either expressed or
+implied; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE!
+User assumes all risk.
+In no event shall any contributor to this code be liable for any damages or
+losses, including, but not limited to, incidental, consequential, or any
+other damages, resulting from the use or misuse of any information contained
+here.
+
+All comments are the opinions of their respective authors.
+
+This work is distributed under the LaTeX Project Public License (LPPL)
+( http://www.latex-project.org/ ) version 1.3, and may be freely used,
+distributed and modified. A copy of the LPPL, version 1.3, is included
+in the base LaTeX documentation of all distributions of LaTeX released
+2003/12/01 or later.
+Retain all contribution notices and credits.
+** Modified files should be clearly indicated as such, including  **
+** renaming them and changing author support contact information. **
+
+File list of work: mciteplus.sty, mciteplus_doc.pdf, mciteplus_doc.tex,
+                   mciteplus_code.txt, apsrevM.bst, apsrmpM.bst,
+                   IEEEtranM.bst, IEEEtranMN.bst
+
+***************************************************************************