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/resource/AbstractResourceManager.java
*/
    public final Object create(DeviceResourceDescriptor descriptor) throws DeviceResourceException {
        
        if (map == null) {
            map = new HashMap();
        }
        
        
        RefCount count = (RefCount)map.get(descriptor);
        if (count != null) {
            
            
            count.count++;
            return count.resource;
        }
        
        
        Object resource = allocate(descriptor);
        
        count = new RefCount(resource);
        map.put(descriptor, count);
        
        return resource;
    }
    /* (non-Javadoc)
     * @see ResourceManager#destroy(DeviceResourceDescriptor)
     */
    public final void destroy(DeviceResourceDescriptor descriptor) {
        
        if (map == null) {