This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: New to DocBook: XML or SGML, Clark or Open?
- To: Adam Di Carlo <adam at onshore dot com>
- Subject: Re: New to DocBook: XML or SGML, Clark or Open?
- From: "M. Wroth" <mark at astrid dot upland dot ca dot us>
- Date: Thu, 05 Apr 2001 21:03:13 -0700
- Cc: "Prikryl,Petr" <PRIKRYLP at skil dot cz>,DocBook mailing list <docbook at lists dot oasis-open dot org>
- References: <5.0.2.1.0.20010328194941.00a10ec0@astrid.upland.ca.us><5.0.2.1.0.20010328194941.00a10ec0@astrid.upland.ca.us>
It may be -- in fact probably is -- a function of the specific binary I'm
using (which is the Windows version of OpenJade 1.3 / OpenSP 1.3.4
downloaded from the DSSSL site). I haven't noticed any announcement
of a newer version -- but I haven't been looking very carefully,
either.
A short description of the problem would be that the error messages in
general bear no discernable (to me) relevance to the actual error, and
are different than those emitted by Jade. This appears to be true
for errors in the SGML document (as opposed to errors in the DSSSL), and
so may actually be a problem in OpenSP, rather than OpenJade
itself.
A relatively user friendly example is caused by omitting a (required)
end-tag. OpenJade returns:
- openjade -c catalog -t rtf -dsgmlweave.dsl sample.sgm
- C:\USR\DSSSL\OPENJA~1.3\BIN\OPENJADE.EXE:sample.sgm:60:9:E: invalid
content map
- C:\USR\DSSSL\OPENJA~1.3\BIN\OPENJADE.EXE:sample.sgm:5:2: content map
references non-existent port "SECTION"
While Jade returns
- jade -c catalog -t rtf -dsgmlweave.dsl sample.sgm
- C:\USR\DSSSL\JADE\JADE.EXE:sample.sgm:60:9:E: end tag for
"SECTION" omitted, but OMITTAG NO was specified
- C:\USR\DSSSL\JADE\JADE.EXE:sample.sgm:5:2: start tag was here
At 05:06 PM 4/5/01 -0400, Adam Di Carlo wrote:
"M. Wroth"
<mark@astrid.upland.ca.us> writes:
> OpenJADE is the open source continuation of JADE, started with
James'
> blessing when he became too involved in other projects to continue
to
> update JADE. There is additional functionality in OpenJade,
which may or
> may not be important to you (*I* haven't had any particular need for
it,
> processing DocBook and some homegrown scripts, but YMMMV). On
the other
> hand, I have found the error messages from OpenJADE to be less than
> informative...which makes a difference, especially when you're
trying to learn.
I'm surprised to hear that the quality of the error messages seem
to
be lower in OpenJade than in Jade. Do you have any more
information?
--
.....Adam Di
Carlo....adam@onshore.com.....<URL:http://www.onshored.com/>
Mark B. Wroth
<mark@astrid.upland.ca.us>