Re: [ooc-compiler] Package creation

[Michael v. A. <Mic...@de...>]

"August" <fus...@sp...> writes:

> > Packages come into play if you want to distribute source archives to
> > other people, which in turn install the library or program into the
> > oo2c setup.  The "pkg" commands are usually triggered from a Makefile,
> > which in turn is provided with parameters from an autoconf-generated
> > configure script.
> 
> Ok. But the documentation extraction facility, `--build-pkg-doc', may be
> useful even if I'm not going to distribute source archives to other people.
> Can I create html documentation from sources without a  pkginfo.xml file?

For this purpose, a very small pkginfo.xml file will do:

<?xml version="1.0" encoding="ISO-8859-1"?>
<package name="PkgT">
  <version current="0" revision="0"/>
  
  <library name="LibT" main-module="T">
    <version current="0" revision="0" age="0"/>
  </library>
</package>

Assuming that module src/T.Mod imports all the modules (either
directly or indirectly) from the repository `-r .' you are interested
in, the command

  oo2c --build-pkg-doc PkgT

builds HTML files from the modules' public interfaces.  The files end
up in `oocdoc/html'.  You need xsltproc for the conversion from .xml
into .html files.

-- mva