commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefan Bodewig <bode...@apache.org>
Subject [compress] exclude _internal package from javadocs?
Date Sun, 12 Jan 2014 10:18:46 GMT
Compress holds a package that is public as an implementation detail but
whose API isn't meant for public consumption.  The javadocs of said
package state this in bold letters.[1]

Current trunk will even go further and hide the package from javadoc,
but the only class inside is still refered to by two stream classes that
inherit from it (ZCompressorInputStream and UnshrinkingInputStream).

I'm a bit torn on this and since I'll re-roll a new RC anyway I'd like
to see what others think about hiding internal packages.

Stefan

[1] http://people.apache.org/~bodewig/cc-1.7/apidocs/org/apache/commons/compress/compressors/z/_internal_/package-summary.html

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message