commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Henri Yandell <bay...@generationjava.com>
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 o.a.c.io.input and o.a.c.io.output
> ----------------------------------------------------------------
> 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.

> o.a.c.io
> - what about putting them in the root package similar to java.io

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
however.

> ----------------------------------------------------------------
> class o.a.c.io.HexDump
> ----------------------------------------------------------------
>
> 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.

+1

Hen


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


Mime
View raw message