diff --git a/docs/source/commands/configtxgen.md b/docs/source/commands/configtxgen.md
index 187539dba18..2744cf2c917 100644
--- a/docs/source/commands/configtxgen.md
+++ b/docs/source/commands/configtxgen.md
@@ -86,16 +86,20 @@ for channel reconfiguration workflows, such as adding a member).
 configtxgen -printOrg Org1
 ```
 
-### Output anchor peer tx
-
-Output a configuration update transaction to `anchor_peer_tx.pb` which sets the
-anchor peers for organization Org1 as defined in profile
-SampleSingleMSPChannelV1_1 based on `configtx.yaml`.
+### Output anchor peer tx (deprecated)
 
+Output a channel configuration update transaction `anchor_peer_tx.pb`  based on
+the anchor peers defined for Org1 and channel profile SampleSingleMSPChannelV1_1
+in `configtx.yaml`. Transaction will set anchor peers for Org1 if no anchor peers
+have been set on the channel.
 ```
 configtxgen -outputAnchorPeersUpdate anchor_peer_tx.pb -profile SampleSingleMSPChannelV1_1 -asOrg Org1
 ```
 
+The `-outputAnchorPeersUpdate` output flag has been deprecated. To set anchor
+peers on the channel, use [configtxlator](configtxlator.html) to update the
+channel configuration.
+
 ## Configuration
 
 The `configtxgen` tool's output is largely controlled by the content of
diff --git a/docs/wrappers/configtxgen_postscript.md b/docs/wrappers/configtxgen_postscript.md
index fd45d3ea6fa..5f61466d9dc 100644
--- a/docs/wrappers/configtxgen_postscript.md
+++ b/docs/wrappers/configtxgen_postscript.md
@@ -46,16 +46,20 @@ for channel reconfiguration workflows, such as adding a member).
 configtxgen -printOrg Org1
 ```
 
-### Output anchor peer tx
-
-Output a configuration update transaction to `anchor_peer_tx.pb` which sets the
-anchor peers for organization Org1 as defined in profile
-SampleSingleMSPChannelV1_1 based on `configtx.yaml`.
+### Output anchor peer tx (deprecated)
 
+Output a channel configuration update transaction `anchor_peer_tx.pb`  based on
+the anchor peers defined for Org1 and channel profile SampleSingleMSPChannelV1_1
+in `configtx.yaml`. Transaction will set anchor peers for Org1 if no anchor peers
+have been set on the channel.
 ```
 configtxgen -outputAnchorPeersUpdate anchor_peer_tx.pb -profile SampleSingleMSPChannelV1_1 -asOrg Org1
 ```
 
+The `-outputAnchorPeersUpdate` output flag has been deprecated. To set anchor
+peers on the channel, use [configtxlator](configtxlator.html) to update the
+channel configuration.
+
 ## Configuration
 
 The `configtxgen` tool's output is largely controlled by the content of