hal: explain why the enums all have distinct values
hal: use rtapi_bool.h for the type underlying hal_bit_t
hal: use rtapi_stdint for the types underlying hal types