INSTALL

This file is part of 3DLDF, a package for three-dimensional drawing. 
Copyright (C) 2003 Laurence D. Finston. 

$Id: INSTALL,v 1.6 2004/01/12 20:46:02 lfinsto1 Exp $

3DLDF 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. 

3DLDF 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 3DLDF; if not, write to the Free Software 
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 

3DLDF is a GNU package.  
It is part of the GNU Project of the  
Free Software Foundation 
and is published under the GNU General Public License. 
See the website http://www.gnu.org 
for more information.   
3DLDF is available for downloading from 
http://www.gnu.org/3DLDF. 
It is also available from 
http://www.dante.de/software/ctan/, the Dante www-server  
and from http://wwwuser.gwgd.de/~lfinsto1, 
the author's website.  

Please send bug reports to bug-3DLDF@gnu.org 
The mailing list help-3DLDF@gnu.org is available for people to 
ask other users for help.  
The mailing list info-3DLDF@gnu.org is for sending 
announcements to users. To subscribe to these mailing lists, send an 
email with ``subscribe <email-address>'' as the subject.  
The author can be contacted at: 

Laurence D. Finston 
Kreuzbergring 41 
D-37075 Goettingen 
Germany 

lfinsto1@gwdg.de 
s246794@stud.uni-goettingen.de 


To install 3DLDF, decompress 3DLDF-1.1.5.tar.gz using gzip, or a
compatible program, e.g., 
`gunzip 3DLDF-1.1.5.tar.gz'.
Then, expand 3DLDF-1.1.5.tar using the tar command, typically:
`tar xvpf 3DLDF-1.1.5.tar'
The exact syntax of the tar command may differ, depending on what
system you're using.

3DLDF unpacks into the directory /3DLDF-1.1.5/.  

Change your working directory to /3DLDF-1.1.5/ and run 
`configure --prefix=<your path>/3DLDF-1.1.5/' 
to generate the Makefiles.  There is one each in /3DLDF-1.1.5/, 
/3DLDF-1.1.5/CWEB, /3DLDF-1.1.5/DOC, and /3DLDF-1.1.5/DOC/TEXINFO.  
`<your path>' must be the absolute path of the directory where you
want to put the /3DLDF-1.1.5/ subdirectory. For example, if you want
to put 3DLDF into /usr/local/mydirectory/, enter
 `configure --prefix=/usr/local/mydirectory/3DLDF-1.1.5/' 

Since 3DLDF currently does not have an input routine, the executable
3dldf will need to be regenerated each time the user code changes.
For this reason, it might as well reside in the same directory as the
C++ source files.  However, it can be put in 
another directory, e.g., /usr/local/bin/, if desired.  In this case,
`configure' can be called with a different `prefix' argument, or the
default (/usr/local/bin/) can be used.

Change the working directory to /3DLDF-1.1.5/ and 
call `make install' from the command line of a shell.
This creates the executable file `3dldf'.

For information on running 3dldf, see the README file in this directory, and
the _3DLDF User and Reference Manual_, which is included in this
distribution as the PostScript file /3DLDF-1.1.5/DOC/TEXINFO/3DLDF.ps.

