Bug 161848 [JFace] Javadoc quality in org.eclipse.jface
As Tod announced on the platform-ui mailing list he wants to set the compiler settings to stricter mode so to ensure the javadoc quality. Because the weather was so lousy in Austria today I tried it and took the effort (~2 hours). I'll attach the patches package wise. This is a starting point.
bundles/org.eclipse.jface/src/org/eclipse/jface/util/Assert.java
* @deprecated As of 3.3, replaced by {@link org.eclipse.core.runtime.Assert}
 * </p>
 */
public final class Assert {
    /**
     * <code>AssertionFailedException</code> is a runtime exception thrown
     * by some of the methods in <code>Assert</code>.
     * <p>
     * This class is not declared public to prevent some misuses; programs that catch 
     * or otherwise depend on assertion failures are susceptible to unexpected
     * breakage when assertions in the code are added or removed.
     * </p>
     */
    private static class AssertionFailedException extends RuntimeException {
        /**
         * Generated serial version UID for this class.
         * @since 3.1
         */
        private static final long serialVersionUID = 3257852073508024376L;
        /**
         * Constructs a new exception.
         */
        public AssertionFailedException() {
        }
        /**
         * Constructs a new exception with the given message.
         */
        public AssertionFailedException(String detail) {
            super(detail);
        }