doc: Edit the Pinmux driver APIs
doc: Edit the Pinmux driver APIs

Edit public API details for clarity, grammar, punctuation found
on file pinmux.h

Change-Id: Ib75e5c3bff84709e8f3f830dd71dde00bdef08a2
Signed-off-by: Rodrigo Caballero <e74c61adb7ade025bc8e83a25052d36636c989a9@intel.com>

kraj/zephyr,explora26/zephyr,aceofall/zephyr-iotos,pklazy/zephyr,explora26/zephyr,tidyjiang8/zephyr-doc,GiulianoFranchetto/zephyr,runchip/zephyr-cc3200,kraj/zephyr,punitvara/zephyr,fbsder/zephyr,bigdinotech/zephyr,galak/zephyr,runchip/zephyr-cc3220,finikorg/zephyr,runchip/zephyr-cc3200,bigdinotech/zephyr,Vudentz/zephyr,fractalclone/zephyr-riscv,fbsder/zephyr,fractalclone/zephyr-riscv,aceofall/zephyr-iotos,32bitmicro/zephyr,mirzak/zephyr-os,aceofall/zephyr-iotos,rsalveti/zephyr,coldnew/zephyr-project-fork,ldts/zephyr,nashif/zephyr,bboozzoo/zephyr,nashif/zephyr,sharronliu/zephyr,GiulianoFranchetto/zephyr,ldts/zephyr,zephyrproject-rtos/zephyr,coldnew/zephyr-project-fork,erwango/zephyr,explora26/zephyr,holtmann/zephyr,Vudentz/zephyr,pklazy/zephyr,sharronliu/zephyr,runchip/zephyr-cc3220,runchip/zephyr-cc3220,mbolivar/zephyr,pklazy/zephyr,32bitmicro/zephyr,32bitmicro/zephyr,fractalclone/zephyr-riscv,bboozzoo/zephyr,finikorg/zephyr,mirzak/zephyr-os,Vudentz/zephyr,GiulianoFranchetto/zephyr,mirzak/zephyr-os,kraj/zephyr,nashif/zephyr,zephyrproject-rtos/zephyr,32bitmicro/zephyr,fbsder/zephyr,punitvara/zephyr,sharronliu/zephyr,mirzak/zephyr-os,mirzak/zephyr-os,punitvara/zephyr,runchip/zephyr-cc3200,runchip/zephyr-cc3200,galak/zephyr,runchip/zephyr-cc3220,runchip/zephyr-cc3200,tidyjiang8/zephyr-doc,sharronliu/zephyr,rsalveti/zephyr,zephyriot/zephyr,holtmann/zephyr,coldnew/zephyr-project-fork,zephyriot/zephyr,holtmann/zephyr,Vudentz/zephyr,mbolivar/zephyr,zephyrproject-rtos/zephyr,fractalclone/zephyr-riscv,zephyriot/zephyr,coldnew/zephyr-project-fork,bboozzoo/zephyr,zephyriot/zephyr,bigdinotech/zephyr,punitvara/zephyr,bigdinotech/zephyr,tidyjiang8/zephyr-doc,pklazy/zephyr,tidyjiang8/zephyr-doc,rsalveti/zephyr,32bitmicro/zephyr,aceofall/zephyr-iotos,finikorg/zephyr,sharronliu/zephyr,holtmann/zephyr,fbsder/zephyr,galak/zephyr,bboozzoo/zephyr,zephyrproject-rtos/zephyr,runchip/zephyr-cc3220,fbsder/zephyr,erwango/zephyr,rsalveti/zephyr,tidyjiang8/zephyr-doc,nashif/zephyr,aceofall/zephyr-iotos,zephyriot/zephyr,mbolivar/zephyr,nashif/zephyr,mbolivar/zephyr,Vudentz/zephyr,rsalveti/zephyr,punitvara/zephyr,erwango/zephyr,erwango/zephyr,kraj/zephyr,zephyrproject-rtos/zephyr,finikorg/zephyr,ldts/zephyr,holtmann/zephyr,galak/zephyr,GiulianoFranchetto/zephyr,galak/zephyr,pklazy/zephyr,GiulianoFranchetto/zephyr,ldts/zephyr,erwango/zephyr,explora26/zephyr,Vudentz/zephyr,fractalclone/zephyr-riscv,explora26/zephyr,kraj/zephyr,bigdinotech/zephyr,bboozzoo/zephyr,mbolivar/zephyr,coldnew/zephyr-project-fork,ldts/zephyr,finikorg/zephyr