Re: docbook installation

[Gleef <dzol virtual-yellow com>]

On Sat, 20 Mar 1999, Ronald de Man wrote:
> I wonder how many persons have succeeded in installing
> docbook/gtk-doc/gnome-docu such that it actually works.
> For example where should DocBook DTD v3.0 be installed. You obviously
> can't put it anywhere without specifying the path in some other place,
> but where you have to specify what is cleverly hidden.

My copy is in /usr/lib/sgml (since I installed from RPMS).  Using
/usr/local/lib/sgml, /usr/share/sgml, /usr/local/share/sgml or /opt/sgml
would also make sense to my mind.

The two key things you need for an SGML system to work are the SGML
programs (eg. Jade and PSGML) to be able to find CATALOG (also in
/usr/lib/sgml on my system), and for CATALOG to be able to find everything
else (all dtds are either in the same directory or a subdirectory of
CATALOG's location on my system).  

This, of course, assumes no bugs.  For example, old copies of PSGML
running on Emacs 20.3 don't find CATALOG properly, even if it's in the
right place.

PSGML lists where it finds CATALOG by setting sgml-catalog-files
and/or sgml-local-catalog-files.  Check the attached psgml-init.el file
for an example.

I'm not sure how Jade determines its CATALOG search path, but you can
apparently override it with the -c option.

 
Best of Luck,
-Gleef
(setq load-path (append load-path '("/usr/share/emacs/site-lisp/psgml")))

(autoload 'sgml-mode "psgml" "Major mode for editing SGML." t)
(if (not (getenv "SGML_CATALOG_FILES"))
   (defvar sgml-catalog-files '("CATALOG" "/usr/lib/sgml/CATALOG"))
  "*List of catalog entry files.
The files are in the format defined in the SGML Open Draft Technical
Resolution on Entity Management.")
(put 'sgml-catalog-files 'sgml-type 'list)