documentation

I've recently discovered that the https://www.hdfgroup.org/products/java/hdf-java-html/javadocs/ncsa/hdf/object/FileFormat.html#isThisType(java.lang.String) method opens the file that is being checked and doesn't close it.... or so it seems to me, at least. The documentation (Javadoc) for this method doesn't say this and it took some debugging to figure out why I had open resources. Can the documentation be updated to reflect this, to spare others the same problem in the future?

Thanks,
Sarah

Hi Sarah,

Which version of HDF-Java are you using and what platform are you on?
Thanks!

-Barbara

···

From: Hdf-forum [mailto:hdf-forum-bounces@lists.hdfgroup.org] On Behalf Of Jaworski, Sarah S
Sent: Wednesday, April 20, 2016 1:02 PM
To: HDF Users Discussion List
Subject: [Hdf-forum] documentation

I've recently discovered that the https://www.hdfgroup.org/products/java/hdf-java-html/javadocs/ncsa/hdf/object/FileFormat.html#isThisType(java.lang.String) method opens the file that is being checked and doesn't close it.... or so it seems to me, at least. The documentation (Javadoc) for this method doesn't say this and it took some debugging to figure out why I had open resources. Can the documentation be updated to reflect this, to spare others the same problem in the future?

Thanks,
Sarah

Currently using version 2.7. We are trying to upgrade to a later version now, but are running into some problems that we need to sort through.

Since I posted this, we've found that the problem we're seeing (resources not being closed) is intermittent, so we are no longer convinced that it's a result of isThisType not closing the file. It just seemed like that because we put a close in after and things worked... for a while. It was most likely a coincidence. It may be something we're doing. I'm not sure at this time.

···

From: Hdf-forum [mailto:hdf-forum-bounces@lists.hdfgroup.org] On Behalf Of Barbara Jones
Sent: Thursday, April 21, 2016 12:09 PM
To: HDF Users Discussion List <hdf-forum@lists.hdfgroup.org>
Subject: EXTERNAL: Re: [Hdf-forum] documentation

Hi Sarah,

Which version of HDF-Java are you using and what platform are you on?
Thanks!

-Barbara

From: Hdf-forum [mailto:hdf-forum-bounces@lists.hdfgroup.org] On Behalf Of Jaworski, Sarah S
Sent: Wednesday, April 20, 2016 1:02 PM
To: HDF Users Discussion List
Subject: [Hdf-forum] documentation

I've recently discovered that the https://www.hdfgroup.org/products/java/hdf-java-html/javadocs/ncsa/hdf/object/FileFormat.html#isThisType(java.lang.String) method opens the file that is being checked and doesn't close it.... or so it seems to me, at least. The documentation (Javadoc) for this method doesn't say this and it took some debugging to figure out why I had open resources. Can the documentation be updated to reflect this, to spare others the same problem in the future?

Thanks,
Sarah