Move docs -> class level javadoc

okhttp-clients/src/main/java/com/palantir/remoting3/okhttp/ImmutableSampleWindow.java

@@ -14,12 +14,6 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
- * Changes made:
- *
- * 1. Package was changed.
- * 2. Fields made private.
- * 3. Fixed a typo.
  */
 package com.palantir.remoting3.okhttp;
 
@@ -28,7 +22,11 @@
 /**
  * Class used to track immutable samples in an AtomicReference.
  *
- * See {@link com.netflix.concurrency.limits.limit.ImmutableSampleWindow}
+ * Changes made to {@link com.netflix.concurrency.limits.limit.ImmutableSampleWindow}
+ *
+ * 1. Package was changed.
+ * 2. Fields made private.
+ * 3. Fixed a typo (getAverateRttNanos -> getAverageRttNanos)
  */
 final class ImmutableSampleWindow {
     private final long minRtt;

okhttp-clients/src/main/java/com/palantir/remoting3/okhttp/RemotingBlockingLimiter.java

@@ -14,13 +14,6 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
- * This limiter has been forked from Netflix's implementation. Changes are:
- * 1. Palantir license.
- * 2. Codestyle.
- * 3. Made package private.
- * 4. Modified to support a 'timeout', rather than blocking forever.
- * 5. Renamed to RemotingBlockingLimiter and changed package in order to avoid ambiguity.
  */
 package com.palantir.remoting3.okhttp;
 
@@ -34,6 +27,15 @@
  * {@link Limiter} that blocks the caller when the limit has been reached.  The caller is
  * blocked until the limiter has been released.  This limiter is commonly used in batch
  * clients that use the limiter as a back-pressure mechanism.
+ *
+ * This limiter has been forked from Netflix's {@link com.netflix.concurrency.limits.limiter.BlockingLimiter}.
+ *
+ * Changes are:
+ * 1. Modified to support a 'timeout', rather than blocking forever.
+ * 2. Codestyle.
+ * 3. Made package private.
+ * 4. Palantir license.
+ * 5. Renamed to RemotingBlockingLimiter and changed package in order to avoid ambiguity.
  * <p>
  * TODO(j-baker): Remove once https://github.com/Netflix/concurrency-limits/pull/78 is merged and released.
  */

okhttp-clients/src/main/java/com/palantir/remoting3/okhttp/RemotingWindowedLimit.java

@@ -14,13 +14,6 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
- * Changes made from WindowedLimit:
- *
- * 1. Change package and make package private.
- * 2. Code style.
- * 3. Modify to reduce window size whenever a dropped sample is seen, rather than awaiting the whole window.
- * 4. Inlined constants.
  */
 package com.palantir.remoting3.okhttp;
 
@@ -29,6 +22,14 @@
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Consumer;
 
+/**
+ * Changes made from {@link com.netflix.concurrency.limits.limit.WindowedLimit}:
+ *
+ *  1. Modify to reduce window size whenever a dropped sample is seen, rather than awaiting the whole window.
+ *  2. Change package and make package private.
+ *  3. Code style.
+ *  4. Inlined constants.
+ */
 class RemotingWindowedLimit implements Limit {
     private static final long MIN_WINDOW_TIME = TimeUnit.SECONDS.toNanos(1);
     private static final long MAX_WINDOW_TIME = TimeUnit.SECONDS.toNanos(1);