better docs for attach, fixes #28