README

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

3DLDF is a GNU package. It is part of the GNU Project of the 
Free Software Foundation.  See the website http://www.gnu.org for more
information.  

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 


$Id: README,v 1.4 2003/12/01 20:32:29 lfinsto1 Exp lfinsto1 $

3DLDF is a package for three-dimensional drawing with MetaPost output.
It currently does not possess an input routine, so that user code must
be written in C++, compiled, and linked with the rest of the program.
This file, and the _User and Reference Manual_ 
(/3DLDF-1.1.3/DOC/TEXINFO/3DLDF.ps) contain instructions on how to do
this.  3DLDF is intended, among other things, to provide a fairly
convenient way of making 3D drawings that can be included in TeX
documents.

3DLDF is available for downloading from
http://ftp.gnu.org/gnu/3DLDF.
The official 3DLDF website is 
http://www.gnu.org/software/3DLDF.

See the file INSTALL for instructions on installing 3DLDF.


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 files /3DLDF-1.1.3/CWEB/3DLDFprg.ps and
/3DLDF-1.1.3/DOC/TEXINFO/3DLDF.ps contain respectively the documents  
_3DLDF: The Program_ and the _3DLDF User and Reference Manual_ 
in PostScript format.  In addition,
/3DLDF-1.1.3/CWEB/3DLDFprg.dvi contains _3DLDF: The Program_ in DVI
format.  If you need to  
regenerate the documentation for some reason, type `make ps' at the
command line from the directory /3DLDF-1.1.3/.  
Please note, that if you decide to run cweave on 3DLDFprg.web by hand,
be sure to use the version of the file cwebmacs.tex 
in /3DLDF-1.1.3/CWEB/, since I've made a number of additions and changes
to the original.  Ordinarily, it will be used automatically, so most
users won't need to worry about this. 

I apologize for the number of typos and other errors in the
documentation.  I hope they don't detract from their usefulness.  I
would have liked to have proofread and corrected them again before
publication, but for reasons external to 3DLDF, it is necessary
for me to publish now.  
I plan to set up an errata list on the website:
http://www.gnu.org/software/3DLDF

Once 3DLDF is installed, put the code for your drawings in
/3DLDF-1.1.3/main.web, and call `make run' from the command
line in the directory /3DLDF-1.1.3/ to run 3dldf (the executable
program), MetaPost, TeX, and dvips, to generate a PostScript file
containing your drawings.  

As a convenience, /3DLDF-1.1.3/ and /3DLDF-1.1.3/CWEB/ both contain an
identical shell script called `ldfr', which simply calls 'make run',
so that 3DLDF can be used conveniently from either directory.  

To get rid of the files that 3DLDF generates, without deleting any
important ones, call `make purge'.

If you call `make all', it will work, but make may exit with an
error, because there will be too many errors when it tries to generate
a `3DLDF.info' file.  
This is because the Texinfo file 3DLDF.texi currently can't be
used to generate an Info file, only a PostScript file (the _3DLDF User
and Reference Manual_). However, it will generate a `3DLDF.info' file
despite the errors, so `make all' will work the next time it's
called.  The same thing may happen if you call `make dist'.  I say
"may", because I tested it again on November 27, 2003, and neither
`make all' nor `make dist' failed.  I suspect they fail after any of
the Texinfo sources have been changed.

For further information, see the _3DLDF User and
Reference Manual_ (/3DLDF-1.1.3/DOC/TEXINFO/3DLDF.ps).  



For information about changes to 3DLDF, see ChangeLog, ./CWEB/ChangeLog, 
./DOC/ChangeLog, ./DOC/TEXINFO/ChangeLog, 
./RCSFREEZE.log
./CWEB/RCSFREEZE.log, ./DOC/RCSFREEZE.log, and ./DOC/TEXINFO/RCSFREEZE.log.  
The latter files
contain information about frozen configurations, referring to general
changes affecting multiple files.  
	
./CWEB/ChangeLog.dev, ./DOC/TEXINFO/ChangeLog.dev,
./CWEB/.rcsfreeze.log.dev, and ./DOC/TEXINFO/.rcsfreeze.log.dev contain the
ChangeLog files and .rcsfreeze.log files from my development version up to
2003-11-28, when I set up RCS repositories for my releases.  






