public interface DBAccess
// Reads a record from the file. Returns an array where each
// element is a record value.
public String  readRecord(long recNo)
Originally posted by Terry Martinson:
George - when you say not to modify it in any way, do you also mean that we shouldn't change their comments to javadoc style?
Or do you just mean to leave their basic info in the comment as is and ok to change to appropriate javadoc style?
If it's a runtime exception it isn't a checked exception, so you needn't include it in the throws list. Right?
maybe you should look into creating a new interface and then adapt the new interface to the one provided by Sun.
public static int parseInt(String s)
Parses the string argument as a signed decimal integer...
s - a String containing the int representation to be parsed
the integer value represented by the argument in decimal.
NumberFormatException - if the string does not contain a parsable integer.
One minor point: if you document the MyRuntimeException using the javadoc @throws, then if you subsequently run DocCheck (Sun's check tool that makes sure everything has a javadoc comment that needs one, and among other things, tries to verify the javadoc comment against the code that's being commented) it will complain that you have a @throws MyRuntimeException but that exception is not actually listed in the throws clause of the method declaration.
Does anyone know of a precedence/example in SUN's API where Runtime exceptions are documented in the class methods but they do not appear in the throw clause.