
                            COPYRIGHT

  PCB, interactive printed circuit board design
  Copyright (C) 1994 Thomas Nau

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

  Contact addresses for paper mail and Email:
  Thomas Nau, Schlehenweg 15, 88471 Baustetten, Germany
  Thomas.Nau@medizin.uni-ulm.de



-----------------------------------------------------------------------------

The release has been successfully compiled on the following platforms:

X11R4
	Check the GNU info file for problems.

HP series 300 (9.00), 700 (9.01) and 800 (9.00)
	All HP machines require the MIT release of X11R5 (or R6 of the
	XConsortium). HP does not ship the Athena Widgets with its release nor
	necessary tools like imake...
	You will also have to get yourself an ANSI compiler if you are stuck
	with HPs cc.

Sun SparcStation II (Solaris 2.3, BSD 4.1.3)
	You won't have any problems if you use X11R5 or later. 
	Using OpenWindows will cause some of them. See the GNU info file for
	details about it.

Silicon Graphics Indigo (IRIX 4.0.5)
	No problems beside additional CFLAGS in Imakefile. Check if you are
	using a R4 server and, if you do, read the GNU info file of pcb.

Linux 0.99pl14 and later, XFree 2.1.1
	No problems with the S3 version of XFree. The ATI and Cirrus server
	freeze sometimes ?!?, reason unknown.

SCO ODT 3.0
	Needs tls003 of the Athena Widget library from sosco.sco.com
	(mailed by John DuBois <spcecdt@deeptht.armory.com>).

-----------------------------------------------------------------------------

     ***** YOU MUST HAVE AN ANSI COMPILER TO COMPILE THESE SOURCES *****

Here's how to install:

1. Edit Imakefile:
   - define the installation path for fonts...
   - read the note about additional paths for include files (OpenWindows)
   - if your architecture isn't listed, define
       EXITCALL as:
         -DHAS_ATEXIT if your system supports atexit()
         -DHAS_ON_EXIT if your system supports on_exit()
		 or none of them if the OS doesn't support it
       SYS_LIBRARIES as
         -ll (for lex) plus -lm
         -lfl (for flex) plus -lm
     add some additional defines as needed. If it works ok mail a copy to
     the author to be included in the next (sub)release.

2. Run 'xmkmf -a' to create the Makefile or if you don't have it
	 imake -DUseInstalled -I<X11 config directory>
	 make Makefiles
	 make includes
	 make depend
   Don't care about warnings at this time.

3. Run 
       make pcb.man
       make Pcb.ad
       make pcb.info
       make pcb.dvi
   to create a man page, the application default resource file, a GNU
   info file as well as a TeX documentation.

4. Get yourself a printed copy of the documentation and of the 'Pcb.ad'.

5. Run 'make'.

6. Test the program before you install it to see if the application defaults
   match your window environment. Copy 'Pcb.ad' to your home directory or
   to the one where your environment 'XAPPLRESDIR' points to.
   Rename it to 'Pcb'.

7. Take the printed copies from (2) and check if the translations work
   (see chapter 'Getting Started') by running 'pcb demo'.
   It comes up with layout created by an old version of pcb and therefore
   doesn't have any single elements. It provides one big element which
   covers all circuits.

   Take special care on the ones related to the functions keys and the
   pointer buttons because most of the window managers use them too.
   Change the defaults file according to your hardware/software environment.
   You may have to change all occurances of 'baseTranslations' to
   'translations' in your resource file if you use X11R4.

8. When you're satisfied with the defaults and the program run:
       make install
       make install.man
       make install.info
   as a user with the appropriate rights. Depending on the filemodes set
   by your X11 environment you must remove existing copies of fonts,
   manpage and program before you are able to install successfully.
   Set umask to 022 else the new created directories wont be world
   readable; the fonts cannot be found.



If yout create any element files or package description files I would be glad
to get a copy to include them into the next release or an additional archive.


Have fun with it.

Thomas
