Notice framework documentation confusion

Description

The Notice documentation includes the phrase "Users should directly make modifications to the Notice::Info record given as the argument to the hook". Initially I read this with a presumption that it was a typo and what was meant was instead "should not directly make ...". Then when I got to the example I see that it actually does mean go-ahead-and-modify, though presumably it only makes sense to modify some fields (such as $actions) and not others (context provided by the Info record). So this phrasing should be clarified, maybe along the lines of "Users alter notice processing by directly modifying certain fields in the Notice::Info record given as the argument ...".

Environment

None

Activity

Show:
Robin Sommer
May 27, 2016, 8:53 PM

Fixed in c74effad429c19b587d81ff64ddaa94a66a4f95d

Fixed

Assignee

Robin Sommer

Reporter

Vern Paxson

Labels

None

External issue ID

None

Components

Fix versions

Priority

Low