Software Collection, Department of Mathematics, University of York
Release 4 2004/09/30

The most up-to-date information about this CD can be found on the WWW at http://www-users.york.ac.uk/~spe1/cd/

CONTENTS

Installation instructions are immediately after the following:

IMPORTANT NOTICES

I have assembled this CD in the hope that it will be useful, but neither I nor the Department of Mathematics can accept any responsibility for its operation.

I obtained the contents of this CD from reputable archives with up-to-date virus-checking software running on my computer. However, I cannot absolutely guarantee that this disc is virus-free and strongly advise you to have up-to-date anti-virus software running when you install programs from it (or any other source, for that matter).

The programs on this CD are from a variety of sources and are distributed under a variety of licenses, but they are all freely distributable for non-commercial purposes. Any charge levied by the Department of Mathematics is to cover duplication costs only; you are not being charged for the software. You are free to copy this CD or use it to install the software it contains on any number of computers, subject to the licenses governing each piece of software.

This CD has been assembled and tested under Windows 98SE, Windows 2000 and Windows XP. I expect it to work under 95, 98, ME, and NT4, but this has not been tested.

Please read the likely problems section before reporting problems, and please note also that in many cases I have included software at the suggestion of a colleague and know nothing about it myself!

Simon Eveson
spe1@york.ac.uk

Contents of the CD

GhostView 4.6 viewing and printing PostScript files Reading files from our website
GhostScript 8.14 PostScript interpreter used by GhostView
MiKTeX 2.4 TeX, LaTeX, etc. Mathematical Writing course, final-year project
York LaTeX environment MicroEMACS front end, some extra files for MiKTeX Mathematical Writing course, final-year project
TeXnicCenter A more conventional Windows editor for LaTeX files Mathematical Writing course, final-year project
Adobe Acrobat Reader 6.0.1 viewing and printing PDF files Reading files on our website, and many others.
R 1.9.1 general-purpose statistical software Introduction to Linear Regression course, final-year projects
Octave 2.1.42, 2.1.50a Matlab clone for numerical calculation MSc courses
gnuplot 4.0 graph plotting, standalone or from Octave MSc courses, final-year projects
Dev-C++ 4, 5 beta 9 C++ development system C Programming course, final-year projects
WinBUGS 14 "aims to make practical MCMC methods available to applied statisticians" (whatever that means) final-year projects
arc 1.06 "a free statistical analysis tool for regression problems" final-year projects

Installation: Generalities

If you have autorun enabled, on inserting the CD you should see an Explorer window called "maths" showing the contents of the top level of the CD (it might be hidden behind this window; if it's not there, open My Computer, right-click on your CD or DVD drive and click on Explore). Files and folders mentioned below are in this window unless otherwise stated.

Since almost nobody will want to install all of this stuff, and most of these programs have their own installation wizards, I haven't supplied a single, overarching installation tool: you'll need to install individually the bits you want. However, I have provided two scripts which run existing installers consecutively (and in the right order!): one for GhostScript/GhostView and one for the whole TeX setup.

I generally say "don't change the default settings" below. Obviously you can change them to reconfigure things, but if you want to do this then make sure you change them all consistently, and don't expect much help if it doesn't work! One hint: the extra York stuff is normally installed in c:\localtexmf. If you put this somewhere else, you must tell MiKTeX by appropriately setting "local texmf tree" in the MiKTeX installation wizard.

GhostScript and GhostView: automatic installation

Do this if you want to be able to read and print PostScript files (e.g. from our website). If you're installing TeX, GhostScript and GhostView are included: they don't need to be installed separately.

If you have problems with this you might have more success running the installation programs separately: see manual installation below.

Double-click the "setup_ghost" icon to run the two installers in succession, and then follow the instructions. All the defaults are sensible, so just leave them alone. If you have an existing installation of GhostView, you might see a separate window, asking if you want to uninstall it; if so, click on Uninstall and, when it's finished, Exit. If you're given a list of versions of GhostScript and asked to choose one, choose the one with the highest number: presumably 8.14.

When it's finished, there will be various Explorer windows and possibly a "Finished" command prompt or MSDOS prompt window; you'll have to close these manually.

TeX and friends: automatic installation

Double-click the "setup_tex" icon and follow the instructions. This one runs four separate installation wizards back to back (GhostScript, GhostView, extra York stuff, MiKTeX), so it goes on a bit; but the defaults are all sensible, so by and large you just have to keep clicking OK and Next until it finishes, with the following exceptions:

  1. If you have an existing installation of GhostView, you might see a separate window, asking if you want to uninstall it; if so, click on Uninstall and, when it's finished, Exit.
  2. The installation process might stall after GhostView has been installed. This is because there's a window saying "Installation successful" in which you have to click on Exit before the next installer can run. It might be hidden behind an Explorer window containing GhostScript or GhostView icons, which you can close if it's in the way.
  3. The MiKTeX wizard will give you the option of "small", "large" or "total" package set. If you have enough disk space (500Mb), you can choose "total" and have done with it; otherwise, choose "small". If you choose "small" and then try to use a feature you haven't installed, the system will find it and install it for you, either from the CD or the internet.
  4. When the MiKTeX wizard asks you for a "local package repository", click on Browse and navigate to Z:\miktex-2.4-repository, where Z: is the CD or DVD drive containing the CD (usually D: or E:).

Note that MiKTeX can take quite a a while to install. I timed it on one machine at 5 minutes before the progress meters even started moving, then a further 15 to complete the installation, and I've heard of much slower installations than that.

When it's all over, you'll find an icon on the desktop called "LaTeX via MicroEMACS" and also a group in the start menu. You'll also find a MiKTeX group in the start menu, but under normal circumstances you won't need to use this.

If you prefer a more conventional Windows editor to MicroEMACS, try installing TeXnicCenter: see next section.

Restart the computer before you try to use TeX.

If you have problems with this you might have more success running the installation programs separately: see manual installation below.

R, Octave, Dev-C++ 5 (beta), arc, WinBUGS, TeXnicCenter, Acrobat Reader: automatic installation

Installation wizards for all these are in the "distributions" folder: open it and double-click on the appropriate file. There are two versions of Octave because the download page on sourceforge notes of the newer one that "initial tests show that it does not work on all machines". The older one is probably safer. After installing WinBUGS, double-click on the text file WinBUGS14_cumulative_patch... and follow the instructions to install the latest updates.

R rw1091.exe (see also README.rw1091.txt)
octave octave-2.1.42-windows-atlas.exe octave-2.1.50a-inst.exe
Dev-C++ 5 devcpp4990setup.exe
arc arc32.exe
WinBUGS winbugs14.exe (see also Manual14.pdf)
TeXnicCenter TXCSetup_1Beta6_21.exe
Acrobat Reader AdobeRdr60_enu_full.exe

In each case, just follow the instructions to install the software and some combination of start menu and desktop shortcuts.

Dev-C++ 4: installation

Since version 5 is a beta release, you might prefer to run version 4, which lives in the file devcpp4.zip in the "distributions" folder. Newer versions of Windows will show this as a compressed folder. If you have an older versions you'll need to unzip it into a temporary folder somewhere; there's an unzipper in the "tools" folder (wiz502xN.exe) if you haven't got one. Once you can see the files, run setup.exe. I'm assuming anyone in the market for a C compiler doesn't need any more detailed instructions than this!

Gnuplot: installation

This doesn't come with an installation wizard. You'll need to unzip the file gp400win32.zip in the "distributions" folder to an appropriate folder and sort out shortcuts etc. by hand. There's an unzipper in the "tools" folder (wiz502xN.exe) if you haven't got one (newer versions of Windows will show the zip file as a compressed folder).

GhostScript, GhostView, TeX, etc: Manual Installation

You should use this section if you don't trust my installation script or if it failed for some reason. Make sure you do these in the order stated.

  1. Open the "distributions" folder on the CD. Eveything referred to below is in this folder.
  2. (GhostScript installation) In the "distributions" folder, double-click on gs814w32.exe and follow the on-screen instructions.
  3. (GhostView installation) Double-click on gsv46w32 and follow the instructions.
  4. (York Extras) Drag the "localtexmf" folder from the top level of the CD to the top level of your C: drive.
  5. (MiKTeX installation) Back in the "distributions" folder, double-click on setup-2.4.1661.exe and follow the instructions, The local package repository is z:\miktex-2.4-repository where Z: is the drive letter of your CD or DVD drive.
  6. (Set up a desktop shortcut to MicroEMACS) Right-click on the desktop (the background window) then click on New and Shortcut. In the Command Line box enter
    c:\localtexmf\microemacs\mewin.exe @c:\localtexmf\microemacs\texmenu.cmd
    
    and click on Next (you can cut and paste: highlight the above line, press Ctrl-C, click in the Command Line box, press Ctrl-V). Type in a suitable name like "TeX via MicroEMACS" and click on Finish. The default startup directory isn't very sensible in this case, so you might want to change it. To do this, right-click on the MicroEMACS icon on the desktop, click on Properties and in the Start In box type c:\ as a neutral starting point, or the name of the folder you keep your TeX files in. You can set up start menu shortcuts to the same target, of course.
  7. Restart the system before you try to use TeX.

Likely problems

All the commands on the TeX menu give "Macro failed ..." errors.
The most common cause of this is trying to run TeX immediately after installation, without restarting. If it persists after a restart, you'll need to manually edit the PATH environment variable. So far I have only seen this problem with Windows XP. I don't know what causes it, but this is the solution. Incorrectly setting the PATH can stop parts of your system from working, so take care with this!

Under Windows XP or Windows 2000 (or, I suppose, NT4 in the highly unlikely event anyone is using NT4!): right-click My Computer, click Properties, click Advanced, click Environment Variables. In the list of System Variables, click on Path, then click on Edit. At the end of the "Variable value" box add
;c:\texmf\miktex\bin
Be sure to get this exactly right, including the semicolon. Now you can click on OK a few times to get rid of all the My Computer windows. If you have a copy of MicroEMACS running, close it. The next time you open MicroEMACS, the TeX menu should work.

Under Windows 95, 98 or ME: edit c:\autoexec.bat and at the end of the file add the line
set path=%path%;c:\texmf\miktex\bin
You now have to restart your computer before trying to use TeX.

The MiKTeX installer (or some other part of MiKTeX; for TeXnicCenter see next item) complains about missing DLLs or missing exports.
This is caused by missing or out of date DLLs, usually on old W95 systems. Look in the tools folder on the CD for a file called vcredist_enu. Double-click it and follow the instructions.
TeXnicCenter complains that it cannot find a .DLL file
This is anticipated to happen on older Windows systems (95 and 98). Open the "tools" folder on the CD, double-click on TxcSystemUpdate.exe and follow the instructions.
The previewer takes a long time to start up.
This is normal the first few times you use it but startup time improves as it builds the resources (fonts, mostly) you most commonly use.
GhostView asks "which version of GhostScript do you want to use"
This is normal the first time you use it. Choose the highest version number (most likely, 8.14 is the only version on offer).
GhostView prints rubbish.
Your printer settings are probably wrong. In the bottom left hand corner of the Print dialog there's a section called Print Method. The most reliable setting is Windows GDI Printer (others may be better or faster; read the documentation if you want to experiment.)
MicroEMACS doesn't start or is missing the TeX menu, or you haven't got a shortcut to MicroEMACS at all.
Delete the shortcut (if you've got it) and recreate it manually following the manual installation instructions above, making sure you get the command line exactly right (cut and paste is the most reliable method).
A window entitled "Package Installation" appears
If you went for one of the smaller installations of MiKTeX, you're missing various useful things. This message means that you need one of them. There are two ways to get it:
  1. From the department CD: MiKTeX should remember that the source for installation is z:\miktex-2.4-repository where z: is the CD or DVD drive you used for the original installation; if not, click on Change, select Local Folder, click on Next, click on Browse, find the location given above, then click on Finish and finally Install.
  2. From the Internet: click on Change, select Internet, click on Next. You should see a list of "remote package repositories" (this might take a few moments to download). Choose one, click on Finish and finally Install.
Either way, the system should install whatever resource you were missing and TeX will continue to run.
yap (the previewer) complains about your printer having the wrong resolution (dots per inch)
Details are too complicated to go into here. To avoid this problem, use "Print PostScript" instead of "Print" or use GhostView instead of yap.
The "Preview or print" commands in the MicroEMACS TeX menu give an error window saying "Macro failed ..." but other commands on the TeX menu work.
The most likely cause is an incompatibility between different versions of Windows. The menu system in MicroEMACS tries to find out which version you're using, but isn't always successful, especially on Windows ME systems. Try the following: shut down MicroEMACS, open the "tools" folder on the CD and double-click on:
force_9x_me if you have Windows 95/98/ME
bludgeon_9x_me if force_9x_me didn't work
force_2k_xp if you have Windows 2000/XP
force_exec if nothing else works
restore_auto to revert to the installation defaults.
Then start MicroEMACS again and see if it works. Note that this will not work unless you have installed the York extra stuff in the default location.

WWW links

MiKTeX http://www.miktex.org/
GhostView http://www.cs.wisc.edu/~ghost/gsview/
GhostScript http://www.cs.wisc.edu/~ghost/doc/AFPL/
R http://www.r-project.org/
Octave http://octave.sourceforge.net/
gnuplot http://www.gnuplot.info/
winbugs http://www.mrc-bsu.cam.ac.uk/bugs/winbugs/contents.shtml
arc http://www.stat.umn.edu/arc/
Dev-C++ http://www.bloodshed.net/
OpenOffice.org http://www.openoffice.org/
WiZ http://www.info-zip.org/pub/infozip/
TeXnicCenter http://www.toolscenter.org/