/[gzz]/manuscripts/UMLLink/short-paper.rst
ViewVC logotype

Diff of /manuscripts/UMLLink/short-paper.rst

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.14 by tjl, Tue May 20 19:32:59 2003 UTC revision 1.15 by tjl, Wed May 21 05:59:36 2003 UTC
# Line 80  the design documentation and the embedde Line 80  the design documentation and the embedde
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
# Line 88  there on how one may create objects that Line 88  there on how one may create objects that
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.

Legend:
Removed from v.1.14  
changed lines
  Added in v.1.15

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26