Cyclone-Team/gramps
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Corrected outdated documentation info and links.

Browse Source 
svn: r1115
This commit is contained in:
Donald A. Peterson 2002-08-07 01:26:01 +00:00
parent 84235796f6
commit cc5c53e3c4
2 changed files with 11 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
gramps/INSTALL
View File

@ -16,7 +16,7 @@ building gramps.
SHORT VERSION: SHORT VERSION:
Execute: Execute:
aclocal aclocal
automake --gnu && autoconf && make automake --add-missing --gnu && autoconf && make
HTML documentation is built from SGML sources via jw. It is known to work HTML documentation is built from SGML sources via jw. It is known to work
with docbook-utils-0.6.9. There is a problem with 0.6.10, which seems to with docbook-utils-0.6.9. There is a problem with 0.6.10, which seems to

30
gramps/README
View File

@ -15,31 +15,21 @@ Documentation
--------------------------------- ---------------------------------
Gramps documentation is supplied in the form of SGML files, which will be 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 installed in the GNOME help path(*). Recent versions of Nautilus and Galeon
can generate HTML documents on-the-fly from these. To generate distinct can generate HTML on-the-fly documents from these. For more information on
HTML documentation follow these steps: building HTML files (including info about packages that do and do not work
with the documentation) see the INSTALL file. To generate separate HTML
documentation:
1) Ensure the following packages are installed: 1) Ensure the following packages are installed:
* db2html >= 0.6.9 (jw >= 1.1) to convert the SGML -> HTML * db2html >= 0.6.9 (jw >= 1.1) to convert the SGML -> HTML
* gnome-doc-tools-2-1 for the GNOME documentation style sheets * 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 at The former is part of the docbook-utils package, the latter can be found
http://people.redhat.com/dcm/software.html. The /etc/sgml/catalog file from the developer section at gnome.org.
should contain an entry pointing to PNG support. If configured properly,
your db2html should automatically look up and use the /etc/sgml/catalog
file. If it doesn't you can try editing the DB2HTML line in Makefile.comm
to explicitly use that file, DB2HTML = db2html -c /etc/sgml/catalog
2) Invoke configure with the --enable-html option: One also needs png support for sgml, which should be a part of the
./configure --enable-html gnome-doc-tools package. The /etc/sgml/catalog file should
contain an entry pointing to PNG support. If configured properly, your
3) In addition to the normal 'make' and 'make install', you need to also db2html should automatically look up and use the /etc/sgml/catalog file.
execute 'make html && make install-html'.
If all goes well and you do the happy dance, the HTML files should be
built and installed successfully. Due to a wide variation in the
implementation of db2html (and docbook-utils) across various Linux
distributions, though, this is not guaranteed to work. Some configure-time
checks are in place, and it _should_ work, but it is very ad-hoc at the
moment. You have been warned. :-)
Of course, current HTML documentation can also be found on the gramps website, Of course, current HTML documentation can also be found on the gramps website,
http://gramps.sourceforge.net/help.html http://gramps.sourceforge.net/help.html