aboutsummaryrefslogtreecommitdiff
path: root/src/main/scala/firrtl/options/Registration.scala
diff options
context:
space:
mode:
Diffstat (limited to 'src/main/scala/firrtl/options/Registration.scala')
-rw-r--r--src/main/scala/firrtl/options/Registration.scala9
1 files changed, 8 insertions, 1 deletions
diff --git a/src/main/scala/firrtl/options/Registration.scala b/src/main/scala/firrtl/options/Registration.scala
index 481c095b..a826ec50 100644
--- a/src/main/scala/firrtl/options/Registration.scala
+++ b/src/main/scala/firrtl/options/Registration.scala
@@ -10,7 +10,14 @@ import scopt.OptionParser
*/
trait HasScoptOptions {
- /** This method will be called to add options to an OptionParser
+ /** This method will be called to add options to an OptionParser ('''OPTIONS SHOULD BE PREPENDED''')
+ *
+ *
+ * '''The ordering of [[firrtl.annotations.Annotation Annotation]] is important and has meaning for parallel
+ * compilations. For deterministic behavior, you should always prepend any annotations to the [[firrtl.AnnotationSeq
+ * AnnotationSeq]]. The [[firrtl.AnnotationSeq AnnotationSeq]] will be automatically reversed after a [[Stage]]
+ * parses it.'''
+ *
* @param p an option parser
*/
def addOptions(p: OptionParser[AnnotationSeq]): Unit