diff --git a/documentation/RELEASE_NOTES.md b/documentation/RELEASE_NOTES.md
index c8003116e1..0b025cdb45 100644
--- a/documentation/RELEASE_NOTES.md
+++ b/documentation/RELEASE_NOTES.md
@@ -304,23 +304,23 @@ being taken on the part of whoever sets up, or changes an IOC.
 To preserve compatibility, the default behavior of link does not change.
 
 This behavior/mode, now retroactively called `AUTO`, may now be expressed
-explicitly with:
+explicitly in a `.db` file with:
 
 ```
 set("link:scope","AUTO")
 ```
 
-A new `INT` behavior/mode is added where links will by default be required to
-target records within the same IOC. Links which may target an external PV must
-be marked with a new `EXT` link modifier.
+A new `set("link:scope","INT")` behavior/mode is added where links will by
+default be required to target records within the same IOC. Links which
+intended to target an external PV must be marked with a new `EXT` link modifier.
 
 This new mode is an attempt to reduce the possibility of typos in links going
 unnoticed by allowing a **per-file** change to opt-in to the new behavior.
 
 This allows the author of a .db file to explicitly mark those (usually few)
-links which are intended to become external `CA` links. Links not marked as
-`EXT` will trigger an error during `iocInit()` if the target is not a local
-record.
+links which are intended to become external `CA` links.  With
+`set("link:scope","INT")` links not marked as `EXT` will trigger an error
+during `iocInit()` if the target is not a local record.
 
 `EXT` and `CA` can be combined to require a local CA link.
 
@@ -328,7 +328,7 @@ record.
 of links always behaves as if `AUTO` was specified.
 
 ```
-set("link:scope","INT") # affects current .db file only
+set("link:scope","INT") # affects current file only
 
 record(longin, "my:dev:sigA") {
     #field(INP, "my:dev:sigB CPP") # intended
@@ -337,6 +337,10 @@ record(longin, "my:dev:sigA") {
 record(longin, "my:dev:sigB") {
     field(INP, "some:other EXT") # allowed
 }
+
+# set back to AUTO behavior.  Optional.  Helpful for situations
+# .template and .db fragments are concatenated together.
+set("link:scope","AUTO")
 ```
 
 In this example the first record has a link with a typo (`def` vs. `dev`).