variables: REMOVE_ABC_BUFFERS is deprecated

Signed-off-by: Øyvind Harboe <[email protected]>

Author: oharboe

flow/scripts/generate-variables-docs.py

@@ -25,15 +25,20 @@
 markdown_table = ""
 
 markdown_table += "## Variables in alphabetic order\n\n"
-table_header = "| Variable | Description | Default |\n| --- | --- | --- |\n"
+table_header = """
+| Variable | Description | Default | Deprecated |
+| --- | --- | --- | --- |
+"""
 table_rows = ""
 for key in sorted(data):
     value = data[key]
     description = value.get("description", "").replace("\n", " ").strip()
     table_rows += (
         f'| <a name="{key}"></a>{key}'
         + f"| {description}"
-        + f'| {value.get("default", "")} |\n'
+        + f'| {value.get("default", "")}'
+        + f'| {"yes" if value.get("deprecated", 0) == 1 else ""}'
+        + "|\n"
     )
 
 markdown_table += table_header + table_rows

flow/scripts/variables.yaml

@@ -187,9 +187,12 @@ FLOORPLAN_DEF:
     - place
 REMOVE_ABC_BUFFERS:
   description: >
-    Remove abc buffers from the netlist.
+    Remove abc buffers from the netlist. If timing repair in floorplanning is
+    taking too long, use a SETUP_HOLD_MARGIN to terminate timing repair early
+    instead of using REMOVE_ABC_BUFFERS or set SKIP_LAST_GAST=1.
   stages:
     - floorplan
+  deprecated: 1
 PLACE_SITE:
   description: >
     Placement site for core cells defined in the technology LEF file.