drivers: bluetooth: add more documentation for BT_HCI_SET_PUBLIC_ADDR

Hopefully this should now aid driver developers as well as application
developers.

Signed-off-by: Armin Brauns <armin.brauns@embedded-solutions.at>