Exec remote API documentation

Includes
1. minor code cleanup 
2. addition of a TODO
3. updated CLI documentation.

Ping @cpuguy83 
set up; down-case `detach`, need a comma after "true". But I'm confused by that sentence. What returns after starting the exec command?

Also, `code font` for `exec` here and throughout.