diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/amsrefs/00readme.txt')
-rw-r--r-- | Master/texmf-dist/source/latex/amsrefs/00readme.txt | 112 |
1 files changed, 63 insertions, 49 deletions
diff --git a/Master/texmf-dist/source/latex/amsrefs/00readme.txt b/Master/texmf-dist/source/latex/amsrefs/00readme.txt index 0dec0fb6419..824654406e4 100644 --- a/Master/texmf-dist/source/latex/amsrefs/00readme.txt +++ b/Master/texmf-dist/source/latex/amsrefs/00readme.txt @@ -1,7 +1,11 @@ -00readme.txt for amsrefs 2.0 [2004-06-30] +00readme.txt for amsrefs 2.02 [2007/10/01] -See also install.txt and manifest.txt. There is a history of changes at -the end of this file. +See also install.txt. There is a history of changes at the end of this +file. + +This material is copyrighted by the American Mathematical society and +released subject to the LaTeX Project Public License. See individual +files for additional information. Please send bug reports and questions to tech-support@ams.org. @@ -13,15 +17,15 @@ in standard LaTeX (\cite), but a number of additional variations address certain known pitfalls or gaps in the standard LaTeX set of citation features. -The command for bibliography items is different---\bib instead of -\bibitem---for reasons that will be evident upon further reading in the -documentation. +The command for bibliography items is different -- \bib instead of +\bibitem -- for reasons that will be evident upon further reading in +the documentation. A set of BibTeX style files are provided to allow people to extract data from .bib files and produce .bbl files in amsrefs format instead of conventional \bibitem format. -User documentation is in amsrdoc.pdf. +User documentation is in amsrdoc.pdf and amsrefs.faq. Technical documentation (including documentation for package writers) is in amsrefs.pdf. @@ -29,7 +33,7 @@ is in amsrefs.pdf. ======================================================================== I. FEATURES ----Preservation of structure. +-- Preservation of structure. The internal structural information of the bibliography entries is not lost when they are imported from the database file into the LaTeX @@ -37,17 +41,17 @@ document. This takes on its greatest significance when archiving documents in LaTeX form or transmitting them to another user (such as a publisher). ----Deferred formatting. +-- Deferred formatting. This means that the style of the bibliography can be changed on demand -without reimporting everything from the original database(s). +without re-importing everything from the original database(s). ----More natural data format for titles. +-- More natural data format for titles. Proper nouns do not need to have braces added to prevent capitalization problems. ----Less ambiguous format for author names. +-- Less ambiguous format for author names. When author names are given in inverted order (last name first) it is possible for LaTeX to unambiguously identify the last name without any @@ -57,28 +61,28 @@ Saunders) versus Stephen H. Lane (Lane, Stephen H.), or Cam Van Tran BibTeX some of these would need to have extra braces added to ensure that the surname is accurately distinguished. ----Author-year citations. +-- Author-year citations. There is integrated support for citations in author-year form. ----Back-reference support. +-- Back-reference support. Works in conjunction with the hyperref package. ----Setup requires only LaTeX knowledge. +-- Setup requires only LaTeX knowledge. All bibliography setup can be done in LaTeX; learning another programming language (such as, the one used in BibTeX bst files) is unnecessary. ----Self-printable database files. +-- Self-printable database files. A LaTeX document that contains only a bibliography in amsrefs forms can be used as a database for exporting entries to other documents. And because it is a LaTeX document, the database can be printed directly at any time simply by running it through LaTeX in the usual way. ----Self-contained. +-- Self-contained. In many cases it seems possible to do without BibTeX entirely. For example, if the entries are extracted from a single database file that @@ -93,51 +97,61 @@ II. GETTING STARTED 2. There are four example files provided: - cite-xa : Demonstrates an author-year citation scheme. The - bibliography is embedded in the .tex file instead of - residing in a separate .bbl file. - - cite-xb : Demonstrates usage with more-or-less standard BibTeX - methods. - - cite-xs : Shows how the bbl file can be created by LaTeX itself from a - suitably presorted ltb file. - - cite-xh : A working hyperref/backrefs example. - -3. Run LaTeX on cite-xa.tex. Take a look at the messages that have to do -with citations and the bibliography section. Run LaTeX again to resolve -the citations and check the output. + cite-xa : Demonstrates an author-year citation scheme. The + bibliography is embedded in the .tex file instead of + residing in a separate .bbl file. + + cite-xb : Demonstrates usage with more-or-less standard BibTeX + methods. + + cite-xs : Shows how the bbl file can be created by LaTeX itself from a + suitably presorted ltb file. + + cite-xh : A working hyperref/backrefs example. + +3. Run LaTeX on cite-xa.tex. Take a look at the messages that have to + do with citations and the bibliography section. Run LaTeX again to + resolve the citations and check the output. 4. Run LaTeX on cite-xb.tex. Run BibTeX. Look at the bbl file. -Interesting, huh? Run LaTeX twice more to resolve the citations. + Interesting, huh? Run LaTeX twice more to resolve the citations. 5. Run LaTeX on cite-xs.tex and look at the output. 6. Run pdflatex on cite-xh.tex (it is set up to use BibTeX also, like -cite-xb). + cite-xb). ======================================================================== III. REMARKS ON THIS RELEASE -This is a thorough overhaul and rewrite of the the amsrefs package. -Many (perhaps even most) of the internals have changed and a number of -new features have been added. Backwards compatibility for documents -created with previous versions of this package has been - -See changes.pdf for information on the user-visible changes. +This is a bug-fix release. No new features have been implemented and, +except for bug fixes, this version should be backwards compatible with +version 2.0. ======================================================================== -IV. SETTING UP A CUSTOM BIBLIOGRAPHY STYLE +IV. CHANGE LOG -More documentation is needed here, but the discussion in amsrefs.pdf -should be enough to get you started. See especially sections 4, 6.10, -6.26.15, and 6.27. +2004-06-30 amsrefs.dtx 2.0 -======================================================================== -V. CHANGE LOG + * Major rewrite of internals. See changes.pdf for information on + the user-visible changes. + +2006-10-25 amsrefs.dtx 2.02 + + -- Updated copyright and license fields. + -- Numerous bug fixes. -*amsrefs.dtx 2.0 2004-06-30 11:24:39 EDT + * amsrefs.dtx 2.02: + -- Fixed bug in copying cross-referenced entries from .ltb files + to the .bbl file. + -- Fixed disappearing table of contents when used with AMS + document classes. + -- Enabled xrefs in more fields. + -- Fixed spacing problems with \MR. Also be more forgiving if + the argument to \MR begins with "MR" or "MR ". + -- Added support for showlabels.sty. + -- Fixed some bugs in the interaction with hyperref. + -- Removed support for the obsolete beta and jpa package options. -Major rewrite of internals. See changes.pdf for information on the -user-visible changes. + * amsxport.dtx 2.01: + -- Fixed bug in sort order of references. |