Eliminate warnings on `sbt doc` and `sbt unidoc` (#1470)

* Eliminate warnings on `sbt doc` and `sbt unidoc`
- removed toFirrtl reference on MultiTargetAnnotation
- lots of places where package path has to be added to comment references
- Change to use `/** text starts here` convention when wrong in comment with a doc fix.
  - Did not exhaustively change these
- Wrestled doc example in RenderDiGraph#renderNode, not sure if I won
- Cleaned up InferWidths & CatchExceptions imports
- Added missing license message to a couple of files.
- fixed a couple of stale parameter names in scaladoc
- Added @unchecked to stop erasure warning in Emitting where emission annotations are collected
- Change types to [_] on match in RenameMap#recordAll to fix erasure warning

* Where  possible change [[firrtl.ir.X]] to [[firrtl.ir.X X]] for better display in scaladoc

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

1 files changed, 11 insertions, 19 deletions

diff --git a/src/main/scala/firrtl/transforms/PropagatePresetAnnotations.scala b/src/main/scala/firrtl/transforms/PropagatePresetAnnotations.scala
index 92022278..f36ee5e0 100644
--- a/src/main/scala/firrtl/transforms/PropagatePresetAnnotations.scala
+++ b/src/main/scala/firrtl/transforms/PropagatePresetAnnotations.scala
@@ -3,13 +3,9 @@
 package firrtl
 package transforms
 
-import firrtl.{Utils}
-
-
 import firrtl.PrimOps._
-import firrtl.ir._
-import firrtl.ir.{AsyncResetType}
 import firrtl.annotations._
+import firrtl.ir.{AsyncResetType, _}
 import firrtl.options.{Dependency, PreservesAll}
 
 import scala.collection.mutable
@@ -72,8 +68,8 @@ class PropagatePresetAnnotations extends Transform with PreservesAll[Transform]
     *     - Annotate all leaf register with PresetRegAnnotation
     *     - Annotate all intermediate wire, node, connect with PresetConnectorAnnotation
     *
-    * @param circuit the circuit
-    * @param annotations all the annotations
+    * @param cs the circuit state
+    * @param presetAnnos all the annotations
     * @return updated annotations
     */
   private def propagate(cs: CircuitState, presetAnnos: Seq[PresetAnnotation]): AnnotationSeq = {
@@ -93,8 +89,7 @@ class PropagatePresetAnnotations extends Transform with PreservesAll[Transform]
     * WALK I PHASE 1 FUNCTIONS
     */
 
-    /**
-      * Walk current module
+    /* Walk current module
       *  - process ports
       *     - store connections & entry points for PHASE 2
       *  - process statements
@@ -109,14 +104,13 @@ class PropagatePresetAnnotations extends Transform with PreservesAll[Transform]
       val moduleTarget = circuitTarget.module(m.name)
       val localInstances = new TargetMap()
 
-      /**
-        * Recursively process a given type
+      /* Recursively process a given type
         * Recursive on Bundle and Vector Type only
         * Store Register and Connections for AsyncResetType
-        *
-        * @param tpe Type to be processed
-        * @param target ReferenceTarget associated to the tpe
-        * @param all Boolean indicating whether all subelements of the current tpe should also be stored as Annotated AsyncReset entry points
+        * @param tpe [[Type]] to be processed
+        * @param target [[ReferenceTarget]] associated to the tpe
+        * @param all Boolean indicating whether all subelements of the current
+        *            tpe should also be stored as Annotated AsyncReset entry points
         */
       def processType(tpe: Type, target: ReferenceTarget, all: Boolean): Unit = {
         if(tpe == AsyncResetType){
@@ -149,13 +143,11 @@ class PropagatePresetAnnotations extends Transform with PreservesAll[Transform]
         processType(w.tpe, target, presets.contains(target))
       }
 
-      /**
-        * Recursively search for the ReferenceTarget of a given Expression
-        *
+      /*  Recursively search for the ReferenceTarget of a given Expression
         * @param e Targeted Expression
         * @param ta Local ReferenceTarget of the Targeted Expression
         * @return a ReferenceTarget in case of success, a GenericTarget otherwise
-        * @throw Internal Error on unexpected recursive path return results
+        * @throws [[InternalError]] on unexpected recursive path return results
         */
       def getRef(e: Expression, ta: ReferenceTarget, annoCo: Boolean = false) : Target = {
         e match {