[Gzz-commits] manuscripts/UMLLink umllink.rst

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/gzz
Module name:    manuscripts
Changes by:     Tuomas J. Lukka <address@hidden>        03/01/21 04:18:05

Modified files:
        UMLLink        : umllink.rst 

Log message:
        Reorg

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/manuscripts/UMLLink/umllink.rst.diff?tr1=1.16&tr2=1.17&r1=text&r2=text

Patches:
Index: manuscripts/UMLLink/umllink.rst
diff -u manuscripts/UMLLink/umllink.rst:1.16 
manuscripts/UMLLink/umllink.rst:1.17
--- manuscripts/UMLLink/umllink.rst:1.16        Tue Jan 21 04:14:51 2003
+++ manuscripts/UMLLink/umllink.rst     Tue Jan 21 04:18:05 2003
@@ -2,26 +2,13 @@
 A free software toolchain for bidirectional linking between UML diagrams and 
Javadoc
 
====================================================================================
 
-:Last-Modified: $Date: 2003/01/21 09:14:51 $
+:Last-Modified: $Date: 2003/01/21 09:18:05 $
 
 Introduction
 ============
 
 UML, the blah, has recently become blah blah
 
-Javadoc, the hypertext documentation tool that comes with
-Java (trademark of Sun Microsystems, Javadoc is distributed only
-as part of Java, non-free), is ...
-Easy to check methods, hard to get overall picture.
-Because doc is generated from source, the class, method, field
-names are always up-to-date(!!)
-
-Architectural docs using UML: little detail, may be
-slightly outdated at any particular time. However,
-good overall picture. Even outdated but well simplified diagram
-is better than too detailed, automaticly up-to dated and reverse
-engineered diagram.
-
 Some statements from the UML book (Booch, Jacobson, Rumbaugh, p.6)
 "A model is a simplification of reality."
 "We build models so that we can better understand the system
@@ -84,6 +71,31 @@
 
 This page lists a lot of UML tools:
 http://plg.uwaterloo.ca/~migod/uml.html
+
+Setting of problem
+==================
+
+Javadoc, the hypertext documentation tool that comes with
+Java (trademark of Sun Microsystems, Javadoc is distributed only
+as part of Java, non-free), is ...
+
+    - Easy to check methods, hard to get overall picture.
+
+    - Because doc is generated from source, the class, method, field
+      names are always up-to-date(!!)
+
+Architectural docs using UML: 
+
+    - little detail, 
+
+    - may be slightly outdated at any particular time. 
+
+    - good overall picture. 
+
+    - Even outdated but well simplified diagram
+      is better than too detailed, automaticly up-to dated and reverse
+      engineered diagram.
+
 
 Design
 ======