Compare commits

...

232 Commits
R5_1 ... master

Author SHA1 Message Date
Diomidis Spinellis e83df07d5f
Merge pull request #65 from VillePekka/patch-1
Fix typo in README.md
2025-12-01 00:30:52 +02:00
VillePekka e79f81666b
Fix typo in README.md
Comparisson => Comparison
2025-11-30 23:19:24 +01:00
Diomidis Spinellis 893fa38908
Add D2 and comparison links 2023-10-27 13:33:55 +03:00
Diomidis Spinellis a4fa650471
Add related tools 2023-06-13 15:23:31 +03:00
Diomidis Spinellis 606976778e [maven-release-plugin] prepare for next development iteration 2023-05-23 14:59:36 +03:00
Diomidis Spinellis 8d7a3e4b5c [maven-release-plugin] prepare release R6_0_0 2023-05-23 14:59:31 +03:00
Diomidis Spinellis 2a471e5b8c
Merge pull request #64 from laurentschoelens/java9
jdk9 migration fixes
2023-04-08 20:58:59 +03:00
Laurent SCHOELENS 42c648b596 fix findClass for UMLNoteOptions / UMLOptions unqualified classes 2023-03-28 18:58:28 +02:00
Laurent SCHOELENS 5a058a3ace more readable else if statement 2023-03-28 18:58:20 +02:00
Laurent SCHOELENS 24e5822d7b extra fix for typeparameters in classes 2023-03-28 13:14:18 +02:00
Laurent SCHOELENS 7147eaa5ed fix simpleName v. qualifiedName for packageProccesing 2023-03-28 10:48:09 +02:00
Diomidis Spinellis 62acb7337b
Merge pull request #63 from laurentschoelens/java9
jdk9 : bugfixes and update readme
2023-03-27 17:53:37 +03:00
Laurent SCHOELENS de056154bd remove reporter diagnostic / fix class graph / make javase api 9 default / fix package-list and element-list api fetch 2023-03-27 14:52:04 +02:00
Laurent SCHOELENS 27d7821666 fix generation with primitive array 2023-03-27 12:31:35 +02:00
Laurent SCHOELENS 16c1937aad update readme 2023-03-27 12:24:31 +02:00
Laurent SCHOELENS 70929da1d0 make some fixes after run on bigger project 2023-03-27 12:18:46 +02:00
Diomidis Spinellis 6115e12837
Merge pull request #62 from laurentschoelens/java9
jdk9 port of UMLGraph
2023-03-24 17:57:20 +02:00
Laurent SCHOELENS d273b6a3ef fix junit dep / jdk11+ build 2023-03-24 16:11:29 +01:00
Laurent SCHOELENS cd8c3629a1 version running jdk9 2023-03-24 14:55:50 +01:00
Laurent SCHOELENS c8f805bdef reformat classes 2023-03-21 09:15:55 +01:00
Laurent SCHOELENS d80597d547 remove .classpath / .project files and add it to .gitignore 2023-03-21 08:15:34 +01:00
Diomidis Spinellis 09576db5ae Merge branch 'master' of github.com:dspinellis/UMLGraph 2019-03-25 22:17:17 +02:00
Diomidis Spinellis 75cc871a10 Correct version extraction when tags are missing
Issue: #55
2019-03-25 22:16:02 +02:00
Erich Schubert 0967a91289 Add -hideprivateinner option 2018-11-03 23:06:36 +01:00
Erich Schubert 0ba1798ac5 Point out jitpack.io option to get jars. 2018-11-03 21:45:04 +01:00
Erich Schubert bab25cbe35 invalid xml 2018-11-03 20:41:56 +01:00
Diomidis Spinellis 26c9f9d1e5
Merge pull request #54 from kno10/java8
Larger refactorings
2018-11-01 22:38:46 +02:00
Erich Schubert e93b793bd6 Get rid of these margins, then we don't need port="p" anymore. 2018-10-28 13:34:16 +01:00
Erich Schubert e27eeb4bc3 Simplify classinfo handling. 2018-10-27 23:23:47 +02:00
Erich Schubert 867dec5d9c fixup dot formatting 2018-10-27 23:23:47 +02:00
Erich Schubert 1d03695f8e Produce simpler dot files, reduce code duplication in edge generation. 2018-10-27 23:23:47 +02:00
Erich Schubert 8b39c4614f Improve node naming of inner classes. 2018-10-27 23:23:46 +02:00
Erich Schubert 7169d40228 Add -hideGenerics option. 2018-10-27 23:23:46 +02:00
Erich Schubert dc18c503e9 Improve class info handling. 2018-10-27 23:23:46 +02:00
Erich Schubert c7d8648352 Cleanup classToUrl 2018-10-27 23:18:32 +02:00
Erich Schubert aa15be7405 Determine context package only once. 2018-10-27 23:18:32 +02:00
Erich Schubert 1925d2f1c7 More StringUtil functionality. 2018-10-27 23:18:32 +02:00
Erich Schubert 08b8976076 Caching is not necessary with current JavaDoc (8, maybe even earlier) 2018-10-27 23:18:31 +02:00
Erich Schubert 1b29f70460 Avoid having to add/remove hyphens for all options. 2018-10-27 23:18:31 +02:00
Erich Schubert 2f27948475 Refactor font handling. 2018-10-27 23:18:31 +02:00
Erich Schubert 7d9f665d07 Refactor shape into enum pattern. 2018-10-27 23:18:31 +02:00
Erich Schubert 9ddf84129a Move visibility symbols into Visibility class. 2018-10-27 23:18:31 +02:00
Erich Schubert a4ab6f179a Have relation styles in a single place. 2018-10-27 23:18:31 +02:00
Erich Schubert fe2c0c3df1 Streamline code, smaller optimizations. 2018-10-27 23:18:31 +02:00
Erich Schubert f3e945c646 Remove warning in code obsoleted by commit #a29ba215 2018-10-27 23:08:20 +02:00
Erich Schubert 141c8a9353 Trivial simplification. 2018-10-27 21:30:17 +02:00
Erich Schubert fc1b199daf Better error reporting. 2018-10-27 21:30:17 +02:00
Erich Schubert 1e52483a86 Postpone test failues, to first generate the pngs 2018-10-27 21:30:17 +02:00
Erich Schubert f1be5aaee8 add 'clean' ant target 2018-10-27 21:30:17 +02:00
Erich Schubert f7df826f53 fix broken test, where undeclared package was lost previously, now preserved 2018-10-27 21:30:17 +02:00
Erich Schubert 644d148455 Exit code on errors. 2018-10-27 21:30:17 +02:00
Erich Schubert e51f53b25e Add -qualifyGenerics to optionLength. 2018-10-26 21:17:21 +02:00
Erich Schubert a29ba21580 Fix active class shape broken by commit 1b4c9763 + add test.
This was easy to break, because of a non-obvious logic.

Instead we now use the hack of just using a too large rowspan.
2018-10-26 01:32:31 +02:00
Erich Schubert bca0ceae17 Cleanup Options: move defaults to declaration rather than constructor. 2018-10-25 00:18:28 +02:00
Erich Schubert 71f74d3093 Move some basic string processing helpers into StringUtil. 2018-10-25 00:18:28 +02:00
Erich Schubert 1b4c97630d Old merge error / duplicated line? 2018-10-25 00:18:28 +02:00
Erich Schubert 477d5cc58a Fail on test failures. 2018-10-25 00:18:28 +02:00
Diomidis Spinellis e5bc6f1f8f Exit with an error on structural differences 2018-10-24 13:34:33 +03:00
Diomidis Spinellis e2595350fd Correct build status icon URL 2018-10-24 13:11:59 +03:00
Diomidis Spinellis 8806b89cd8 Do not set OS type
This avoids the following error java.lang.Runtime.exec:
java.lang.Error: generic is not a supported OS platform.
2018-10-24 13:11:59 +03:00
Diomidis Spinellis 70a7580e2c Install GraphViz as a CI dependency 2018-10-24 12:52:55 +03:00
Diomidis Spinellis cb77d617e9 Remove unneeded deps 2018-10-24 12:47:57 +03:00
Diomidis Spinellis 13bb2d54bc Remove confusing duplicate file 2018-10-24 12:47:11 +03:00
Diomidis Spinellis 27baa4a6be Add Travis CI configuration 2018-10-24 12:45:09 +03:00
Diomidis Spinellis 3eb6f8d034 Convert README into markdown 2018-10-24 12:45:09 +03:00
Diomidis Spinellis b5238b3bdc
Merge pull request #52 from kno10/patch-qualify-generics
add -!qualifyGenerics option that strips package names only in generics
2018-10-24 12:25:55 +03:00
Erich Schubert 0477f4b82d add -!qualifyGenerics option that strips package names only in generics
This is useful in combination with `-qualify`;
in particular with `-qualify -postfixpackage`

This version also supports *inner* classes, where the outer class has a
generic.

Test case: `p1.Class<A extends g1.G>.Inner<B super g2.G>`

Depending on `-qualify` and `-qualifyGenerics` this can become either:
```
p1.Class<A extends g1.G>.Inner<B super g2.G>
p1.Class<A extends G>.Inner<B super G>
Class<A extends g1.G>.Inner<B super g2.G>
Class<A extends G>.Inner<B super G>
```
on the long run, it may however be convenient to also allow hiding
generics completely, and/or show them just as diamonds. For example
`Class<>.Inner<>` as a shorthand. Other users will prefer to see the
constraint only, e.g., `Class<G>.Inner<G>`... it may need a list of
different named formatters.
2018-10-24 10:55:35 +02:00
Diomidis Spinellis 5de652cfeb
Merge pull request #53 from kno10/patch-includes
Add an @opt include option for the package view.
2018-10-23 23:33:01 +03:00
Erich Schubert 0e69b7a40f Add an @opt include option for the package view. 2018-10-21 03:38:40 +02:00
Diomidis Spinellis 132f389bcf
Merge pull request #50 from kno10/patch-4
Avoid repeated lowercasing
2018-08-14 14:32:09 +03:00
Diomidis Spinellis 7cc92e6fa2
Merge pull request #49 from kno10/patch-3
Strip generics from parent classes properly, fixes #20
2018-03-28 17:24:36 +03:00
Erich Schubert 40b24774eb Strip generics from parent classes properly
Fixes the handling of non-static inner classes `Parent<A>.Child` if the parent has generics, #20
2018-03-28 16:04:44 +02:00
Erich Schubert 021dc34d8e Avoid repeated lowercasing 2018-03-28 16:03:15 +02:00
Diomidis Spinellis 5cd82f641e
Merge pull request #48 from kno10/patch-1
Remove -verbose2 from docs
2018-03-28 15:47:38 +03:00
Erich Schubert ce3847a1e6
Remove -verbose2 from docs
According to the changelog, this option was removed.
2018-03-26 17:56:51 +02:00
Diomidis Spinellis 40b5a687cc Merge branch 'master' and update test data
To match the new -!autosize parameter.
2017-03-21 19:53:36 +02:00
Diomidis Spinellis c0b7962170 Update test data due to JavaDoc changes
From javadoc 1.8.0_20 to 1.8.0_121
2017-03-21 19:48:49 +02:00
Diomidis Spinellis d744535438 Merge pull request #45 from robross0606/master
Added "-autosize" parameter and fixed parameter matching bug with "!"
2017-03-21 19:47:26 +02:00
Robert Ross 160a7db3a7 Added "-autosize" parameter and fixed parameter matching bug with "!" 2017-03-21 13:20:15 -04:00
Diomidis Spinellis 5e854d5667 Merge pull request #43 from adrianN/patch-1
Update index.html
2017-03-15 17:49:19 +02:00
Adrian Neumann 962ad5af72 Update index.html
fix typo
2017-03-15 16:46:24 +01:00
Diomidis Spinellis e307530d8e Correct UMLGraph location 2016-10-24 20:38:25 +03:00
Diomidis Spinellis 6211164ca2 Merge pull request #34 from gousiosg/patch-1
Update documentation
2016-09-20 17:07:34 +03:00
Georgios Gousios 37dc189a29 s/SQO-OSS/Alitheia Core/
Also, add link to the annotated source code.
2016-09-20 15:05:14 +02:00
Diomidis Spinellis d0ede46da8 Correct URL 2016-09-16 23:47:03 +03:00
Diomidis Spinellis 30a611ec91 Update project web page location 2016-09-16 23:38:47 +03:00
Diomidis Spinellis a72c88fb70 Running testupdate requires bash 2016-09-16 23:34:03 +03:00
Diomidis Spinellis 09fab1724d Add reference to textual UML tool survey 2016-06-09 08:10:13 +03:00
Diomidis Spinellis db1a918e16 Remove repeated @override 2016-06-07 17:23:40 +03:00
Diomidis Spinellis ff13af7ea6 Merge pull request #32 from DevFactory/release/remove-dead-stores-fix-1
[squid:S1854] Dead stores should be removed
2016-06-07 17:22:20 +03:00
Diomidis Spinellis c4713960af Merge pull request #31 from DevFactory/release/replace-synchronized-classes-fix-1
[squid:S1149] Synchronized classes Vector, Hashtable, Stack and StringBuffer should not be used
2016-06-07 17:21:55 +03:00
Diomidis Spinellis a0ed8a2672 Merge pull request #30 from DevFactory/release/add-missing-override-annotation-fix-1
[squid:S1161] "@Override" annotation should be used on any method overriding (since Java 5) or implementing (since Java 6) another one
2016-06-07 17:21:36 +03:00
Diomidis Spinellis c4f32a5a74 Update test reference files 2016-06-07 17:20:48 +03:00
Diomidis Spinellis 86574a7824 Update Sun to Oracle URLs 2016-06-07 16:41:55 +03:00
Diomidis Spinellis 4425596017 Merge branch 'master' of github.com:dspinellis/UMLGraph 2016-06-07 16:10:47 +03:00
ayman abdelghany 1ec3be2f98 [squid:S1149] Synchronized classes Vector, Hashtable, Stack and StringBuffer should not be used 2016-06-07 14:12:05 +02:00
ayman abdelghany 105db10e1a [squid:S1854] Dead stores should be removed 2016-06-07 14:07:16 +02:00
ayman abdelghany 9f25167880 [squid:S1161] "@Override" annotation should be used on any method overriding (since Java 5) or implementing (since Java 6) another one 2016-06-07 14:04:11 +02:00
Diomidis Spinellis 23e7da7ca5 Merge pull request #15 from frankgrimes97/svg-uml-output
Output as SVG instead of PNG and minor cosmetic fixes.
2015-11-01 13:09:52 +02:00
Diomidis Spinellis 49a3f570bf Document package diagram generation 2015-10-05 15:14:30 +03:00
Diomidis Spinellis 93e69a4e24 Make umlgraph shell script work under Cygwin 2015-10-05 14:23:19 +03:00
Diomidis Spinellis ee82a7fd20 Update URLs for Javadoc and GraphViz 2014-10-29 09:23:04 +02:00
Diomidis Spinellis 17ab5f89f2 Update version 2014-10-29 00:19:04 +02:00
Diomidis Spinellis 9039a0011b [maven-release-plugin] prepare for next development iteration 2014-10-29 00:04:30 +02:00
Diomidis Spinellis 6700c90fe2 [maven-release-plugin] prepare release R5_7_2 2014-10-29 00:04:24 +02:00
Diomidis Spinellis 691cf7fe69 Add Version.java
Although it's auto-generated Maven wants it under SCM.
2014-10-29 00:03:19 +02:00
Diomidis Spinellis e2d2529ce6 [maven-release-plugin] prepare for next development iteration 2014-10-28 23:45:58 +02:00
Diomidis Spinellis 0a37b4e98f [maven-release-plugin] prepare release R5_7_1 2014-10-28 23:45:53 +02:00
Diomidis Spinellis 3c92579f87 Prepare snapshot for release 2014-10-28 23:45:25 +02:00
Diomidis Spinellis 43517f2a6d Merge branch 'master' of github.com:dspinellis/UMLGraph 2014-10-28 23:44:31 +02:00
Diomidis Spinellis ee39c4bca8 [maven-release-plugin] prepare release R5_7_1 2014-10-28 23:43:29 +02:00
Diomidis Spinellis 91157698e3 [maven-release-plugin] prepare release R5_7_1 2014-10-28 23:40:37 +02:00
Diomidis Spinellis d88df8470f Changes for deployment
See http://central.sonatype.org/pages/apache-maven.html
2014-10-28 23:38:59 +02:00
Diomidis Spinellis e5d0ce31d3 Add tags rule 2014-10-28 22:58:28 +02:00
Diomidis Spinellis 0a8e4a2481 Use OpenSSL for MD5 checksums 2014-10-28 21:54:52 +02:00
Diomidis Spinellis 0bf2c1e440 Use ActiveState Perl for doc building
Required for syntax coloring.
2014-10-28 21:53:01 +02:00
Diomidis Spinellis 76c7c6290c Update regression test reference files
Verified with:
for i in `cd dot-ref ; ls *.dot`; do ../tools/viscompare.sh $i; done

Some differences having to do with inference were found.  It is not
clear which version is correct.
2014-10-28 20:26:12 +02:00
Diomidis Spinellis 786d98cd71 Do not update files for trivial differences 2014-10-28 20:15:40 +02:00
Diomidis Spinellis abeb6c22e0 Update reference data test update for git 2014-10-28 20:07:01 +02:00
Diomidis Spinellis b23a483c1e Update diff for lowercase tag names 2014-10-28 20:01:04 +02:00
Diomidis Spinellis f687058ca3 Bring back comma that got lost in 52d95c3c 2014-10-28 19:54:57 +02:00
Diomidis Spinellis cc22b016ef Introduce required JavaDoc class path 2014-10-28 19:53:39 +02:00
Diomidis Spinellis ade4d6dfc6 Fix build/run of regression tests 2014-10-28 19:44:15 +02:00
Diomidis Spinellis d76d42066a Remove generics warning 2014-10-28 19:43:55 +02:00
Diomidis Spinellis 7fc14a491e Fix includeantruntime warning
Simple set its value to false.
See http://stackoverflow.com/questions/5103384/ant-warning-includeantruntime-was-not-set
2014-10-28 19:25:57 +02:00
Diomidis Spinellis da4d335f38 Remove obsolete variable 2014-10-28 19:07:44 +02:00
Diomidis Spinellis de854f562b Remove obsolete RCS tagging 2014-10-28 17:49:24 +02:00
Diomidis Spinellis fe9ac58af1 Disable importedClasses deprecation warning
In our case an attempt to get the imported classes is justified.
Although they are an implementation detail, we document the
implementation.
2014-10-28 17:23:47 +02:00
Diomidis Spinellis a8b1f1ff46 Remove auto-generated file 2014-10-28 17:07:14 +02:00
Diomidis Spinellis fa40aaf731 Get rid of Java generics warning
Casts are still needed, because Properties extends
Hashtable<Object, Object> instead of Hashtable<String, String>.
2014-10-28 17:04:59 +02:00
Diomidis Spinellis d46829bb01 Add methods required by Java 1.8 2014-10-28 16:38:14 +02:00
Diomidis Spinellis ac69e12d7a Remove obsolete RCS/CVS $Id$
Command used:
sed -i '/^# \$Id\$$/d;/^ \* \$Id\$$/d;/^<!-- \$Id\$ -->$/d;/\/\/ \$Id\$/d' $(fgrep -l \$Id $(git ls-files))
2014-10-28 16:29:43 +02:00
Diomidis Spinellis c1d994d650 Merge pull request #18 from tischda/master
check if source and dest are not already linked
2014-03-06 09:23:44 +02:00
Daniel TISCHER 52d95c3cc3 workaround empty label problem 2014-02-10 13:43:08 +01:00
Daniel TISCHER 8d77597da5 workaround for http://www.graphviz.org/mantisbt/view.php?id=2421 2014-02-09 11:50:05 +01:00
Daniel TISCHER a463b627fb check if source and dest are not already linked 2014-02-09 11:18:57 +01:00
Diomidis Spinellis 3bdff0e55b Fix float clearing for Chrome
Error pointed by: @gousiosg
2013-11-14 03:12:48 +02:00
Emanuel Pordes 44a146c03d Added width and height to svg object tag 2013-10-15 15:28:17 -04:00
Emanuel Pordes 41d93e14f6 Fix variable naming 2013-10-11 15:50:54 -04:00
Emanuel Pordes e58589e4c0 Output as SVG instead of PNG and minor cosmetic fixes. 2013-10-11 14:26:56 -04:00
Diomidis Spinellis 6202d34fa6 Merge pull request #14 from real-prometheus/master
Added support for options tags in ContextView and PackageView using the ...
2013-08-23 00:15:57 -07:00
real-prometheus 0435986b92 Added support for options tags in ContextView and PackageView using the UmlGraphDoc docklet for javadoc generation with integrated Uml. 2013-08-23 02:27:53 +02:00
Diomidis Spinellis bd246d364f Maven-related changes 2013-08-11 15:28:13 +03:00
Diomidis Spinellis e8b54cfde9 Add GitHub ribbon 2013-08-11 15:27:36 +03:00
Diomidis Spinellis 9240c4a012 [maven-release-plugin] prepare for next development iteration 2013-05-23 20:32:03 +03:00
Diomidis Spinellis 14fca5b59c [maven-release-plugin] prepare release R5_6_6 2013-05-23 20:31:53 +03:00
Diomidis Spinellis c67864269c [maven-release-plugin] prepare for next development iteration 2013-05-23 20:29:03 +03:00
Diomidis Spinellis bf757a720a [maven-release-plugin] prepare release R5_6_5 2013-05-23 20:28:49 +03:00
Diomidis Spinellis c713061dca Add dependency versions 2013-05-23 20:22:39 +03:00
Diomidis Spinellis 22f95917f4 Inherit Sonatype's pom 2013-05-23 20:08:50 +03:00
Diomidis Spinellis ef20511703 Merge branch 'master' of github.com:dspinellis/UMLGraph
Conflicts:
	src/main/java/org/umlgraph/doclet/Version.java
2013-05-23 19:53:17 +03:00
Diomidis Spinellis a54b9bfc40 For Maven to work Version.java must exist
New Version.java can be created with "ant version"
2013-05-23 19:44:52 +03:00
Diomidis Spinellis faedc3f0ff Correct handling of Version.java
It is generated automatically from the version and the git hash.
2013-05-23 19:05:57 +03:00
Diomidis Spinellis f6e263028a Merge branch 'master' of https://github.com/Stummi/UMLGraph into Stummi-master 2013-05-23 18:52:27 +03:00
Diomidis Spinellis af5f800017 Update regression test reference data
This matches JDK 1.7 javadoc
2013-05-23 18:45:27 +03:00
Diomidis Spinellis 7621aba4df Add state-machine reference 2013-05-23 18:45:16 +03:00
Diomidis Spinellis 37cd34d38f Merge branch 'master' of github.com:dspinellis/UMLGraph 2013-05-23 18:27:05 +03:00
Diomidis Spinellis f517c8704e Merge pull request #12 from CyrilDeverson/master
Fix a NullPointerException
2013-05-23 08:26:11 -07:00
CyrilDeverson 22d63f06b4 Update ClassGraph.java 2013-05-23 15:54:16 +02:00
Diomidis Spinellis 4fe531b9d0 Add argoumk-graphiviz reference 2012-12-18 17:33:41 +02:00
Michael Stummvoll 6bedd8a96b changed version to 5.6.5 to be higher than the last 5.6.4 2012-12-17 11:48:45 +01:00
Michael Stummvoll 93b9f60f0d changes in the pom.xml:
- added an configuration for the maven-compiler-plugin
- added project.build.sourceEncoding
- added the dependency for the tools.jar
2012-12-17 09:23:51 +01:00
Michael Stummvoll 22bee0462c Merge git://github.com/gousiosg/UMLGraph - base for a fixed maven build 2012-12-17 09:21:32 +01:00
Diomidis Spinellis cdcbba6b74 Merge pull request #8 from jcaden/master
Fix package insertion point for Java 7
2012-11-07 02:43:48 -08:00
Jose Antonio Santos Cadenas 6c630e04b6 Fix package insertion point Patter for java 7 2012-11-07 11:32:46 +01:00
Diomidis Spinellis b91039f798 Add pointer to Sketchlet 2012-09-02 17:44:22 +03:00
Georgios Gousios 0508d2e2e8 Add developerConnection link 2012-06-27 20:43:36 +02:00
Georgios Gousios 72a7eef460 Correctly formatted SCM URL 2012-06-27 19:35:13 +02:00
Georgios Gousios a000667eac Include main class in jar manifest file 2012-06-27 19:32:24 +02:00
Georgios Gousios 841067cda1 Generate UmlGraph-based Javadoc 2012-06-27 19:32:07 +02:00
Georgios Gousios ce821892f2 Don't ignore Version.java. Ignore Intellij project files. 2012-06-27 18:39:54 +02:00
Georgios Gousios f309d89222 Do not autogenerate Version class on every compile.
Instead, use a properties template file and Maven filtering
to set the correct version while building the output jar.
At runtime, load the properties file from the classpath and
statically initialize the version parameter.
2012-06-27 18:35:02 +02:00
Georgios Gousios 381301b1e3 Move test sources to Maven standard test dir 2012-06-27 18:31:33 +02:00
Georgios Gousios 897edbda76 Produce Javadoc and src jars 2012-06-27 17:55:57 +02:00
Georgios Gousios b8a974e20f Make UMLGraph maven compatible 2012-06-27 17:46:47 +02:00
Diomidis Spinellis c3fe00bb0c Merge pull request #5 from jean/master
Drive-by typo fix
2012-06-04 00:04:36 -07:00
Jean Jordaan 8d63c48637 Fix typo 2012-06-04 13:24:25 +07:00
Diomidis Spinellis 402d57a502 Add Maven artifact deployment
Issue: #1
2012-05-31 19:04:17 +03:00
Diomidis Spinellis 8c637cf8d8 Make version compatible with Maven's conventions 2012-05-30 17:29:45 +03:00
Diomidis Spinellis 49fb9100a2 Fix javadoc parameter documentation 2012-05-27 14:58:12 +03:00
Diomidis Spinellis 3a599f0be9 Adjust last-modified timestamp to git 2012-05-18 11:48:07 +03:00
Diomidis Spinellis c19d24b5db Add UML Distilled book image 2012-05-18 11:40:56 +03:00
Diomidis Spinellis 24a435a751 Create static-web rule 2012-05-18 11:15:44 +03:00
Diomidis Spinellis 0fd6bc912a Correct file's location 2012-05-18 11:15:29 +03:00
Diomidis Spinellis ea8deeca54 Git-ignore test results one directory level up 2012-05-18 11:07:12 +03:00
Diomidis Spinellis e92131fdca Improve file specifications 2012-05-18 11:01:42 +03:00
Diomidis Spinellis 5851e43722 Document release
* Add release data
* Add new version placeholder
* Document GitHub move
* Fix XML tag
2012-05-13 21:04:47 +03:00
Diomidis Spinellis d5d31d7bc6 Clarify file types 2012-05-13 20:57:09 +03:00
Diomidis Spinellis 76172b583f Add rule to make the threading tools 2012-05-12 18:59:32 +03:00
Diomidis Spinellis eecc4076d5 Create version file in build.xml
Issue: #3
2012-05-10 17:15:02 +03:00
Diomidis Spinellis a9de3300c0 Add contributors 2012-05-02 18:26:36 +03:00
Diomidis Spinellis caae7d949b Add missing media files 2012-04-25 14:23:52 +03:00
Diomidis Spinellis 13ae4f5aea Legacy file reorganization 2012-04-25 13:38:55 +03:00
Diomidis Spinellis 4bfd0200fa Mediawiki formatting fixes 2012-04-25 13:22:40 +03:00
Diomidis Spinellis 4af68f0d3a GitHub documentation 2012-04-25 12:58:19 +03:00
Diomidis Spinellis e87bfa6d8a Tools are now on the Gygwin path 2012-04-25 12:57:44 +03:00
Diomidis Spinellis 87a3fc7df3 Add files missing from repo 2012-04-25 12:56:18 +03:00
Diomidis Spinellis 6d701ce7a3 Freshmeat renamed to free(code) 2012-04-25 12:21:01 +03:00
Diomidis Spinellis f528f5c973 Move from CVS to Git 2012-04-25 12:03:34 +03:00
Diomidis Spinellis d54d8bf7da Added ability to make aggregate relationships navigable
The @has and @composed now also have corresponding @navhas
and @navcomposed relationships.

Contributed by: Alan Jeffrey.
2012-04-23 18:30:50 +00:00
Diomidis Spinellis 6fcc5df6ef Add missing @inferdepinpackage 2012-04-17 10:46:57 +00:00
Diomidis Spinellis 41b09d5e62 Upgrade links to JDK 7 2012-04-17 10:00:21 +00:00
Diomidis Spinellis 72ec8f2f41 Document changes 2012-04-17 09:23:08 +00:00
Diomidis Spinellis 3f8eb67d7b Update reference for new JDK version 2012-04-17 09:23:07 +00:00
Diomidis Spinellis eae2f33497 Compatibility with JDK 7
Submitted by: Stefano Martina
2012-04-17 08:39:26 +00:00
Diomidis Spinellis e8fcbbf72c Improvements after reviewing 2012-04-17 08:13:23 +00:00
Diomidis Spinellis 6e9eea3f90 Add italic font spec, expand diagram types 2012-04-17 07:09:28 +00:00
Diomidis Spinellis a4136c20d5 Add Java Power Tools link 2012-04-10 18:38:32 +00:00
Diomidis Spinellis 9cbc8dc9d2 Fix XML validation errors. 2011-01-08 18:38:06 +00:00
Diomidis Spinellis 17efed7a0c Release. 2011-01-08 18:24:44 +00:00
Diomidis Spinellis 88440e18d8 Fix to ensure that class images only appear once.
Contributed by:	Zhigang Xie.
2011-01-08 18:20:27 +00:00
Diomidis Spinellis 0c403eb9e2 Fresh reference data following change to make maps appearing in HTML
content clickable.
2011-01-08 18:19:55 +00:00
Diomidis Spinellis 2a4c1a936e Make the maps of diagrams appearing in HTML content clickable.
Contributed by:	Bernd Onasch
2011-01-07 09:52:45 +00:00
Diomidis Spinellis d7384d7c0f Make the generation of diamond shapes compatible with GraphViz 2.27.
(Contributed by Soraya Santana de la Fe.)
2010-11-27 14:07:46 +00:00
Diomidis Spinellis 1ebaea9eb0 Add answer provided by Georgios Gousios. 2010-11-01 06:55:23 +00:00
Diomidis Spinellis 233c924f18 Add contributors of 5.2 5.3 2010-05-25 17:43:05 +00:00
Diomidis Spinellis eca48d28d3 New version. 2010-05-24 07:45:27 +00:00
Diomidis Spinellis b70d336608 Do not show relations of hidden fields.
Contributed by: Cimballi
2010-05-24 07:29:29 +00:00
Diomidis Spinellis 708035d5f2 Support for javadoc's -linkoffline option.
Contributed by:	Nikita Kozlov
2010-05-24 07:18:03 +00:00
Diomidis Spinellis 630779e815 Update for new version. 2010-05-24 06:33:10 +00:00
Diomidis Spinellis e82a26fa64 Use logical font rather than font name for italics.
This fixes a problem with unresolved fonts under Windows and
Graphviz versions 2.26.3 and newer.
(Suggested by Przemyslaw Szufel.)
2010-05-24 06:07:28 +00:00
Diomidis Spinellis da28a7e4ff - New -dotexecutable option.
- UmlGraphDoc supports @opt options.

(Contributed by Laird Nelson.)
2010-05-24 05:46:57 +00:00
Diomidis Spinellis d69eda41a3 Add another line that can make files different without a problem. 2010-05-24 05:22:04 +00:00
Diomidis Spinellis be16a6b0ee Documentation generated with UMLGraph will process correctly
non-ASCII characters.
Fix contributed by: Gunho Kim
2009-11-12 08:06:09 +00:00
Diomidis Spinellis c3cba69d67 Add link to UML sequence diagram DSL.
Fix duplication in the contributor list.
2009-09-08 05:56:34 +00:00
Diomidis Spinellis 767f30bcf9 Add link to phpCallGraph. 2009-08-06 08:12:53 +00:00
Diomidis Spinellis 41d8a6b2e2 Sequence diagrams provide an option to specify whether objects are
underlined or not.
2009-02-10 10:12:05 +00:00
Diomidis Spinellis 75f8df20de Private fields. 2009-02-10 10:11:38 +00:00
Diomidis Spinellis e591d58a40 Pre-release. 2008-12-03 14:09:22 +00:00
Diomidis Spinellis 41b61d45e0 Corrected NullPointerException occurring when no global options were
available.
Fix supplied by Bernd Blacha.
2008-10-25 07:26:40 +00:00
Diomidis Spinellis 569d6849cc Fixed exception when an unknown class dependency is specified. 2008-10-20 09:55:42 +00:00
Diomidis Spinellis 328901d184 Corrected case of the tools.jar filename in the umlgraph shell script. 2008-09-12 15:26:53 +00:00
257 changed files with 9821 additions and 8655 deletions

View File

@ -1,7 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry kind="src" path="src"/>
<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
<classpathentry kind="var" path="JDK_LIB/tools.jar"/>
<classpathentry kind="output" path="build"/>
</classpath>

View File

@ -1,7 +0,0 @@
.settings
build
lib
javadoc
UMLGraph-snapshot
UMLGraph-snapshot.tar.gz
UMLGraph-snapshot.zip

18
.gitignore vendored Normal file
View File

@ -0,0 +1,18 @@
*.DS_Store
*.iml
*.ipr
*.iws
*.swp
.idea
.settings
.project
.classpath
_vimrc
build
CHECKSUM.MD5
javadoc
lib
TAGS
target
UMLGraph-R*
UMLGraph-snapshot*

View File

@ -1,17 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>umlgraph_cvs</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
<buildCommand>
<name>org.eclipse.jdt.core.javabuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>org.eclipse.jdt.core.javanature</nature>
</natures>
</projectDescription>

10
.travis.yml Normal file
View File

@ -0,0 +1,10 @@
language: java
addons:
apt:
packages:
- graphviz
install: ant
script: ant test

View File

@ -1,14 +1,9 @@
#
# $Id$
#
VERSION?=5.1
TAGVERSION=$(shell echo $(VERSION) | sed 's/\./_/g')
VERSION:=$(shell git describe --abbrev=6 HEAD | sed 's/R//;s/_/./;s/-/./;s/-.*$$/-SNAPSHOT/')
BALL_TAR_GZ=UMLGraph-$(VERSION).tar.gz
ZIPBALL=UMLGraph-$(VERSION).zip
DISTDIR=UMLGraph-$(VERSION)
WEBDIR=$(UH)/dds/pubs/web/home/sw/umlgraph-mirror
DOCLETSRCPATH=src/org/umlgraph/doclet
WEBDIR=$(UH)/dds/pubs/web/home/umlgraph
DOCLETSRCPATH=src/main/java/org/umlgraph/doclet
DOCLETSRC= \
$(DOCLETSRCPATH)/ClassGraph.java \
$(DOCLETSRCPATH)/ClassInfo.java \
@ -17,14 +12,12 @@ DOCLETSRC= \
$(DOCLETSRCPATH)/UmlGraph.java \
$(DOCLETSRCPATH)/Version.java
TESTSRC = \
src/org/umlgraph/test/DotDiff.java \
src/org/umlgraph/test/BasicTest.java
src/main/java/org/umlgraph/test/DotDiff.java \
src/main/java/org/umlgraph/test/BasicTest.java
PICFILE=sequence.pic
README=README.txt
LICENSE=LICENSE
OTHERSRC=index.html build.xml Makefile oldversion.html
# Files to tag
ALLTAG=$(DOCLETSRC) $(TESTSRC) $(PICFILE) $(README) $(LICENSE) $(OTHERSRC)
# Documentation location (release)
ifeq ($(VERSION),snapshot)
DOC=snapshot-doc
@ -41,9 +34,6 @@ all: $(JARFILE)
tarball: $(BALL_TAR_GZ)
src/org/umlgraph/doclet/Version.java: Makefile
ant -DVERSION="$(VERSION)" version
$(BALL_TAR_GZ): $(JARFILE) docs Makefile
-cmd /c rd /s/q $(DISTDIR)
mkdir $(DISTDIR)
@ -64,6 +54,7 @@ $(BALL_TAR_GZ): $(JARFILE) docs Makefile
zip -r $(ZIPBALL) $(DISTDIR)
docs:
(cd $(UH)/dds/pubs/Courses/tools && make)
(cd doc && make DOC=$(DOC))
ant javadocs
@ -74,19 +65,25 @@ test:
ant test
testupdate:
sh tools/testupdate.sh
bash tools/testupdate.sh
# Create only the static HTML pages
static-web:
(cd web && sh build.sh)
cp web/build/* $(WEBDIR)
sed "s/VERSION/$(VERSION)/g" web/build/download.html >$(WEBDIR)/download.html
web: $(BALL_TAR_GZ) CHECKSUM.MD5
cp $(BALL_TAR_GZ) $(ZIPBALL) CHECKSUM.MD5 $(WEBDIR)
(cd web && sh build.sh)
cp web/build/*.* $(WEBDIR)
cp web/build/* $(WEBDIR)
sed "s/VERSION/$(VERSION)/g" web/build/download.html >$(WEBDIR)/download.html
cp $(JARFILE) $(WEBDIR)/jars/UmlGraph-$(VERSION).jar
tar cf - javadoc | tar -C $(WEBDIR) -xvf -
CHECKSUM.MD5: $(BALL_TAR_GZ) $(JARFILE)
md5 UMLGraph-2.10.* UMLGraph-4.8.* UMLGraph-$(VERSION).* >CHECKSUM.MD5
(cd lib ; md5 UmlGraph.jar) >>CHECKSUM.MD5
openssl md5 legacy/UMLGraph-2.10.* legacy/UMLGraph-4.8.* UMLGraph-$(VERSION).* >CHECKSUM.MD5
(cd lib ; openssl md5 UmlGraph.jar) >>CHECKSUM.MD5
tag:
rcs -nV$(TAGVERSION): $(ALLTAG)
tags:
etags **/*.java

69
README.md Normal file
View File

@ -0,0 +1,69 @@
# UMLGraph - Declarative Drawing of UML Diagrams
*UMLGraph* allows the declarative specification and drawing of UML diagrams.
You can browse the system's documentation
through [this link](http://www.spinellis.gr/umlgraph/doc/index.html),
or print it through [this link](http://www.spinellis.gr/umlgraph/doc/indexw.html).
In order to run *UMLGraph*, you need to have [GraphViz](https://www.graphviz.org/)
installed in your system path. On most Linux distributions, this can be easily
installed using the regular package manager.
To compile the Java doclet from the source code run *ant* on the
*build.xml* file.
If you change the source code, you can run regression tests by
executing *ant test*.
Visit the project's [home page](http://www.spinellis.gr/umlgraph) for more information.
## Compatibility
If you build against Java 8, please use latest version of 5.X of the Doclet.
Since Java 9 doclet APIs where completely rewritten, the Doclet in version 6 supports only supports Java 9 and above.
## Development versions
In order to use development versions, you can use [JitPack](https://jitpack.io/#dspinellis/UMLGraph/master-SNAPSHOT).
Note that as this is compiled on demand, you may sometimes see a "Read timed out" when the package is recompiled,
and it should be fine a few seconds later. And because the master branch can change any time, you may want to use
a versioned snapshot instead (see the Jitpack documentation for details).
**Gradle**:
```
repositories { maven { url 'https://jitpack.io' } }
configurations { umlgraph }
dependencies { umlgraph 'com.github.dspinellis:UMLGraph:master-SNAPSHOT' }
javadoc {
doclet = 'org.umlgraph.doclet.UmlGraphDoc'
docletpath = configurations.umlgraph.files.asType(List)
tags("hidden:X", "opt:X", "has:X", "navhas:X", "assoc:X", "navassoc:X",
"composed:X", "navcomposed:X", "stereotype:X", "depend:X")
}
```
**Maven**:
```
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
...
<dependency>
<groupId>com.github.dspinellis</groupId>
<artifactId>UMLGraph</artifactId>
<version>master-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
```
**Jar download**: <https://jitpack.io/com/github/dspinellis/UMLGraph/master-SNAPSHOT/UMLGraph-master-SNAPSHOT.jar>
## See also
* [D2: Declarative Diagraming](https://d2lang.com/) (Emphasis on aesthetics and extensionability)
* [Mermaid diagramming and charting tool](https://mermaid.js.org/) (JavaScript-based; easier syntax, good Markdown integration; interactive diagrams)
* [PlantUML](https://plantuml.com/) (Java-based; supports IDEs and more diagram types)
* [Comparison of textual diagraming systems](https://text-to-diagram.com/)

View File

@ -1,22 +0,0 @@
UMLGraph - Declarative Drawing of UML Diagrams
UMLGraph allows the declarative specification and drawing of
UML class and sequence diagrams. You can browse the system's
documentation from the doc/index.html page, or print it from
doc/indexw.html.
To install the elements required to run UMLGraph, simply copy
the contents of the lib directory to a location consistent with
your installation's conventions (for example to /usr/local/lib).
To compile the Java doclet from the source code run ant on the
build.xml file.
If you change the source code, you can run regression tests by
executing "ant test".
Project home page: http://www.umlgraph.org
Diomidis Spinellis - November 2005, August 2008
$Id$

14
TODO
View File

@ -1,4 +1,14 @@
$Id$
http://stackoverflow.com/questions/8609546/umlgraph-not-automatic-integrated-in-javadoc
Support for all UML diagrams: state, use-case, etc.
State diagrams:
See state-example.dot
See also http://forrst.com/posts/State_Machine_Dont_abuse_the_if-1fE
Note that Hierarchically nested states cannot be shown in GraphViz,
because you can't set shape and labels in cluster, nor can they act
as edge targets.
Add in UmlGraphDoc support for showing package dependencies.
See http://java.dzone.com/articles/reverse-engineer-source-code-u#comment-6124
@ -20,8 +30,6 @@ public class A {
}
Requires special care for containers and arrays.
Support for all UML diagrams: state, use-case, etc.
command-line (and global) options for setting all graph attributes
Class options for setting edge attributes fillcolor fontcolor etc per edge

230
build.xml
View File

@ -1,20 +1,77 @@
<project name="umlgraph" default="compile" basedir=".">
<project name="umlgraph" default="compile" basedir="."
xmlns:artifact="antlib:org.apache.maven.artifact.ant" >
<description>
The specification for the Java-based umlgraph build processes.
$Id$
</description>
<!-- set global properties for this build -->
<property name="src" location="src"/>
<property name="src" location="src/main/java"/>
<property name="testsrc" location="src/test"/>
<property name="build" location="build"/>
<property name="javadoc" location="javadoc"/>
<property name="lib" location="lib"/>
<property name="testsrc" location="test/src"/>
<property name="testout" location="${basedir}/testdata/dot-out"/>
<property name="testref" location="${basedir}/testdata/dot-ref"/>
<property name="dist" location="dist" />
<!-- obtain version from git; see http://techblog.41concepts.com/2009/05/08/generating-ant-build-numbers-using-subversion/ -->
<macrodef name="gitversion" description="Get git version.">
<attribute name="outputproperty"/>
<sequential>
<echo message="git rev-parse --short=6 => '@{outputproperty}'"/>
<exec executable="git"
failonerror="true"
outputproperty="@{outputproperty}">
<arg value="rev-parse"/>
<arg value="--short=6"/>
<arg value="HEAD"/>
<redirector>
<outputfilterchain>
<tokenfilter>
<replaceregex pattern="R" replace=""/>
<replaceregex pattern="_" replace="."/>
<replaceregex pattern="-" replace="."/>
<replaceregex pattern="(-.*)$" replace="-SNAPSHOT"/>
</tokenfilter>
</outputfilterchain>
</redirector>
</exec>
<echo message="gitversion returned '${@{outputproperty}}'"/>
</sequential>
</macrodef>
<!-- define Maven coordinates; see https://docs.sonatype.org/display/Repository/Sonatype+OSS+Maven+Repository+Usage+Guide#SonatypeOSSMavenRepositoryUsageGuide-7c.DeploySnapshotsandStageReleaseswithAnt -->
<property name="groupId" value="org.umlgraph" />
<property name="artifactId" value="UmlGraph" />
<!-- <property name="version" value="1.0-SNAPSHOT" /> -->
<gitversion outputproperty="version"/>
<!-- define artifacts' name, which follows the convention of Maven -->
<property name="maven-jar" value="${dist}/lib/${artifactId}-${version}.jar" />
<property name="maven-javadoc-jar" value="${dist}/lib/${artifactId}-${version}-javadoc.jar" />
<property name="maven-sources-jar" value="${dist}/lib/${artifactId}-${version}-sources.jar" />
<!-- defined maven snapshots and staging repository id and url -->
<!-- passwords are stored in \Users\Diomidis Spinellis\.m2\settings.xml -->
<property name="maven-snapshots-repository-id" value="sonatype-nexus-snapshots" />
<property name="maven-snapshots-repository-url" value="https://oss.sonatype.org/content/repositories/snapshots/" />
<property name="maven-staging-repository-id" value="sonatype-nexus-staging" />
<property name="maven-staging-repository-url" value="https://oss.sonatype.org/service/local/staging/deploy/maven2/" />
<!-- import environment variables -->
<property environment="env"/>
<target name="clean">
<delete dir="${build}"/>
<delete dir="${lib}"/>
<delete dir="testdata/dot-out"/>
<delete dir="${javadoc}"/>
<delete dir="${dist}/lib"/>
</target>
<target name="init">
<!-- Create the time stamp -->
<tstamp/>
@ -23,20 +80,31 @@
<mkdir dir="${lib}"/>
<mkdir dir="testdata/dot-out"/>
<mkdir dir="${javadoc}"/>
<mkdir dir="${dist}/lib"/>
</target>
<target name="version">
<exec executable="git"
outputproperty="VERSION">
<arg value="rev-parse"/>
<arg value="--short=6"/>
<arg value="HEAD"/>
</exec>
<echo>Version is ${VERSION}</echo>
<echo file="src/org/umlgraph/doclet/Version.java">/* Automatically generated file */
<echo file="src/main/java/org/umlgraph/doclet/Version.java">/* Automatically generated file */
package org.umlgraph.doclet;
class Version { public static String VERSION = "${VERSION}";}
</echo>
</target>
<target name="compile" depends="init"
<target name="compile" depends="init,version"
description="compile the source, build library " >
<javac srcdir="${src}" destdir="${build}" debug="true" deprecation="true" >
<javac srcdir="${src}" destdir="${build}" debug="true"
deprecation="true" includeantruntime="false" >
<compilerarg value="-Xlint"/>
<classpath>
<pathelement location="${env.JAVA_HOME}/lib/tools.jar"/>
</classpath>
</javac>
<jar basedir="${build}" destfile="${lib}/UmlGraph.jar" includes="org/umlgraph/doclet/*.class">
<manifest>
@ -46,38 +114,57 @@ class Version { public static String VERSION = "${VERSION}";}
</jar>
</target>
<target name="test" depends="compile"
description="run the regression tests" >
<java classname="org.umlgraph.test.BasicTest" fork="true">
<target name="testcompile" depends="init"
description="compile the test code " >
<javac srcdir="${testsrc}" destdir="${build}" debug="true"
deprecation="true" includeantruntime="false" >
<classpath>
<pathelement location="${env.JAVA_HOME}/lib/tools.jar"/>
<pathelement location="${build}"/>
<pathelement location="${lib}/UmlGraph.jar"/>
</classpath>
</java>
<java classname="org.umlgraph.test.UmlDocTest" fork="true">
<classpath>
<pathelement location="${env.JAVA_HOME}/lib/tools.jar"/>
<pathelement location="${build}"/>
<pathelement location="${lib}/UmlGraph.jar"/>
</classpath>
</java>
<compilerarg value="-Xlint"/>
</javac>
</target>
<target name="test" depends="compile,testcompile"
description="run the regression tests" >
<!-- postpone failures, so we get to see the pngs -->
<java classname="org.umlgraph.test.BasicTest" fork="true" resultproperty="BasicTest.exit">
<classpath>
<pathelement location="${env.JAVA_HOME}/lib/tools.jar"/>
<pathelement location="${build}"/>
<pathelement location="${lib}/UmlGraph.jar"/>
</classpath>
</java>
<java classname="org.umlgraph.test.UmlDocTest" fork="true" resultproperty="UmlDocTest.exit">
<classpath>
<pathelement location="${env.JAVA_HOME}/lib/tools.jar"/>
<pathelement location="${build}"/>
<pathelement location="${lib}/UmlGraph.jar"/>
</classpath>
</java>
<apply executable="dot" dest="${testout}" parallel="false">
<arg value="-Tpng"/>
<arg value="-o"/>
<targetfile/>
<srcfile/>
<fileset dir="${testout}" includes="*.dot"/>
<mapper type="glob" from="*.dot" to="*.png"/>
<fileset dir="${testout}" includes="*.dot"/>
<mapper type="glob" from="*.dot" to="*.png"/>
</apply>
<apply executable="dot" dest="${testref}" parallel="false">
<arg value="-Tpng"/>
<arg value="-o"/>
<targetfile/>
<srcfile/>
<fileset dir="${testref}" includes="*.dot"/>
<mapper type="glob" from="*.dot" to="*.png"/>
<fileset dir="${testref}" includes="*.dot"/>
<mapper type="glob" from="*.dot" to="*.png"/>
</apply>
<!-- postponed failure, so we get to see the pngs -->
<fail message="BasicTest failed">
<condition><not><equals arg1="0" arg2="${BasicTest.exit}"/></not></condition>
</fail>
<fail message="UmlDocTest failed">
<condition><not><equals arg1="0" arg2="${UmlDocTest.exit}"/></not></condition>
</fail>
</target>
<target name="javadocs" depends="compile">
@ -85,6 +172,7 @@ class Version { public static String VERSION = "${VERSION}";}
<doclet name="org.umlgraph.doclet.UmlGraphDoc" path="${lib}/UmlGraph.jar">
<param name="-inferrel"/>
<param name="-inferdep"/>
<param name="-autosize"/>
<param name="-collapsible"/>
<param name="-hide" value="java.*"/>
<param name="-collpackages" value="java.util.*"/>
@ -92,10 +180,100 @@ class Version { public static String VERSION = "${VERSION}";}
<param name="-postfixpackage"/>
<param name="-nodefontsize" value="9"/>
<param name="-nodefontpackagesize" value="7"/>
<param name="-link" value="http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/doclet/spec"/>
<param name="-link" value="http://java.sun.com/j2se/1.5/docs/api"/>
<param name="-link" value="http://docs.oracle.com/javase/7/docs/jdk/api/javadoc/doclet/"/>
<param name="-link" value="http://download.oracle.com/javase/7/docs/api/"/>
</doclet>
</javadoc>
</target>
<target name="pom" description="generate the pom.xml file with the correct version">
<copy file="pom.template.xml"
tofile="pom.xml"
filtering="yes" overwrite="yes">
<filterchain>
<filterreader classname="org.apache.tools.ant.filters.ExpandProperties"/>
</filterchain>
</copy>
</target>
<target name="dist" depends="compile" description="generate the distribution">
<!-- build the main artifact -->
<jar jarfile="${maven-jar}" basedir="${build}" />
<!-- build the javadoc artifact -->
<javadoc sourcepath="${src}" destdir="${dist}/javadoc" />
<jar jarfile="${maven-javadoc-jar}">
<fileset dir="${dist}/javadoc" />
</jar>
<!-- build the sources artifact -->
<jar jarfile="${maven-sources-jar}">
<fileset dir="${src}" />
</jar>
</target>
<target name="deploy" depends="dist,pom" description="deploy snapshot version to Maven snapshot repository">
<!-- for this to work install http://maven.apache.org/ant-tasks/download.html into ant/lib -->
<artifact:mvn>
<arg value="org.apache.maven.plugins:maven-deploy-plugin:2.6:deploy-file" />
<arg value="-Durl=${maven-snapshots-repository-url}" />
<arg value="-DrepositoryId=${maven-snapshots-repository-id}" />
<arg value="-DpomFile=pom.xml" />
<arg value="-Dfile=${maven-jar}" />
</artifact:mvn>
<artifact:mvn>
<arg value="org.apache.maven.plugins:maven-deploy-plugin:2.6:deploy-file" />
<arg value="-Durl=${maven-snapshots-repository-url}" />
<arg value="-DrepositoryId=${maven-snapshots-repository-id}" />
<arg value="-DpomFile=pom.xml" />
<arg value="-Dfile=${maven-sources-jar}" />
<arg value="-Dclassifier=sources" />
</artifact:mvn>
<!-- sign and deploy the javadoc artifact -->
<artifact:mvn>
<arg value="org.apache.maven.plugins:maven-deploy-plugin:2.6:deploy-file" />
<arg value="-Durl=${maven-snapshots-repository-url}" />
<arg value="-DrepositoryId=${maven-snapshots-repository-id}" />
<arg value="-DpomFile=pom.xml" />
<arg value="-Dfile=${maven-javadoc-jar}" />
<arg value="-Dclassifier=javadoc" />
</artifact:mvn>
</target>
<!-- before this, update project version (both build.xml and pom.xml) from SNAPSHOT to RELEASE -->
<target name="stage" depends="dist,pom" description="deploy release version to Maven staging repository">
<!-- sign and deploy the main artifact -->
<artifact:mvn>
<arg value="org.apache.maven.plugins:maven-gpg-plugin:1.3:sign-and-deploy-file" />
<arg value="-Durl=${maven-staging-repository-url}" />
<arg value="-DrepositoryId=${maven-staging-repository-id}" />
<arg value="-DpomFile=pom.xml" />
<arg value="-Dfile=${maven-jar}" />
<arg value="-Pgpg" />
</artifact:mvn>
<!-- sign and deploy the sources artifact -->
<artifact:mvn>
<arg value="org.apache.maven.plugins:maven-gpg-plugin:1.3:sign-and-deploy-file" />
<arg value="-Durl=${maven-staging-repository-url}" />
<arg value="-DrepositoryId=${maven-staging-repository-id}" />
<arg value="-DpomFile=pom.xml" />
<arg value="-Dfile=${maven-sources-jar}" />
<arg value="-Dclassifier=sources" />
<arg value="-Pgpg" />
</artifact:mvn>
<!-- sign and deploy the javadoc artifact -->
<artifact:mvn>
<arg value="org.apache.maven.plugins:maven-gpg-plugin:1.3:sign-and-deploy-file" />
<arg value="-Durl=${maven-staging-repository-url}" />
<arg value="-DrepositoryId=${maven-staging-repository-id}" />
<arg value="-DpomFile=pom.xml" />
<arg value="-Dfile=${maven-javadoc-jar}" />
<arg value="-Dclassifier=javadoc" />
<arg value="-Pgpg" />
</artifact:mvn>
</target>
</project>

View File

@ -1,28 +0,0 @@
bib.xml
GUI-DB.gif
advrel.gif
assoc.gif
car.gif
catalina.gif
cd-opt.err
class-eg.gif
classadd.gif
color.gif
dist-52.gif
dnsq.gif
faq.err
fmtcache
general.gif
schema.gif
seq-cd.gif
seq-eg.gif
seq-impr.gif
seq-ops.err
seq-simple.gif
uml-182.gif
uml-184.gif
uml-71.gif
uml-appa.gif
ver.err
vis.gif
*.dot

5
doc/.gitignore vendored Normal file
View File

@ -0,0 +1,5 @@
bib.xml
fmtcache
*.dot
*.gif
*.err

View File

@ -13,7 +13,6 @@
# WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
# MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
# $Id$
#
.PS

View File

@ -1,12 +1,10 @@
#
# $Id$
#
ROOT=/cygdrive/c
PIC2PLOT=$(ROOT)/app/plotutils/bin/pic2plot
NETPBM=$(ROOT)/app/netpbm/bin
GS=$(ROOT)/app/gs
DESTDIR=/dds/pubs/web/home/sw/umlgraph-mirror
PIC2PLOT=pic2plot
GS=gs
DESTDIR=/dds/pubs/web/home/umlgraph
NOTETOOLS=/dds/pubs/Courses/tools
GIF := $(shell sed -n 's/.*<img *src *= *"\([^.]*\.gif\)".*/\1/p' *.xml)
XML := $(wildcard *.xml)
@ -32,15 +30,15 @@ DOC?=snapshot-doc
.pic.gif:
perl -p -e 'BEGIN {binmode(STDOUT);} s/\r//' $< | \
$(PIC2PLOT) -Tps | \
$(GS)/gs -I$(GS) -I$(GS)/fonts -q -r360 -dNOPAUSE -sDEVICE=pnm -sOutputFile=- - -c quit | \
$(NETPBM)/pnmcrop | \
$(NETPBM)/pnmscale 0.25 | \
$(NETPBM)/ppmtogif >$@
$(GS) -q -r360 -dNOPAUSE -sDEVICE=pnm -sOutputFile=- - -c quit | \
pnmcrop | \
pnmscale 0.25 | \
ppmtogif >$@
all: sequence.pic $(GIF) $(XML)
sh $(ROOT)/$(NOTETOOLS)/coursebib.sh bib
echo "Drawing UML Diagrams with UMLGraph" | perl $(NOTETOOLS)/thread.pl -n -h html -r -p ../index.html index ${DESTDIR}/${DOC}
echo "Drawing UML Diagrams with UMLGraph" | /c/Perl/bin/perl $(NOTETOOLS)/thread.pl -n -h html -r -p ../index.html index ${DESTDIR}/${DOC}
sequence.pic: ../sequence.pic
perl -p -e 'BEGIN {binmode(STDOUT);} s/\r//' $< >$@

View File

@ -1,5 +1,4 @@
// Author: Vadim Nasardinov
// Version: $Id$
import java.util.List;
import java.util.Map;

View File

@ -1,6 +1,5 @@
// Author: Vadim Nasardinov
// Author: Andrea Aime
// Version: $Id$
import java.util.List;
import java.util.Map;
@ -64,4 +63,4 @@ class DetailedView {}
/**
* @view
*/
class Overview {}
class Overview {}

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<p>
UMLGraph was developed and is being maintained by
@ -17,31 +16,44 @@ UMLGraph would not be in its current state without their contributions.
<li>Nascif Abousalh-Neto</li>
<li>Roger Alexander</li>
<li>Panagiotis Astithas</li>
<li>Bernd Blacha</li>
<li>Yves Bossel</li>
<li>Maxim Butov</li>
<li>David P. Caldwell</li>
<li>Anthony Callegaro</li>
<li>Cimballi</li>
<li>Dirk Datzert</li>
<li>Christophe Deneux</li>
<li>Nick Efthymiou</li>
<li>Georgios Gousios</li>
<li>Antti Hakala</li>
<li>Art Hampton</li>
<li>Alan Jeffrey</li>
<li>&#216;yvind Jergan</li>
<li>Scott Johnson</li>
<li>Gunho Kim</li>
<li>Nikita Kozlov</li>
<li>Trustin Lee</li>
<li>Joshua Lim</li>
<li>Stefano Martina</li>
<li>Vadim Nasardinov</li>
<li>Laird Nelson</li>
<li>Bernd Onasch</li>
<li>S&#233;bastien Pierre</li>
<li>Olek Poplavskyy</li>
<li>Alessandro Riva</li>
<li>Arnaud Rogues</li>
<li>Arnaud Rogues</li>
<li>Soraya Santana de la Fe</li>
<li>Jonathan R. Santos</li>
<li>Jan Schl&#252;ter</li>
<li>Erich Schubert</li>
<li>Sebastian Setzer</li>
<li>J&#246;rn Guy S&#252;&#223;</li>
<li>Andreas Studer</li>
<li>Przemyslaw Szufel</li>
<li>Ivan F. Villanueva B.</li>
<li>Przemyslaw Wesolek</li>
<li>Franz Wilhelmstoetter</li>
<li>Zhigang Xie</li>
</ul>
</notes>

View File

@ -1,7 +1,6 @@
/*
* Advanced relationships
* UML User Guide p. 137
* $Id$
*/
/**

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
To run the UMLGraph doclet from <em>ant</em>, use a rule,
like the following.
@ -13,7 +12,7 @@ like the following.
<pathelement path="${src.java.dir}"/>
</path>
<javadoc sourcepathref="uml.source.path" packagenames="*" package="true">
<doclet name="org.umlgraph.doclet.UmlGraph" path="${basedir}/lib/UMLGraph.jar">
<doclet name="org.umlgraph.doclet.UmlGraph" path="${basedir}/lib/UmlGraph.jar">
<param name="-d" value="${uml.dir}"/>
</doclet>
</javadoc>

View File

@ -1,4 +1,3 @@
// $Id$
/**
* Associations with visibility

View File

@ -110,3 +110,14 @@
Note="Available online \url{http://java.dzone.com/articles/reverse-engineer-source-code-u}",
Author="Meera Subbarao"
}
@CONFERENCE{SG16,
author={Seifermann, S. and Groenda, H.},
title={Survey on textual notations for the Unified Modeling Language},
journal={MODELSWARD 2016 - Proceedings of the 4th International Conference on Model-Driven Engineering and Software Development},
year={2016},
pages={28--39},
note={cited By 0},
url={https://www.cooperate-project.de/images/publications/MODELSWARD2016.pdf},
document_type={Conference Paper},
}

View File

@ -1,4 +1,3 @@
// $Id$
class Tyre {}
class Engine {}

View File

@ -1,8 +1,13 @@
/*
* Interface and generalization relationships in Jakarta Catalina
* $Id$
*/
/**
* @opt nodefontname "Arial"
* @hidden
*/
class UMLOptions{}
class HttpResponseBase
extends ResponseBase
implements HttpResponse, HttpServletResponse {}

View File

@ -1,5 +1,4 @@
<?xml version="1.0" encoding="ISO-8859-7" ?>
<!-- $Id$ -->
<notes>
One specifies a class diagram using the Java syntax complemented by
<a href="http://java.sun.com/j2se/javadoc/"><em>javadoc</em></a>
@ -8,7 +7,7 @@ Running the UmlGraph doclet on the specification will generate
a
<a href="http://www.graphviz.org/">Graphviz</a>
diagram specification that can be automatically processed to
create Postscript, GIF, SVG, JPEG, fig, or Framemaker drawings.
create PNG, SVG, EMF, Postscript, GIF, JPEG, fig, or Framemaker drawings.
<p />
The following is an example of a specification and the resulting UML class
diagram:

View File

@ -1,10 +1,10 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The UMLGraph class diagrams allows you to model
<ul>
<li>classes (specified as Java classes)
</li>
<li>
active classes, components, nodes, use cases,
collaborations, and packages
(specified as Java classes with an <code>@opt shape</code> tag)
@ -21,18 +21,16 @@ collaborations, and packages
</li>
<li>generalization relationships (specified using the Java <code>extends</code> declaration or (for multiple inheritance) the <em>javadoc</em> <code>@extends</code> tag)
</li>
<li>association relationships (specified using the <em>javadoc</em> <code>@assoc</code> tag)
</li>
<li>navigatable (directed) association relationships (specified using the <em>javadoc</em> <code>@navassoc</code> tag)
</li>
<li>aggregation relationships (specified using the <em>javadoc</em> <code>@has</code> tag)
</li>
<li>composition relationships (specified using the <em>javadoc</em> <code>@composed</code> tag)
</li>
<li>association relationships (specified using the <em>javadoc</em> <code>@assoc</code> tag) </li>
<li>navigable (directed) association relationships (specified using the <em>javadoc</em> <code>@navassoc</code> tag) </li>
<li>aggregation relationships (specified using the <em>javadoc</em> <code>@has</code> tag) </li>
<li>navigable aggregation relationships (specified using the <em>javadoc</em> <code>@navhas</code> tag) </li>
<li>composition relationships (specified using the <em>javadoc</em> <code>@composed</code> tag) </li>
<li>navigable composition relationships (specified using the <em>javadoc</em> <code>@navcomposed</code> tag) </li>
<li>dependency relationships (specified using the <em>javadoc</em> <code>@depend</code> tag)
</li>
</ul>
All relationship tags appart from <code>@extends</code> take four arguments:
All relationship tags apart from <code>@extends</code> take four arguments:
<ol>
<li> The source adornments (role, multiplicity, and visibility)
</li>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
In UMLGraph you can easily add a note (comment) to an element,
using the <code>@note</code> tag.

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
UMLGraph's input follows the Java syntax and semantics.
However,
@ -16,20 +15,20 @@ Java code.
Note however that UMLGraph was not originally designed for this purpose;
the resulting graphs may be large and unwieldy.
<p />
There are various ways to invoke UmlGraph,
There are various ways to invoke UMLGraph,
each providing a different balance between convenience and flexibility.
<h2>Option 1: Using the Supplied Script</h2>
This is the simplest option.
If <code>umlgraph</code> (or <code>umlgraph.bat</code>) is correctly
installed,
you can run UmlGraph by simply specifying the basename of
you can run UMLGraph by simply specifying the basename of
the Java file containing the diagram specification and the file type of
the generated diagram (e.g. gif, ps, png, svg).
Example:
<fmtcode ext="sh">
umlgraph Test png
</fmtcode>
Any additional UmlGraph or <em>javadoc</em> arguments can be added at
Any additional UMLGraph or <em>javadoc</em> arguments can be added at
the end of the command line.
This command will read the specification file (e.g. Test.java) and
generate directly a diagram of the appropriate type
@ -41,7 +40,7 @@ You can accomplish this in two ways.
<ol>
<li>
Specify the location of <code>tools.jar</code> as a part of Java's classpath
and specify the full name of the UmlGraph doclet as an argument to Java.
and specify the full name of the UMLGraph doclet as an argument to Java.
This is an invocation example under Windows
<fmtcode ext="bat">
java -classpath "lib/UmlGraph.jar;c:\program files\java\jdk1.6.0_02\lib\Tools.jar"
@ -58,7 +57,7 @@ file in a directory that also contains the Java SDK <code>tools.jar</code> file.
You can accomplish this either by copying <code>UmlGraph.jar</code> to the SDK
<code>lib</code> directory where <code>tools.jar</code> resides,
or by copying the JDK <code>tools.jar</code> file into the directory
where you installed UmlGraph.
where you installed UMLGraph.
You then run
<fmtcode ext="sh">
java -jar /path/to/UmlGraph.jar yourfile1.java ...
@ -73,10 +72,18 @@ Example:
java -jar /usr/jvm/java-1.5.0/lib/UmlGraph.jar -private Simple.java
</fmtcode>
<p />
To generate a diagram of all classes in the package specify as arguments
to the Java invocation the name of the package and the directory where
it resides.
The following example generates a diagram of all UMLGraph classes.
<fmtcode ext="sh">
java -classpath ... org.umlgraph.doclet.UmlGraph -sourcepath src/main/java org.umlgraph.doclet
</fmtcode>
<p />
Specifying some packages before the list of source files will designate
those packages as <em>local</em>.
When you specify a package list,
the SVG output UmlGraph generates will contain
the SVG output UMLgraph generates will contain
local hyperlinks for the local classes
and hyperlinks to the Sun Java API documentation for all other classes.
<p />

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Since the options are really a part of the generated graph you
want in many cases to include them in the diagram specification.
@ -13,7 +12,7 @@ of a class named <code>UMLOptions</code>, as in the following example:
*/
class UMLOptions {}
</fmtcode>
<p>
<p />
Similarly, you can also globally specify options for all the note elements.
through a class named <code>UMLNoteOptions</code>, as in the following example:
<fmtcode ext="java">
@ -23,7 +22,7 @@ through a class named <code>UMLNoteOptions</code>, as in the following example:
*/
class UMLNoteOptions{}
</fmtcode>
<p>
<p />
You can also change the UMLGraph operation on a per-class basis by
using <code>@opt</code> attributes on individual classes.

View File

@ -1,10 +1,10 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
A number of options contol the operation of UMLGraph
A number of options control the operation of UMLGraph
class diagram generator.
These can be specified on the command line, and most can also
be specified through javadoc tags within the diagram, affecting all or some elements.
be specified through javadoc <code>@opt</code> tags within the diagram, affecting all or some elements.
Most have a negated version by prefixing an exclamation mark.
<p/>
<h2>What Gets Drawn</h2> <!-- {{{1 -->
<dl>
@ -28,8 +28,12 @@ be specified through javadoc tags within the diagram, affecting all or some elem
in this case it will hide everything (useful in the context of views
to selectively unhide some portions of the graph, see the view chapter for
further details). </dd>
<dt>-include</dt><dd>Match classes to include with a non-anchored match. This is weaker than
the <code>-hide</code> option, but can be used to include classes from foreign packages
in the package view (which would by default filter to only include package members).</dd>
<dt>-operations</dt><dd>Show class operations (Java methods) </dd>
<dt>-qualify</dt><dd>Produce fully-qualified class names. </dd>
<dt>-qualifyGenerics</dt><dd>Use fully-qualified class names in Java generics.</dd>
<dt>-types</dt><dd>Add type information to attributes and operations </dd>
<dt>-view</dt><dd>Specify the fully qualified name of a class that contains
a view definition. Only the class diagram specified by this view will be generated.
@ -40,6 +44,7 @@ be specified through javadoc tags within the diagram, affecting all or some elem
<h2>Visual Appearance</h2> <!-- {{{1 -->
<dl>
<dt>-bgcolor</dt><dd>Specify the graph's background color. </dd>
<dt>-autosize</dt><dd>Fits generated graph to the width of the page/window. Defaults to true. </dd>
<dt>-collapsible</dt><dd>Enhance the javadoc HTML files containing UML diagrams with Javascript that provides a link for showing the (initially collapsed) diagrams. </dd>
<dt>-edgecolor</dt><dd>Specify the color for drawing edges. </dd>
<dt>-edgefontcolor</dt><dd>Specify the font color to use for edge labels. </dd>
@ -78,9 +83,9 @@ be specified through javadoc tags within the diagram, affecting all or some elem
<p />
All colors can be either a symbolic name (e.g. blue),
a tripple specifying hue-saturation-brightness as values 0-1
a triple specifying hue-saturation-brightness as values 0-1
(e.g. ".13 0.9 1"),
or a tripple specifying red-green-blue values as hexadecimal
or a triple specifying red-green-blue values as hexadecimal
digits prefixed by a # (e.g. "#ff8020").
The symbolic color names are derived from the X Windows System;
you can find a complete list in the
@ -156,6 +161,19 @@ has to be manipulated by an automated tool
</dd>
<dt>-d</dt><dd>Specify the output directory (defaults to the current directory).
</dd>
<dt>-dotexecutable</dt><dd>Specify the path of the <em>dot</em> executable.
</dd>
<dt>-linkoffline</dt><dd>Specify
links to javadoc-generated documentation for external referenced classes.
The <code>-linkoffline</code> option takes two arguments:
the first for the string to be embedded in the <code>href</code>
links, the second telling it where to find the <code>package-list</code>.
Example:
<pre>
-linkoffline http://developer.android.com/reference file:/home/doc/android/
</pre>
See the <em>javadoc</em> documentation for more details.
</dd>
<dt>-output</dt><dd>Specify the output file (default <code>graph.dot</code>).
If the output directory is provided, -output can only specify a file name,
otherwise a full path is accepted as well.
@ -170,10 +188,6 @@ When using <em>dot</em> to generate SVG diagrams you should specify
<code>UTF-8</code> as the output encoding, to have guillemots correctly
appearing in the resulting SVG.
</dd>
<dt>-verbose2</dt><dd>Will print on the standard output details regarding
the progress of graph generation.
(Note that -verbose is a javadoc option with a different meaning).
</dd>
</dl>
<!-- Footer {{{1 -->
</notes>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
UmlGraphDoc is a standard doclet wrapper that combines
the standard doclet output (javadoc documentation) along with auto-generated

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>
@ -32,7 +31,7 @@ class SetTopController implements URLStreamHandler {
void connect() {}
}
/** @depend - <friend> - SetTopController */
/** @depend - &lt;friend&gt; - SetTopController */
class ChannelIterator {}
interface URLStreamHandler {

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<fmtcode ext="java">
/*

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>

14
doc/ceg-er.xml Normal file
View File

@ -0,0 +1,14 @@
<?xml version="1.0" ?>
<notes>
The following was generated by annotating the
<a href="https://github.com/istlab/Alitheia-Core/tree/master/alitheia/core/src/main/java/eu/sqooss/service/db">source code</a> of the
<a href="https://github.com/istlab/Alitheia-Core/">Alitheia Core</a> project.
Georgios Gousios, who created it, wrote:
<blockquote>
<p>
I've used UMLgraph to generate an E-R diagram out of the DAOs we use in Alitheia Core. I've just annotated a few classes with @assoc tags, removed the super class DAObject from all entities with sed, did some tweaking by hand in the .dot output, et voila, an E-R depicting almost 30 classes in less than 30 minutes!
</p>
</blockquote>
<p />
<img src="er-sqo-oss.png" alt="UML diagram showing an entity relationship diagram" />
</notes>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>
@ -13,6 +12,7 @@ import java.util.Arrays;
* @opt inferrel
* @opt collpackages java.util.*
* @opt inferdep
* @opt inferdepinpackage
* @opt hide java.*
* @hidden
*/
@ -20,8 +20,8 @@ class UMLOptions {}
class Person {
House[] houses;
List<Dog> dogs;
List&lt;Dog&gt; dogs;
public Room getFavouriteRoom(House house) {}
}
@ -29,7 +29,7 @@ class Person {
* @opt inferreltype composed
*/
class House {
Map<String, Room> nameRoomMap;
Map&lt;String, Room&gt; nameRoomMap;
}
class Room {}
@ -37,7 +37,6 @@ class Room {}
class Dog {
Person owner;
}
</fmtcode>
</td><td>
<img src="infer.png" alt="UML diagram with relationship inference" />

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Vadim Nasardinov noted that an advantage of UMLGraph over many
GUI-oriented UML drawing tools is the ability
@ -16,7 +15,6 @@ a Makefile illustrates a way to organize this process.
<h2>Java Description</h2>
<fmtcode ext="java">
// Author: Vadim Nasardinov
// Version: $Id$
import java.util.List;
import java.util.Map;
@ -63,8 +61,7 @@ class DataOperation extends Element {}
<fmtcode ext="mak">
# Author: Vadim Nasardinov (vadimn@redhat.com)
# Since: 2004-05-26
# Version: $Id$
# See: http://www.spinellis.gr/sw/umlgraph/doc/ceg-mv.html
# See: http://www.spinellis.gr/umlgraph/doc/ceg-mv.html
# Requires: graphviz
# Requires: javadoc
@ -96,18 +93,18 @@ clean:
build/%.dot : %.java
mkdir -p $(dir $@)
$(jd) $(jd_flags) $(detailed_flags) -output $@ $<
$(jd) $(jd_flags) $(detailed_flags) -output $@ $&lt;
build/%-small.dot : %.java
mkdir -p $(dir $@)
$(jd) $(jd_flags) -output $@ $<
$(jd) $(jd_flags) -output $@ $&lt;
%.png : %.dot
dot -Nheight=0.2 -Elabelfontcolor=DarkSlateBlue -Elabelfontsize=8 -Tpng -o $@ $<
dot -Nheight=0.2 -Elabelfontcolor=DarkSlateBlue -Elabelfontsize=8 -Tpng -o $@ $&lt;
build/%.png : %.fig
mkdir -p $(dir $@)
fig2dev -L png -S 4 $< $@
fig2dev -L png -S 4 $&lt; $@
dot: $(dot_files)
@ -115,7 +112,7 @@ png: $(png_files)
build/%.png : %.png
mkdir -p $(dir $@)
cp $< $@
cp $&lt; $@
# Example usage:
# make debug-java_files

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<fmtcode ext="java">
/**

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<table>
<tr><td>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The makefile-based multiple view example can be generated by using internal
view support by means of the following sources (note the use of UmlOptions
@ -9,7 +8,6 @@ diagrams at different detail level).
<fmtcode ext="java">
// Author: Vadim Nasardinov
// Author: Andrea Aime
// Version: $Id$
import java.util.List;
import java.util.Map;

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Views are especially interesting in big projects, since they allow to
generate package specific diagrams and overview diagrams in a quick and

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Views are special classes that allow the generation of a custom class
diagram based on a set of diagram global options and a set of option

View File

@ -1,4 +1,3 @@
// $Id$
/**
* @opt nodefillcolor ".13 .9 1"

View File

@ -1,13 +1,12 @@
/*
* Class stereotypes and tagged values
* UML User Guide p. 439
* $Id$
*/
/**
* @opt attributes
* @opt operations
* @opt types
/**
* @opt attributes
* @opt operations
* @opt types
* @hidden
*/
class UMLOptions {}
@ -15,8 +14,8 @@ class UMLOptions {}
/** @hidden */
class Action {}
/**
* @stereotype container
/**
* @stereotype container
* @tagvalue version 3.2
*/
class ActionQueue {

View File

@ -1,4 +1,3 @@
// $Id$
/**
* @opt edgecolor "yellow"
@ -11,12 +10,13 @@
class UMLOptions{}
/**
* @opt nodefontname "Helvetica-Bold"
* @opt nodefontname "Arial"
* @opt nodefontcolor "white"
* @composed - - - Red
* @composed - - - Green
* @composed - - - Blue
* @opt attributes
* @opt operations
* @opt visibility
* @opt types
*/

View File

@ -1,17 +1,19 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Here are other programs or efforts that build on UMLGraph's
code or ideas.
<ul>
<li> <a href="http://lightuml.sourceforge.net/">LightUML</a>
integrates UMLGraph into <a href="http://www.eclipse.org">Eclipse</a>.</li>
<li> <a href="http://maven-plugins.sourceforge.net/maven-dotuml-plugin/">Dotuml</a>
integrates UMLGraph into <a href="http://maven.apache.org/">Maven</a>.</li>
<li> The <a href="http://www.primordion.com/Xholon/index.html">Xholon</a>
framework for building loosely-organized systems
captures object interactions at runtime,
and creates UML 2.0 sequence diagrams using UMLGraph.</li>
<li> <a href="http://phpcallgraph.sourceforge.net/">phpCallGraph</a>
can output its analysis in UMLGraph format, allowing the
automatic production of UML sequence diagrams from PHP code.</li>
<li> <a href="http://lightuml.sourceforge.net/">LightUML</a>
integrates UMLGraph into <a href="http://www.eclipse.org">Eclipse</a>.</li>
<li> <a href="http://ruby-uml.rubyforge.org/">ruby-uml</a>
traces aspects of an application
using UMLGraph to generate sequence and class diagrams.</li>
@ -30,5 +32,14 @@ supports the scripting of UMLGraph.</li>
<li> W. Goesgens has <a href="http://wiki.ioslo.net/dokuwiki/graphviz#plugging_umlgraph_infront_of_graphviz">documented here</a> a way to use
UMLGraph diagrams in
<a href="http://wiki.splitbrain.org/wiki:dokuwiki">DokuWiki</a>.</li>
<li> Mykhaylo Sorochan has built on top of UMLGraph a
<a href="http://macroexpand.org/doku.php/articles:uml-sequence-diagram-dsl-txl:start">higher-level domain-specific language for specifying UML sequence diagrams</a>.</li>
<li>
<a href="http://sketchlet.sourceforge.net/">Sketchlet</a> is using UMLGraph as a widget plugin. You can find a video about the Sketchlet UMLGraph widget usage at <a href="http://www.youtube.com/watch?v=H6lrgSYyzE0">http://www.youtube.com/watch?v=H6lrgSYyzE0</a>.
</li>
<li>
<a href="http://argouml-graphviz.tigris.org/">argouml-graphviz</a>
is a plugin to let ArgoUML generate graphviz files.
</li>
</ul>
</notes>

View File

@ -1,6 +1,5 @@
# UML Distilled: Figure 5-2 p. 70
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following diagram, based on the diagram appearing on p. 70 of
UML Distilled, contains self calls, object activation,

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following diagram, illustrates the operating system calls of
a typical DNS query.
@ -17,7 +16,6 @@ drawing facility.
#
# DNS query collaboration diagram
#
# $Id$
#
.PS

View File

@ -4,7 +4,6 @@
#
# DNS query collaboration diagram
#
# $Id$
#
.PS

BIN
doc/er-sqo-oss.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<!--
@ -27,6 +26,7 @@ To update the table of contents execute the following vim command from a registe
<li> <a href="#license">Under what license is UMLGraph distributed?</a></li>
<li> <a href="#classnotfound">Why do I get an exception java.lang.NoClassDefFoundError: com/sun/tools/javadoc/Main?</a></li>
<li> <a href="#truncxml">How can I prevent clipped SVG images in sequence diagrams?</a></li>
<li> <a href="#private">How can I instruct UMLGraph to include private fields in its output?</a></li>
</ul>
<h2><a name="cmdline">What is the command line sequence to generate a UMLGraph class diagram?</a></h2>
@ -222,4 +222,15 @@ of your JDK distribution.)
This appears to be a limitation of <em>pic2plot</em>.
You can work around it, by increasing the width and height values appearing
in the SVG XML file that <em>pic2plot</em> generates.
<h2><a name="private">How can I instruct UMLGraph to include private fields in its output?</a></h2>
You need to pass the <code>-private</code> flag to <em>javadoc</em>.
Note that
when processing code that includes annotations
defined by libraries outside the core J2SE distribution,
it is a good idea to include the library jars to the classpath.
Otherwise, <em>javadoc</em> (and concequently UMLGraph)
will fail to process the input classes correctly.
This is <a href="http://forums.oracle.com/forums/thread.jspa?threadID=1521148">a known issue</a> with <em>javadoc</em>,
but only manifests in certain occasions when running UMLGraph,
for example when processing private class fields.
</notes>

View File

@ -1,7 +1,6 @@
/*
* Generalisation
* UML User Guide p. 141
* $Id$
*/
/* Basic categorisations */

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following sequence diagram demonstrates the use of the frame and comment elements.
<h2>Diagram</h2>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<index>
<ch><ti>Introduction</ti><fi>intro</fi></ch>
<ch><ti>Installation</ti><fi>install</fi></ch>
@ -16,13 +15,14 @@
<ch><ti>Class Diagram Example: Advanced Relationships</ti><fi>ceg-adv</fi></ch>
<ch><ti>Class Diagram Example: Relationships Inference</ti><fi>ceg-infer</fi></ch>
<ch><ti>Class Diagram Example: Schema</ti><fi>ceg-schema</fi></ch>
<ch><ti>Class Diagram Example: ER</ti><fi>ceg-er</fi></ch>
<ch><ti>Class Diagram Example: Element Visibility</ti><fi>ceg-ev</fi></ch>
<ch><ti>Class Diagram Example: Association Types</ti><fi>ceg-at</fi></ch>
<ch><ti>Class Diagram Example: Real Example (Catalina Classes)</ti><fi>ceg-cat</fi></ch>
<ch><ti>Class Diagram Example: Class Stereotypes and Tagged Values</ti><fi>ceg-ster</fi></ch>
<ch><ti>Class Diagram Example: Fonts, Colors, Global and Local Options</ti><fi>ceg-color</fi></ch>
<ch><ti>Class Diagram Example: Multiple Views Through Command-Line Options</ti><fi>ceg-mv</fi></ch>
<ch><ti>Class Diagram Example: Inner support for views</ti><fi>ceg-view-spec</fi></ch>
<ch><ti>Class Diagram Example: Built-in Support for Views</ti><fi>ceg-view-spec</fi></ch>
<ch><ti>Class Diagram Example: Views With Different Specification Details</ti><fi>ceg-view-details</fi></ch>
<ch><ti>Class Diagram Example: Views for Different Packages</ti><fi>ceg-view-packages</fi></ch>
<ch><ti>Running the Doclet from Ant</ti><fi>ant</fi></ch>

View File

@ -1,6 +1,5 @@
/*
* Relationship inference
* $Id$
*/
import java.util.List;
@ -12,6 +11,7 @@ import java.util.Arrays;
* @opt inferrel
* @opt collpackages java.util.*
* @opt inferdep
* @opt inferdepinpackage
* @opt hide java.*
* @hidden
*/

View File

@ -1,5 +1,4 @@
<?xml version="1.0" encoding="ISO-8859-7" ?>
<!-- $Id$ -->
<notes>
To install UmlGraph follow these steps.
<ol>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
UMLGraph allows the declarative specification and drawing of
UML class and sequence diagrams.
@ -34,8 +33,9 @@ Creating models in a declarative, textual notation offers a number of advantages
It is more difficult for designers to get away, as they often do now, with drawing for a model a nice picture of the implementation they have in mind.</li>
<li> The declarative representation is also highly malleable, the existing visual structure does not hinder drastic changes, nor is effort wasted on the tidy arrangement of graph nodes a psychological barrier against massive design refactoring.</li>
<li> Declarative models are also highly automatable: they can be easily generated from even higher-level descriptions by trivial scripts and tools operating on design process inputs such as database schemas, existing code, or structured requirements documents.</li>
<li> Text macro processors can be used for configuration management, while revision control and team integration activities can utilize the same proven tools and processes that are currently used for managing source code.
Thus with a tool like CVS or RCS one can keep track of design revisions, create and merge branches, and monitor model changes, while a system like CVS can allow work to be split into teams.</li>
<li> With a declarative specification under the programmer's control a macro processors can be used for configuration management, allowing the same model to be used for generating diverse diagrams.</li>
<li> Revision control and team integration activities can utilize the same proven tools and processes that are currently used for managing source code.
Thus with a tool like Subversion or Git one can keep track of design revisions, create and merge branches, monitor model changes, and split work among a team.</li>
<li> Finally, the declarative approach can readily utilize existing text processing tools for tasks that a drawing editor system may not provide.</li>
</ul>
Consider how your favorite model editor handles the following tasks and how you could handle them using a simple Perl script or a text-processing pipeline applied to the declarative model specification:

View File

@ -1,3 +1,10 @@
/**
* @opt nodefontname "Helvetica"
* @opt edgefontname "Helvetica"
* @hidden
*/
class UMLOptions{}
/**
* @opt shape node
* @note Located in the

View File

@ -1,7 +1,6 @@
/*
* Schema model
* UML User Guide p. 112
* $Id$
*/
/**

View File

@ -1,5 +1,4 @@
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Objects do not always appear at the top of a UML sequence diagram;
they are often constructed by other objects.

View File

@ -1,6 +1,5 @@
# UML User Guide: Appendix A,p. 436
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Let us try to improve the simple sequence diagram.
<fmtcode ext="pic">

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
One specifies a sequence diagram using <em>pic</em> macros to define
objects and method invocations.

View File

@ -1,5 +1,4 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- $Id$ -->
<notes>
The following calls can be used to define a sequence diagram.
<dl>

View File

@ -1,5 +1,4 @@
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
A sequence diagram is defined in three main phases:
<ol>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Sequence diagrams consist of objects, their lifelines
(also known as smimming lanes),

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The value of
<em>pic</em> variables can sometimes be modified by assignment
@ -24,5 +23,6 @@ a drawing.
<tr><td>dashwid</td><td>0.05</td><td>Interval for dashed lines</td></tr>
<tr><td>maxpswid</td><td>11</td><td>Maximum width of picture</td></tr>
<tr><td>maxpsht</td><td>11</td><td>Maximum height of picture</td></tr>
<tr><td>underline</td><td>1</td><td>Underline the name of objects</td></tr>
</table>
</notes>

View File

@ -14,7 +14,6 @@
# WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
# MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
# $Id$
#
@ -34,13 +33,14 @@ define comment_default_move {up 0.25 right 0.25};
comment_default_ht=0.5;
# Comment width
comment_default_wid=1;
# Underline object name
underline=1;
# Create a new object(name,label)
define object {
$1: box $2; move;
# Could also underline text with \mk\ul\ul\ul...\rt
{
if (underline) then {
line from $1.w + (.1, -.07) to $1.e + (-.1, -.07);
}
move to $1.e;

View File

@ -1,6 +1,5 @@
# UML User Guide: Figure 18-2
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following diagram, based on the one appearing on p. 247 of the
UML User Guide, illustrates the dynamic creation and destruction of

View File

@ -1,6 +1,5 @@
# UML User Guide: Figure 18-4
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following diagram, based on Figure 18-4 appearing on p. 252 of the
UML User Guide, illustrates constraints on an object's lifeline,
@ -31,7 +30,7 @@ async(); message(S,W,"liftReceiver"); sync();
active(S);
message(W,S,"setDialTone()");
async(); message(S,W,"*dialDigit(d)"); sync();
lconstraint(W,"{dialing.executionTime < 30s}");
lconstraint(W,"{dialing.executionTime &lt; 30s}");
active(W);
message(W,W,"routeCalls(s,n)");
inactive(W);

View File

@ -1,6 +1,5 @@
# UML User Guide Figure 7-1.
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following diagram, based on Figure 7-1 appearing on p. 102 of the
UML User Guide, illustrates an interaction diagram with an

View File

@ -1,6 +1,5 @@
# UML User Guide: Appendix A,p. 436
#
# $Id$
#
.PS

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
The following diagram, based on the one appearing on p. 436 of the
UML User Guide, contains the most important elements

View File

@ -1,9 +1,92 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
<dl>
<dt>Version 5.2 Under development </dt><dd>
<dt>Version 5.7 Under development </dt><dd>
<ul>
<li>The <code>@opt include</code> option can be used to include classes from
foreign packages in the package view (unless hidden with <code>@opt hide</code>).</li>
<li>You can now also use <code>@opt</code> in <code>package-info.java</code>.</li>
<li>Added <code>-qualifyGenerics</code> option to separately control the inclusion of
package names for the class (<code>-qualify</code>) and its generics. In particular
this works well with <code>-qualify -postfixpackage</code> (and <code>-!qualifyGenerics</code>).<br />
To get the old <code>-qualify</code> behavior, you need to add <code>-qualifyGenerics</code>,
the default is off, and it will not inherit from <code>-qualify</code>.</li>
<li>Better handling of complex names with generics and inner classes such as <code>pkg.Outer&lt;T&gt;.Inner</code>.</li>
<li>Use &lt;i&gt; tags for italic, because the old font naming approach does not work with SVG anymore.
Replace <code>-nodefontabstractname</code> and <code>-nodefontclassabstractname</code>
with a simple flag <code>-nodefontabstractitalic</code> instead.</li>
<li>Added <code>-hideprivateinner</code> to hide all private inner classes.</li>
</ul>
</dd>
<dt>Version 5.6 2012-05-31 </dt><dd>
<ul>
<li>Maven artifact deployment</li>
</ul>
</dd>
<dt>Version 5.5 2012-05-13 </dt><dd>
<ul>
<li>Added ability to make aggregate relationships (<code>@has</code> and
<code>@composed</code>) navigable through the new <code>@navhas</code>
and <code>@navcomposed</code> relationships.
(Contributed by Alan Jeffrey.)</li>
<li>Make UMLGraphDoc generation compatible with JDK 7
(Contributed by Stefano Martina.)</li>
<li>Moved project's source code repository hosting to
<a href="https://github.com/dspinellis/UMLGraph">GitHub</a>.</li>
<li>Various documentation improvements.</li>
</ul>
</dd>
<dt>Version 5.4 2011-01-08</dt><dd>
<ul>
<li>Make the generation of diamond shapes compatible with GraphViz 2.27.
(Contributed by Soraya Santana de la Fe.)</li>
<li>Make the diagram elements appearing in HTML content clickable.
(Contributed by Bernd Onasch.)</li>
<li>Fix to ensure that class images only appear once.
(Contributed by Zhigang Xie.)</li>
</ul>
</dd>
<dt>Version 5.3 2010-05-24</dt><dd>
<ul>
<li>Sequence diagrams provide an option to specify whether objects are
underlined or not.</li>
<li>Documentation generated with UMLGraph will process correctly
non-ASCII characters.
(Fix contributed by Gunho Kim.)</li>
<li>New <code>-dotexecutable</code> option allows the explicit specification of
<em>dot</em>'s location.
(Contributed by Laird Nelson.)</li>
<li><em>UmlGraphDoc</em> will obey the options specified through
<code>@opt</code> tags within Java files.
(Contributed by Laird Nelson.)</li>
<li>Use a logical font rather than a font file name for italics.
This fixes a problem with unresolved fonts under Windows and
modern versions of Graphviz.
(Suggested by Przemyslaw Szufel.)</li>
<li>Support for <em>javadoc</em>'s <code>-linkoffline</code> option.
(Contributed by Nikita Kozlov.)</li>
<li>Do not show relations of hidden fields.
(Fix contributed by Cimballi.)</li>
</ul>
</dd>
<dt>Version 5.2 2008-12-03</dt><dd>
<ul>
<li> Corrected case of the tools.jar filename in the umlgraph shell script.
(Reported by &#216;yvind Jergan).
</li>
<li> Fixed exception when an unknown class dependency is specified.
(Reported by Jan Schl&#252;ter).
</li>
<li> Corrected NullPointerException occurring when no global options were
available.
(Fix supplied by Bernd Blacha.)</li>
</ul>
</dd>
<dt>Version 5.1 2008-08-27 </dt><dd>

View File

@ -1,5 +1,4 @@
<?xml version="1.0" ?>
<!-- $Id$ -->
<notes>
Documenting a big project often requires multiple diagrams:
each to show a specific and limited portion of the system.

View File

@ -1,4 +1,3 @@
// $Id$
/**
* Attribute and operation visility

BIN
legacy/UMLGraph-4.8.tar.gz Normal file

Binary file not shown.

BIN
legacy/UMLGraph-4.8.zip Normal file

Binary file not shown.

38
pom.template.xml Normal file
View File

@ -0,0 +1,38 @@
<?xml version="1.0"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.umlgraph</groupId>
<artifactId>umlgraph</artifactId>
<packaging>jar</packaging>
<name>UMLGraph</name>
<version>${version}</version>
<description>Declarative Drawing of UML Diagrams</description>
<url>http://www.spinellis.gr/umlgraph</url>
<licenses>
<license>
<name>BSD License (original)</name>
<url>http://www.opensource.org/licenses/bsd-license.php</url>
<distribution>repo</distribution>
</license>
</licenses>
<scm>
<url>https://github.com/dspinellis/UMLGraph</url>
<connection>git://github.com/dspinellis/UMLGraph.git</connection>
</scm>
<developers>
<developer>
<id>dspinellis</id>
<name>Diomidis Spinellis</name>
<email>dds@aueb.gr</email>
</developer>
</developers>
<dependencies/>
</project>

156
pom.xml Normal file
View File

@ -0,0 +1,156 @@
<?xml version="1.0"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.umlgraph</groupId>
<artifactId>umlgraph</artifactId>
<packaging>jar</packaging>
<name>UMLGraph</name>
<version>6.0.1-SNAPSHOT</version>
<description>Declarative Drawing of UML Diagrams</description>
<url>http://www.spinellis.gr/umlgraph</url>
<licenses>
<license>
<name>BSD License (original)</name>
<url>http://www.opensource.org/licenses/bsd-license.php</url>
<distribution>repo</distribution>
</license>
</licenses>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<scm>
<url>https://github.com/dspinellis/UMLGraph/</url>
<connection>scm:git://github.com/dspinellis/UMLGraph.git</connection>
<developerConnection>scm:git:git@github.com:dspinellis/UMLGraph.git</developerConnection>
<tag>R5_7_1</tag>
</scm>
<developers>
<developer>
<id>dspinellis</id>
<name>Diomidis Spinellis</name>
<email>dds@aueb.gr</email>
</developer>
</developers>
<parent>
<groupId>org.sonatype.oss</groupId>
<artifactId>oss-parent</artifactId>
<version>9</version>
</parent>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
</resource>
</resources>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.10.1</version>
<configuration>
<source>9</source>
<target>9</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.3.0</version>
<configuration>
<archive>
<manifest>
<addClasspath>true</addClasspath>
<mainClass>org.umlgraph.doclet.UmlGraph</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-release-plugin</artifactId>
<version>3.0.0-M7</version>
<configuration>
<autoVersionSubmodules>true</autoVersionSubmodules>
<useReleaseProfile>false</useReleaseProfile>
<releaseProfiles>release</releaseProfiles>
<goals>deploy</goals>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>3.2.1</version>
<executions>
<execution>
<id>attach-sources</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.5.0</version>
<configuration>
<tags>
<tag>
<name>depend</name>
<placement>X</placement>
</tag>
<tag>
<name>hidden</name>
<placement>X</placement>
</tag>
<tag>
<name>opt</name>
<placement>X</placement>
</tag>
</tags>
<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
<docletPath>${project.build.directory}${file.separator}${project.build.finalName}.jar</docletPath>
<additionalOptions>
<option>-inferrel</option>
<option>-inferdep</option>
<option>-autosize</option>
<option>-collapsible</option>
<option>--hide="java.*"</option>
<option>--collpackages=</option>
<option>-qualify</option>
<option>-postfixpackage</option>
<option>-nodefontsize 9</option>
<option>-nodefontpackagesize 7</option>
<option>--link="https://docs.oracle.com/javase/9/docs/api/"</option>
</additionalOptions>
<detectJavaApiLink>false</detectJavaApiLink>
<useStandardDocletOptions>true</useStandardDocletOptions>
</configuration>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>

View File

@ -14,7 +14,6 @@
# WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
# MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
# $Id$
#
@ -34,13 +33,14 @@ define comment_default_move {up 0.25 right 0.25};
comment_default_ht=0.5;
# Comment width
comment_default_wid=1;
# Underline object name
underline=1;
# Create a new object(name,label)
define object {
$1: box $2; move;
# Could also underline text with \mk\ul\ul\ul...\rt
{
if (underline) then {
line from $1.w + (.1, -.07) to $1.e + (-.1, -.07);
}
move to $1.e;

View File

@ -0,0 +1,6 @@
module org.umlgraph.doclet {
exports org.umlgraph.doclet;
opens org.umlgraph.doclet;
requires transitive jdk.javadoc;
}

File diff suppressed because it is too large Load Diff

View File

@ -14,62 +14,60 @@
* WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
* MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*
* $Id$
*
*/
package org.umlgraph.doclet;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.lang.model.element.Name;
/**
* Class's dot-comaptible alias name (for fully qualified class names)
* and printed information
* Class's dot-compatible alias name (for fully qualified class names) and
* printed information
*
* @version $Revision$
* @author <a href="http://www.spinellis.gr">Diomidis Spinellis</a>
*/
class ClassInfo {
private static int classNumber;
/** Alias name for the class */
String name;
final String name;
/** True if the class class node has been printed */
boolean nodePrinted;
/** True if the class class node is hidden */
boolean hidden;
/**
* The list of classes that share a relation with this one. Contains
* all the classes linked with a bi-directional relation , and the ones
* referred by a directed relation
/**
* The list of classes that share a relation with this one. Contains all the
* classes linked with a bi-directional relation , and the ones referred by a
* directed relation
*/
Map<String, RelationPattern> relatedClasses = new HashMap<String, RelationPattern>();
Map<String, RelationPattern> relatedClasses = new HashMap<>();
ClassInfo(boolean p, boolean h) {
nodePrinted = p;
hidden = h;
name = "c" + (new Integer(classNumber)).toString();
classNumber++;
ClassInfo(boolean h) {
hidden = h;
name = "c" + classNumber;
classNumber++;
}
public void addRelation(String dest, RelationType rt, RelationDirection d) {
RelationPattern ri = relatedClasses.get(dest);
if(ri == null) {
ri = new RelationPattern(RelationDirection.NONE);
relatedClasses.put(dest, ri);
}
ri.addRelation(rt, d);
public void addRelation(Name dest, RelationType rt, RelationDirection d) {
RelationPattern ri = relatedClasses.get(dest.toString());
if (ri == null) {
ri = new RelationPattern(RelationDirection.NONE);
relatedClasses.put(dest.toString(), ri);
}
ri.addRelation(rt, d);
}
public RelationPattern getRelation(String dest) {
return relatedClasses.get(dest);
public RelationPattern getRelation(CharSequence dest) {
return relatedClasses.get(dest.toString());
}
/** Start numbering from zero. */
public static void reset() {
classNumber = 0;
classNumber = 0;
}
}

View File

@ -12,28 +12,27 @@
* WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
* MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*
* $Id$
*
*/
package org.umlgraph.doclet;
import com.sun.javadoc.ClassDoc;
import javax.lang.model.element.TypeElement;
/**
* A ClassMatcher is used to check if a class definition matches a
* specific condition. The nature of the condition is dependent on
* the kind of matcher
* A ClassMatcher is used to check if a class definition matches a specific
* condition. The nature of the condition is dependent on the kind of matcher
*
* @author wolf
*/
public interface ClassMatcher {
/**
* Returns the options for the specified class.
* Returns the options for the specified class.
*/
public boolean matches(ClassDoc cd);
public boolean matches(TypeElement cd);
/**
* Returns the options for the specified class.
* Returns the options for the specified class.
*/
public boolean matches(String name);
public boolean matches(CharSequence name);
}

View File

@ -0,0 +1,210 @@
/*
* Contibuted by Andrea Aime
* (C) Copyright 2005 Diomidis Spinellis
*
* Permission to use, copy, and distribute this software and its
* documentation for any purpose and without fee is hereby granted,
* provided that the above copyright notice appear in all copies and that
* both that copyright notice and this permission notice appear in
* supporting documentation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
* WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
* MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*
*
*/
package org.umlgraph.doclet;
import java.io.IOException;
import java.io.PrintWriter;
import java.io.Writer;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.regex.Pattern;
import jdk.javadoc.doclet.DocletEnvironment;
import javax.lang.model.element.Element;
import javax.lang.model.element.TypeElement;
/**
* Matches classes that are directly connected to one of the classes matched by
* the regual expression specified. The context center is computed by regex
* lookup. Depending on the specified Options, inferred relations and
* dependencies will be used as well.
* <p>
* This class needs to perform quite a bit of computations in order to gather
* the network of class releationships, so you are allowed to reuse it should
* you
*
* @author wolf
*
* @depend - - - DevNullWriter
*/
public class ContextMatcher implements ClassMatcher {
ClassGraphHack cg;
Pattern pattern;
List<TypeElement> matched;
Set<String> visited = new HashSet<>();
/** The options will be used to decide on inference */
Options opt;
DocletEnvironment root;
boolean keepParentHide;
/**
* Builds the context matcher
*
* @param root The root doc returned by JavaDoc
* @param pattern The pattern that will match the "center" of this
* context
* @param keepParentHide If true, parent option hide patterns will be preserved,
* so that classes hidden by the options won't be shown in
* the context
* @throws IOException
*/
public ContextMatcher(DocletEnvironment root, Pattern pattern, Options options, boolean keepParentHide) throws IOException {
this.pattern = pattern;
this.root = root;
this.keepParentHide = keepParentHide;
opt = (Options) options.clone();
opt.setOption(new String[] { "!hide" });
opt.setOption(new String[] { "!attributes" });
opt.setOption(new String[] { "!operations" });
this.cg = new ClassGraphHack(root, opt);
setContextCenter(pattern);
}
/**
* Can be used to setup a different pattern for this context matcher.
* <p>
* This can be used to speed up subsequent matching with the same global
* options, since the class network informations will be reused.
*
* @param pattern
*/
public void setContextCenter(Pattern pattern) {
// build up the classgraph printing the relations for all of the
// classes that make up the "center" of this context
this.pattern = pattern;
matched = new ArrayList<>();
for (Element cd : root.getIncludedElements()) {
if (cd instanceof TypeElement && pattern.matcher(cd.toString()).matches()) {
matched.add((TypeElement) cd);
addToGraph((TypeElement) cd);
}
}
}
/**
* Adds the specified class to the internal class graph along with its relations
* and dependencies, eventually inferring them, according to the Options
* specified for this matcher
*
* @param cd
*/
private void addToGraph(TypeElement cd) {
// avoid adding twice the same class, but don't rely on cg.getClassInfo
// since there are other ways to add a classInfor than printing the class
if (visited.contains(cd.toString())) {
return;
}
visited.add(cd.toString());
cg.printClass(cd, false);
cg.printRelations(cd);
if (opt.inferRelationships) {
cg.printInferredRelations(cd);
}
if (opt.inferDependencies) {
cg.printInferredDependencies(cd);
}
}
/**
* @see org.umlgraph.doclet.ClassMatcher#matches(TypeElement)
*/
public boolean matches(TypeElement cd) {
if (keepParentHide && opt.matchesHideExpression(cd.getQualifiedName())) {
return false;
}
// if the class is matched, it's in by default.
if (matched.contains(cd)) {
return true;
}
// otherwise, add the class to the graph and see if it's associated
// with any of the matched classes using the classgraph hack
addToGraph(cd);
return matches(cd.toString());
}
/**
* @see org.umlgraph.doclet.ClassMatcher#matches(CharSequence)
*/
public boolean matches(CharSequence name) {
if (pattern.matcher(name).matches()) {
return true;
}
for (TypeElement mcd : matched) {
RelationPattern rp = cg.getClassInfo(mcd, true).getRelation(name);
if (rp != null && opt.contextRelationPattern.matchesOne(rp)) {
return true;
}
}
return false;
}
/**
* A quick hack to compute class dependencies reusing ClassGraph but without
* generating output. Will be removed once the ClassGraph class will be split
* into two classes for graph computation and output generation.
*
* @author wolf
*
*/
private static class ClassGraphHack extends ClassGraph {
public ClassGraphHack(DocletEnvironment root, OptionProvider optionProvider) throws IOException {
super(root, optionProvider, null);
prologue();
}
@Override
public void prologue() throws IOException {
w = new PrintWriter(new DevNullWriter());
}
}
/**
* Simple dev/null imitation
*
* @author wolf
*/
private static class DevNullWriter extends Writer {
@Override
public void write(char[] cbuf, int off, int len) throws IOException {
// nothing to do
}
@Override
public void flush() throws IOException {
// nothing to do
}
@Override
public void close() throws IOException {
// nothing to do
}
}
}

View File

@ -0,0 +1,133 @@
package org.umlgraph.doclet;
import java.io.IOException;
import java.util.regex.Pattern;
import jdk.javadoc.doclet.DocletEnvironment;
import javax.lang.model.element.ModuleElement;
import javax.lang.model.element.TypeElement;
import org.umlgraph.doclet.util.ElementUtil;
import com.sun.source.util.DocTrees;
/**
* A view designed for UMLDoc, filters out everything that it's not directly
* connected to the center class of the context.
* <p>
* As such, can be viewed as a simplified version of a {@linkplain View} using a
* single {@linkplain ContextMatcher}, but provides some extra configuration
* such as context highlighting and output path configuration (and it is
* specified in code rather than in javadoc comments).
*
* @author wolf
*
*/
public class ContextView implements OptionProvider {
private TypeElement cd;
private DocletEnvironment root;
private ContextMatcher matcher;
private Options globalOptions;
private Options myGlobalOptions;
private Options hideOptions;
private Options centerOptions;
private Options packageOptions;
private static final String[] HIDE_OPTIONS = new String[] { "hide" };
public ContextView(String outputFolder, TypeElement cd, DocletEnvironment root, Options parent) throws IOException {
this.cd = cd;
this.root = root;
ModuleElement md = ElementUtil.getModuleOf(root, cd);
String pathPrefix = Runtime.version().major() > 10 && md != null ? md.getQualifiedName().toString() + "/" : "";
String outputPath = pathPrefix + ElementUtil.getPackageOf(root, cd).getQualifiedName().toString().replace('.', '/') + "/" + cd.getSimpleName() + ".dot";
// setup options statically, so that we won't need to change them so
// often
this.globalOptions = parent.getGlobalOptions();
this.packageOptions = parent.getGlobalOptions();
this.packageOptions.showQualified = false;
this.myGlobalOptions = parent.getGlobalOptions();
this.myGlobalOptions.setOption(new String[] { "output", outputPath });
this.myGlobalOptions.setOption(HIDE_OPTIONS);
this.hideOptions = parent.getGlobalOptions();
this.hideOptions.setOption(HIDE_OPTIONS);
this.centerOptions = parent.getGlobalOptions();
this.centerOptions.nodeFillColor = "lemonChiffon";
this.centerOptions.showQualified = false;
this.matcher = new ContextMatcher(root, Pattern.compile(Pattern.quote(cd.toString())), myGlobalOptions, true);
}
public void setContextCenter(TypeElement contextCenter) {
this.cd = contextCenter;
ModuleElement md = ElementUtil.getModuleOf(root, contextCenter);
String pathPrefix = Runtime.version().major() > 10 && md != null ? md.getQualifiedName().toString() + "/" : "";
String outputPath = pathPrefix + ElementUtil.getPackageOf(root, cd).getQualifiedName().toString().replace('.', '/') + "/" + cd.getSimpleName() + ".dot";
this.myGlobalOptions.setOption(new String[] { "output", outputPath });
matcher.setContextCenter(Pattern.compile(Pattern.quote(cd.toString())));
}
public String getDisplayName() {
return "Context view for class " + cd;
}
public Options getGlobalOptions() {
return myGlobalOptions;
}
public Options getOptionsFor(DocTrees dt, TypeElement cd) {
Options opt;
if (globalOptions.matchesHideExpression(cd.getQualifiedName())
|| !(matcher.matches(cd) || globalOptions.matchesIncludeExpression(cd.getQualifiedName()))) {
opt = hideOptions;
} else if (cd.equals(this.cd)) {
opt = centerOptions;
} else if (root.getElementUtils().getPackageOf(cd).equals(root.getElementUtils().getPackageOf(this.cd))) {
opt = packageOptions;
} else {
opt = globalOptions;
}
Options optionClone = (Options) opt.clone();
overrideForClass(optionClone, cd);
return optionClone;
}
public Options getOptionsFor(CharSequence name) {
Options opt;
if (!matcher.matches(name)) {
opt = hideOptions;
} else if (name.equals(cd.getSimpleName())) {
opt = centerOptions;
} else {
opt = globalOptions;
}
Options optionClone = (Options) opt.clone();
overrideForClass(optionClone, name);
return optionClone;
}
public void overrideForClass(Options opt, TypeElement cd) {
opt.setOptions(root.getDocTrees(), cd);
if (opt.matchesHideExpression(cd.getQualifiedName())
|| !(matcher.matches(cd) || opt.matchesIncludeExpression(cd.getQualifiedName()))) {
opt.setOption(HIDE_OPTIONS);
}
if (cd.equals(this.cd)) {
opt.nodeFillColor = "lemonChiffon";
}
}
public void overrideForClass(Options opt, CharSequence className) {
if (!(matcher.matches(className) || opt.matchesIncludeExpression(className))) {
opt.setOption(HIDE_OPTIONS);
}
}
}

View File

@ -0,0 +1,101 @@
package org.umlgraph.doclet;
/**
* Class to represent a font for graphviz.
* <p>
* This is a fairly complicated model, because it is rather an API into graphviz
* formatting strings rather than a standalone thing. <p> Some fonts (edge, node,
* abstract) are set on the top level elements, whereas others (class name, tag,
* package) are inserted as {@code <font>} tags, and these can be omitted if not
* set. Inheritance of properties then happens in graphviz.
*
* @author Erich Schubert
*/
public enum Font {
/** Edge label font */
EDGE, //
/** Node basic */
NODE, //
/** Normal operation font */
NORMAL, //
/** Abstract operation font */
ABSTRACT, //
/** Class name. Inherits from null. */
CLASS, //
/** Class name of abstract classes (usually italic) */
CLASS_ABSTRACT, //
/** Package names Inherits from null. */
PACKAGE, //
/** Tags Inherits from null. */
TAG;
public static final String DEFAULT_FONT;
// Static initialization of further values.
static {
// use an appropriate font depending on the current operating system
if (System.getProperty("os.name").toLowerCase().contains("windows")) {
DEFAULT_FONT = "Arial";
} else {
DEFAULT_FONT = "Helvetica"; // TODO: can we use just "sans"?
}
}
/**
* Wraps the text with the appropriate font according to the specified font type
*
* @param opt Options
* @param text Text to wrap
* @return Wrapped text
*/
public String wrap(Options opt, String text) {
if (text.isEmpty() || this == NORMAL)
return text;
String face = null;
double size = -1;
boolean italic = false;
switch (this) {
case EDGE:
case NODE:
// Not used with the wrap function.
throw new UnsupportedOperationException();
case ABSTRACT:
italic = opt.nodeFontAbstractItalic;
case NORMAL:
break;
case CLASS_ABSTRACT:
italic = opt.nodeFontAbstractItalic;
case CLASS:
face = opt.nodeFontClassName;
size = opt.nodeFontClassSize;
break;
case PACKAGE:
face = opt.nodeFontPackageName;
size = opt.nodeFontPackageSize;
break;
case TAG:
face = opt.nodeFontTagName;
size = opt.nodeFontTagSize;
break;
}
if (face == null && size < 0 && !italic)
return text;
StringBuilder buf = new StringBuilder(text.length() + 100);
if (face != null || size > 0) {
buf.append("<font");
if (face != null)
buf.append(" face=\"").append(face).append('"');
if (size > 0)
buf.append(" point-size=\"").append(size).append('"');
buf.append('>');
}
if (italic)
buf.append("<i>");
buf.append(text);
if (italic)
buf.append("</i>");
if (face != null || size > 0)
buf.append("</font>");
return buf.toString();
}
}

Some files were not shown because too many files have changed in this diff Show More