Readme File for MiKTeX 1.08
Copyright (C) 1997 Christian Schenk <cschenk@berlin.snafu.de>

Contents:

        What is it?
        What is it not?
        What should you download?
        Installation
        Configuring Dvips
        Where are the docs?
        Copying
        No Warranty


What is it?
***********

MiKTeX 1.08 is an implementation of TeX, METAFONT, dvips and other TeX
related utilities for Windows NT and Windows 95. The MiKTeX
distribution contains the following packages:

  * TeX 3.14159
  * LaTeX2e Jun'97 including standard packages
  * METAFONT 2.718
  * MetaPost 0.632
  * dvips 5.74
  * MakeIndex 2.12
  * Texinfo 3.11
  * BibTeX 0.99c
  * YAP (Yet Another Previewer) 0.91
  * TeXware (dvitype, ...)
  * METFONTware (gftopk, ...)
  * psutils (psselect, pstops, ...)
  * DVIcopy

You must have some basic knowledge of (La)TeX in order to make use of
MiKTeX. If you are an absolute beginner, then you should start with
one of the FAQs:

  English:  http://www.cogs.susx.ac.uk/cgi-bin/texfaq2html?introduction=yes
  German:   http://www.dante.de/dante/dante-faq.html


MiKTeX features
---------------

  * Native Win32 implementation
  * Supports multiple TeXMF directory trees
  * Uses a file name data base for fast file access
  * TDS compliant
  * Supports long file names
  * On-the-fly generation of TFM files
  * On-the-fly generation of PK files
  * Free software (GPLed). Source code available.


What is it not?
***************

Most of the programs that come with MiKTeX are command line oriented,
i.e., you will miss a graphical user interface.

MiKTeX does not run under Windows 3.1.


What should you download?
*************************

MiKTeX 1.08 is distributed in the form of 21 packed archives (zip format):

  ---------------------------------------------------------------------------
   Filename      |   |   Description
  ---------------+---+-------------------------------------------------------
   amsf108.zip   |   |   AMS-Fonts
   amsl108.zip   |   |   AMS-LaTeX
   babl108.zip   |   |   Babel system
    bib108.zip   |   |   Generic BibTeX input files
     cm108.zip   |   |   Computer Modern fonts
  dvips108.zip   |   |   Generic dvips input files
     ec108.zip   |   |   EC fonts
  exe108ia.zip   | ! |   intel-based executables, part 1/2
  exe108ib.zip   | ! |   intel-based executables, part 2/2
  latex108.zip   |   |   LaTeX2e base distribution
     mf108.zip   |   |   Generic METAFONT input files and plain base file
    mik108.zip   | ! |   Essential MiKTeX files
   misc108.zip   |   |   MiKTeX input files
  mkind108.zip   |   |   Generic MakeIndex input files
     mp108.zip   |   |   Generic MetaPost input files
     ps108.zip   |   |   PostScript fonts for LaTeX2e
    src108.zip   |   |   MiKTeX source files
    sty108.zip   |   |   Various LaTeX packages
    tex108.zip   |   |   Generic TeX input files
    txi108.zip   |   |   Texinfo input files and documentation
    vga108.zip   |   |   PK font files for the screen
  ---------------------------------------------------------------------------

You use an installation utility (install.exe) to unpack the archives
and to configure MiKTeX for your system. The installation utility
depends on the presence of unzip.exe:

  ---------------------------------------------------------------------------
   Filename      |   |   Description
  ---------------+---+-------------------------------------------------------
   install.exe   | ! |   MiKTeX installation utility
     unzip.exe   | ! |   Unzip utility (by Info-ZIP)
  ---------------------------------------------------------------------------

Files marked with '!' are absolutely necessary.  The others are
optional.  If you already have a comprehensive TeX directory tree
(such as a TeX Live 2 CD), then it should be enough to download the
essential files.

You don't need to download SRC108.ZIP unless you want to re-compile
MiKTeX (you then need M$ Visual C++ 5.0 Pro).


Installation
************

  1.   Make sure that you have the necessary files (see previous section).

  2.   Choose a name for the root TEXMF directory, say C:\TEXMF. Please note,
       that due to a bug in Unzip 5.31, you cannot choose a UNC path here.
       Work-around: Use a non-UNC path for installation. Later you can redefine
       the root directory with the help of the Configuration Utility.

  3.   Decide whether you want to use pre-existing TEXMF trees (such as
       a shared teTeX directory hierarchy).

  4.   Don't install MiKTeX 1.08 over an older MiKTeX version. If you have
       an old version, then you should remove it (after you have saved
       you local additions).

  5.   Invoke INSTALL.EXE.

  5.1  When prompted for the destination directory, enter the name chosen
       in step 2.

  5.2  When prompted for the root directories of other TEXMF trees, enter a
       semicolon-separated list of existing TEXMF root directories. Enter
       nothing, if you just want to use the TEXMF tree that comes with MiKTeX.

       For example, if your workstation is connected to a shared teTeX
       directory, then you can enter its UNC name (e.g. \\SERVER\TETEX).

       If you have a TeX Live 2 CD, then you can enter X:\SHARE\TEXMF
       (replace X with the CD-ROM drive letter).

  6.   Add the MiKTeX bin directory to the environment variable PATH.
       Under Windows 95 you have to append something like

        set PATH=c:\texmf\miktex\bin;%PATH%

       to your AUTOEXEC.BAT.  Under Windows NT you can use Control
       Panel to change the value of PATH.

  7.   Restart Windows.


Example Installation
--------------------

Here comes the transcript of a standard installation procedure.
C:\TEXMF is the destination directory. No additional TEXMF trees will
be incorporated.

      +------------------------------------------------------------------+
      | C:\temp> install                                                 |
      | Welcome to MiKTeX 1.08 Installation Utility. This program will   |
      | install MiKTeX 1.08 on your system.                              |
      |                                                                  |
      | MiKTeX 1.08 will be installed in `c:\texmf'.                     |
      |                                                                  |
      | To install to this directory, press <RETURN>.                    |
      |                                                                  |
      | To install to a different directory, enter the name of another   |
      | directory.                                                       |
      |                                                                  |
      | You can choose not to install MiKTeX 1.08. Enter `cancel' to     |
      | cancel the installation.                                         |
      |                                                                  |
      | Destination Directory: c:\texmf                                  |
      |                                                                  |
      | You can cause MiKTeX to incorporate additional TEXMF trees.      |
      | To do so, enter a semicolon-separated list of directory names.   |
      | Press <RETURN>, to use nothing but the TEXMF tree that comes     |
      | with MiKTeX.                                                     |
      |                                                                  |
      | Incorporate other TEXMF trees:                                   |
      |                                                                  |
      | Installing AMS-Fonts...	       	       	       	       	       	 |
      | Installing AMS-LaTeX...						 |
      | Installing Babel system...					 |
      | Installing Generic BibTeX input files...			 |
      | Installing Computer Modern fonts...				 |
      | Installing Generic dvips input files...				 |
      | Installing EC fonts...						 |
      | Installing intel-based executables, part 1/2...			 |
      | Installing intel-based executables, part 2/2...			 |
      | Installing LaTeX2e base distribution...				 |
      | Installing Generic METAFONT input files...			 |
      | Installing Essential MiKTeX files...				 |
      | Installing Various input files...				 |
      | Installing Generic MakeIndex input files...			 |
      | Installing Generic MetaPost input files...			 |
      | Installing PostScript fonts for LaTeX2e...			 |
      | Installing Various LaTeX packages...				 |
      | Installing Generic TeX input files...				 |
      | Installing Texinfo input files and documentation...		 |
      | Installing PK font files for the screen...			 |
      |                                                                  |
      | Writing file name data base...                                   |
      |                                                                  |
      | Checking that the installation worked:                           |
      |                                                                  |
      | 1. Invoking TeX...                                               |
      |                                                                  |
      | This is TeX, Version 3.14159 (MiKTeX 1.08)                       |
      | (test.tex [1] )                                                  |
      | Output written on test.dvi (1 page, 484 bytes).                  |
      | Transcript written on test.log.                                  |
      |                                                                  |
      | 2. Opening DVI file...                                           |
      |                                                                  |
      | Installation is complete. Please append `c:\texmf\miktex\bin' to |
      | the environment variable `PATH' and reboot the system.           |
      +------------------------------------------------------------------+


Configuring dvips
*****************

Dvips is configured as follows:

  a) When generating fonts, Dvips uses METAFONT mode ljfour (HP Laserjet 4).

  b) Horizontal resolution is 600 dpi.

  c) Paper size is A4.

If these settings are not suitable for your printer, then you have to
edit the Dvips configuration file CONFIG.PS.  You will find this file
in the directory C:\TEXMF\DVIPS\CONFIG\LOCAL.  See the Local Guide,
for more information.


Where are the docs?
*******************

The Local Guide is available in HTML/WinHelp format:

        c:\texmf\doc\miktex\miktex.html
        c:\texmf\doc\miktex\miktex.hlp

For up-to-date information, visit the MiKTeX project page:

        http://www.snafu.de/~cschenk/miktex


Copying
*******

MiKTeX is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.


No warranty
***********

MiKTeX is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with MiKTeX; if not, write to the Free Software Foundation,
Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


--
Christian Schenk <cschenk@berlin.snafu.de>
