commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Henri Yandell <>
Subject Re: [io] docs and refactorings
Date Sun, 21 Dec 2003 01:24:18 GMT

On Sat, 20 Dec 2003, __matthewHawthorne wrote:

> Since Maven is so good at generating docs, I'm starting to favor useful
> xdocs over long package descriptions.  It just seems easier to navigate.

Ditto, though I've started to favour turning off the default Maven
navigation and setting my own up by hand.

> ----------------------------------------------------------------
> Packages and
> ----------------------------------------------------------------
> I'd like to merge these into one package which contains all
> InputStreams, OutputStreams, Readers and Writers.  Currently, we have 1
> Writer, 0 Readers, and the rest are streams.  I just think it makes more
> sense to have these classes side by side.  For example --
> ProxyInputStream and ProxyOutputStream, DemuxInputStream and
> DemuxOutputStream.  These classes will most like be used together, and
> change together, so lets put them together.

Dunno. I'm hesitant on this move as I don't think the Proxy's will be used
side by side, though Demux might.

> - what about putting them in the root package similar to

Tidiness. At this stage of IO's life, a package with lots of classes in
looks like one that won't scope. A package with a few things in will scope

> ----------------------------------------------------------------
> class
> ----------------------------------------------------------------
> This class only has one method, dump(byte[], long, OutputStream, int).
> I would like to move this method to IOUtils as dumpHex, then deprecate
> and remove the original class.



To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message