Re: Playing with the spec
[I've cc'ed this to a few others]
* gk4@us.ibm.com wrote:
> Enclosed is a shell script that I used to download and install the
> sgmltools for Redhat 6.2beta. Also attached are the changes to the
> makefile I used to build the spec.
See the attached announcement. Please stop hacking on such
distribution-specific things, there are already too many of these. An
approach is underway to standardize that once and for all (that is: The
environment for SGML/DocBook-processing tools on Unix or at least
Linux). There is also a first implementation of it, based on Mark
Galassi's scripts. This implementation will also support plug-in
backends for converting DocBook via other ways beside DSSSL. If you are
interested in discussing this standard, please subscribe to the mailing
list.
Message-ID: <38C00B8B.F811465E@cybercable.tm.fr>
Date: Fri, 03 Mar 2000 13:59:23 -0500
To: Zoe Hava <zoeh@corel.com>, Guylhem Aznar <guylhem@oeil.qc.ca>,
Cees de Groot <cg@cdegroot.com>, docbook-tools@bazar.conectiva.com.br
CC: Ming Poon <mingp@corel.com>
From: Eric Bischoff <ebisch@cybercable.tm.fr>
Subject: (docbook-tools) Directory Layout normalization for DocBook
Dear friends and collegues,
I'de like to invite you to the discussion on :
docbook-tools-subscribe@bazar.conectiva.com.br
(just send a message at this address and reply to the
confirmation message)
We are trying to reach an agreement on the directory names,
file names, package names and configuration files for the
SGML and DocBook-related applications.
The results will be proposed to Mark Galassi (DocBook Tools
project) and to Ralf Flaxa (Linux Standard Base).
We already have a first draft of the recommandations and I'd
like your approval, your objections or some suggestions,
even if you don't subscribe to the list.
Here they are :
-------------------------------------------------------------------------------------------
Recomendations for DocBook and SGML processing
----------------------------------------------
In a normalization effort, about thirty people, including
packagers
of some Linux distributions, discussed informally and agreed
on a series
of recomendations that will be done to the DocBook-Tools
reference
distribution and to the Linux Standard Base project.
The philosophy was to keep the "historical" choices
everywhere it had
no consequences, and the "best" technical choice wherever it
was
interesting.
Here is the list of recommandations :
Recomendation R001 - Directory layout
(standard names for directories)
Recomendation R002 - Catalog file names
(for the merged catalog and for the individual catalogs)
Recomendation R003 - Packages
(which ones, what names, containing what)
Recomendation R004 - Configuration files
(location, purpose and syntax)
R001 - Directory layout
-----------------------
/etc/sgml/
(configuration files)
/usr/share/sgml/
iso-entities-8879.1986/
(name chosen for compatibility with
sgml-tools-1.09)
jade-1.2.1/
openjade-1.0/
(the parsers and DSSSL engines)
docbook-dtd-3.1/
(the docbook DTD)
docbook-stylesheets-1.52/
(Norman Walsh's modular stylesheets for
DocBook)
docbook-utils-0.2/
(conversion scripts backends and helpers)
kde-0.1/
gnome-0.1/
ldp-0.1/
(customization stylesheets for the various
projects)
non-docbook other SGML stuff
etc...
(version numbers examples are arbitrary in this list)
R002 - Catalog file names
-------------------------
/etc/sgml/
catalog (the centralized catalog)
/usr/share/sgml/iso-entities-8879-1986/
iso-entities.cat
/usr/share/sgml/jade-1.2.1/
/usr/share/sgml/openjade-1.0/
dsssl.cat
/usr/share/sgml/docbook-dtd-3.1/
docbook.cat
/usr/share/sgml/docbook-stylesheets-1.52/
nwalsh-modular.cat
R003 - Packages
---------------
iso-entities
(and not "sgml-common")
jade
openjade
(parsers and DSSSL engines)
jadetex
(macros for TeX)
psgml
(macros for Emacs)
docbook-dtd
(and not "docbook")
docbook-stylesheets
(and not "stylesheets" nor "nwalsh-modular")
docbook-utils
(shell scripts and other utilities)
R004 - Configuration files
--------------------------
/etc/sgml/
catalog
(the centralized catalog)
docbook.conf
(basic configuration for many
docbook-related tools)
xxx.conf
(configuration files for other
sgml-related programs)
"catalog" will follow the "Open SGML Catalogs" syntax.
The other files have no defined syntax yet, but will
probably be
key-value pairs or XML.
Reply to: