gramps/gramps
Don Allingham 69eabdf997 Fixed apply on test
svn: r1658
2003-06-04 13:00:32 +00:00
..
doc Patch-release for 0.8.1 2003-02-17 03:08:06 +00:00
example General cleaup 2002-04-21 14:53:28 +00:00
omf-install Vastly overhauled Makefile heirarchy to conform to GNU automake/autoconf 2002-07-01 18:55:23 +00:00
src Fixed apply on test 2003-06-04 13:00:32 +00:00
.cvsignore
aclocal.m4 Update for .in files 2002-07-14 23:36:28 +00:00
AUTHORS Vastly overhauled Makefile heirarchy to conform to GNU automake/autoconf 2002-07-01 18:55:23 +00:00
autogen.sh Added hook to ensure py-compile script is executable. Updated autmoake ftp 2002-07-24 00:45:17 +00:00
ChangeLog Vastly overhauled Makefile heirarchy to conform to GNU automake/autoconf 2002-07-01 18:55:23 +00:00
configure Patch-release for 0.8.1 2003-02-17 03:08:06 +00:00
configure.in Patch-release for 0.8.1 2003-02-17 03:08:06 +00:00
COPYING
gramps.sh.in Updated GRAMPS shell script to build LD_PRELOAD variable correctly 2002-07-27 13:54:56 +00:00
gramps.spec Patch-release for 0.8.1 2003-02-17 03:08:06 +00:00
gramps.spec.in Patch-release for 0.8.1 2003-02-17 03:08:06 +00:00
HACKING Moved INSTALL to HACKING since INSTALL can be overwritten by autotools (namely autoreconf -vfi) 2003-01-16 19:49:53 +00:00
INSTALL A little more information moving/reorganizing between the documents 2002-08-07 04:34:00 +00:00
install-sh
Makefile.am More Makefile overhaul 2002-07-01 19:05:11 +00:00
Makefile.in Update for 0.8.0 release candidate 1 2002-07-23 16:23:18 +00:00
NEWS Ready for 0.8.0 release 2002-08-19 04:34:45 +00:00
py-compile Made executable 2002-07-23 18:20:47 +00:00
README Moved INSTALL to HACKING since INSTALL can be overwritten by autotools (namely autoreconf -vfi) 2003-01-16 19:49:53 +00:00
TODO Updated bug checks 2002-10-14 00:39:26 +00:00

Please read the COPYING file first.
If building from source, also read the HACKING file (at least through the
"SUPER-SHORT VERSION") before going further.

Requirements
--------------------------------
Python 1.5.2 or greater
Gnome 1.2 or greater
PyGnome 1.0.53 or greater

If you are using python 1.5.2, you may also need PyXML 0.6.2 or
greater. Many distributions already provide this, but if your
installation does not have it, you can get it from
http://sourceforge.net/project/showfiles.php?group_id=6473

Documentation
---------------------------------
Gramps documentation is supplied in the form of SGML files, which will be
installed in the GNOME help path(*).  Recent versions of Nautilus and Galeon
can generate HTML on-the-fly documents from these.  For more information on
building HTML files (including info about packages that do and do not work
with the documentation) see the INSTALL file.  To generate HTML
documentation the following packages *MUST* installed:
* db2html >= 0.6.9  (jw >= 1.1)  to convert the SGML -> HTML
* gnome-doc-tools-2-1            for the GNOME documentation style sheets
The former is part of the docbook-utils package, the latter can be found
from the developer section at gnome.org. (note that docbook-utils 0.6.10 is
buggy)

One also needs png support for sgml, which should be a part of the
gnome-doc-tools package. The /etc/sgml/catalog file should
contain an entry pointing to PNG support. If configured properly, your
db2html should automatically look up and use the /etc/sgml/catalog file.

Of course, current HTML documentation can also be found on the gramps website,
http://gramps.sourceforge.net/help.html

(*) More precisely, they are installed in ${prefix}/share/gnome/help, where
${prefix} is given by the --prefix= option to configure.  If this is
different from where your standard GNOME installation looks for help files
and documentation, then set your GNOMEDIR environment variable to the
${prefix} path before starting gramps. For example, if you are installing
gramps in /usr/local/, then type the following:
in tcsh: setenv GNOMEDIR /usr/local/
in bash: GNOMEDIR=/usr/local/ ; export GNOMEDIR


Building on non-Linux systems: i18n support and GNU make
--------------------------------------------------------

Linux has libintl (GNU gettext) built-in the C library. Other systems
are likely to have libintl as a separate or optional library. Also,
other systems may have a different make utility.

On those systems, like FreeBSD, you must tell configure where to find
the libintl library and the libintl.h include file:

CPPFLAGS="-I/usr/local/include -L/usr/local/lib" ./configure --prefix=/usr/local

Once you have done this, if make fails, use gmake (the name FreeBSD
gives to GNU make) instead.

--------------------------------
Donald Allingham
dallingham@users.sourceforge.net