doc: Enhancements for microkernel semaphore objects
doc: Enhancements for microkernel semaphore objects

Enhances description for semaphore definition. Adds examples of
semaphore use. Fills in gaps in the semaphore API table.

Note: Enhancement of the initial part of this document is left
for future commits.

Change-Id: I45a1326e564f20db2beed0c761584804ad61b053
Signed-off-by: Allan Stephens <1038bc33971d2c23c8e2eee8dd6938c077db52dc@windriver.com>

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