You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Niall Pemberton <ni...@gmail.com> on 2010/10/10 06:30:32 UTC
[VOTE] Release Commons IO 2.0 based on RC3
I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
improvements to some tests which were causing intermittent failures in
Gump & Continuum and JavaDoc improvements. For details about Continuum
builds/failures, see:
http://people.apache.org/~niallp/io-2.0/IOFailures.html
The distro is here:
http://people.apache.org/~niallp/io-2.0-rc3/
Release Notes:
http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
Site:
http://people.apache.org/~niallp/io-2.0-rc3/site/
Maven Stuff:
http://people.apache.org/~niallp/io-2.0-rc3/maven/
Some Notes:
* There is one error on the clirr report - which is a false positive
(a generic method that is erased)
http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
* Links to the JavaDoc versions on the site don't work (they will when
its deployed to the right location)
Thanks
Niall
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: [VOTE] Release Commons IO 2.0 based on RC3
Posted by Niall Pemberton <ni...@gmail.com>.
On Sun, Oct 10, 2010 at 9:38 AM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> Hi All:
>
> Is the ant build still supported? I get:
>
> BUILD FAILED
> C:\temp\commons-io-2.0-src\commons-io-2.0-src\build.xml:184: Test org.apache.commons.io.monitor.AbstractMonitorTestCase failed
> at org.apache.tools.ant.taskdefs.optional.junit.JUnitTask.actOnTestResult(JUnitTask.java:1863)
> at org.apache.tools.ant.taskdefs.optional.junit.JUnitTask.execute(JUnitTask.java:814)
>
> Which looks like a build.xml issue (exclude Abstract* classes from tests)
Doh, it worked in RC2 - but I refactored two tests and created a new
Abstract* one.
> I'm not sure how I ended up with a nested commons-io-2.0-src/commons-io-2.0-src either, but that's probably a carbon-based error.
>
I don't see that.
Thanks
Niall
> Gary Gregory
> Senior Software Engineer
> Rocket Software
> 3340 Peachtree Road, Suite 820 . Atlanta, GA 30326 . USA
> Tel: +1.404.760.1560 . Mobile: +1.310.403.8747
> Email: ggregory@seagullsoftware.com
> Web: seagull.rocketsoftware.com
>
>
>
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Saturday, October 09, 2010 21:31
> To: Commons Developers List
> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>
> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> improvements to some tests which were causing intermittent failures in
> Gump & Continuum and JavaDoc improvements. For details about Continuum
> builds/failures, see:
> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>
> The distro is here:
> http://people.apache.org/~niallp/io-2.0-rc3/
>
> Release Notes:
> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>
> Site:
> http://people.apache.org/~niallp/io-2.0-rc3/site/
>
> Maven Stuff:
> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>
> Some Notes:
>
> * There is one error on the clirr report - which is a false positive
> (a generic method that is erased)
> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> * Links to the JavaDoc versions on the site don't work (they will when
> its deployed to the right location)
>
> Thanks
>
> Niall
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: [VOTE] Release Commons IO 2.0 based on RC3
Posted by Gary Gregory <GG...@seagullsoftware.com>.
Hi All:
Is the ant build still supported? I get:
BUILD FAILED
C:\temp\commons-io-2.0-src\commons-io-2.0-src\build.xml:184: Test org.apache.commons.io.monitor.AbstractMonitorTestCase failed
at org.apache.tools.ant.taskdefs.optional.junit.JUnitTask.actOnTestResult(JUnitTask.java:1863)
at org.apache.tools.ant.taskdefs.optional.junit.JUnitTask.execute(JUnitTask.java:814)
Which looks like a build.xml issue (exclude Abstract* classes from tests)
I'm not sure how I ended up with a nested commons-io-2.0-src/commons-io-2.0-src either, but that's probably a carbon-based error.
Gary Gregory
Senior Software Engineer
Rocket Software
3340 Peachtree Road, Suite 820 . Atlanta, GA 30326 . USA
Tel: +1.404.760.1560 . Mobile: +1.310.403.8747
Email: ggregory@seagullsoftware.com
Web: seagull.rocketsoftware.com
-----Original Message-----
From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
Sent: Saturday, October 09, 2010 21:31
To: Commons Developers List
Subject: [VOTE] Release Commons IO 2.0 based on RC3
I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
improvements to some tests which were causing intermittent failures in
Gump & Continuum and JavaDoc improvements. For details about Continuum
builds/failures, see:
http://people.apache.org/~niallp/io-2.0/IOFailures.html
The distro is here:
http://people.apache.org/~niallp/io-2.0-rc3/
Release Notes:
http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
Site:
http://people.apache.org/~niallp/io-2.0-rc3/site/
Maven Stuff:
http://people.apache.org/~niallp/io-2.0-rc3/maven/
Some Notes:
* There is one error on the clirr report - which is a false positive
(a generic method that is erased)
http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
* Links to the JavaDoc versions on the site don't work (they will when
its deployed to the right location)
Thanks
Niall
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: [VOTE] Release Commons IO 2.0 based on RC3
Posted by Niall Pemberton <ni...@gmail.com>.
Apologies, this vote is cancelled.
I'll roll another RC to fix the issue Gary found in the Ant build.
Niall
On Sun, Oct 10, 2010 at 5:30 AM, Niall Pemberton
<ni...@gmail.com> wrote:
> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> improvements to some tests which were causing intermittent failures in
> Gump & Continuum and JavaDoc improvements. For details about Continuum
> builds/failures, see:
> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>
> The distro is here:
> http://people.apache.org/~niallp/io-2.0-rc3/
>
> Release Notes:
> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>
> Site:
> http://people.apache.org/~niallp/io-2.0-rc3/site/
>
> Maven Stuff:
> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>
> Some Notes:
>
> * There is one error on the clirr report - which is a false positive
> (a generic method that is erased)
> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> * Links to the JavaDoc versions on the site don't work (they will when
> its deployed to the right location)
>
> Thanks
>
> Niall
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based
on RC3]
Posted by Gary Gregory <GG...@seagullsoftware.com>.
> -----Original Message-----
> From: jodastephen@gmail.com [mailto:jodastephen@gmail.com] On Behalf Of
> Stephen Colebourne
> Sent: Monday, October 11, 2010 17:09
> To: Commons Developers List
> Subject: Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on
> RC3]
>
> On 12 October 2010 00:29, Niall Pemberton <ni...@gmail.com> wrote:
> > Part of me thinks its a bit late in the day to raise this when its
> > been in svn for 2+ years. But then again, if more people agree with
> > Gary then I can cancel the release and rename them (I would probably
> > opt for FileItem, FileObserver, FileMonitor rather than
> > FileSystemItem, FileSystemObserver, FileSystemMonitor).
>
> I strongly recommend renaming in line with the JDK -
> http://openjdk.java.net/projects/nio/javadoc/index.html
> (assuming the classes are unreleased ATM) I do agree that it is
> unfortunate to have an issue at this point.
>
> I would be happy with the shorter (non system) names too.
I just realized that [io] is not consistent with itself since it provides a class named FileSystemUtils (not FilesystemUtils). So [io] trunk has both naming conventions.
Gary
>
> Stephen
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Posted by Stephen Colebourne <sc...@joda.org>.
On 12 October 2010 00:29, Niall Pemberton <ni...@gmail.com> wrote:
> Part of me thinks its a bit late in the day to raise this when its
> been in svn for 2+ years. But then again, if more people agree with
> Gary then I can cancel the release and rename them (I would probably
> opt for FileItem, FileObserver, FileMonitor rather than
> FileSystemItem, FileSystemObserver, FileSystemMonitor).
I strongly recommend renaming in line with the JDK -
http://openjdk.java.net/projects/nio/javadoc/index.html
(assuming the classes are unreleased ATM) I do agree that it is
unfortunate to have an issue at this point.
I would be happy with the shorter (non system) names too.
Stephen
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based
on RC3]
Posted by Gary Gregory <GG...@seagullsoftware.com>.
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Monday, October 11, 2010 16:30
> To: Commons Developers List
> Subject: Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on
> RC3]
>
> On Mon, Oct 11, 2010 at 8:37 PM, Matt Benson <gu...@gmail.com> wrote:
> >
> > On Oct 11, 2010, at 11:49 AM, Gary Gregory wrote:
> >
> >> Hi All:
> >>
> >> The more I think about it and read it, the more non-English and odd the
> word "filesystem" feels to me. I would never write: 'Do this or that with the
> filesystem.' It just sounds Dutch or German to me. That's what I get for
> working with Dutch people :)
> >>
> >
> > Speaking as a native American English speaker and confessed spelling/grammar
> nazi, I would personally *prefer* to see the compound "filesystem" used
> instead of "file system". I consider it to be simply one of those computing
> terms that is no less correct for your spell checking software refusing to
> recognize it.
> >
>
> Thanks Matt for your opinion.
>
> Part of me thinks its a bit late in the day to raise this when its
> been in svn for 2+ years. But then again, if more people agree with
> Gary then I can cancel the release and rename them (I would probably
> opt for FileItem, FileObserver, FileMonitor rather than
> FileSystemItem, FileSystemObserver, FileSystemMonitor).
Your rename proposal is +1 from me ;)
Gary
>
> Opinions welcome - either way :)
>
> Niall
>
> > $0.02,
> > Matt
> >
> >> I am not the guardian of the English lanugage (and neither is Wikipedia), I
> do not see compound nouns in English like as I do speakers of other languages
> use them.
> >>
> >> About the Wikipedia entry: They do say "often also written as filesystem"
> but so what? Wikipedia says a lot of things...
> >>
> >> I am kinda ranting on this one because I think names are very important.
> >>
> >> Gary
> >>
> >> -----Original Message-----
> >> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> >> Sent: Monday, October 11, 2010 05:11
> >> To: Commons Developers List
> >> Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
> >>
> >> On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
> >> <GG...@seagullsoftware.com> wrote:
> >>> I am looking around and I notice set of class names that are IMO
> incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem"
> is not a word in English.
> >>
> >> Thats true but its often written as one - see wikipedia "A file system
> >> (often also written as filesystem) is..."
> >> http://en.wikipedia.org/wiki/File_system
> >>
> >> ...and I think it gives better emphasis that way.
> >>
> >> Also JCI was released with the same naming (which IO was initially
> >> based on, before a complete refactoring):
> >>
> >> http://commons.apache.org/jci/apidocs/index.html
> >>
> >> Niall
> >>
> >>
> >>> Gary Gregory
> >>>
> >>>
> >>> -----Original Message-----
> >>> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> >>> Sent: Saturday, October 09, 2010 21:31
> >>> To: Commons Developers List
> >>> Subject: [VOTE] Release Commons IO 2.0 based on RC3
> >>>
> >>> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> >>> improvements to some tests which were causing intermittent failures in
> >>> Gump & Continuum and JavaDoc improvements. For details about Continuum
> >>> builds/failures, see:
> >>> http://people.apache.org/~niallp/io-2.0/IOFailures.html
> >>>
> >>> The distro is here:
> >>> http://people.apache.org/~niallp/io-2.0-rc3/
> >>>
> >>> Release Notes:
> >>> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
> >>>
> >>> Site:
> >>> http://people.apache.org/~niallp/io-2.0-rc3/site/
> >>>
> >>> Maven Stuff:
> >>> http://people.apache.org/~niallp/io-2.0-rc3/maven/
> >>>
> >>> Some Notes:
> >>>
> >>> * There is one error on the clirr report - which is a false positive
> >>> (a generic method that is erased)
> >>> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> >>> * Links to the JavaDoc versions on the site don't work (they will when
> >>> its deployed to the right location)
> >>>
> >>> Thanks
> >>>
> >>> Niall
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >> For additional commands, e-mail: dev-help@commons.apache.org
> >>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >> For additional commands, e-mail: dev-help@commons.apache.org
> >>
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> > For additional commands, e-mail: dev-help@commons.apache.org
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Posted by Niall Pemberton <ni...@gmail.com>.
On Mon, Oct 11, 2010 at 8:37 PM, Matt Benson <gu...@gmail.com> wrote:
>
> On Oct 11, 2010, at 11:49 AM, Gary Gregory wrote:
>
>> Hi All:
>>
>> The more I think about it and read it, the more non-English and odd the word "filesystem" feels to me. I would never write: 'Do this or that with the filesystem.' It just sounds Dutch or German to me. That's what I get for working with Dutch people :)
>>
>
> Speaking as a native American English speaker and confessed spelling/grammar nazi, I would personally *prefer* to see the compound "filesystem" used instead of "file system". I consider it to be simply one of those computing terms that is no less correct for your spell checking software refusing to recognize it.
>
Thanks Matt for your opinion.
Part of me thinks its a bit late in the day to raise this when its
been in svn for 2+ years. But then again, if more people agree with
Gary then I can cancel the release and rename them (I would probably
opt for FileItem, FileObserver, FileMonitor rather than
FileSystemItem, FileSystemObserver, FileSystemMonitor).
Opinions welcome - either way :)
Niall
> $0.02,
> Matt
>
>> I am not the guardian of the English lanugage (and neither is Wikipedia), I do not see compound nouns in English like as I do speakers of other languages use them.
>>
>> About the Wikipedia entry: They do say "often also written as filesystem" but so what? Wikipedia says a lot of things...
>>
>> I am kinda ranting on this one because I think names are very important.
>>
>> Gary
>>
>> -----Original Message-----
>> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
>> Sent: Monday, October 11, 2010 05:11
>> To: Commons Developers List
>> Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
>>
>> On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
>> <GG...@seagullsoftware.com> wrote:
>>> I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
>>
>> Thats true but its often written as one - see wikipedia "A file system
>> (often also written as filesystem) is..."
>> http://en.wikipedia.org/wiki/File_system
>>
>> ...and I think it gives better emphasis that way.
>>
>> Also JCI was released with the same naming (which IO was initially
>> based on, before a complete refactoring):
>>
>> http://commons.apache.org/jci/apidocs/index.html
>>
>> Niall
>>
>>
>>> Gary Gregory
>>>
>>>
>>> -----Original Message-----
>>> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
>>> Sent: Saturday, October 09, 2010 21:31
>>> To: Commons Developers List
>>> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>>>
>>> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
>>> improvements to some tests which were causing intermittent failures in
>>> Gump & Continuum and JavaDoc improvements. For details about Continuum
>>> builds/failures, see:
>>> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>>>
>>> The distro is here:
>>> http://people.apache.org/~niallp/io-2.0-rc3/
>>>
>>> Release Notes:
>>> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>>>
>>> Site:
>>> http://people.apache.org/~niallp/io-2.0-rc3/site/
>>>
>>> Maven Stuff:
>>> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>>>
>>> Some Notes:
>>>
>>> * There is one error on the clirr report - which is a false positive
>>> (a generic method that is erased)
>>> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
>>> * Links to the JavaDoc versions on the site don't work (they will when
>>> its deployed to the right location)
>>>
>>> Thanks
>>>
>>> Niall
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Posted by Matt Benson <gu...@gmail.com>.
On Oct 11, 2010, at 11:49 AM, Gary Gregory wrote:
> Hi All:
>
> The more I think about it and read it, the more non-English and odd the word "filesystem" feels to me. I would never write: 'Do this or that with the filesystem.' It just sounds Dutch or German to me. That's what I get for working with Dutch people :)
>
Speaking as a native American English speaker and confessed spelling/grammar nazi, I would personally *prefer* to see the compound "filesystem" used instead of "file system". I consider it to be simply one of those computing terms that is no less correct for your spell checking software refusing to recognize it.
$0.02,
Matt
> I am not the guardian of the English lanugage (and neither is Wikipedia), I do not see compound nouns in English like as I do speakers of other languages use them.
>
> About the Wikipedia entry: They do say "often also written as filesystem" but so what? Wikipedia says a lot of things...
>
> I am kinda ranting on this one because I think names are very important.
>
> Gary
>
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Monday, October 11, 2010 05:11
> To: Commons Developers List
> Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
>
> On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
> <GG...@seagullsoftware.com> wrote:
>> I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
>
> Thats true but its often written as one - see wikipedia "A file system
> (often also written as filesystem) is..."
> http://en.wikipedia.org/wiki/File_system
>
> ...and I think it gives better emphasis that way.
>
> Also JCI was released with the same naming (which IO was initially
> based on, before a complete refactoring):
>
> http://commons.apache.org/jci/apidocs/index.html
>
> Niall
>
>
>> Gary Gregory
>>
>>
>> -----Original Message-----
>> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
>> Sent: Saturday, October 09, 2010 21:31
>> To: Commons Developers List
>> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>>
>> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
>> improvements to some tests which were causing intermittent failures in
>> Gump & Continuum and JavaDoc improvements. For details about Continuum
>> builds/failures, see:
>> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>>
>> The distro is here:
>> http://people.apache.org/~niallp/io-2.0-rc3/
>>
>> Release Notes:
>> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>>
>> Site:
>> http://people.apache.org/~niallp/io-2.0-rc3/site/
>>
>> Maven Stuff:
>> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>>
>> Some Notes:
>>
>> * There is one error on the clirr report - which is a false positive
>> (a generic method that is erased)
>> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
>> * Links to the JavaDoc versions on the site don't work (they will when
>> its deployed to the right location)
>>
>> Thanks
>>
>> Niall
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Posted by Niall Pemberton <ni...@gmail.com>.
On Tue, Oct 12, 2010 at 9:20 PM, Torsten Curdt <tc...@vafer.org> wrote:
> On Tue, Oct 12, 2010 at 20:43, Gary Gregory
> <GG...@seagullsoftware.com> wrote:
>>> -----Original Message-----
>>> From: mfncooper@gmail.com [mailto:mfncooper@gmail.com] On Behalf Of Martin
>>> Cooper
>>> Sent: Monday, October 11, 2010 19:42
>>> To: Commons Developers List
>>> Subject: Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on
>>> RC3]
>>>
>>> On Mon, Oct 11, 2010 at 9:49 AM, Gary Gregory
>>> <GG...@seagullsoftware.com> wrote:
>>> > Hi All:
>>> >
>>> > The more I think about it and read it, the more non-English and odd the word
>>> "filesystem" feels to me. I would never write: 'Do this or that with the
>>> filesystem.' It just sounds Dutch or German to me. That's what I get for
>>> working with Dutch people :)
>>> >
>>>
>>> I'm with Gary on this. Not only would I not write the above, I - and
>>> most other people I know - don't speak that way either. We speak as if
>>> they are the two words that they are. It's a file system, just like a
>>> video system or a stereo system, or some other kind of system.
>>
>> I am happy to make these changes.
>>
>> For example, simply option (1):
>>
>> FilesystemEntry -> FileSystemEntry
>> FilesystemListener -> FileSystemListener
>> FilesystemListenerAdaptor -> FileSystemListenerAdaptor
>> FilesystemMonitor -> FileSystemMonitor
>> FilesystemObserver -> FileSystemObserver
>>
>> Or option (2), as suggested by Nial:
>>
>> FilesystemEntry -> FileItem
>> FilesystemListener -> FileSystemListener
>> FilesystemListenerAdaptor -> FileSystemListenerAdaptor
>> FilesystemMonitor -> FileMonitor
>> FilesystemObserver -> FileObserver
>
> I tried to stay out of this but...
>
> either it is a "file?system alteration monitor" or a "file alteration
> monitor" ... also known as "FAM"
>
> http://en.wikipedia.org/wiki/File_alteration_monitor
>
> IMO "FileMonitor" does not really express what it does. Nor will users
> search for it like that.
> I am not sure why we try to come up with our own special name here.
Seemed less of a mouthfull/verbose - at the time dropping the
*alteration* part didn't seem to loose much in meaning to me - but
perhaps your're right - I guess files could be monitored for all sorts
of reasons.
Niall
> Guess I am the one to blame for the spelling.
>
> http://commons.apache.org/jci/apidocs/org/apache/commons/jci/monitor/package-summary.html
>
> But I found both spellings ...plus it made the FAM more clear.
>
> ...in case someone is wondering
>
> cheers,
> Torsten
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Posted by Torsten Curdt <tc...@vafer.org>.
On Tue, Oct 12, 2010 at 20:43, Gary Gregory
<GG...@seagullsoftware.com> wrote:
>> -----Original Message-----
>> From: mfncooper@gmail.com [mailto:mfncooper@gmail.com] On Behalf Of Martin
>> Cooper
>> Sent: Monday, October 11, 2010 19:42
>> To: Commons Developers List
>> Subject: Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on
>> RC3]
>>
>> On Mon, Oct 11, 2010 at 9:49 AM, Gary Gregory
>> <GG...@seagullsoftware.com> wrote:
>> > Hi All:
>> >
>> > The more I think about it and read it, the more non-English and odd the word
>> "filesystem" feels to me. I would never write: 'Do this or that with the
>> filesystem.' It just sounds Dutch or German to me. That's what I get for
>> working with Dutch people :)
>> >
>>
>> I'm with Gary on this. Not only would I not write the above, I - and
>> most other people I know - don't speak that way either. We speak as if
>> they are the two words that they are. It's a file system, just like a
>> video system or a stereo system, or some other kind of system.
>
> I am happy to make these changes.
>
> For example, simply option (1):
>
> FilesystemEntry -> FileSystemEntry
> FilesystemListener -> FileSystemListener
> FilesystemListenerAdaptor -> FileSystemListenerAdaptor
> FilesystemMonitor -> FileSystemMonitor
> FilesystemObserver -> FileSystemObserver
>
> Or option (2), as suggested by Nial:
>
> FilesystemEntry -> FileItem
> FilesystemListener -> FileSystemListener
> FilesystemListenerAdaptor -> FileSystemListenerAdaptor
> FilesystemMonitor -> FileMonitor
> FilesystemObserver -> FileObserver
I tried to stay out of this but...
either it is a "file?system alteration monitor" or a "file alteration
monitor" ... also known as "FAM"
http://en.wikipedia.org/wiki/File_alteration_monitor
IMO "FileMonitor" does not really express what it does. Nor will users
search for it like that.
I am not sure why we try to come up with our own special name here.
Guess I am the one to blame for the spelling.
http://commons.apache.org/jci/apidocs/org/apache/commons/jci/monitor/package-summary.html
But I found both spellings ...plus it made the FAM more clear.
...in case someone is wondering
cheers,
Torsten
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based
on RC3]
Posted by Gary Gregory <GG...@seagullsoftware.com>.
> -----Original Message-----
> From: mfncooper@gmail.com [mailto:mfncooper@gmail.com] On Behalf Of Martin
> Cooper
> Sent: Monday, October 11, 2010 19:42
> To: Commons Developers List
> Subject: Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on
> RC3]
>
> On Mon, Oct 11, 2010 at 9:49 AM, Gary Gregory
> <GG...@seagullsoftware.com> wrote:
> > Hi All:
> >
> > The more I think about it and read it, the more non-English and odd the word
> "filesystem" feels to me. I would never write: 'Do this or that with the
> filesystem.' It just sounds Dutch or German to me. That's what I get for
> working with Dutch people :)
> >
>
> I'm with Gary on this. Not only would I not write the above, I - and
> most other people I know - don't speak that way either. We speak as if
> they are the two words that they are. It's a file system, just like a
> video system or a stereo system, or some other kind of system.
I am happy to make these changes.
For example, simply option (1):
FilesystemEntry -> FileSystemEntry
FilesystemListener -> FileSystemListener
FilesystemListenerAdaptor -> FileSystemListenerAdaptor
FilesystemMonitor -> FileSystemMonitor
FilesystemObserver -> FileSystemObserver
Or option (2), as suggested by Nial:
FilesystemEntry -> FileItem
FilesystemListener -> FileSystemListener
FilesystemListenerAdaptor -> FileSystemListenerAdaptor
FilesystemMonitor -> FileMonitor
FilesystemObserver -> FileObserver
Gary
>
> --
> Martin Cooper
>
>
> > I am not the guardian of the English lanugage (and neither is Wikipedia), I
> do not see compound nouns in English like as I do speakers of other languages
> use them.
> >
> > About the Wikipedia entry: They do say "often also written as filesystem"
> but so what? Wikipedia says a lot of things...
> >
> > I am kinda ranting on this one because I think names are very important.
> >
> > Gary
> >
> > -----Original Message-----
> > From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> > Sent: Monday, October 11, 2010 05:11
> > To: Commons Developers List
> > Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
> >
> > On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
> > <GG...@seagullsoftware.com> wrote:
> >> I am looking around and I notice set of class names that are IMO
> incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem"
> is not a word in English.
> >
> > Thats true but its often written as one - see wikipedia "A file system
> > (often also written as filesystem) is..."
> > http://en.wikipedia.org/wiki/File_system
> >
> > ...and I think it gives better emphasis that way.
> >
> > Also JCI was released with the same naming (which IO was initially
> > based on, before a complete refactoring):
> >
> > http://commons.apache.org/jci/apidocs/index.html
> >
> > Niall
> >
> >
> >> Gary Gregory
> >>
> >>
> >> -----Original Message-----
> >> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> >> Sent: Saturday, October 09, 2010 21:31
> >> To: Commons Developers List
> >> Subject: [VOTE] Release Commons IO 2.0 based on RC3
> >>
> >> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> >> improvements to some tests which were causing intermittent failures in
> >> Gump & Continuum and JavaDoc improvements. For details about Continuum
> >> builds/failures, see:
> >> http://people.apache.org/~niallp/io-2.0/IOFailures.html
> >>
> >> The distro is here:
> >> http://people.apache.org/~niallp/io-2.0-rc3/
> >>
> >> Release Notes:
> >> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
> >>
> >> Site:
> >> http://people.apache.org/~niallp/io-2.0-rc3/site/
> >>
> >> Maven Stuff:
> >> http://people.apache.org/~niallp/io-2.0-rc3/maven/
> >>
> >> Some Notes:
> >>
> >> * There is one error on the clirr report - which is a false positive
> >> (a generic method that is erased)
> >> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> >> * Links to the JavaDoc versions on the site don't work (they will when
> >> its deployed to the right location)
> >>
> >> Thanks
> >>
> >> Niall
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> > For additional commands, e-mail: dev-help@commons.apache.org
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> > For additional commands, e-mail: dev-help@commons.apache.org
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Posted by Martin Cooper <ma...@apache.org>.
On Mon, Oct 11, 2010 at 9:49 AM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> Hi All:
>
> The more I think about it and read it, the more non-English and odd the word "filesystem" feels to me. I would never write: 'Do this or that with the filesystem.' It just sounds Dutch or German to me. That's what I get for working with Dutch people :)
>
I'm with Gary on this. Not only would I not write the above, I - and
most other people I know - don't speak that way either. We speak as if
they are the two words that they are. It's a file system, just like a
video system or a stereo system, or some other kind of system.
--
Martin Cooper
> I am not the guardian of the English lanugage (and neither is Wikipedia), I do not see compound nouns in English like as I do speakers of other languages use them.
>
> About the Wikipedia entry: They do say "often also written as filesystem" but so what? Wikipedia says a lot of things...
>
> I am kinda ranting on this one because I think names are very important.
>
> Gary
>
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Monday, October 11, 2010 05:11
> To: Commons Developers List
> Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
>
> On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
> <GG...@seagullsoftware.com> wrote:
>> I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
>
> Thats true but its often written as one - see wikipedia "A file system
> (often also written as filesystem) is..."
> http://en.wikipedia.org/wiki/File_system
>
> ...and I think it gives better emphasis that way.
>
> Also JCI was released with the same naming (which IO was initially
> based on, before a complete refactoring):
>
> http://commons.apache.org/jci/apidocs/index.html
>
> Niall
>
>
>> Gary Gregory
>>
>>
>> -----Original Message-----
>> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
>> Sent: Saturday, October 09, 2010 21:31
>> To: Commons Developers List
>> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>>
>> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
>> improvements to some tests which were causing intermittent failures in
>> Gump & Continuum and JavaDoc improvements. For details about Continuum
>> builds/failures, see:
>> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>>
>> The distro is here:
>> http://people.apache.org/~niallp/io-2.0-rc3/
>>
>> Release Notes:
>> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>>
>> Site:
>> http://people.apache.org/~niallp/io-2.0-rc3/site/
>>
>> Maven Stuff:
>> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>>
>> Some Notes:
>>
>> * There is one error on the clirr report - which is a false positive
>> (a generic method that is erased)
>> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
>> * Links to the JavaDoc versions on the site don't work (they will when
>> its deployed to the right location)
>>
>> Thanks
>>
>> Niall
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based
on RC3]
Posted by Gary Gregory <GG...@seagullsoftware.com>.
About the JCI reference: Well, VFS was release with many "FileSystem" classes:
http://commons.apache.org/vfs/apidocs/org/apache/commons/vfs/FileSystem.html
Does that bring more weight to my argument? :)
Gary Gregory
Senior Software Engineer
Rocket Software
3340 Peachtree Road, Suite 820 . Atlanta, GA 30326 . USA
Tel: +1.404.760.1560
Email: ggregory@seagullsoftware.com
Web: seagull.rocketsoftware.com
-----Original Message-----
From: Gary Gregory [mailto:GGregory@seagullsoftware.com]
Sent: Monday, October 11, 2010 09:49
To: Commons Developers List
Subject: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]
Hi All:
The more I think about it and read it, the more non-English and odd the word "filesystem" feels to me. I would never write: 'Do this or that with the filesystem.' It just sounds Dutch or German to me. That's what I get for working with Dutch people :)
I am not the guardian of the English lanugage (and neither is Wikipedia), I do not see compound nouns in English like as I do speakers of other languages use them.
About the Wikipedia entry: They do say "often also written as filesystem" but so what? Wikipedia says a lot of things...
I am kinda ranting on this one because I think names are very important.
Gary
-----Original Message-----
From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
Sent: Monday, October 11, 2010 05:11
To: Commons Developers List
Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
Thats true but its often written as one - see wikipedia "A file system
(often also written as filesystem) is..."
http://en.wikipedia.org/wiki/File_system
...and I think it gives better emphasis that way.
Also JCI was released with the same naming (which IO was initially
based on, before a complete refactoring):
http://commons.apache.org/jci/apidocs/index.html
Niall
> Gary Gregory
>
>
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Saturday, October 09, 2010 21:31
> To: Commons Developers List
> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>
> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> improvements to some tests which were causing intermittent failures in
> Gump & Continuum and JavaDoc improvements. For details about Continuum
> builds/failures, see:
> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>
> The distro is here:
> http://people.apache.org/~niallp/io-2.0-rc3/
>
> Release Notes:
> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>
> Site:
> http://people.apache.org/~niallp/io-2.0-rc3/site/
>
> Maven Stuff:
> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>
> Some Notes:
>
> * There is one error on the clirr report - which is a false positive
> (a generic method that is erased)
> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> * Links to the JavaDoc versions on the site don't work (they will when
> its deployed to the right location)
>
> Thanks
>
> Niall
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on
RC3]
Posted by Gary Gregory <GG...@seagullsoftware.com>.
Hi All:
The more I think about it and read it, the more non-English and odd the word "filesystem" feels to me. I would never write: 'Do this or that with the filesystem.' It just sounds Dutch or German to me. That's what I get for working with Dutch people :)
I am not the guardian of the English lanugage (and neither is Wikipedia), I do not see compound nouns in English like as I do speakers of other languages use them.
About the Wikipedia entry: They do say "often also written as filesystem" but so what? Wikipedia says a lot of things...
I am kinda ranting on this one because I think names are very important.
Gary
-----Original Message-----
From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
Sent: Monday, October 11, 2010 05:11
To: Commons Developers List
Subject: Re: [VOTE] Release Commons IO 2.0 based on RC3
On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
Thats true but its often written as one - see wikipedia "A file system
(often also written as filesystem) is..."
http://en.wikipedia.org/wiki/File_system
...and I think it gives better emphasis that way.
Also JCI was released with the same naming (which IO was initially
based on, before a complete refactoring):
http://commons.apache.org/jci/apidocs/index.html
Niall
> Gary Gregory
>
>
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Saturday, October 09, 2010 21:31
> To: Commons Developers List
> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>
> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> improvements to some tests which were causing intermittent failures in
> Gump & Continuum and JavaDoc improvements. For details about Continuum
> builds/failures, see:
> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>
> The distro is here:
> http://people.apache.org/~niallp/io-2.0-rc3/
>
> Release Notes:
> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>
> Site:
> http://people.apache.org/~niallp/io-2.0-rc3/site/
>
> Maven Stuff:
> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>
> Some Notes:
>
> * There is one error on the clirr report - which is a false positive
> (a generic method that is erased)
> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> * Links to the JavaDoc versions on the site don't work (they will when
> its deployed to the right location)
>
> Thanks
>
> Niall
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: [VOTE] Release Commons IO 2.0 based on RC4
Posted by Gary Gregory <GG...@seagullsoftware.com>.
FYI: The source zip builds and tests pass with Ant 1.8.1 and Maven 2.2.1 on Oracle/Sun Java 1.6.0_21 on Windows Vista Business N 64-bit.
Gary Gregory
Senior Software Engineer
Rocket Software
3340 Peachtree Road, Suite 820 . Atlanta, GA 30326 . USA
Tel: +1.404.760.1560
Email: ggregory@seagullsoftware.com
Web: seagull.rocketsoftware.com
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: [VOTE] Release Commons IO 2.0 based on RC4
Posted by Gary Gregory <GG...@seagullsoftware.com>.
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Monday, October 11, 2010 16:16
> To: Commons Developers List
> Subject: Re: [VOTE] Release Commons IO 2.0 based on RC4
>
> On Tue, Oct 12, 2010 at 12:11 AM, Gary Gregory
> <GG...@seagullsoftware.com> wrote:
> > Hi All:
> >
> > I see mismatch here:
> >
> > * @deprecated Use IOUtils. Will be removed in 2.0.
> > * Methods renamed to IOUtils.write() or IOUtils.copy().
> > * Null handling behaviour changed in IOUtils (null data does not
> > * throw NullPointerException).
> > */
> > @Deprecated
> > public class CopyUtils {
> >
> > Either the class should be removed or the Javadoc updated.
>
> I'll update the JavaDoc
>
> > Other deprecated items do not specify when they will be removed. If they
> will not be removed, it would be nice for the Javadoc to say so.
> >
> > IMO, a major release (like this 2.0) is as good a time as any.
>
> Yes, but for IO we would then end up in the package-rename-game -
> which I didn't want for 2.0
Ah, so nothing deprecated gets removed, the deprecated code is just not moved to the new package. I like that (in this case at least.)
Gary
>
> Niall
>
> > Gary
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: [VOTE] Release Commons IO 2.0 based on RC4
Posted by Niall Pemberton <ni...@gmail.com>.
On Tue, Oct 12, 2010 at 12:11 AM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> Hi All:
>
> I see mismatch here:
>
> * @deprecated Use IOUtils. Will be removed in 2.0.
> * Methods renamed to IOUtils.write() or IOUtils.copy().
> * Null handling behaviour changed in IOUtils (null data does not
> * throw NullPointerException).
> */
> @Deprecated
> public class CopyUtils {
>
> Either the class should be removed or the Javadoc updated.
I'll update the JavaDoc
> Other deprecated items do not specify when they will be removed. If they will not be removed, it would be nice for the Javadoc to say so.
>
> IMO, a major release (like this 2.0) is as good a time as any.
Yes, but for IO we would then end up in the package-rename-game -
which I didn't want for 2.0
Niall
> Gary
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: [VOTE] Release Commons IO 2.0 based on RC4
Posted by Gary Gregory <GG...@seagullsoftware.com>.
Hi All:
I see mismatch here:
* @deprecated Use IOUtils. Will be removed in 2.0.
* Methods renamed to IOUtils.write() or IOUtils.copy().
* Null handling behaviour changed in IOUtils (null data does not
* throw NullPointerException).
*/
@Deprecated
public class CopyUtils {
Either the class should be removed or the Javadoc updated.
Other deprecated items do not specify when they will be removed. If they will not be removed, it would be nice for the Javadoc to say so.
IMO, a major release (like this 2.0) is as good a time as any.
Gary
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: [VOTE] Release Commons IO 2.0 based on RC3
Posted by Niall Pemberton <ni...@gmail.com>.
On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
Thats true but its often written as one - see wikipedia "A file system
(often also written as filesystem) is..."
http://en.wikipedia.org/wiki/File_system
...and I think it gives better emphasis that way.
Also JCI was released with the same naming (which IO was initially
based on, before a complete refactoring):
http://commons.apache.org/jci/apidocs/index.html
Niall
> Gary Gregory
>
>
> -----Original Message-----
> From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
> Sent: Saturday, October 09, 2010 21:31
> To: Commons Developers List
> Subject: [VOTE] Release Commons IO 2.0 based on RC3
>
> I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
> improvements to some tests which were causing intermittent failures in
> Gump & Continuum and JavaDoc improvements. For details about Continuum
> builds/failures, see:
> http://people.apache.org/~niallp/io-2.0/IOFailures.html
>
> The distro is here:
> http://people.apache.org/~niallp/io-2.0-rc3/
>
> Release Notes:
> http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
>
> Site:
> http://people.apache.org/~niallp/io-2.0-rc3/site/
>
> Maven Stuff:
> http://people.apache.org/~niallp/io-2.0-rc3/maven/
>
> Some Notes:
>
> * There is one error on the clirr report - which is a false positive
> (a generic method that is erased)
> http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
> * Links to the JavaDoc versions on the site don't work (they will when
> its deployed to the right location)
>
> Thanks
>
> Niall
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
RE: [VOTE] Release Commons IO 2.0 based on RC3
Posted by Gary Gregory <GG...@seagullsoftware.com>.
I am looking around and I notice set of class names that are IMO incorrectly camel-cased: Filesystem* should be FileSystem because "filesystem" is not a word in English.
Gary Gregory
Senior Software Engineer
Rocket Software
3340 Peachtree Road, Suite 820 . Atlanta, GA 30326 . USA
Tel: +1.404.760.1560 . Mobile: +1.310.403.8747
Email: ggregory@seagullsoftware.com
Web: seagull.rocketsoftware.com
-----Original Message-----
From: Niall Pemberton [mailto:niall.pemberton@gmail.com]
Sent: Saturday, October 09, 2010 21:31
To: Commons Developers List
Subject: [VOTE] Release Commons IO 2.0 based on RC3
I have prepared Commons IO 2.0 RC3. The main changes since RC2 are
improvements to some tests which were causing intermittent failures in
Gump & Continuum and JavaDoc improvements. For details about Continuum
builds/failures, see:
http://people.apache.org/~niallp/io-2.0/IOFailures.html
The distro is here:
http://people.apache.org/~niallp/io-2.0-rc3/
Release Notes:
http://people.apache.org/~niallp/io-2.0-rc3/RELEASE-NOTES.txt
Site:
http://people.apache.org/~niallp/io-2.0-rc3/site/
Maven Stuff:
http://people.apache.org/~niallp/io-2.0-rc3/maven/
Some Notes:
* There is one error on the clirr report - which is a false positive
(a generic method that is erased)
http://people.apache.org/~niallp/io-2.0-rc3/site/clirr-report.html
* Links to the JavaDoc versions on the site don't work (they will when
its deployed to the right location)
Thanks
Niall
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org