summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/INSTALL.TXT
blob: 8eb172a538ad8f34c4c78a79551014d5f9083058 (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
Installation
============

Preamble:
---------

This manual is only for use with TeX installations using TDS. Examples
of those TeX installations are teTeX and MikTeX. If you are not sure,
search about a directory named `texmf'. Perhaps there are more lots of
directories named `texmf'. At unix you may find `/usr/texmf' (or
`/usr/share/texmf' or `/usr/TeX/texmf' or `/usr/share/TeX/texmf'),
`/usr/local/texmf' (or `/usr/local/share/texmf' or 
`/usr/TeX/texmf.local' or many more) and several users with 
`~/texmf' (`texmf' at the home directory of several users). At windows
with MikTeX this is often `\texmf' or `\Miktex' and `\localtexmf'.

One of these is the primary texmf tree of the package manager
(`/usr/texmf' or `/usr/share/texmf' or ..., with MikTeX `\texmf' or 
`\Miktex'). This was created at the installation of your TeX 
distribution.

One of these is the system texmf tree (`/usr/local/texmf' or
`/usr/local/share/texmf' or ..., with MikTeX `\localtexmf'). If you 
are administrator use this texmf tree to install KOMA-Script.

If you install KOMA-Script as normal user, you have to ask your
administrator, where to install KOMA-Script. You can also ask
texmf.cnf, if you can use a local texmf tree at your HOME directory.

Short:

- Do NOT install KOMA-Script at the primary texmf tree of the package
  manager (e.g. if you're using MikTeX not at `\texmf' oder `\Miktex').
- If you are administrator, install KOMA-Script at the system texmf
  tree.
- If you are normal user, use the texmf tree of your HOME directory or
  "Own Files" at windows or ask your administrator.

In the following `.../texmf' is used for your texmf tree. If you are
using windows and the explorer or DOS-prompt, you have also replace
every slash (`/') by backslash (`\'). At TeX itself you're using still
slash for directory separation.


Installation:
-------------

At Unix you may edit a `Makefile' called copy of `Makefile.unx', set
variable INSTALLTEXMF to your texmf tree, save Makefile and call make. 
If no error occurs, you can do the installation with `make install'
subsequently.

Note: Distributors do not need to put the Makefile into a KOMA-Script
distribution and the Makefile needs (almost) all other files of
KOMA-Script that are not needed for distributions. If you are using
the KOMA-Script distribution from CTAN you have good changes to get
the Makefile and to use it. But KOMA-Script distributions from some
TeX installations don't have those files or even the Makefile.

If you don't use Unix or don't like Makefile, do this:

1. Copy all files of KOMA-Script bundle to a new directory and change
   to this directory.
2. Call LaTeX with filename komascr.ins. At Unix just say:
       latex komascr.ins
   This may be done at windows, too.
   If LaTeX tells you some files already existing, DO NOT overwrite
   them, yet.
   Inform yourself, which files are newer, the one you want to install
   or the already installed. Afterwards call LaTeX again an overwrite
   older files - and only older - by newer.
3. Copy all generated files ending `.cls' and all files ending `.sty' 
   and all files ending `.lco' into the directory 
   `.../texmf/tex/latex/koma-script'. If there isn't a directory named
   `.../texmf/tex/latex/koma-script', create it. (Remember! This is
   `\localtexmf\tex\latex\koma-script' at MikTeX.)
4. Copy all files ending `.dvi', `.ps', `.pdf', `.txt' or `.TXT' and all
   `komabug.tex' and `scrclass.dtx' into the directory
   `.../texmf/doc/latex/koma-script'. If there isn't a directory named
   `.../texmf/doc/latex/koma-script', create it. (Remember! This is
   `\localtexmf\doc\latex\koma-script' at MikTeX.) Copy `scrclass.dtx'
   to this directory, too. This will be need, if you'll want to 
   generate a bug report.
   You will need file `scrclass.dtx' there, if you try to write a bug 
   report. You may use a symbolic link to the file at the source
   directory instead of a copy of `scrclass.dtx'.
5. Install adrconv package. This step is only neccessary, if you got
   it separatly from KOMA-Script or have one at subdirectory `contrib'
   at your KOMA-Script distribution.
6. Maybe you have to inform your TeX distribution about the newly
   installed files. Using teTeX you have to call `texhash', using 
   MikTeX this is `Refresh Filename Database'. At fpTeX there is also
   an entry at windows start button. Ask the manual of your
   distribution or your administrator.  
7. Save following als `komaexam.tex' and call LaTeX.
	  \documentclass{scrartcl}
	  \begin{document}
	  dummy
	  \end{document}
   Read the LOG file and search for the date and version numbers of
   the loaded scrlartcl class and typearea package. Compare these with
   the date and version number of the previously installed files
   scrartcl.cls and typearea.sty. If they are not equal, installation
   failed. Compare also the filenames at the LOG file. Ask your
   administrator for help.
8. Read all DVI files, you've copied at step 4. You should print at
   least scrguide. If you don't know l2short and usrguide, read them
   also before reading scrguide.

Have a nice day, even if you don't understand my 
`something-like-english'!