Index of /~gartland/mscsletter

	Name	Last modified	Size	Description
	Parent Directory		-
	csletterhead.pdf	06-Jan-2007 17:28	41K
	csletterhead.ps	22-Sep-2005 23:40	1.5M
	letterhead.tex	06-Jan-2007 18:11	1.0K
	mathletterhead.pdf	06-Jan-2007 17:28	41K
	mathletterhead.ps	22-Sep-2005 23:41	1.5M
	mscsletter.cls	06-Dec-2006 17:46	6.7K
	mscsletter.tar.gz	06-Jan-2007 17:12	185K
	myletter.sty	18-Sep-2005 18:47	3.0K
	sample.pdf	06-Jan-2007 17:38	55K
	sample.ps	22-Sep-2005 23:41	1.5M
	sample.tex	26-Feb-2002 00:44	929
	sun_2C.eps	08-Feb-2002 10:52	1.4M
	sun_2C.pdf	06-Dec-2006 17:17	30K
	sun_281.eps	08-Feb-2002 10:52	1.4M
	sun_281.pdf	06-Dec-2006 17:17	32K

CONTENTS
--------

csletterhead.{ps,pdf} = sample blank letterhead, from LaTeX-ing (or
  PDF-LaTeX-ing) "letterhead.tex" with "cs" option.

letterhead.tex = LaTeX source file to generate blank letterheads.

mathletterhead.{ps,pdf} = sample blank letterhead, from LaTeX-ing (or
  PDF-LaTeX-ing) "letterhead.tex" with "math" option.

mscsletter.cls = main class file.

mscsletter.tar.gz = gzipped TAR file containing "sun_281.{eps,pdf}",
  "sun_2C.{eps,pdf}", and "mscsletter.cls", the main files you need to
  install.

myletter.sty = sample style file to customize the appearance (widths,
  margins, signature, etc.) when using "mscsletter.cls" (or "letter.cls").

sample.{ps,pdf} = output from LaTeX-ing (or PDF-LaTeX-ing)
  "sample.tex", which illustrates the use of "myletter.sty".

sample.tex = sample LaTeX source file using "myletter.sty".

sun_2C.{eps,pdf} = blue/gold KSU logo.

sun_281.{eps,pdf} = blue KSU logo.

DISCUSSION
----------

The main class file is "mscsletter.cls".  Read the header for a
description of the options.

The file "myletter.sty" is an example of a personal customization file
a ("style file").  Most users don't like the defaults for the LaTeX
"letter.cls" file, on top of which "mscsletter.cls" is built.  Read
the header of "myletter.sty" for a description of its options.

If you wish, you can customize "myletter.sty" and put it in your own
TeX input area.  I use a subdirectory called "texmf" off my home
directory for this.  Our TeX distribution automatically searches
there.  Alternately you can put your personal TeX inputs in some other
directory, e.g., "tex", and direct TeX to search there by setting your
environment variable TEXINPUTS in your .cshrc file:

  setenv TEXINPUTS $HOME/tex:

or in your .bash_profile file:

  export TEXINPUTS=$HOME/tex:

Don't forget the ":" at the end above, otherwise the (many) other
components of the search path would be lost.

Of course input files such as "mscsletter.cls" and "myletter.sty" will
be found automatically if they reside in the current working directory
where you are LaTeX-ing your document.

Read the "LaTeX User's Guide" for general info and for a description
of the basic LaTeX "letter.cls".

PostScript Generation and Previewing/Printing
---------------------------------------------

To LaTeX the sample file:

  $ latex sample

To create a Postscript file containing the logo and all:

  $ dvips -o -G0 sample

The option "-G0" is (at least, used to be) recommended to address a
certain bug; "-o" produces an output file "sample.ps", instead of
sending the output directly to the printer (which is the default
action).

To preview, on different machines:

  HPUX: $ ghostview sample.ps

  Linux: $ evince sample.ps
      or $ ghostview sample.ps
      or $ gv sample.ps
      or $ kghostview sample.ps

If you're on a personal Linux box and your logo and/or footer don't
position properly, then your "dvips" is probably defaulting to "a4"
paper size (which is the default for freshly installed TeX
distributions).  You can overcome this via a command-line option

  $ dvips -o -t letter sample

or get someone with root privileges to fix the global default behavior.

To print, e.g., to printer "color5m", from an HP machine:

  $ lp -d color5m sample.ps

from a Linux machine: the above or

  $ lpr -P color5m sample.ps

PDF Generation and Previewing/Printing
--------------------------------------

To LaTeX the sample file, directly creating a PDF output file:

  $ pdflatex sample

To preview:

  $ acroread sample.pdf

or you can use (depending on the machine you are on) "evince" or
"ghostview" or "gv" or "kghostview" or "kpdf" or ... .

To print:  You can normally find a print button or menu on your 
previewer.  You can also print directly from the command line as
above, e.g., to print to printer "color5m" from an HP machine:

  $ lp -d color5m sample.pdf

from a Linux machine: the above or

  $ lpr -P color5m sample.pdf

-----

N.B. These files are for internal, draft use only: University policy
     requires that all external correspondence be on official KSU
     letterhead.

Let me know if you have any problems.

Chuck Gartland

February 25, 2002 (orig)
September 22, 2007 (latest revision)