Skip to content

Commit

Permalink
update release notes
Browse files Browse the repository at this point in the history
  • Loading branch information
mdavidsaver committed May 4, 2023
1 parent c738a3a commit 441979d
Showing 1 changed file with 12 additions and 8 deletions.
20 changes: 12 additions & 8 deletions documentation/RELEASE_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -304,31 +304,31 @@ 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.

`INT` behavior is applied only during IOC initialization. Runtime re-targeting
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
Expand All @@ -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`).
Expand Down

0 comments on commit 441979d

Please sign in to comment.