[OpenJade-users] various questions ... is there a faq?

[Jeremy C. R. <re...@re...>]

I am attempting to generate tex from DragonFly handbook which uses docbook
and some FreeBSD documentation add-ons.

I am using the following which I don't all understand yet:

        openjade -V tex-backend \
        -ioutput.print -d share/sgml/default.dsl \
        -V "%show-all-trademark-symbols%" \
        -V %two-side% -ioutput.print.twoside \
        -ioutput.print.niceheaders      \
        -V minimal-section-labels       \
        -ioutput.print.justify  \
        -V openjade \
        -i chap.index \
        -c en/share/sgml/catalog \
        -c share/sgml/catalog \
        -c /usr/share/sgml/docbook/dsssl/modular/catalog \
        -c /usr/share/sgml/iso8879/catalog \
        -c /usr/share/xml/docbook/catalog \
        -c /usr/share/sgml/openjade/catalog \
        -t tex en/books/handbook/x11/chapter.sgml

(I also tried other sgml files and get similar errors.)

The following are some of the errors I am receiving. If you can teach me
how to track down these problems for myself, it would be appreciated.


1)

openjade:/usr/share/xml/docbook/catalog:118:11:E: end of entity in comment

I am not sure what 118 or 11 mean above. I look at those line numbers and
don't see the error.

I think "E" means error above.

2)

openjade:/usr/share/xml/docbook/catalog:5:17:E: cannot open
"/usr/share/xml/docbook/data" (No such file or directory)
openjade:/usr/share/xml/docbook/catalog:13:25:E: cannot open
"/usr/share/xml/docbook/data" (No such file or directory)
openjade:/usr/share/xml/docbook/catalog:14:48:E: cannot open
"/usr/share/xml/docbook/files." (No such file or directory)
openjade:/usr/share/xml/docbook/catalog:19:57:E: cannot open
"/usr/share/xml/docbook/data." (No such file or directory)
openjade:/usr/share/xml/docbook/catalog:115:20:E: cannot open
"/usr/share/xml/docbook/data" (No such file or directory)

Notice the period following files. and data. above. This is repeated a
lot. I can't find the reference to this files and data.

3)

openjade:en/books/handbook/x11/chapter.sgml:8:0:E: prolog can't be omitted
unless CONCUR NO and LINK EXPLICIT NO and either IMPLYDEF ELEMENT YES or
IMPLYDEF DOCTYPE YES

4)

openjade:en/books/handbook/x11/chapter.sgml:8:0:E: no document type
declaration; will parse without validation

5)

openjade:en/books/handbook/x11/chapter.sgml:8:0:E: no document type
declaration; will parse without validation
openjade:en/books/handbook/x11/chapter.sgml:14:11:W: cannot generate
system identifier for general entity "os"
openjade:en/books/handbook/x11/chapter.sgml:14:11:E: general entity "os"
not defined and no default entity
openjade:en/books/handbook/x11/chapter.sgml:14:13:E: reference to entity
"os" for which no system identifier could be generated
openjade:en/books/handbook/x11/chapter.sgml:14:10: entity was defined here

I have same problem repeated for several entities, like "xfree86",
"macos", "man.X.7", "unix", "microsoft.windows" and others.

These are all defined in the share/sgml/trademarks.ent,
share/sgml/man-refs.ent and other entity file and my share/sgml/catalog
has:

PUBLIC "-//DragonFlyBSD//ENTITIES DocBook Trademark Entities//EN"
        "trademarks.ent"


I can generate the DVI fine, but it is missing a lot of words -- because
entities are missing.

I know there is make files for generating these docs, but I am trying to
understand how it all works.

Please carbon-copy me on replies.

Thanks,

 Jeremy C. Reed

 	  	 	 BSD News, BSD tutorials, BSD links
	  	 	 http://www.bsdnewsletter.com/