diff --git a/make/scripts/genExceptions.sh b/make/scripts/genExceptions.sh index 68f545457ed..4f6c0d9820b 100644 --- a/make/scripts/genExceptions.sh +++ b/make/scripts/genExceptions.sh @@ -1,6 +1,6 @@ #! /bin/sh # -# Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. +# Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved. # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. # # This code is free software; you can redistribute it and/or modify it @@ -68,6 +68,9 @@ __END__ cat >>$out <<__END__ + /** + * The $ARG_PHRASE. + */ private $ARG_TYPE $ARG_ID; /** diff --git a/src/java.base/share/classes/java/nio/charset/MalformedInputException.java b/src/java.base/share/classes/java/nio/charset/MalformedInputException.java index b29564ae794..37e20040dd5 100644 --- a/src/java.base/share/classes/java/nio/charset/MalformedInputException.java +++ b/src/java.base/share/classes/java/nio/charset/MalformedInputException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -41,6 +41,9 @@ public class MalformedInputException @java.io.Serial private static final long serialVersionUID = -3438823399834806194L; + /** + * The length of the input. + */ private int inputLength; /** diff --git a/src/java.base/share/classes/java/nio/charset/UnmappableCharacterException.java b/src/java.base/share/classes/java/nio/charset/UnmappableCharacterException.java index a307e0a783e..c5fddd1684f 100644 --- a/src/java.base/share/classes/java/nio/charset/UnmappableCharacterException.java +++ b/src/java.base/share/classes/java/nio/charset/UnmappableCharacterException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2001, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2001, 2021, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -41,6 +41,9 @@ public class UnmappableCharacterException @java.io.Serial private static final long serialVersionUID = -7026962371537706123L; + /** + * The length of the input character (or byte) sequence. + */ private int inputLength; /** diff --git a/src/java.base/share/classes/java/nio/charset/exceptions b/src/java.base/share/classes/java/nio/charset/exceptions index 22dfa3ca621..c4773090ae0 100644 --- a/src/java.base/share/classes/java/nio/charset/exceptions +++ b/src/java.base/share/classes/java/nio/charset/exceptions @@ -1,5 +1,5 @@ # -# Copyright (c) 2000, 2007, Oracle and/or its affiliates. All rights reserved. +# Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved. # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. # # This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ SINCE=1.4 PACKAGE=java.nio.charset # This year should only change if the generated source is modified. -COPYRIGHT_YEARS="2000, 2007," +COPYRIGHT_YEARS="2000, 2021," SUPER=java.io.IOException diff --git a/src/java.base/share/classes/java/nio/exceptions b/src/java.base/share/classes/java/nio/exceptions index d8cba29cc2d..7465cdbed78 100644 --- a/src/java.base/share/classes/java/nio/exceptions +++ b/src/java.base/share/classes/java/nio/exceptions @@ -1,5 +1,5 @@ # -# Copyright (c) 2000, 2007, Oracle and/or its affiliates. All rights reserved. +# Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved. # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. # # This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ SINCE=1.4 PACKAGE=java.nio # This year should only change if the generated source is modified. -COPYRIGHT_YEARS="2000, 2007," +COPYRIGHT_YEARS="2000, 2021," SUPER=RuntimeException diff --git a/src/java.base/share/classes/java/nio/file/DirectoryIteratorException.java b/src/java.base/share/classes/java/nio/file/DirectoryIteratorException.java index 158ac728222..51fb08759e0 100644 --- a/src/java.base/share/classes/java/nio/file/DirectoryIteratorException.java +++ b/src/java.base/share/classes/java/nio/file/DirectoryIteratorException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2021, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -73,9 +73,19 @@ public final class DirectoryIteratorException /** * Called to read the object from a stream. * + * @param s + * the {@code ObjectInputStream} to read + * * @throws InvalidObjectException * if the object is invalid or has a cause that is not * an {@code IOException} + * + * @throws IOException + * if an I/O error occurs + * + * @throws ClassNotFoundException + * if the class of a serialized object could not be + * found */ @java.io.Serial private void readObject(ObjectInputStream s) diff --git a/src/java.base/share/classes/java/nio/file/FileSystemException.java b/src/java.base/share/classes/java/nio/file/FileSystemException.java index f6cadfb0f10..a03a2708ce6 100644 --- a/src/java.base/share/classes/java/nio/file/FileSystemException.java +++ b/src/java.base/share/classes/java/nio/file/FileSystemException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2007, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2007, 2021, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -40,7 +40,15 @@ public class FileSystemException @java.io.Serial static final long serialVersionUID = -3055425747967319812L; + /** + * String identifying the file or {@code null} if not known. + */ private final String file; + + /** + * String identifying the other file or {@code null} if there isn't + * another file or if not known. + */ private final String other; /** diff --git a/src/java.base/share/classes/java/nio/file/InvalidPathException.java b/src/java.base/share/classes/java/nio/file/InvalidPathException.java index c3ceea4d24e..bb28b61b83b 100644 --- a/src/java.base/share/classes/java/nio/file/InvalidPathException.java +++ b/src/java.base/share/classes/java/nio/file/InvalidPathException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2007, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2007, 2021, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -39,7 +39,15 @@ public class InvalidPathException @java.io.Serial static final long serialVersionUID = 4355821422286746137L; + /** + * The input string. + */ private String input; + + /** + * The index of the input string at which the error occurred or + * {@code -1} if not known. + */ private int index; /** diff --git a/src/java.base/share/classes/java/nio/file/attribute/UserPrincipalNotFoundException.java b/src/java.base/share/classes/java/nio/file/attribute/UserPrincipalNotFoundException.java index 511dcda1525..209453cdaad 100644 --- a/src/java.base/share/classes/java/nio/file/attribute/UserPrincipalNotFoundException.java +++ b/src/java.base/share/classes/java/nio/file/attribute/UserPrincipalNotFoundException.java @@ -40,6 +40,9 @@ public class UserPrincipalNotFoundException @java.io.Serial static final long serialVersionUID = -5369283889045833024L; + /** + * The user principal name. + */ private final String name; /**