Dear user,
	This program is FULL of BUGS and I DO NOT assume any responsability
on the consequences of its use. (it is not THAT dangereous)

                        USE IT AT YOUR OWN RISK.
_______________________________________________________________________________
FILE YOU SHOULD HAVE:

README		this file
INSTALL		csh installation script
pdbv_IRIX405	executable for IRIX 4.0.5
pdbv_IRIX53	executable for IRIX 5.3
pdbv.z		packed pseudo-man page
_______________________________________________________________________________
INSTALLATION:

	To install the program follow the steps:

    - Edit the file INSTALL and modify the following two lines in it:
set PDBV_BINPATH = /usr/local/bin
set PDBV_MANPATH = /usr/local/man/cat1
changing the directories to whatever you want.

    - execute the script INSTALL specifying the IRIX operating system you 
are using in the following way:
 % ./INSTALL 405
 % ./INSTALL 53
if the IRIX 5.3 version does not work on your machine you can try the 
IRIX 4.0.5.

NOTE: you should be SuperUser (root) to install the program

	Any comments, please feel free to send me e-mail.

_______________________________________________________________________________
SHORTS ON USING PDBV:

Start the program by typing:
 % pdbv -f file.pdb

where file.pdb is your molecular model in the PDB format.

	The program will create at startup 3 standard objects which can be
interactively toggled with the FUNCTION keys: 
   F7 = Suporting C-alpha (trace that is NOT modifiable by the user),
   F1 = C-alphas,
   F2 = backbones and
   F3 = all-PROTEIN-atoms-in-PDB

	This program also allows the user to create a secondary window to
display the Ramachandran plot of the molecule being viewed. Actually the
plot starts empty (you must click inside as soon as the window is placed
in your desktop) and a pop-up menu is available in the window that allows
the user to chose between the plot background (either theoric areas or
procheck statistics). 

	Besides allowing the user to rotate-translate-scale-slab-etc with
some complicated mouse button combinations it is also possible to pick
atoms (there is a four [4] atom buffer; last four picked atoms) and to do
measures with them (e.g. distance, dihedral, neighbours and Hbonds [very
nasty, it is not really H-bonds, it just checks for the atom types and for
the distance] ). 

	Things that are hard to do on most mol/graph packages can easily
be done with pdbv. For example, you can pick an atom, press "a" on the
keyboard and you're presented with a sphere of atoms within 10 A of the
picked atom (the 10A cutoff can be changed with the arrow-keys).  Also
after picking an atom you can press "s" for a sidechain, "r" for the
residue, "o" for the neighbours and lots more. 

	The program also allows you to insert text and shapes (rectangles,
ellipses and lines, filled or not). After chosing insert text or edit 
text, wait until a floating prompt appears. The edit/text function allows
only to change color/size/font of the text NOT the TEXT. Also you can put
accents on some letters, but not all accents, only those used in portuguese
(which is my native language). 

_______________________________________________________________________________
COMMENTS AND BUGS:
	If you want to send me comments, put them in a PostCard and send it 
to my AIR-MAIL address. 
	Well, if you don't want to send me the postcard you can send the 
comments by e-mail.

_______________________________________________________________________________
HOW TO FIND ME:

Ezequiel Horacio Panepucci <-- This is ME, but you can call me Zac

E-MAIL:   zac@ifqsc.sc.usp.br
PHONE:    55-162-74-9204 
FAX:      55-162-71-3616

AIR-MAIL: Grupo de Cristalografia
          DFI / IFSC / USP
          Av. Dr. Carlos Botelho, 1465 - Centro
          C.P.: 369
          Sao Carlos - SP
          Brasil