Is there anywhere some documentation that enables someone to
understand SGML, DSSSL and so on from scratch? I have picked up
a fair bit by trial and error, but all the documentation
appears to assume knowledge. (For example, it says that you
must do so and so without saying how to do it.)
This is my immediate problem that I cannot find a way round.
I am trying to generate SGML docs for PostgreSQL:
$ make reference.html
(rm -rf *.htm)
jade -D sgml -d /usr/lib/dsssl/stylesheets/docbook/html/docbook.dsl -t sgml
reference.sgml
jade:/usr/lib/sgml/catalog:43:0:W: DTDDECL catalog entries are not supported
jade:/usr/lib/sgml/davenport/docbook.cat:30:0:W: DTDDECL catalog entries are
not supported
[ The docbook-stylesheets documentation says that this is to be expected:
"Note, however, that Jade does not understand the DTDDECL directive
in catalog files and will issue a warning if you use docbook.cat
unchanged."
However, it does not say how you should change docbook.cat. ]
jade:ref/select.sgml:230:87:E: general entity "lt" not defined and no
default entity
jade:ref/select.sgml:230:100:E: general entity "gt" not defined and no
default entity
$ env | grep SGML
SGML_CATALOG_FILES=/usr/lib/sgml/davenport/docbook.cat:/usr/lib/jade/catalog
$ find /usr/lib -name '*.cat' -o -name '*.catalog' | xargs grep general
/usr/lib/debiandoc-sgml/sgml.catalog:ENTITY %general-chars
entities/general
$ find `find /usr/lib/sgml -name '*entit*' -type d` -type f | xargs grep -E
'gt|lt'
/usr/lib/sgml/entities/general:<!entity gt sdata ">" >
/usr/lib/sgml/entities/general:<!entity lt sdata "<" >
/usr/lib/sgml/entities/HTMLspecial:<!ENTITY lt CDATA "<" --
less-than sign, U+003C ISOnum -->
/usr/lib/sgml/entities/HTMLspecial:<!ENTITY gt CDATA ">" --
greater-than sign, U+003E ISOnum -->
I seem to have definitions that point to lt and gt, so why does jade think
they're not defined?
jade:/usr/lib/sgml/davenport/docbook.cat:30:0:W: DTDDECL catalog entries are
not supported
jade:/usr/lib/sgml/davenport/docbook.cat:30:0:W: DTDDECL catalog entries are
not supported
jade:/usr/lib/sgml/catalog:43:0:W: DTDDECL catalog entries are not supported
jade:/usr/lib/sgml/davenport/docbook.cat:30:0:W: DTDDECL catalog entries are
not supported
jade:/usr/lib/sgml/davenport/docbook.cat:30:0:W: DTDDECL catalog entries are
not supported
make: *** [reference.html] Segmentation fault (core dumped)
Core was generated by `jade -D sgml -d /usr/lib/dsssl/stylesheets/docbook/html/
docbook.dsl -t sgml ref'.
Program terminated with signal 11, Segmentation fault.
find_solib: Can't read pathname for load map: Input/output error
(gdb) bt
#0 0x80eaec3 in _start ()
#1 0xbfffe850 in ?? ()
#2 0x80e29e5 in _start ()
#3 0x80e1b8d in _start ()
#4 0x80ea757 in _start ()
#5 0x80e9643 in _start ()
#6 0x80e9f06 in _start ()
#7 0x80e5f64 in _start ()
#8 0x80e4177 in _start ()
#9 0x809b271 in _start ()
#10 0x80e2a2e in _start ()
#11 0x80e1b8d in _start ()
#12 0x80e9f06 in _start ()
#13 0x80e2e6e in _start ()
#14 0x80e4177 in _start ()
#15 0x80e6b0b in _start ()
#16 0x80e6792 in _start ()
#17 0x80e1ff9 in _start ()
#18 0x80e9cb6 in _start ()
#19 0x80e5f64 in _start ()
#20 0x80e4177 in _start ()
#21 0x809b271 in _start ()
#22 0x80e2a2e in _start ()
#23 0x80e1b8d in _start ()
#24 0x80e9f06 in _start ()
#25 0x80e2e6e in _start ()
#26 0x80e4177 in _start ()
#27 0x80e6b0b in _start ()
#28 0x80e6792 in _start ()
#29 0x80e1ff9 in _start ()
#30 0x80e5f64 in _start ()
#31 0x80e4177 in _start ()
#32 0x809b271 in _start ()
#33 0x80e2a2e in _start ()
#34 0x80e1b8d in _start ()
#35 0x80a2bd7 in _start ()
#36 0x80a251d in _start ()
#37 0x8095fae in _start ()
#38 0x80a5bf8 in _start ()
#39 0x807cf92 in _start ()
#40 0x810a3fa in _start ()
#41 0x807c297 in _start ()
#42 0x401827e1 in ?? () from /usr/lib/libsp.so.1
#43 0x807be4d in _start ()
#44 0x401815b9 in ?? () from /usr/lib/libsp.so.1
#45 0x4017ff12 in ?? () from /usr/lib/libsp.so.1
#46 0x8051465 in _start ()
(gdb)
This is a bug, but perhaps it will go away if the other things are sorted out.
Versions:
docbook 3.0-3
docbook-stylesh 1.07-1
jade 1.1-5
sgml-data 0.11
sgml-tools 1.0.5-1
sgml-base 1.01
libc6 2.0.7pre1-4
sp 1.3-1.1-5
gawk 3.0.3-0.2
perl 5.004.04-5
libstdc++2.8 2.90.27-0.6
--
Oliver Elphick [EMAIL PROTECTED]
Isle of Wight http://www.lfix.co.uk/oliver
PGP key from public servers; key ID 32B8FAA1
========================================
Come to me, all you who labour and are heavily laden, and I will
give you rest. Take my yoke upon you, and learn from me; for I am
meek and lowly in heart, and you shall find rest for your souls.
For my yoke is easy and my burden is light. (Matthew 11: 28-30)
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
