Documentation for pool and semaphore. Add return types for some Cython semaphore functions in hopes of better code.