povray/unix
Wouter Verhelst 9e7e624bcd Make sure Makefile.in gets generated properly
config.guess, config.sub, depcomp, etc, are all scripts that ship with
automake, and which will be updated with a new automake version; it's
generally a bad idea to use one of these scripts from a different
automake version.

Moreover, recent versions of automake also contain and require a
"compile" script, which isn't in this directory.

Instead, pass the "--add-missing" parameter to automake, which will copy
the required files to the expected location. This will make automake
work, regardless of the version, and will avoid any issues due to the
used scripts not matching the used automake version.
2013-12-06 08:37:38 +01:00
..
config Make sure Makefile.in gets generated properly 2013-12-06 08:37:38 +01:00
icons Initial import 2013-11-06 13:07:19 -05:00
scripts Initial import 2013-11-06 13:07:19 -05:00
AUTHORS Initial import 2013-11-06 13:07:19 -05:00
ChangeLog Initial import 2013-11-06 13:07:19 -05:00
configure.ac Account for changes in boost dependencies 2013-12-06 08:02:27 +01:00
COPYING Initial import 2013-11-06 13:07:19 -05:00
disp.h Initial import 2013-11-06 13:07:19 -05:00
disp_sdl.cpp minor whitespace cleanup 2013-12-05 04:00:17 +01:00
disp_sdl.h Initial import 2013-11-06 13:07:19 -05:00
disp_text.cpp Initial import 2013-11-06 13:07:19 -05:00
disp_text.h Initial import 2013-11-06 13:07:19 -05:00
install Initial import 2013-11-06 13:07:19 -05:00
install.txt Initial import 2013-11-06 13:07:19 -05:00
Makefile.header Initial import 2013-11-06 13:07:19 -05:00
NEWS Initial import 2013-11-06 13:07:19 -05:00
povray.1 Initial import 2013-11-06 13:07:19 -05:00
povray.conf Initial import 2013-11-06 13:07:19 -05:00
prebuild.sh Make sure Makefile.in gets generated properly 2013-12-06 08:37:38 +01:00
README Initial import 2013-11-06 13:07:19 -05:00
README.bin Initial import 2013-11-06 13:07:19 -05:00
README.md Update README.md 2013-11-16 19:23:41 +11:00
README.unix Initial import 2013-11-06 13:07:19 -05:00
VERSION Initial import 2013-11-06 13:07:19 -05:00
xbgmap.xpm Initial import 2013-11-06 13:07:19 -05:00
xpovicon.xbm Initial import 2013-11-06 13:07:19 -05:00
xpovicon.xpm Initial import 2013-11-06 13:07:19 -05:00
xpovmask.xbm Initial import 2013-11-06 13:07:19 -05:00

Building POV-Ray 3.7 for GNU/Linux and similar systems

This distribution contains the complete source code of POV-Ray for UNIX as well as its accompanying HTML documentation and supporting files. In order to build the distribution supplied in the POV-Ray github repo, you will need to run a pre-build step. This generates the configure script and does a few other things usually performed by our developers prior to releasing a source package.

NB if you have improvements to the below instructions, please add a comment to issue #1, or (if you are working in a branch) send us a pull request.

Generating configure and building the code

% cd unix/
% ./prebuild.sh
% cd ../
% ./configure COMPILED_BY="your name <email@address>" 
% make

Note that the prebuild step will generate a few warnings as it still looks for some files no longer included in v3.7. This is harmless.

Installing

% make install

This above installs POV-Ray under system-wide directories and needs root privileges. Installing as non-privileged user is also possible. By default (i.e. as root), 'make install' installs the following components:

povray binary (executable)              in /usr/local/bin
data files (e.g. includes, scene files) in /usr/local/share/povray-3.7
documentation (text and html)           in /usr/local/share/doc/povray-3.7
configuration files (e.g. povray.conf)  in /usr/local/etc/povray/3.7

The configuration files are also copied under the $HOME/.povray/3.7 directory of the user (or root) who is doing the installation.

Please see unix/install.txt for more details about available configuration options etc.

Dependencies

By default POV-Ray will attempt to build using system-supplied libraries for boost, zlib, libpng, libjpeg, libtiff, and openexr. We recommend you have the following packages pre-installed:

libboost-dev
zlib1g-dev
libpng12-dev
libjpeg8-dev
libtiff5-dev
libopenexr-dev