[VOTE] Release Commons IO 2.0 based on RC3

classic Classic list List threaded Threaded
21 messages Options
12
Reply | Threaded
Open this post in threaded view
|

[VOTE] Release Commons IO 2.0 based on RC3

Niall Pemberton
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: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: [VOTE] Release Commons IO 2.0 based on RC3

Gary Gregory
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: [hidden email]
Web: seagull.rocketsoftware.com 



-----Original Message-----
From: Niall Pemberton [mailto:[hidden email]]
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: [hidden email]
For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [VOTE] Release Commons IO 2.0 based on RC3

Niall Pemberton
On Sun, Oct 10, 2010 at 9:38 AM, Gary Gregory
<[hidden email]> 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: [hidden email]
> Web: seagull.rocketsoftware.com
>
>
>
> -----Original Message-----
> From: Niall Pemberton [mailto:[hidden email]]
> 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: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [VOTE] Release Commons IO 2.0 based on RC3

Niall Pemberton
In reply to this post by Niall Pemberton
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
<[hidden email]> 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: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: [VOTE] Release Commons IO 2.0 based on RC3

Gary Gregory
In reply to this post by Niall Pemberton
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: [hidden email]
Web: seagull.rocketsoftware.com 



-----Original Message-----
From: Niall Pemberton [mailto:[hidden email]]
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: [hidden email]
For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [VOTE] Release Commons IO 2.0 based on RC3

Niall Pemberton
On Mon, Oct 11, 2010 at 3:58 AM, Gary Gregory
<[hidden email]> 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:[hidden email]]
> 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: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Gary Gregory
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:[hidden email]]
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
<[hidden email]> 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:[hidden email]]
> 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: [hidden email]
For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Gary Gregory
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: [hidden email]
Web: seagull.rocketsoftware.com 



-----Original Message-----
From: Gary Gregory [mailto:[hidden email]]
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:[hidden email]]
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
<[hidden email]> 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:[hidden email]]
> 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: [hidden email]
For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Matt Benson-2
In reply to this post by Gary Gregory

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:[hidden email]]
> 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
> <[hidden email]> 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:[hidden email]]
>> 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: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: [VOTE] Release Commons IO 2.0 based on RC4

Gary Gregory
In reply to this post by Niall Pemberton
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: [hidden email]
Web: seagull.rocketsoftware.com 


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: [VOTE] Release Commons IO 2.0 based on RC4

Gary Gregory
In reply to this post by Niall Pemberton
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: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [VOTE] Release Commons IO 2.0 based on RC4

Niall Pemberton
On Tue, Oct 12, 2010 at 12:11 AM, Gary Gregory
<[hidden email]> 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: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: [VOTE] Release Commons IO 2.0 based on RC4

Gary Gregory
> -----Original Message-----
> From: Niall Pemberton [mailto:[hidden email]]
> 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
> <[hidden email]> 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: [hidden email]
> For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Niall Pemberton
In reply to this post by Matt Benson-2
On Mon, Oct 11, 2010 at 8:37 PM, Matt Benson <[hidden email]> 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:[hidden email]]
>> 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
>> <[hidden email]> 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:[hidden email]]
>>> 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: [hidden email]
>> For additional commands, e-mail: [hidden email]
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [hidden email]
>> For additional commands, e-mail: [hidden email]
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

jodastephen
On 12 October 2010 00:29, Niall Pemberton <[hidden email]> 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: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Martin Cooper-3
In reply to this post by Gary Gregory
On Mon, Oct 11, 2010 at 9:49 AM, Gary Gregory
<[hidden email]> 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:[hidden email]]
> 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
> <[hidden email]> 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:[hidden email]]
>> 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: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Gary Gregory
In reply to this post by Niall Pemberton
> -----Original Message-----
> From: Niall Pemberton [mailto:[hidden email]]
> 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 <[hidden email]> 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:[hidden email]]
> >> 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
> >> <[hidden email]> 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:[hidden email]]
> >>> 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: [hidden email]
> >> For additional commands, e-mail: [hidden email]
> >>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: [hidden email]
> >> For additional commands, e-mail: [hidden email]
> >>
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [hidden email]
> > For additional commands, e-mail: [hidden email]
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Gary Gregory
In reply to this post by jodastephen
> -----Original Message-----
> From: [hidden email] [mailto:[hidden email]] 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 <[hidden email]> 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: [hidden email]
> For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Gary Gregory
In reply to this post by Martin Cooper-3
> -----Original Message-----
> From: [hidden email] [mailto:[hidden email]] 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
> <[hidden email]> 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:[hidden email]]
> > 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
> > <[hidden email]> 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:[hidden email]]
> >> 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: [hidden email]
> > For additional commands, e-mail: [hidden email]
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [hidden email]
> > For additional commands, e-mail: [hidden email]
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: Weird class names [WAS RE: [VOTE] Release Commons IO 2.0 based on RC3]

Torsten Curdt-3
On Tue, Oct 12, 2010 at 20:43, Gary Gregory
<[hidden email]> wrote:

>> -----Original Message-----
>> From: [hidden email] [mailto:[hidden email]] 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
>> <[hidden email]> 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: [hidden email]
For additional commands, e-mail: [hidden email]

12