archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 06:45:07 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8241760: Typos: empty lines in javadoc, inconsistent indents, etc. (net and nio)

Browse source 
Reviewed-by: alanb, prappo, dfuchs
This commit is contained in:
Ivan Gerasimov 2020-03-30 13:59:16 -07:00
parent 916f00acc1
commit 53b2368d49
25 changed files with 107 additions and 99 deletions
Download patch file Download diff file Expand all files Collapse all files

14
src/java.base/share/classes/java/net/HttpURLConnection.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2020, 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
@ -424,11 +424,11 @@ public abstract class HttpURLConnection extends URLConnection {
* @see #getInstanceFollowRedirects
* @since 1.3
*/
public void setInstanceFollowRedirects(boolean followRedirects) {
public void setInstanceFollowRedirects(boolean followRedirects) {
instanceFollowRedirects = followRedirects;
}
}
/**
/**
* Returns the value of this {@code HttpURLConnection}'s
* {@code instanceFollowRedirects} field.
*
@ -438,9 +438,9 @@ public abstract class HttpURLConnection extends URLConnection {
* @see #setInstanceFollowRedirects(boolean)
* @since 1.3
*/
public boolean getInstanceFollowRedirects() {
return instanceFollowRedirects;
}
public boolean getInstanceFollowRedirects() {
return instanceFollowRedirects;
}
/**
* Set the method for the URL request, one of:

4
src/java.base/share/classes/java/net/Inet4Address.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2020, 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
@ -51,7 +51,7 @@ import java.io.ObjectStreamException;
* <p> When four parts are specified, each is interpreted as a byte of
* data and assigned, from left to right, to the four bytes of an IPv4
* address.
*
* <p> When a three part address is specified, the last part is
* interpreted as a 16-bit quantity and placed in the right most two
* bytes of the network address. This makes the three part address

4
src/java.base/share/classes/java/net/NetPermission.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2020, 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
@ -164,7 +164,7 @@ import java.util.StringTokenizer;
* creating a ProtectionDomain/CodeSource for a class even though
* that class really didn't come from that location.</td>
* </tr>
</tbody>
* </tbody>
* </table>
*
* @implNote

4
src/java.base/share/classes/java/net/Proxy.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2020, 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
@ -131,7 +131,7 @@ public class Proxy {
return type() + " @ " + address();
}
/**
/**
* Compares this object against the specified object.
* The result is {@code true} if and only if the argument is
* not {@code null} and it represents the same proxy as

4
src/java.base/share/classes/java/net/SecureCacheResponse.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2020, 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
@ -93,7 +93,7 @@ public abstract class SecureCacheResponse extends CacheResponse {
public abstract Principal getPeerPrincipal()
throws SSLPeerUnverifiedException;
/**
/**
* Returns the principal that was sent to the server during
* handshaking in the original connection that retrieved the
* network resource.

3
src/java.base/share/classes/java/net/Socket.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1995, 2020, 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
@ -821,7 +821,6 @@ public class Socket implements java.io.Closeable {
* then this method will continue to return the connected address
* after the socket is closed.
*
* @return a {@code SocketAddress} representing the remote endpoint of this
* socket, or {@code null} if it is not connected yet.
* @see #getInetAddress()

4
src/java.base/share/classes/java/net/SocketImpl.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1995, 2020, 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
@ -187,7 +187,7 @@ public abstract class SocketImpl implements SocketOptions {
* @return a stream for reading from this socket.
* @throws IOException if an I/O error occurs when creating the
* input stream.
*/
*/
protected abstract InputStream getInputStream() throws IOException;
/**

6
src/java.base/share/classes/java/net/URL.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1995, 2020, 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
@ -414,7 +414,7 @@ public final class URL implements java.io.Serializable {
* @param file the file on the host
* @param handler the stream handler for the URL.
* @throws MalformedURLException if an unknown protocol or the port
is a negative number other than -1
* is a negative number other than -1
* @throws SecurityException
* if a security manager exists and its
* {@code checkPermission} method doesn't allow
@ -781,7 +781,7 @@ public final class URL implements java.io.Serializable {
*
* @param protocol the name of the protocol to use
* @param host the name of the host
@param port the port number on the host
* @param port the port number on the host
* @param file the file on the host
* @param ref the internal reference in the URL
*/

34
src/java.base/share/classes/java/net/URLConnection.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1995, 2020, 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
@ -157,7 +157,7 @@ import sun.security.action.GetPropertyAction;
*/
public abstract class URLConnection {
/**
/**
* The URL represents the remote object on the World Wide Web to
* which this connection is opened.
* <p>
@ -172,7 +172,7 @@ public abstract class URLConnection {
*/
protected URL url;
/**
/**
* This variable is set by the {@code setDoInput} method. Its
* value is returned by the {@code getDoInput} method.
* <p>
@ -187,7 +187,7 @@ public abstract class URLConnection {
*/
protected boolean doInput = true;
/**
/**
* This variable is set by the {@code setDoOutput} method. Its
* value is returned by the {@code getDoOutput} method.
* <p>
@ -204,7 +204,7 @@ public abstract class URLConnection {
private static boolean defaultAllowUserInteraction = false;
/**
/**
* If {@code true}, this {@code URL} is being examined in
* a context in which it makes sense to allow user interactions such
* as popping up an authentication dialog. If {@code false},
@ -225,7 +225,7 @@ public abstract class URLConnection {
private static volatile boolean defaultUseCaches = true;
/**
/**
* If {@code true}, the protocol is allowed to use caching
* whenever it can. If {@code false}, the protocol must always
* try to get a fresh copy of the object.
@ -248,7 +248,7 @@ public abstract class URLConnection {
private static final ConcurrentHashMap<String,Boolean> defaultCaching =
new ConcurrentHashMap<>();
/**
/**
* Some protocols support skipping the fetching of the object unless
* the object has been modified more recently than a certain time.
* <p>
@ -268,7 +268,7 @@ public abstract class URLConnection {
*/
protected long ifModifiedSince = 0;
/**
/**
* If {@code false}, this connection object has not created a
* communications link to the specified URL. If {@code true},
* the communications link has been established.
@ -286,9 +286,9 @@ public abstract class URLConnection {
*/
private MessageHeader requests;
/**
* @since 1.1
*/
/**
* @since 1.1
*/
private static volatile FileNameMap fileNameMap;
/**
@ -372,7 +372,7 @@ public abstract class URLConnection {
* connection can be established, a
* java.net.SocketTimeoutException is raised. A timeout of zero is
* interpreted as an infinite timeout.
*
* <p> Some non-standard implementation of this method may ignore
* the specified timeout. To see the connect timeout set, please
* call getConnectTimeout().
@ -416,7 +416,7 @@ public abstract class URLConnection {
* for read, a java.net.SocketTimeoutException is raised. A
* timeout of zero is interpreted as an infinite timeout.
*
*<p> Some non-standard implementation of this method ignores the
* <p> Some non-standard implementation of this method ignores the
* specified timeout. To see the read timeout set, please call
* getReadTimeout().
*
@ -1032,7 +1032,7 @@ public abstract class URLConnection {
return ifModifiedSince;
}
/**
/**
* Returns the default value of a {@code URLConnection}'s
* {@code useCaches} flag.
* <p>
@ -1049,7 +1049,7 @@ public abstract class URLConnection {
return defaultUseCaches;
}
/**
/**
* Sets the default value of the {@code useCaches} field to the
* specified value. This default value can be over-ridden
* per protocol using {@link #setDefaultUseCaches(String,boolean)}
@ -1061,7 +1061,7 @@ public abstract class URLConnection {
defaultUseCaches = defaultusecaches;
}
/**
/**
* Sets the default value of the {@code useCaches} field for the named
* protocol to the given value. This value overrides any default setting
* set by {@link #setDefaultUseCaches(boolean)} for the given protocol.
@ -1078,7 +1078,7 @@ public abstract class URLConnection {
defaultCaching.put(protocol, defaultVal);
}
/**
/**
* Returns the default value of the {@code useCaches} flag for the given protocol. If
* {@link #setDefaultUseCaches(String,boolean)} was called for the given protocol,
* then that value is returned. Otherwise, if {@link #setDefaultUseCaches(boolean)}