80 |
This can be daunting to a newcomer; consider the javadoc |
This can be daunting to a newcomer; consider the javadoc |
81 |
for the interface ``java.security.PublicKey`` in Sun's |
for the interface ``java.security.PublicKey`` in Sun's |
82 |
Java2 SDK 1.4.1 |
Java2 SDK 1.4.1 |
83 |
XXXREF. |
REF?. |
84 |
While the class is easy to find through the package and class lists |
While the class is easy to find through the package and class lists |
85 |
when looking for a class to represent cryptographical public keys, |
when looking for a class to represent cryptographical public keys, |
86 |
the javadoc is not terribly useful: there is no information |
the javadoc is not terribly useful: there is no information |
88 |
The only way to find this out is to click on the ``Use`` link |
The only way to find this out is to click on the ``Use`` link |
89 |
which lists all the occurrences of this class as method |
which lists all the occurrences of this class as method |
90 |
return values or parameters, without much contextual information |
return values or parameters, without much contextual information |
91 |
about the importance of the methods. |
about the importance of the methods - the methods for |
92 |
However, what would really help would be a link to the design |
creating a ``PublicKey`` are listed alongside the methods |
93 |
|
that return a ``PublicKey`` contained in another object.. |
94 |
|
|
95 |
|
Far more helpful would be a link to the design |
96 |
documentation, even just a diagram of what the intended |
documentation, even just a diagram of what the intended |
97 |
uses or lifespans of classes implementing this interface |
uses or lifespans of classes implementing this interface |
98 |
are and how one creates them. |
are and how one creates them. |