Deprecate memlib APIs.

[sequencer]

Contributor Checklist

• Did you add Scaladoc to every public function/method?
• Did you update the FIRRTL spec to include every new feature/behavior?
• Did you add at least one test demonstrating the PR?
• Did you delete any extraneous printlns/debugging code?
• Did you specify the type of improvement?
• Did you state the API impact?
• Did you specify the code generation impact?
• Did you request a desired merge strategy?
• Did you add text to be included in the Release Notes for this change?

Type of Improvement

• code refactoring

API Impact

deprecate APIs:
CreateMemoryAnnotations
ConfWriter
ReplSeqMem
ReplaceMemMacros and its functions:
.memToBundle
.memToFlattenBundle
.createMemModule
.defaultConnects
.maskBits
.adaptReader
.adaptWriter
.adaptReadWriter
.constructNameMap
.updateMemStmts
.updateMemMods

Backend Code Generation Impact

None

Desired Merge Strategy

• Rebase: You will rebase the PR onto master and it will be merged with a merge commit.

Release Notes

Reviewer Checklist (only modified by reviewer)

• Did you add the appropriate labels?
• Did you mark the proper milestone (1.2.x, 1.3.0, 1.4.0) ?
• Did you review?
• Did you check whether all relevant Contributor checkboxes have been checked?
• Did you mark as Please Merge?

[jackkoenig]

We should deprecate constructors instead of classes so that people can still have dependencies on them.

  class CreateMemoryAnnotations private (reader: Option[YamlFileReader], dummy: Int) extends Transform with DependencyAPIMigration {
  @deprecated("CreateMemoryAnnotations will not take reader: Option[YamlFileReader] as argument since 1.5.", "FIRRTL 1.4")
  def this(reader: Option[YamlFileReader]) = new CreateMemoryAnnotations(reader, 0)

[sequencer]

I’ll add another PR to 3.4.x:
Not to deprecate entire class, but only deprecate only this constructor.