Fixed SYNOPSIS
Simplified t thread
Pass hash references because it's simpler!
Multiple changes:

Improved comments.
Pass and return option references (not hashes).