devicetree.h: clean up token API docstrings

Clean up the docstrings for the APIs related to converting property
values to tokens. I think the current language has a few issues and
could be made clearer in some cases.

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>