summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/amsrefs/install.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/amsrefs/install.txt')
-rw-r--r--Master/texmf-dist/source/latex/amsrefs/install.txt97
1 files changed, 44 insertions, 53 deletions
diff --git a/Master/texmf-dist/source/latex/amsrefs/install.txt b/Master/texmf-dist/source/latex/amsrefs/install.txt
index ebf0f21d9ed..8fd6c4d0315 100644
--- a/Master/texmf-dist/source/latex/amsrefs/install.txt
+++ b/Master/texmf-dist/source/latex/amsrefs/install.txt
@@ -1,9 +1,9 @@
-install.txt for amsrefs 2.0 [2004-06-30]
+install.txt for amsrefs 2.12 [2013-01-24]
-Copyright 2002-2004, 2010 American Mathematical Society.
+Copyright 2002-2004, 2010, 2013 American Mathematical Society.
-This work may be distributed and/or modified under the
-conditions of the LaTeX Project Public License, either version 1.3c
+This work may be distributed and/or modified under the conditions
+of the LaTeX Project Public License, either version 1.3c
of this license or (at your option) any later version.
The latest version of this license is in
http://www.latex-project.org/lppl.txt
@@ -26,72 +26,63 @@ tel: (401) 455-4080
fax: (401) 331-3842
email: tech-support@ams.org
-%%%% THIS NEEDS TO BE REVISED. WE'RE GOING TO KEEP THESE SEPARATE
-
Preliminary note: The normal destination directory for amsrefs.sty in a
-standard TDS structure would be texmf/tex/latex/amscls (see step 3
-below). In the future, the amsrefs package will be integrated more
-thoroughly into the amscls distribution, but the current release has to
-be provided in the form of a separate distribution for those who already
-have the amscls distrib but not amsrefs.
+standard TDS structure is texmf/tex/latex/amsrefs (see step 3 below).
------------------------------------------------------------------------
-The first step is to identify the primary location for LaTeX input files
-on your system. Typical examples are
+If you have a relatively up-do-date TeX system that complies with the
+TeX Directory Structure (TDS) standard, installing according to the
+instructions in section I below is the easiest method. See
+
+ http://www.tug.org/tds/tds.pdf
- /usr/local/share/texmf/tex/latex... (Unix)
+for details on the TDS standard. If your TeX system does not comply
+with the TDS standard, please contact the manufacturer of your TeX
+system for details on how to install third-party TeX packages.
- C:\SWP30\TCITeX\TeX\LaTeX... (Windows)
+The first step is to identify the TEXMF folder that contains files used
+by LaTeX. To do this, look for the file article.cls. If you find, e.g.,
-We define "ROOT" to mean everything preceding the "/tex/latex" part. In
-the second example, this would be "C:\SWP30\TCITeX". ROOT will normally
-end in "texmf"; if it doesn't you may need to consult the documentation
-for your TeX system to find out what to use. In the following
-instructions, wherever you see ROOT substitute the actual directory or
-folder name that is used on your system.
+ /usr/local/share/texmf/tex/latex/base/article.cls
-If this terminology doesn't make sense to you, seek assistance from
-a friend or colleague, or from the company that you bought your TeX
-system from, or contact us at
+then we will define TEXMF to mean /usr/local/share/texmf (everything
+before the tex/latex/base part). On a Windows system the file location
+will probably be something like
- tech-support@ams.org
- 800-321-4AMS (321-4267) (USA/Canada)
- 401-455-4080
+ c:\sw\texmf\tex\latex\base\article.cls
-If you have multiple texmf trees (as discussed, for example, in the
-teTeX documentation), you may want to install amsrefs using the
-TEXMFLOCAL tree as the value of ROOT. In due course when you upgrade to
-a newer TeX system, we expect that you will find amsrefs already
-incorporated into the TEXMFMAIN tree as part of the tex/latex/amscls
-area, at which point you will no longer need the copy in your TEXMFLOCAL
-tree.
+Then we define TEXMF to mean c:\sw\texmf. In the following instructions,
+wherever you see "TEXMF" substitute the folder name determined in this
+way.
+
+If this terminology does not make sense to you, seek assistance from a
+friend or colleague, or from the company that you bought your TeX
+system from, or contact us at one of the above addresses.
------------------------------------------------------------------------
1. Download the following archive file:
- ftp://ftp.ams.org/pub/tex/amsrefs.zip
-
-2. Extract files using the texmf root directory as the destination. Some
-typical examples:
+ ftp://ftp.ams.org/pub/tex/amsrefs/amsrefs.zip
-WinZip: Click on "Extract" and then in the "Extract to" box, enter
- c:\sw\texmf (or whatever ROOT is on your system)
+2. View the following files to assess the effects of the upgrade on
+your system:
-unzip: unzip amsrefs.zip -d ROOT
+ README
+ install.txt (this file)
+ diffs-m.txt
-3. Please note that although the source files for amsrefs unpack into
-the ROOT/source/latex/amsrefs area at the present time [2001-12-28], the
-other files unpack into .../latex/amscls because that is the natural
-location for them.
+3. Backup the old version of AMS-LaTeX, preferably by moving it out of the
+TEXMF tree.
-To check the end result, you should find that you now have amsrefs.sty
-in the following location (substituting \ or : for / if appropriate):
+4. Extract files from the .zip archive using your favorite unzip tool,
+setting the extraction target directory to the texmf root directory.
- ROOT/tex/latex/amscls/amsrefs.sty
+5. To check the end result, you should find that amsrefs.sty is now in
+the following location (substituting \ or : for / if appropriate):
-If you have a teTeX system you may need to rerun mktexlsr [known in
-earlier versions of teTeX as "texhash"].
+ TEXMF/tex/latex/amsrefs/amsrefs.sty
-For a MikTeX system the command would be "initexmf -u", or look for
-"Refresh the Filename Database" in the MikTeX menus (this may be
-somewhat version-dependent).
+Some TeX systems such as TeX Live and MikTeX also use a database to
+keep track of TeX input files. If this database is not updated, your
+TeX system might not find the newly installed files. Consult your TeX
+system's documentation to determine how to update this database.