ANNOUNCE: new DocBook RPMs available

[Mark Galassi <rosalia cygnus com>]

Amigos, I recently put out new DocBook RPMs.  Here's the announcement
I sent out.

If y'all are adding docs for the gnome-libs 1.0 release, I recommend
you use these tools to process them and verify them.  Among other
things, balanced tags will be enforced now.

I have already gone through gnome-libs/devel-docs to make those files
compliant with the new strictness.

        ANNOUNCE: the Cygnus DocBook packages, 1998-11-30
        =================================================

Dear DocBook enthusiasts,

I have placed the latest DocBook packages on the Cygnus anonymous ftp
server:

    ftp://ftp.cygnus.com/pub/home/rosalia/docware/

The RPMs have been seriously overhauled, and the various parts of the
DocBook picture are now being tracked much better.

As an example (which also includes tables), you can look at my DocBook
tutorial, which has been converted with "db2html", "db2ps" and
"db2rtf".  The stuff is at:

     http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html

------------ important changes ------------

* Closing tags cannot be minimized

  It is now necessary to close all tags: no tags are minimizable.
  This is the prescribed behavior for DocBook, but in the past the
  tools were not reading the DocBook declaration properly; now they
  are, so they enforce things.

  Since the tools were forgiving, you might have some files which need
  the tags to be balanced.

* jadetex now requires teTeX version 0.9 or greater (see the INSTALL
  file below).

------------ project status ------------

Since we started maintaining these RPMs a lot of things have happened,
but some still need to happen.  Here are some issues I would like
people to know about or think about.  This list is shorter than it
used to be.

stylesheets
-----------
   Norman Walsh is actively maintaining the stylesheets.

jade
----
   James Clark is actively maintaining jade.  On top of that, Cess de
   Groot is maintaining the UNIX installation parts of it, so it now
   compiles with egcs, and installs with a configure script.

jadetex
-------
   Sebastian Rahtz is actively maintaining jadetex.

working with the sgml-tools team
--------------------------------
   It is my intention to merge my work on these RPMs with that of Cees
   de Groot and others in the sgml-tools effort
   (http://www.sgmltools.org/).

intro to docbook
----------------
   My tutorial at
     http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html
   is getting a lot of coverage, so I will continue to maintain that
   document.

------------ which packages ------------

The files in the
  ftp://ftp.cygnus.com/pub/home/rosalia/docware/RPMS/i386
directory right now are:

docbook-3.0-5.i386.rpm      psgml-1.0.1-5.i386.rpm
jade-1.2.1-1.i386.rpm       sgml-common-0.0-4.i386.rpm
jadetex-2.3-0.i386.rpm      stylesheets-0.7-2.i386.rpm

but you should usually look for the latest versions in that directory.
The directory RPMS/alpha has older versions only.  The directory SRPMS
has current versions of the source RPMs.  I am not maintaining a
cross-platform setup for these tools, but you could try to build the
tools yourself with the SOURCES and SPECS directories.

There used to be a package called sgml-demo, but since I have not yet
updated it, and it is misleading, I am leaving it out for now.

Yours truly,

Mark Galassi
rosalia@cygnus.com
http://nis-www.lanl.gov/~rosalia/

------------ the INSTAL file ------------

Prerequisites
-------------

To use jadetex (to get printed output with TeX) you will need to
install teTeX 0.9 (or newer).  RedHat 4.x, 5.0 and 5.1 come with teTeX
0.4 which cannot handle jadetex.

You can get teTeX 0.9 from the RedHat 5.2 distribution and install it
on older RedHat releases.  You will need tetex and tetex-latex, and
you will probably also want tetex-dvips and tetex-xdvi.

Here are ftp URLs for the various teTeX packages:
 
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-0.9-6.i386.rpm
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-afm-0.9-6.i386.rpm
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-doc-0.9-6.i386.rpm
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-dvilj-0.9-6.i386.rpm
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-dvips-0.9-6.i386.rpm
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-latex-0.9-6.i386.rpm
   ftp://rawhide.redhat.com:/i386/RedHat/RPMS/tetex-xdvi-0.9-6.i386.
   ftp://rawhide.redhat.com:/SRPMS/tetex-0.9-6.src.rpm


Installing
----------

Install the RPMs in the following order:

sgml-common
docbook
jade
[make sure you've upgraded to tetex 0.9]
jadetex
psgml
stylesheets