added missing docstrings
added param polled_only plus corresponding test