Help wanted ...

["Raj, Ashok" <ashok.raj@intel.com>]

Hello docbook gurus...

Iam using genrd (version of robodoc that can generate sgml docbook style
output) for API documentation.

once the sgml file is produced, iam not able to use any tools sgml2html etc
to convert this to html source files.

To check if there is anything wrong and go from basics, i tried to take an
example in 

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

the output from the example is here shown below. The error output is here..
Can someone let me know what environment settings i should use. Iam having
Redhat 7.2 and all sgml related stuff is installed in /usr/share/sgml

Thanks in advance

ashokr
--- ERROR OUTPUT ------------
[root@sakthi test]# sgml2html api.sgml
Processing file api.sgml
/usr/bin/nsgmls:<OSFD>0:1:59:W: cannot generate system identifier for public
text "-//Davenport//DTD DocBook V3.0//EN"
/usr/bin/nsgmls:<OSFD>0:2:0:E: reference to entity "BOOK" for which no
system identifier could be generated
/usr/bin/nsgmls:<OSFD>0:1:0: entity was defined here
/usr/bin/nsgmls:<OSFD>0:2:0:E: DTD did not contain element declaration for
document type name
/usr/bin/nsgmls:<OSFD>0:3:5:E: element "BOOK" undefined
/usr/bin/nsgmls:<OSFD>0:4:11:E: element "BOOKINFO" undefined
/usr/bin/nsgmls:<OSFD>0:5:9:E: element "DATE" undefined
/usr/bin/nsgmls:<OSFD>0:6:10:E: element "TITLE" undefined
/usr/bin/nsgmls:<OSFD>0:7:13:E: element "SUBTITLE" undefined
/usr/bin/nsgmls:<OSFD>0:9:6:E: element "TOC" undefined
/usr/bin/nsgmls:<OSFD>0:12:10:E: element "CHAPTER" undefined
/usr/bin/nsgmls:<OSFD>0:13:10:E: element "TITLE" undefined
/usr/bin/nsgmls:<OSFD>0:14:9:E: element "PARA" undefined
/usr/bin/nsgmls:<OSFD>0:16:10:E: element "SECT1" undefined
/usr/bin/nsgmls:<OSFD>0:17:12:E: element "TITLE" undefined
/usr/bin/nsgmls:<OSFD>0:18:11:E: element "PARA" undefined
/usr/bin/nsgmls:<OSFD>0:22:11:E: element "APPENDIX" undefined
/usr/bin/nsgmls:<OSFD>0:23:10:E: element "TITLE" undefined
/usr/bin/nsgmls:<OSFD>0:24:9:E: element "PARA" undefined
/usr/bin/nsgmls:<OSFD>0:26:10:E: element "SECT1" undefined
/usr/bin/nsgmls:<OSFD>0:27:12:E: element "TITLE" undefined
/usr/bin/nsgmls:<OSFD>0:28:11:E: element "PARA" undefined
/usr/bin/nsgmls:<OSFD>0:29:17:E: element "EMPHASIS" undefined
/usr/bin/sgmlsasp: can't open `/usr/lib/sgml-tools/dist/book/html/mapping':
No such file or directory

--- SOURCE FILE ------------
[root@sakthi test]# cat api.sgml
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
]>
<book>
  <bookinfo>
    <date>1997-10-11</date>
    <title>My first booklet</title>
    <subtitle>it even has a subtitle</subtitle>
  </bookinfo>
  <toc></toc>
  <!-- We are done with the preliminaries, now we can start with
          the body of the document -->
  <chapter>
    <title>My first chapter</title>
    <para>Here's a paragraph of text because it is stylistically
      poor to start a section right after the chapter title.</para>
    <sect1>
      <title>A section in that first chapter</title>
      <para>All I need is a single paragraph of text to make the
        section valid.</para>
    </sect1>
  </chapter>
  <appendix>
    <title>Remaining details</title>
    <para>Although this booklet is quite complete, here I will
      mention some details I never got to.</para>
    <sect1>
      <title>Use of the word dude</title>
      <para>Here's an example of how to say
        <emphasis>dude</emphasis>: DUDE.</para>
    </sect1>
  </appendix>
</book>