1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
-----------------------------------------------------------------------
README
UMLDoclet release 1
-----------------------------------------------------------------------
1999, 5/7
Takeshi Yamada, Taisuke Fukuno
========
OVERVIEW
========
This documentation generator utilizes javadoc to create HTML files including
UML class figure HTML files from java files
========
LICENESE
========
This is FREE SOFTWARE provided "AS IS", with NO WARRANTY.
================
FUNCTIONALITIES
================
* a pivot class/interface on center of page
* supers are left, subs are right, a outer is up, inners are down
* classes/interfaces are color coded according to which it is a class or a abstract class or a interface.
* link to UML HTML from pivot class/interface
* link to standard HTML from pivot class/interface and members
* link to a standard HTML from UML HTML
* descriptions based on UML class figure
accessibility +:public, #:protected, -:private, default is space character
tags {name:value}
stereotypes <<value>> tags named stereotype is special
a relieved in white arrow represent generalzation, line with a description represent a inner/outer
<dt>
* a name of UML HTML has "uml-" as a prefix
* possible to write only UML HTML
============
REQUIREMENTS
============
JDK1.2
HTML browser JavaScript run
=============
INSTALLATION
=============
0. Unzip the downloaded file.
1. Copy recursively the 'JP' folder to an appropreate folder.
In this document, the tool is assumed to be copied into C:\UMLDoclet
folder. The folder will look like;
C:\UMLDoclet\JP\co\esm\caddies\doclets\RedDoclet.class
2. Set the CLASSPATH environment.
Add the folder to the CLASSPATH environment variable.
Example:
set CLASSPATH = C:\UMLDoclet;.;C:\jdk1.2\lib\tools.jar
In Windows NT, follow [Control Panel] -> [System] -> [Environment]
3. Set the PATH environment.
Add the path to 'javadoc' to the PATH environment variable.
Example:
set PATH = C:\jdk1.2\bin;%PATH%
See the javadoc documentation, and make sure that javadoc works
correctly.
4. Verify the javadoc installation.
From the DOS prompt, type javadoc to see javadoc is working. Then, go on
to the USAGE below.
======
USAGE
======
run on javadoc.
C:\> javadoc -doclet JP.co.esm.caddies.doclets.RedDoclet -private <file1.java> [...]
C:\> javadoc -doclet JP.co.esm.caddies.doclets.RedDoclet -private <package-name>
options
-d <directory>
the folder to output
-windowtitle <text>
the title of HTML
-docencoding <name>
output encoding name
-member <abcde>
members (attributes and methods) showing type
setting option by a 5 beams number, pivot, sub, super, inner, outer
select number each a beam
0. members are disable
1. members are enable, parameters are disable
2. members are enable, parameters are enable
3. class name with package
default is 22202
-interfacecolor <rrggbb>
background color of a interface
-classcolor <rrggbb>
background color of a class
-abstractclasscolor <rrggbb>
background color of a abstract class
default is background color of a class
-finalclasscolor <rrggbb>
background color of a final class
default is background color of a class
-tag <name>
validate tag name
[Others]
1. This tool utilizes javadoc. If you have a problem, first make sure
javadoc works correctly.
2. A batch file may simplify your work.
--------- UMLDoclet.bat ---------------------------------------------------
@ECHO OFF
javadoc -private -doclet JP.co.esm.caddies.doclets.UMLDoclet %1 %2 %3 %4 %5
---------------------------------------------------------------------------
3. This tool may be upgrated and other related tools may be announced at;
http://www.esm.co.jp/divisions/open-sys/technic.htm
Hope you stay tuned.
4. Bug report, Comments are welcome.
�@�@mailto:uml-doclet@esm.co.jp
Thanks.
---
Eiwa System Management, Inc. http://www.esm.co.jp/
Takeshi Yamada E-Mail: tyamada@esm.co.jp
Taisuke Fukuno E-Mail: uni@shaft.to
|
