drivers: gpio: rz: Fix whitespaces and typo

- Add spaces around /* ... */
- Fix a typo and remove a stray space in the description of
renesas,rz-gpio.yaml to make it visible in doc html

Signed-off-by: Nhut Nguyen <nhut.nguyen.kc@renesas.com>