simplify documented example of file-attaching

closes #1
correct documentation of the transport method

closes #1
fix naming of the second "send" method: send_or_die

closes #2
dzilify
this test does die for me, remove TODO