search

roycezhc / doclava

Automatically exported from code.google.com/p/doclava
Apache License 2.0
0 stars 0 forks source link

Method URLs with generics aren't URL-compliant #25

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago 
URLs produced by Doclava aren't compliant URLs.  They contain a number of 
invalid characters for a URI, including '<', '>' and '?'.  The main problem is 
that the URLs are including generic types whereas the JDK javadoc does not.

For an example, this method:
 Binder.bindInterceptor(Matcher<? super Class<?>> classMatcher, Matcher<? super Method> methodMatcher, MethodInterceptor... interceptors)
 produces an href of:
 href="../../../com/google/inject/Binder.html#bindInterceptor(com.google.inject.matcher.Matcher<? super java.lang.Class<?>>, com.google.inject.matcher.Matcher<? super java.lang.reflect.Method>, org.aopalliance.intercept.MethodInterceptor...)"

Whereas in the JDK javadoc, the method:
 Map.putAll(Map<? extends K,? extends V> m) 
produces an href of:
 HREF="../../java/util/Map.html#putAll(java.util.Map)"

Original issue reported on code.google.com by sberlin on 29 Nov 2010 at 2:51

GoogleCodeExporter commented 9 years ago 
Yikes. We should fix this, hopefully without breaking existing links into 
Android's developer site.

Original comment by limpbizkit on 30 Nov 2010 at 2:44