From: Bill Shannon <bill.shannon_at_sun.com>
Date: Mon, 13 Mar 2006 17:08:42 -0800

Let me try. How about this:

     /**
      * Returns a List of URLs for the
      * jar files or exploded jar file directories that the
      * persistence provider must examine for managed classes of
      * the persistence unit. Each URL corresponds to a named
      * &lt;jar-file&gt; element in the persistence.xml file.
      * The URLs will either be a file: URL referring to a jar
      * file or referring to a directory that contains an exploded
      * jar file, or some other URL from which an InputStream in
      * jar format can be obtained.
      *
      * @return a List of URL objects referring to jar files or directories
      */
     public List<URL> getJarFileUrls();

     /**
      * Returns the URL for the jar file or
      * directory that is the root of the persistence unit. (If the
      * persistence unit is rooted in the WEB-INF/classes directory,
      * this will be the URL of that directory.)
      * The URL will either be a file: URL referring to a jar
      * file or referring to a directory that contains an exploded
      * jar file, or some other URL from which an InputStream in
      * jar format can be obtained.
      *
      * @return a URL referring to a jar file or directory
      */
     public URL getPersistenceUnitRootUrl();


You *really* have to fix these javadocs so that they don't start with @return...