Merge branch '3.5.x' into 3.5-release

1 files changed, 22 insertions, 0 deletions

diff --git a/src/main/scala/chisel3/verilog.scala b/src/main/scala/chisel3/verilog.scala
index b926a15c..c301ff98 100644
--- a/src/main/scala/chisel3/verilog.scala
+++ b/src/main/scala/chisel3/verilog.scala
@@ -4,7 +4,29 @@ import chisel3.stage.ChiselStage
 import firrtl.AnnotationSeq
 
 object getVerilogString {
+
+  /**
+    * Returns a string containing the Verilog for the module specified by
+    * the target.
+    *
+    * @param gen the module to be converted to Verilog
+    * @return a string containing the Verilog for the module specified by
+    *         the target
+    */
   def apply(gen: => RawModule): String = ChiselStage.emitVerilog(gen)
+
+  /**
+    * Returns a string containing the Verilog for the module specified by
+    * the target accepting arguments and annotations
+    *
+    * @param gen the module to be converted to Verilog
+    * @param args arguments to be passed to the compiler
+    * @param annotations annotations to be passed to the compiler
+    * @return a string containing the Verilog for the module specified by
+    *         the target
+    */
+  def apply(gen: => RawModule, args: Array[String] = Array.empty, annotations: AnnotationSeq = Seq.empty): String =
+    (new ChiselStage).emitVerilog(gen, args, annotations)
 }
 
 object emitVerilog {