[Gzz] Asko 2002-12-18 (umldoc)

[Asko Soukka]

11h workday
 - basic version of new umldoc working
   * UML and UML-refer directives
   * architecture htmls converted to rsts
   * some old UMLs embedded into rsts
 - name change for generated files
   * umldoc and pegboard generates only *.gen.foo,
     also .cvsignores and doc/uml 'make clean' fixed
 - css, diagram images and imagemaps should work now also
   on himalia (fixed generating relative paths), still some
   problem, but will discuss these with mudyc

Ellei kukaan vastusta, olen jo perjantain vapaalla, kun pitää saada
pidettyä taas vähitellen kertyneitä ylityötunteja pois. Ensi viikolla
ti-to on joululomia ja ma ja pe KL-päiviä. Tulen Jyväskylään sitten
viikonloppuna, mutta fiiliksestä riippuen pitäisin vielä uutta vuotta
edeltävät päivät lomaa (HL tai KL, Päivikin kyseli, milloin pidän lomaa,
ettei tule keneltäkään sanomista O:-). Anyway, after tomorrow I might
be back only next year :)

Currently several documents can refer to same diagram with UML-refer, but
absolute html-links in .uml (links for other documentation/rsts) may not
work yet. FIX-TODO: how to jlink rsts.

My current umldoc approach has a problem with testing for unique diagram
names. Because diagram names are only seen from filenames in doc/uml,
testing uniqueness is only possible after make clean :/

Little about executing order in 'make doc':

doc: pegs javadoc documl docxx

pegs:
        $(JYTHON) metacode/pegboard.py

        Pegs should be always before documl, because pegboard.py
        don't generate any png-files, but it saves .gen.uml and .gen.mp
        files from UML-directives into doc/uml and writes <!-- UML:foo -->
        tags into pegboard HTML-files.

documl:
        $(JYTHON) metacode/umldoc.py doc/
        $(JYTHON) metacode/umlpegboard.py

        Umldoc.py converts at first rst-files in doc/ (is not
        recursive, because it would have problems :). It handles
        UML-directives like pegboard.py.

        Notice that here we have .mp and .uml files for all
        diagrams in pegboard and doc/ (umldoc.py can of course
        have more parameters, files or directories).

        After all rst-files are generated, umldoc.py goes through all
        generated html-files for <!-- UML:foo --> tags, creates and
        embeds all needed diagrams.

        umlpegboard.py does the same for all generated pegboard.html

-- 
Asko Soukka     | Taitoniekantie 9 A 603 | address@hidden
+358-40-8235947 | FIN-40740 JYVÄSKYLÄ    | http://www.iki.fi/asko.soukka/