INFORMATION AND INSTRUCTIONS FOR CREATING YOUR THESIS
-----------------------------------------------------
-------------------------FOR UTEP STUDENTS ONLY--------------------------------
The files included are for a thesis written by Karen Villaverde in 1993 for her
master's degree in computer science. She has provided her thesis as an example
for other students in meeting the Graduate School's format. Some modifications
have been made in an attempt to make things easier for other students to format
their theses. We're all very thankful to Karen. Any changes, additions or
omissions were not meant to discredit Karen in any way. Several students have
contributed in helping make the present form in accordance with the Graduate
School's requirements (as of 1996) by their style file modifications, personal
experiences, suggestions and observations. I thank them all. If you encounter
problems with the instructions or find errors in the format, feel free to send
me e-mail describing the problem/error and I'll try to fix it (if I haven't
graduated by then!) NOTE: See KNOWN BUGS at end of this file for more info.
Patrick Kahl (pkahl@cs.utep.edu) 5-7-96
===============================================================================
GENERAL INFORMATION AND INSTRUCTIONS
------------------------------------
The example thesis is written in LaTeX, a typesetting mark-up language, that
allows you to obtain professional looking documents that include mathematical
formulas and special fonts and figures. References on LaTeX are listed near
the end of this file.
`thesis.tex' is the main file. It calls all other files.
Create your own thesis by editing/creating the following LaTeX files:
signature.tex
* copyright.tex
* dedication.tex
title.tex
* preface.tex
* acknowlegements.tex
* abstract.tex
chapter1.tex
.
:
chapter-.tex
* endnotes.tex
references.tex
* bibliography.tex
* glossary.tex
* abbreviations.tex
* symbols.tex (NOTE: required for some theses)
* appendixA.tex
.
:
* appendix-.tex
vitae.tex
NOTE: All files preceded by an asterisk (`*') are optional. If any don't exist
they will be ignored during compilation. The table of contents, list of tables
and list of figures are all generated automatically by LaTeX.
You probably need to edit `thesis.tex' for the correct number of chapters, etc.
As you create new files, be sure to uncomment the `\include{file.tex}' for the
appropriate file. If there are files that you don't use, comment the same
include line. Comment `\include{listoffigures}' and `\include{listoftables}'
as necessary depending on whether you have figures or tables in your thesis.
Also, if you plan to use the `Makefile', add/delete filenames from the list of
dependency files (the macro `DEPFILES') as you create new files that weren't
included (originally commented out in `thesis.tex') or remove files from the
original list (by commenting out in `thesis.tex').
Figures can be done in `xfig' and then exported to latex. For example,
`chapter1.tex' contains lots of figures. All were done by using `xfig'. To run
`xfig', just type `xfig &' from your OpenWindows cmdtool window.
Once you finish your thesis, you can use the `make' utility to compile the
necessary files per the `Makefile', or do it yourself manually by compiling
`thesis.tex' three times by giving the following commands:
latex thesis
latex thesis
fixtoc thesis
fixlot thesis
fixlof thesis
latex thesis
fixtex thesis
This is done automatically for you if you use `make' and the `Makefile', but
errors may be slightly easier to understand if you do it manually.
Now you can view or print your thesis.
===============================================================================
SPELL CHECKING LaTeX FILES
--------------------------
To check the spelling of your LaTeX files, type `ispell -t file.tex' and press
return where `file.tex' is the name of the file you want spell-checked.
COMPILING THE FILES AUTOMATICALLY
---------------------------------
To compile the latex files automatically, just type `make' and press return.
Additionally, the `Makefile' provides you with other options. Enter
make ps
to have the make utility compile your thesis and automatically convert your
thesis to a Postscript file. Enter
make clean
to remove any auxiliary files that LaTeX creates, as well as most editor and
`ispell' backup files. Enter
make spotless
to do everything `make clean' does, plus remove any `.dvi' and `.ps' files
created when compiling/converting your thesis.
COMPILING THE FILES MANUALLY
----------------------------
To compile your thesis manually, type `latex thesis' and press return. After
successful compilation, reenter `latex thesis' a second time to get the
references resolved. At this point, enter the following commands:
fixtoc thesis
fixlot thesis
fixlof thesis
in order to modify the table of contents, list of tables and list of figures.
Now, reenter `latex thesis' a third time to get all table of contents page
references correct, and to have all modifications take effect. Finally, enter
fixtex thesis
to restore `thesis.tex' to its original form.
VIEWING DVI FILE
----------------
To view the file, type `xdvi thesis &' and press return.
PRINTING DVI FILE (TO THE LASER PRINTER)
----------------------------------------
To print the file, type `dvips -P HS thesis' and press return.
[NOTE: This will only work if you have laser printer permissions. Send e-mail
to the system administrator (`pwesley') to get added to the list.]
[ADDT'L NOTE: Don't try to send output to a non-Postscript printer such as the
dot-matrix printer located in the main lab!]
CONVERTING DVI FILE TO POSTSCRIPT FILE
--------------------------------------
To convert the file, type `dvips thesis.dvi -o thesis.ps' and press return.
SELECTING THE LASER PRINTER FOR PRINTING POSTSCRIPT FILE
--------------------------------------------------------
To print the Postscript file (`thesis.ps') on the laser printer, type
`lpr -PHS thesis.ps' and press return.
[NOTE: This will only work if you have laser printer permissions. Send e-mail
to the system administrator (`pwesley') to get added to the list.]
===============================================================================
REFERENCES ON LaTeX
-------------------
1. Hahn, Jane. LaTeX for Everyone: A Reference Guide and Tutorial for
Typesetting Documents Using a Computer. Personal TEX, Inc.
2. Lamport, Leslie. LaTeX: A Document Preparation System. Addison-Wesley
Publishing Co.
===============================================================================
LIST OF FILES
-------------
Makefile input file used by `make' utility to compile thesis
README this file
abstract.tex LaTeX file containing Abstract text
acknowledgements.tex LaTeX file containing Acknowledgements text
appendixA.tex LaTeX file containing Appendix A text
appendixB.tex LaTeX file containing Appendix B text
appendixC.tex LaTeX file containing Appendix C text
appendixD.tex LaTeX file containing Appendix D text
chapter1.tex LaTeX file containing Introductory Chapter text
chapter2.tex LaTeX file containing Chapter 2 text
chapter3.tex LaTeX file containing Chapter 3 text
chapter4.tex LaTeX file containing Chapter 4 text
chapter5.tex LaTeX file containing Chapter 5 text
chapter6.tex LaTeX file containing Chapter 6 text
chapter7.tex LaTeX file containing Chapter 7 text
chapter8.tex LaTeX file containing Chapter 8 text
fixlof C-shell script to modify List of Figures format
fixlot C-shell script to modify List of Tables format
fixtex C-shell script to modify Table of Contents format *
fixtoc C-shell script to restore `thesis.tex' to original
listoffigures.tex LaTeX file containing instruction for List of Figures
listoftables.tex LaTeX file containing instruction for List of Tables
references.tex LaTeX file containing Chapter 8 text
signature.tex LaTeX file containing Chapter 8 text
thesis.sty LaTeX style file used for formatting the thesis
thesis.tex LaTeX file controlling formatting of all thesis parts
title.tex LaTeX file containing Title Page text
vitae.tex LaTeX file containing Curriculum Vitae text
* `fixtoc' modifies `thesis.tex' slightly by increasing the Table of Contents
depth (tocdepth) to support the changes made to the Table of Contents. The
C-shell script `fixtex' is used to restore `thesis.tex' to original form.
===============================================================================
KNOWN BUGS
----------
A problem was found with the bottom page margin for the first page containing
the printed page number. A crude fix has been provided by creating a discard
page and resetting the page number. --PTK