[Gzz-commits] gzz/Documentation/misc/uml Makefile classes.mp ...

[Asko Soukka]

CVSROOT:        /cvsroot/gzz
Module name:    gzz
Changes by:     Asko Soukka <address@hidden>    02/12/03 11:00:14

Modified files:
        Documentation/misc/uml: Makefile classes.mp classes.uml 
                                newbie.rst 

Log message:
        uml

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Documentation/misc/uml/Makefile.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Documentation/misc/uml/classes.mp.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Documentation/misc/uml/classes.uml.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Documentation/misc/uml/newbie.rst.diff?tr1=1.1&tr2=1.2&r1=text&r2=text

Patches:
Index: gzz/Documentation/misc/uml/Makefile
diff -u gzz/Documentation/misc/uml/Makefile:1.1 
gzz/Documentation/misc/uml/Makefile:1.2
--- gzz/Documentation/misc/uml/Makefile:1.1     Tue Dec  3 06:08:35 2002
+++ gzz/Documentation/misc/uml/Makefile Tue Dec  3 11:00:14 2002
@@ -13,7 +13,9 @@
        MPINPUTS=../../../metacode python ../../../metacode/uml.py $*
 
 %.html: %.rst
-       python ../../../../depends/rst2html.py -stg --stylesheet 
'../../../doc/gzz.css' $*.rst >$*.html
+       python ../../../../depends/rst2html.py -stg --stylesheet 
'../../../doc/gzz.css' *.rst >$*.html
+
+#      make -C ../../../ runjython DBG="../depends/rst2html.py -stg 
--stylesheet 'doc/gzz.css' Documentation/misc/uml/$*.rst 
>Documentation/misc/uml/$*.html"
 
 
 
Index: gzz/Documentation/misc/uml/classes.mp
diff -u gzz/Documentation/misc/uml/classes.mp:1.1 
gzz/Documentation/misc/uml/classes.mp:1.2
--- gzz/Documentation/misc/uml/classes.mp:1.1   Tue Dec  3 06:08:35 2002
+++ gzz/Documentation/misc/uml/classes.mp       Tue Dec  3 11:00:14 2002
@@ -3,4 +3,10 @@
          vertically(50, derived_v, Derived, Implementation); 
 
        Component.c = (300, 17);
-         horizontally(50, component_h, Component);
\ No newline at end of file
+         horizontally(50, component_h, Component);
+ 
+       pad = 30;                           
+       First.nw = Interface.nw + (-pad,pad);
+       First.se = Component.se + (pad,-pad);
+
+       
\ No newline at end of file
Index: gzz/Documentation/misc/uml/classes.uml
diff -u gzz/Documentation/misc/uml/classes.uml:1.1 
gzz/Documentation/misc/uml/classes.uml:1.2
--- gzz/Documentation/misc/uml/classes.uml:1.1  Tue Dec  3 06:08:35 2002
+++ gzz/Documentation/misc/uml/classes.uml      Tue Dec  3 11:00:14 2002
@@ -1,5 +1,7 @@
        jlinkpackage Package.First
 
+       bigpackage First
+
        class Interface "interface"
          jlink
          methods
Index: gzz/Documentation/misc/uml/newbie.rst
diff -u gzz/Documentation/misc/uml/newbie.rst:1.1 
gzz/Documentation/misc/uml/newbie.rst:1.2
--- gzz/Documentation/misc/uml/newbie.rst:1.1   Tue Dec  3 06:08:35 2002
+++ gzz/Documentation/misc/uml/newbie.rst       Tue Dec  3 11:00:14 2002
@@ -3,7 +3,7 @@
 ==========================================================================
 
        :Author: Asko Soukka
-       :Date:  2002-12-03
+       :Date:  $Date: 2002/12/03 16:00:14 $
 
 Some basics to create diagrams with ``uml.py`` tool.
 
@@ -95,6 +95,8 @@
                                    # to link right (java)doc files into class
                                    # objects.
 
+       bigpackage First
+
        class Interface "interface" # Discriminates interface class from
                                    # other classes
 
@@ -136,13 +138,23 @@
 
 ::
 
-       Derived.c = (100, 100)
+       Derived.c = (100, 100)   # Places "Derived" object into absolute 
+                                # coordinates (100, 100). Coordinate (0,0)
+                                # is here the lower left corner.
+         # The following places other objects horizontally or vertically
+         # relatively to absolutely placed "Derived" object.
          horizontally(50, interface_h, Interface, Derived, Abstract);
          vertically(50, interface_v, Derived, Implementation); 
 
-       Component.c = (300, 17);
+       Component.c = (300, 0);  # Places "Component" object into absolute 
+                                # coordinates (300, 0).
          horizontally(50, component_h, Component);
 
+       pad = 30;                           
+       First.nw = Interface.nw + (-pad,pad);
+       First.se = Component.se + (pad,-pad);
+
+
 Output
 ------
 
@@ -155,19 +167,23 @@
 ``sequence.uml``
 ----------------
 
+Creating sequence diagrams is the easiest.
+
 ::
 
+       # At the first we define all the classes interacting
+       # in the diagram.       
        seqobject First
        seqobject Second
        seqobject Third
 
-       sequence example
-         call First "call(...)"
-           call Second "call (...)"
-             call Third "call (...)"
-               call Second "callbac(...)"
-                 call First "callback(...)"
-                  return
+       sequence example # starts sequence diagram called "example"
+         call First "call(...)"        # diagram starts with someone calling 
First
+           call Second "call (...)"    # then First calls Second
+             call Third "call (...)"   # Second calls Third etc...
+               call Second "callback(...)"     # call can be described within 
parenthesis
+                 call First "callback(...)"    # like "callback(...)" here
+                  return               # calls end with "return"
                 return
               return
             return
@@ -178,6 +194,7 @@
 
 ::
 
+         # All the class objects can be placed at once:
          horizontally(100, h, First, Second, Third);
 
 Output