Address review

(this commit will be squashed)

* Do not perform explicit shifts
* Move doc from implementation to header for arch-utils
* Add better comments to gdbarch.sh