[M3devel] Auto-generated html documentation and new tools

[Rodney M. Bates]

On 04/12/2013 01:30 AM, Olaf Wagner wrote:
> 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.

Done, in the head.

>
>> 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.

1) Does it ship from head or release branch?

2) Can I do it myself, in case this happens again?

>
> Olaf
>