More JavaDoc tweaks, and suppress deprecated warnings where these are expected

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1540989 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Nick Burch 2013-11-12 09:55:46 +00:00
parent 1e0b6afd1b
commit f138584877
1 changed files with 9 additions and 4 deletions

View File

@ -58,8 +58,9 @@ public final class ZipPackage extends Package {
private final ZipEntrySource zipArchive; private final ZipEntrySource zipArchive;
/** /**
* Constructor. Creates a new ZipPackage. * Constructor. Creates a new, empty ZipPackage.
*/ */
@SuppressWarnings("deprecation")
public ZipPackage() { public ZipPackage() {
super(defaultPackageAccess); super(defaultPackageAccess);
this.zipArchive = null; this.zipArchive = null;
@ -77,6 +78,7 @@ public final class ZipPackage extends Package {
* If the specified input stream not an instance of * If the specified input stream not an instance of
* ZipInputStream. * ZipInputStream.
*/ */
@SuppressWarnings("deprecation")
ZipPackage(InputStream in, PackageAccess access) throws IOException { ZipPackage(InputStream in, PackageAccess access) throws IOException {
super(access); super(access);
this.zipArchive = new ZipInputStreamZipEntrySource( this.zipArchive = new ZipInputStreamZipEntrySource(
@ -85,7 +87,7 @@ public final class ZipPackage extends Package {
} }
/** /**
* Constructor. Opens a Zip based Open XML document from a File. * Constructor. Opens a Zip based Open XML document from a file.
* *
* @param path * @param path
* The path of the file to open or create. * The path of the file to open or create.
@ -94,6 +96,7 @@ public final class ZipPackage extends Package {
* @throws InvalidFormatException * @throws InvalidFormatException
* If the content type part parsing encounters an error. * If the content type part parsing encounters an error.
*/ */
@SuppressWarnings("deprecation")
ZipPackage(String path, PackageAccess access) { ZipPackage(String path, PackageAccess access) {
super(access); super(access);
@ -110,7 +113,7 @@ public final class ZipPackage extends Package {
} }
/** /**
* Constructor. Opens a Zip based Open XML document. * Constructor. Opens a Zip based Open XML document from a File.
* *
* @param file * @param file
* The file to open or create. * The file to open or create.
@ -119,6 +122,7 @@ public final class ZipPackage extends Package {
* @throws InvalidFormatException * @throws InvalidFormatException
* If the content type part parsing encounters an error. * If the content type part parsing encounters an error.
*/ */
@SuppressWarnings("deprecation")
ZipPackage(File file, PackageAccess access) { ZipPackage(File file, PackageAccess access) {
super(access); super(access);
@ -146,7 +150,8 @@ public final class ZipPackage extends Package {
* @throws InvalidFormatException * @throws InvalidFormatException
* If the content type part parsing encounters an error. * If the content type part parsing encounters an error.
*/ */
ZipPackage(ZipEntrySource zipEntry, PackageAccess access) { @SuppressWarnings("deprecation")
ZipPackage(ZipEntrySource zipEntry, PackageAccess access) {
super(access); super(access);
this.zipArchive = zipEntry; this.zipArchive = zipEntry;
} }