diff --git a/docs/user/FlowVariables.md b/docs/user/FlowVariables.md
index 2eabff74f3..2bc47e843c 100644
--- a/docs/user/FlowVariables.md
+++ b/docs/user/FlowVariables.md
@@ -183,7 +183,7 @@ configuration file.
| LIB_MODEL| Selects between NLDM and CCS timing models for the ASAP7 platform. Valid values: NLDM (default), CCS. Used in flow/platforms/asap7/config.mk to pick the LIB_DIR subdirectory and accumulate the corresponding $(CORNER)_$(LIB_MODEL)_LIB_FILES list, and in flow/scripts/load.tcl to gate CCS-specific Tcl branches.| NLDM|
| MACRO_BLOCKAGE_HALO| Distance beyond the edges of a macro that will also be covered by the blockage generated for that macro. Note that the default macro blockage halo comes from the largest of the specified MACRO_PLACE_HALO x or y values. This variable overrides that calculation.| |
| MACRO_EXTENSION| Sets the number of GCells added to the blockages boundaries from macros.| |
-| MACRO_PLACEMENT_TCL| Specifies the path of a TCL file on how to place macros manually. The user may choose to place just some of the macros in the design. The macro placer will handle the remaining unplaced macros.| |
+| MACRO_PLACEMENT_TCL| Specifies the path of a TCL file on how to place macros manually. The user may choose to place just some of the macros in the design. The macro placer will handle the remaining unplaced macros. Note that using the macro placement file generated by the macro placer will not result in the same global placement as actually running the macro placer: the macro placement file does not contain the locations that the macro placer generates for the standard cells, and those locations impact global placement.| |
| MACRO_PLACE_HALO| Horizontal/vertical halo around macros (microns). Used by automatic macro placement.| |
| MACRO_ROWS_HALO_X| Horizontal distance between the edge of the macro and the beginning of the rows created by tapcell. Only available for ASAP7 PDK and GF180/uart-blocks design.| |
| MACRO_ROWS_HALO_Y| Vertical distance between the edge of the macro and the beginning of the rows created by tapcell. Only available for ASAP7 PDK and GF180/uart-blocks design.| |
diff --git a/flow/scripts/variables.json b/flow/scripts/variables.json
index d2725ce668..2aa9a59ac5 100644
--- a/flow/scripts/variables.json
+++ b/flow/scripts/variables.json
@@ -542,7 +542,7 @@
"description": "Sets the number of GCells added to the blockages boundaries from macros.\n"
},
"MACRO_PLACEMENT_TCL": {
- "description": "Specifies the path of a TCL file on how to place macros manually.\nThe user may choose to place just some of the macros in the design.\nThe macro placer will handle the remaining unplaced macros.\n",
+ "description": "Specifies the path of a TCL file on how to place macros manually.\nThe user may choose to place just some of the macros in the design.\nThe macro placer will handle the remaining unplaced macros. Note\nthat using the macro placement file generated by the macro placer\nwill not result in the same global placement as actually running\nthe macro placer: the macro placement file does not contain the\nlocations that the macro placer generates for the standard cells,\nand those locations impact global placement.\n",
"stages": [
"floorplan"
]
diff --git a/flow/scripts/variables.yaml b/flow/scripts/variables.yaml
index 1b6abe4c83..8908cc64c8 100644
--- a/flow/scripts/variables.yaml
+++ b/flow/scripts/variables.yaml
@@ -543,7 +543,12 @@ MACRO_PLACEMENT_TCL:
description: |
Specifies the path of a TCL file on how to place macros manually.
The user may choose to place just some of the macros in the design.
- The macro placer will handle the remaining unplaced macros.
+ The macro placer will handle the remaining unplaced macros. Note
+ that using the macro placement file generated by the macro placer
+ will not result in the same global placement as actually running
+ the macro placer: the macro placement file does not contain the
+ locations that the macro placer generates for the standard cells,
+ and those locations impact global placement.
stages:
- floorplan
MACRO_PLACE_HALO: