Docs: add a note about when the #<_hal[hal_name]> values are updated.

Signed-off-by: John Thornton <jthornton@gnipsel.com>