update documentation for test_throws exception type. This is a redo of #7042
Clarify return types in REPL and eval mode,  #7166
Merge pull request #7173 from sjkelly/fix_7042

Update @test_throws documentation and clarify return for @__FILE__