Version history:

* Version 2004-04-06, Markus Bohlin
* Version 2003-11-24, Björn Lisper

THESIS CLASS MDHTHESIS.CLS:

This directory contains a LaTeX thesis class for Mälardalen
University, courtesy of Markus Bohlin, SICS, and Thomas Larsson,
IDt. The produced output already has the right size to print: it does
*not* have to be enlarged or diminished! To use this class you need at
least some rudimentary knowledge of latex.

Installation and basic usage:

* unpack the archive,

* run latex on mdhthesis.ins to generate the class file mdhthesis.cls:

  latex mdhthesis.ins

* run latex on mdhthesis.dtx to generate the documentation
  mdhthesis.dvi:

  latex mdhthesis.dtx
  
* fill in your text in the proper files. If you need more chapters
  etc., just create more files and add corresponding entries in the
  main file (thesis.tex).

* To process the final document, you have to run LaTeX three times and
  BibTeX four (!) times: 

	latex thesis
	bibtex thesis
	bibtex bu1
	bibtex bu2
	bibtex bu3
	latex thesis
	latex thesis

	The bash script bibtexall (included from the bibunits package) runs
	bibtex on all files with suffix .aux; a corresponding hardcoded
	script (bubunits.bat, don't ask about the name) for Windows is also
	provided. This simplifies the process to the following:

	latex thesis
	./bibtexall
	latex thesis
	latex thesis

	You probably want to post-process your DVI file to produce
  Postscript and optionally a PDF:

	dvips thesis.dvi -o thesis.ps
	ps2pdf thesis.ps

* If you use UNIX and have PSUtils installed (most newer Linux
  distributions have this installed by default), you can use the
  script "thesisbooklet" (bash) to get a nice unscaled booklet version
  "booklet_X.ps" of your final postscript file:

  thesisbooklet thesis.ps

	Help on how to do this in Windows is appreciated!

* The DVI file mdhthesis.dvi contains the full documentation on how to
  use the class in LaTeX.

FILES:

mdhthesis.ins: file for extracting the mdhthesis.cls class file. 

mdhthesis.dtx: the class and documentation files. This is where you
should change the default stuff that you don't like in the thesis
layout. You will need some experience with class and package writing
for LaTeX to do this. Feel free to extend the class and documentation
how you see fit; if your extensions are of general interest, you
should consider contributing this extension to the phd pages of the
IDt web.

thesisbooklet: bash script to produce an unscaled booklet version of
the thesis for proofreading. You need pstops, psbook and psnup
(PSUtils) for this script.

thesis.tex: main file. This is the main thesis file that you compile
with LaTeX to produce the thesis. It should include the other files of
your thesis; this is already done for the template files in the
archive.

thesis.{dvi,pdf,ps}: output files from latex (dvi, pdf, postscript
format).

thesis.bib: BibTeX file for LaTeX. BibTeX is a reference database
format. In thesis.bib, you can put bibliographic descriptions of the
papers you refer to. Of course, you can change thesis.tex to use your
own favourite BibTeX file(s) instead.

abstract.tex: your abstract.

preface.tex: your preface.

chapter{1..4}.tex: chapters 1..4 in your thesis ("kappan" if you write
a monography).

paper{A..C}.tex: header file for papers A-C (if you plan to do a
"sammanläggsavhandling").

paper{A..C}/content{A..C}.tex: the content of your papers (A, B, C
respectively) is put in a separate subdirectory (paper{A..C}) for each
paper.

bibunits.sty, fancyheadings.sty: style files used to alter the
appearance of the thesis, included for convenience only. Do not change
unless you know what you're doing!

mdh_logo.eps: the MdH logotype in EPS format.

bibtexall: bash script to process all produced BibTeX-units.

bubunits.bat: supposed to be the equivalent of bibtexall for MS
Windows. Please contribute if you know how to do this properly!