[M3devel] Auto-generated html documentation and new tools

[Olaf Wagner]

On Thu, 11 Apr 2013 19:48:11 -0500
"Rodney M. Bates" <rodney_bates at lcwb.coop> wrote:

> After a small clarification to m3-defn-complete.tex, I reran the autogeneration that
> produces various alternate forms, e.g., .ps, .pdf. and single- and multi-page html.
> Many of these are checked-in to CVS, even though mechanically generated.
> 
> All the html files have many differences.  The current checked-in files were built
> by LaTex2HTML v2002-2.1 and generate HTML 3.2 Final.  My computer has LaTex2HTML v2008,
> which generates HTML 4.0 Transitional.  This information is visible within the html files.
> In addition, there are many instances of a few kinds of tag changes.  Anecdotal examination
> revealed no content changes.
> 
> Does anybody have any problems with checking these new versions in?

Just go ahead.

> Also, what is the relationship between the autogenerated html files in cm3/doc/reference/complete/html,
> the older html files in cm3/doc/reference, and what we see at the elegosoft website?

I think reference/complete is just the language reference, while the level above
contains additional information from Critical Mass about the system and libraries.

> If I check
> in the regenerated files into CVS, will they be seen on the website?

There is a script ship-cm3-www-doc which needs to be run; I can do that
for you.

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