RFR: 8150856 - Inconsistent API documentation for @param caller in System.LoggerFinder.getLogger
Daniel Fuchs
daniel.fuchs at oracle.com
Mon Feb 29 17:46:52 UTC 2016
Hi,
Please find below a trivial fix for:
https://bugs.openjdk.java.net/browse/JDK-8150856
8150856: Inconsistent API documentation for @param caller
in System.LoggerFinder.getLogger
http://cr.openjdk.java.net/~dfuchs/webrev_8150856/webrev.00
The @param caller clause says that caller can be null, whereas
the @throws clause says that NPE will be thrown.
The @throws clause is correct and @param needs to be fixed.
best regards,
-- daniel
--- old/src/java.base/share/classes/java/lang/System.java 2016-02-29
18:41:30.000000000 +0100
+++ new/src/java.base/share/classes/java/lang/System.java 2016-02-29
18:41:30.000000000 +0100
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights
reserved.
+ * Copyright (c) 1994, 2016, 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
@@ -1419,7 +1419,6 @@
*
* @param name the name of the logger.
* @param caller the class for which the logger is being
requested;
- * can be {@code null}.
*
* @return a {@link Logger logger} suitable for the given caller's
* use.
More information about the core-libs-dev
mailing list