Re: [ECOS] Opening SGML-manuals

[Iztok Zupet <iz at vsr dot si>]

On Thursday 20 June 2002 14:29, Gary Thomas wrote:
> On Thu, 2002-06-20 at 04:43, Iztok Zupet wrote:
> > On Thursday 20 June 2002 09:42, David Marqvar (DAM) wrote:
> > > Hello.
> > >
> > > I'm currently trying to get into the details of eCos.
> > > I've downloaded the latest CVS, including documentation in SGML.
> > >
> > > How do I open the SGML-files? I've tried to use sgml2html (linux) and
> > > "SoftQuad XMetaL 3.0" (windows).
> > > It seems that I need a Rules File, a DTD or a Schema... I'm missing
> > > something obviously..?
> > >
> > > Regards,
> > > David Marqvar
> >
> > Hi:
> >
> >    Since I haven't updatet my eCos witht thel last update (i'ts 3 weeks
> > old), my information may be out of date.
> >
> >  Seems that the only way one can try to build the docs is:
> >
> > Go to the ecos/doc/sgml directory and hack makemakefile shell script , eg
> > replace every occurence of "ecc" with "packages".
> >  -./makemakefile
> >  -make
> > Then You will notice that there are some unresolved SGML link errors.
> > Just remove the links from SGML sources, because there are some mising
> > sgml files in the repository tree.. The SGML documentation scheme is new
> > in the eCos 2.0. ( I haven't tried that).
>
> A much simpler way to do this is (on Linux):
>   % cd XXX/ecos        // wherever your top-level is installed
>   % ln -s packages ecc
>   % cd doc/sgml
>   % ./makemakefile
>   % make html
>
> This worked fine for me, no unresolved links, etc.

 After updating my ecoscvs the documentation builds with only two missing 
xrefs:

jade:../../ecc/kernel/current/doc/kernel.sgml:222:69:X: reference to 
non-existent ID "COUNTERS-CLOCKS-AND-ALARMS"
jade:../../ecc/kernel/current/doc/kernel.sgml:1703:22:X: reference to 
non-existent ID "COUNTERS-CLOCKS-AND-ALARMS"
jade:../../ecc/kernel/current/doc/kernel.sgml:1116:59:X: reference to 
non-existent ID "MEMORY-POOLS"
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.76/html/dblink.dsl:203:1:E: 
XRef LinkEnd to missing ID 'COUNTERS-CLOCKS-AND-ALARMS'
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.76/html/dblink.dsl:203:1:E: 
XRef LinkEnd to missing ID 'MEMORY-POOLS'
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.76/html/dblink.dsl:203:1:E: 
XRef LinkEnd to missing ID 'COUNTERS-CLOCKS-AND-ALARMS'
make: *** [ecos.html] Error 1

But nevertheless the html tree works and seems to be fully browsable.

 Intresting, I've been using eCos cvs reposytory ever since 1.2x version but 
never noticed such a heavy load on the cvs server. (load average 56). 
 I wander if this heavy cvs access is related to the latest talks about RedHat 
and eCos and eCos developers and if the cvs snapshot at chez-thomas.org is 
accessed that much, too. 

Regards
iz

-- 
Before posting, please read the FAQ: http://sources.redhat.com/fom/ecos
and search the list archive: http://sources.redhat.com/ml/ecos-discuss