[M3devel] "types" directory confusion

[Olaf Wagner]

On Mon, 14 Jul 2014 14:32:01 -0500
"Rodney M. Bates" <rodney_bates at lcwb.coop> wrote:

> The documentation is wrong about the location of the type-describing interfaces
> for instantiating generics, and they are inconsistent and incomplete in their
> locations.
> 
> For example, the page cm3/doc/help/gen_html/libm3/src/types/Refany.i3.html claims
> to describe an interface located in cm3/m3-libs/libm3/src/types, but this file is
> actually located in cm3/m3-libs/m3core/src/types.  Of these kinds of interfaces,
> only RealType.i3 and LongrealType.i3 are in libm3.  Most/all of the rest are in
> m3core.  I don't see an ExtendedType.i3 at all.
> 
> (There are a bunch of interfaces concerning floating types, including Extended, but
> they contain different information.  None appear to be for instantiating e.g, Table.)
> 
> Do we want to consistify this?  I seem to remember that there once were copies
> of at least some of these in both m3core/src/types and libm3/src/types.
> 
> Also, does anybody know what the procedure is for regenerating the html
> documentation files?

With the latter I may be of help. Let's see...

In ~/work/cm3/scripts/make-doc-dist.sh there's the following snippet:

if [ "$1" = "-gen" ] ; then
  cd "${ROOT}/doc/help/gen_html" || exit 1
  rm -f html_gen/m3db 
  m3tohtml -v -root /usr/local/cm3/pkg `cd /usr/local/cm3/pkg && ls -d *`
fi

That should do it, I think.

Olaf
-- 
Olaf Wagner -- elego Software Solutions GmbH -- http://www.elegosoft.com
               Gustav-Meyer-Allee 25 / Gebäude 12, 13355 Berlin, Germany
phone: +49 30 23 45 86 96  mobile: +49 177 2345 869  fax: +49 30 23 45 86 95
Geschäftsführer: Michael Diers, Olaf Wagner | Sitz: Berlin
Handelregister: Amtsgericht Charlottenburg HRB 77719 | USt-IdNr: DE163214194