summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSchuyler Eldridge2020-03-30 18:03:14 -0400
committerGitHub2020-03-30 22:03:14 +0000
commita18515b79bd90e7296451c7cc0bb08834c1b7aca (patch)
treecb82548ad8223817a2b970b0744291b84880e997
parent8903cb10073b22ab7a3313853d1a627fc22dcccf (diff)
Java API Documents Linking (#1367)
* Show linking against Javadoc Signed-off-by: Schuyler Eldridge <schuyler.eldridge@ibm.com> * Add sbt-api-mappings plugin This adds the sbt-api-mappings plugin which enables auto-linking (properly setting the apiMappings for the sbt project) so that Scaldoc/unidoc generation will now automatically link against Java and Scala API docs (and use the right version). Signed-off-by: Schuyler Eldridge <schuyler.eldridge@ibm.com> * Show linking against Scala APIs Signed-off-by: Schuyler Eldridge <schuyler.eldridge@ibm.com>
-rw-r--r--core/src/main/scala/chisel3/package.scala2
-rw-r--r--project/plugins.sbt1
-rw-r--r--src/main/scala/chisel3/util/Bitwise.scala1
3 files changed, 3 insertions, 1 deletions
diff --git a/core/src/main/scala/chisel3/package.scala b/core/src/main/scala/chisel3/package.scala
index 65bfdeb7..cf0afb10 100644
--- a/core/src/main/scala/chisel3/package.scala
+++ b/core/src/main/scala/chisel3/package.scala
@@ -11,7 +11,7 @@ package object chisel3 { // scalastyle:ignore package.object.name
import scala.language.implicitConversions
/**
- * These implicit classes allow one to convert scala.Int|scala.BigInt to
+ * These implicit classes allow one to convert [[scala.Int]] or [[scala.BigInt]] to
* Chisel.UInt|Chisel.SInt by calling .asUInt|.asSInt on them, respectively.
* The versions .asUInt(width)|.asSInt(width) are also available to explicitly
* mark a width for the new literal.
diff --git a/project/plugins.sbt b/project/plugins.sbt
index 6326ba99..aec0ec01 100644
--- a/project/plugins.sbt
+++ b/project/plugins.sbt
@@ -14,3 +14,4 @@ addSbtPlugin("com.eed3si9n" % "sbt-buildinfo" % "0.9.0")
addSbtPlugin("com.eed3si9n" % "sbt-unidoc" % "0.4.3")
+addSbtPlugin("com.thoughtworks.sbt-api-mappings" % "sbt-api-mappings" % "3.0.0")
diff --git a/src/main/scala/chisel3/util/Bitwise.scala b/src/main/scala/chisel3/util/Bitwise.scala
index bbed5f07..4681b34a 100644
--- a/src/main/scala/chisel3/util/Bitwise.scala
+++ b/src/main/scala/chisel3/util/Bitwise.scala
@@ -61,6 +61,7 @@ object Fill {
/** Create n repetitions of x using a tree fanout topology.
*
* Output data-equivalent to x ## x ## ... ## x (n repetitions).
+ * @throws java.lang.IllegalArgumentException if `n` is less than zero
*/
def apply(n: Int, x: UInt): UInt = {
n match {