Fixed javadocs.

Change-Id: I6c0e5f59138ee024a858994a290da75a0f54a71f

@@ -27,6 +27,9 @@ import static com.google.common.base.Preconditions.checkNotNull;
  */
 public final class TunnelPolicy implements Policy {
 
+    // FIXME: We should avoid passing around references to implementation objects
+    // Instead, if some operational context is required, we should abstract it to
+    // a bare minimum.
     private final SegmentRoutingManager srManager;
     private final Type type;
     private final String id;
@@ -61,6 +64,7 @@ public final class TunnelPolicy implements Policy {
     /**
      * Creates a TunnelPolicy reference.
      *
+     * @param srm reference to the segment routing component
      * @param p TunnelPolicy reference
      */
     public TunnelPolicy(SegmentRoutingManager srm, TunnelPolicy p) {

@@ -141,7 +141,7 @@ public final class Frequency implements RichComparable<Frequency> {
     /**
      * Returns a Frequency whose value is Math.floorDiv(this, value).
      *
-     * @param value
+     * @param value value to be divided by this Frequency
      * @return Math.floorDiv(this, value)
      */
     public Frequency floorDivision(long value) {

@@ -100,6 +100,7 @@ public class IOLoopMessaging implements MessagingService {
     /**
      * Activates IO Loops.
      *
+     * @param localEp local end-point
      * @throws IOException is activation fails
      */
     public void start(Endpoint localEp) throws IOException {