<![CDATA[
<BODY bgcolor="#606096" TEXT="#e5ffe5" LINK="#e9e94b"
ALINK="#c8c8ff" VLINK="#47d3d3">
<CENTER>
<A NAME="top">
<A HREF="../"><IMG HSPACE=50 BORDER=0 ALIGN=TOP
SRC="../images/math-banner5.gif" ALT="University of Pennsylvania,
Department of Mathematics"></A></A>
</CENTER>
<H1>General Usage Notes</H1>
<P>
<B><a name="contents">Contents</a></B>
<UL>
<LI><a HREF="#login">How to login</a>
<LI><a HREF="#logout">How to logout</a>
<LI><a HREF="#customize">How to customize your configuration</a>
<UL>
<LI><a HREF="#editors">Picking your editors</a>
<LI><a HREF="#printer">Pick your default printer</a> (in 4N16 or 4E1)
<LI><a HREF="#delete">Pick "backspace" or "delete" key</a>
<LI><a HREF="#aliases">Add your aliases for commands, path, etc.</a>
</UL>
<LI><a HREF="#hints">Usage Hints</a>
<UL>
<LI><a HREF="#mail">E-Mail</a>
<LI><a HREF="#tex">TeX and LaTeX</a>
<LI><a HREF="#editor">Editor</a>
<LI><a HREF="#spell">Spelling</a>
<LI><a HREF="#paste">Cut and Paste</a>
<LI><a HREF="#paste">World Wide Web Browser</a>
<LI><a HREF="#passwd">Changing your password</a>
</UL>
</UL>
<H1><A NAME="login">How to Login</A></H1>
If you are logging in by modem or telnet or rlogin, then you should
use whatever procedure you have been using previously.
<P>
To login from one of the X-terminals, select
<tt>hans.math.upenn.edu</tt> from the login chooser.
<H1><A NAME="logout">How to Logout</A></H1>
Place the mouse cursor on an empty part of the screen and press the
right-most mouse button. A menu will pop-up. Pick <tt>quit</tt>.
<P>
<a HREF="#contents">Return to Table of Contents</a>
<H1><a name="customize">Customizing your configuration</a></H1>
<B><a name="editors">EDITORS: </a></B>
<br>
You may wish to pick your editor for various situations. None of
these editors do things like pick fonts etc. They are editors, not
word processors. By default, everyone has the simple editor "pico"
which many people currently use when they send mail using Elm.
However, when using an X session you may prefer a different editor.
<P> The first two editors both resemble the editor "edit" on the NeXT.
They use a mouse and are fairly intuitive.
<DL>
<DT><B>nedit</B>
<DD> available on both hans.math and graphics.math
<br> I am told this is like an editor in a Mac
<DT><B>emacs</B>
<DD>This is one of the two traditional Unix editors (the other is
<B>vi</B>, see below) This is fairly powerful. The related editor
Pico was designed as a simplified (watered-down) version of this.
<DT><B>vi</B>
<DD>Another standard Unix editor. Most new users will prefer one of
the other editors. This was the first full screen editor, and has not
really changed over the years.
</DL>
The following is exactly what the script to pick an editor looks like.
This information can be found in the file <B>.editor-csh</B>. The
only lines that are read by the computer are the lines <I>without</I> a #
at the beginning. Thus remove the # from your choice (and insert a #
for those you do *not* want).<pre>
if ($?DISPLAY) then
# X editors
setenv SPARC_EDITOR /pkg/bin/pico
#setenv SPARC_EDITOR /pkg/bin/emacs
#setenv SPARC_EDITOR /pkg/bin/nedit
setenv NEXT_EDITOR /usr/local/bin/pico
#setenv NEXT_EDITOR /usr/bin/emacs
else
# single screen (i.e. vt100, rlogin/telnet) editors
setenv SPARC_EDITOR /pkg/bin/pico
# setenv SPARC_EDITOR /pkg/bin/emacs
# setenv SPARC_EDITOR /usr/bin/vi
setenv NEXT_EDITOR /usr/local/bin/pico
#setenv NEXT_EDITOR /usr/bin/emacs
#setenv NEXT_EDITOR /usr/ucb/vi
endif</pre><P>
<B>IMPORTANT NOTE:</B> If you use an editor with command line
arguments, you <EM>MUST</EM> put quotation marks around the entire
command. For example:
<PRE>
setenv SPARC_EDITOR "/pkg/bin/pico -t"
</PRE>
is correct, but
<PRE>
setenv SPARC_EDITOR /pkg/bin/pico -t
</PRE>
is incorrect, and will cause other problems in your setup.
<P>
<a HREF="#contents">Return to Table of Contents</a>
<H2><a name="config">Personal Configuration</a></H2>
You may choose to make the following changes to your <B>.login</B> file:
<UL>
<P>
<B><a name="printer">PRINTER:</a></B>
<P>
Pick as your default printer either the printer in 4N16 or 4E1. Near
the beginning of this file you place a # at the beginning of the line
containing the printer that you do NOT want. For instance, to use
the printer in 4E1, <B>.login</B> would look like:<pre>
#setenv PRINTER 4N16 # 4N16 HP printer
setenv PRINTER 4E1d # 4E1d HP printer </pre>
(The character # "comments out" the line; it is then treated as a remark
and not executed).
<P>
More information on printing may be found in the <A
HREF="print.html">Printer Usage Guidelines</A> document.
<B><a name="delete">BACKSPACE or DELETE Key</a></B>
<P>
Do you prefer using the Delete key rather than Backspace? If you
prefer the "delete" key, then uncomment out the second line in your
file by deleting the #
<pre> stty erase ^H
#stty erase ^?</pre>
<P>
<a HREF="#contents">Return to Table of Contents</a>
<P>
<B><a name="aliases">ALIASES</a></B>
<P>
<I>The ONLY people who will need this step are those who personalized
their previous .cshrc file (practically nobody).</I>
<P>
Insert your personal aliases from your old .cshrc file. This is
located in a directory named something like <tt> old_configs_950502
</tt>, where the last part of the name is the date it was created. At
the same time insert any other customization from your old .cshrc
file.
<P>
If you wish to add personalized items to your <B>path</B>, do it using a
line such as the following:<pre>
set path=( $path /my/path/choice /etc/etc/etc )</pre>
This inserts the system path first. That system path is different
depending on which computer you use and is determined when you login.
<P>To customize your <B>MANPATH</B>, inserting yours before the system
MANPATH use<pre>
setenv MANPATH MyManPath:$MANPATH</pre>
where you insert your own "MyManPath".
</UL>
<P>
<a HREF="#contents">Return to Table of Contents</a>
<P>
<H2><a name="hints">Usage Hints</a></H2>
<I>Remark</I>: See also the brief description of the most common
<a HREF="unixdoc.html">Unix Commands</a>.
<DL>
<DT><B><a name="mail">MAIL</a></B>
<DD>
For reading and sending email, most users will prefer to use <B>elm</B>. It
is simple and effective. There is also a utility <B>readmail</B>
which uses elm to access to your NeXT mailboxes. This
will be of use primarily to those who have a number of different
mailboxes.
<P>
<DT><B><a name="tex">TeX and LaTeX</a></B>
<DD>TeX is unchanged, however hans.math has the new version LaTeX 2e of
LaTeX. It should process old LaTeX files without modification.
<P>One place to read more about the new version of LaTeX 2e is the following
TeX file on our server hans.math:
<tt>/pkg/TeX/lib/texmf/doc/latex2e/usrguide.tex</tt>
<P>Another reference is a sequence of articles that appeared in the
Notices of the AMS in 1994 (the last article appeared in August 1994).
<P>
To PREVIEW a TeX .dvi file, use <B>xdvi</B> (click on the "icon"
on the right side of your screen) and pick the name of the file you
wish to preview. You can also use the Unix command <tt>xdvi MyDviFile</tt>.
<P> To PRINT a TeX .dvi file use the Unix command
<pre> dvips MyDviFile.dvi</pre>
where MyDviFile.dvi is the name of your file. You need not add the ".dvi".
This will be printed on the printer you specified (see customization above).
You can also print to a file as well as other possibilities. for a
brief description, just type <tt>dvips</tt> <I>without</I> a filename.
For more documentation see
<a HREF="http://www.cl.cam.ac.uk/texinfodoc/dvips_toc.html">Dvips Info</a>
<P> Another utility, <B>xtexer</B>, is available from the X terminals.
This provides a simpler interface for editing, previewing, and
printing TeX and LaTeX documents.
<P>
<DT><B><a name="editor"> EDITOR</a></B>
<DD>You can pick an editor from the list in the icons at the right of the
monitor. When using a program such as Elm or Tin (the netnews
reader), or Lynx (the WWW browser) the editor is usually selected in
the configuration file for that program itself. It obtains this from
the EDITOR customization (see above).
<P>
<DT><B><a name="spell">SPELLING</a></B>
<DD><I>emacs</I> is the only editor on <tt>hans.math</tt> with an adequate
spelling checker. With emacs, typing Ctrl C3 calls the spelling
checker <B>ispell</B>.
<br>
If you use a different editor, to check spelling, exit the editor and
use the stand-alone version of <tt>ispell</tt> with the Unix command:
<pre> ispell MyFileName
or ispell -t filename.tex (for a TeX or LaTeX file)
</pre>
<I>NOTE</I>: The <B>I</B> command adds new words to your personal file
<tt>.ispell_words</tt> located in your home directory. This file can
be edited, either to add words or correct spelling of accidently
inserted words.
<br>See <B>
<a HREF="http://csugrad.cs.vt.edu/manuals/ispell/ispell_toc.html">ispell</a>
</B>or the Unix man page (<tt> man ispell</tt>) for more information.
<P>
<DT><B><a name="paste">CUT and PASTE</a></B>
<DD>The mouse on an X-Terminals has <I>three</I> buttons. Drag using use the
left button to mark the part of the text. Then go to where toy wish
to insert this text, possibly in a different document, and press the
<I>middle</I> mouse button.
<P>
<DT><B><a name="www"> WORLD WIDE WEB</a></B>
<DD>We will use the <I>Netscape</I> browser. Netscape will
automatically open in iconized form when you login. Click once to get
to the Math. Dept. Home Page (if you wait, it appears automatically
after a few minutes). [These sentences will be obscure until you try
to use Netscape on hans.math].
<P>
<DT><B><a name="passwd">Changing your password</a></B>
<DD>To change your password, use the command <B>passwd</B>. You will
first be prompted for your old password. Your new password will also
be used on the NeXTs and graphics.math.<P>
<B>passwd</B> is also available on the NeXTs, although it will take 15
minutes for the new password to take effect.
</DL>
<P>
<a HREF="#contents">Return to Table of Contents</a>
<HR>
</BODY>
]]>