summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/amscls/install.txt
blob: 27519dde8363e40a58cec3440b4396bb18cfb5f8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
install.txt for amscls 2.20.4 [2017/10/31]

Copyright 2005, 2010, 2017 American Mathematical Society.

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
and version 1.3c or later is part of all distributions of LaTeX
version 2005/12/01 or later.

This work has the LPPL maintenance status `maintained'.

===========================================================================

If you have a relatively up-do-date TeX system that complies with the
TeX Directory Structure (TDS) standard, check first to see if there is
an available procedure that will install the package automatically from
a CTAN archive.  Otherwise, installing according to the instructions in
section I below is the easiest method.  See

    http://www.tug.org/tds/tds.pdf

for details on the TDS standard.  TeX Live distributions comply with
the standard, as do MikTeX and MacTeX.

If your TeX system does not comply with the TDS standard, please contact
the provider of your TeX system for details on how to install third-party
TeX packages.

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.,

  /usr/local/share/texmf/tex/latex/base/article.cls

then we will define TEXMF to mean /usr/local/share/texmf (everything
up to the /tex/latex/base part). On a Windows system the file location
will probably be something like

  c:\sw\texmf\tex\latex\base\article.cls

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 source that you obtained your TeX
system from, or contact us at

  tech-support@ams.org
  800-321-4AMS (321-4267) (USA/Canada)
  401-455-4080

========================================================================
I. Installing the easy way.

1. Download the following archive file:

   http://mirror.ctan.org/install/macros/latexf/required/amscls.tds.zip

2. View the following files to assess the effects of the upgrade on
your system:

  README
  install.txt (this file)
  diffs-c.txt

3. Backup the old version of amscls, preferably by moving it out of
the TEXMF tree.

4. Extract files from the .zip archive using your favorite unzip tool,
setting the extraction target directory to the texmf root directory.

5. To check the end result, you should find that you now have amsart.cls
in the following location

  TEXMF/tex/latex/amscls/amsart.cls

Some TeX systems 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 system's documentation to determine
how to update this database.

6. There are no duplicate files in this archive.  As distributed, the
files in the source/latex/amscls area comprise a complete copy of the
distribution from which all the other files needed for LaTeX processing
can be regenerated if need be.  If you need to conserve disk space, you
could delete the files in the source area, since they are not needed
for normal use.

========================================================================
II. Installing the not-so-easy way.

Download  http://mirror.ctan.org/macros/latex/required/amscls.zip

Make the following directories, if not already present:

  TEXMF/source/latex/amscls
  TEXMF/tex/latex/amscls
  TEXMF/doc/latex/amscls

Backup your old amscls files if they are installed, preferably moving
them out of the TEXMF tree.

Create a temporary directory and generate documentation files (these
assume a *nix TeX installation):

  - make directory /tmp/amscls
  - unzip -d /tmp/amscls amscls.zip
  - cd /tmp/amscls
  - Run latex on the file amsclass.ins and other *.ins files to produce
    .cls and .sty files
  - Run latex on *.tex
  - [optional] Run pdflatex on *.dtx (technical documentation)
  - move *.pdf and *.tex to TEXMF/doc/latex/amscls
  - [optional] move *.dtx to TEXMF/doc/latex/amscls
  - move *.sty and *.cls to TEXMF/tex/latex/amscls
  - delete /tmp/amscls

Some TeX systems 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 system's documentation to determine
how to update this database.

========================================================================