+1.
And once typed throws are in, it should accept enum shorthand, e.g.:
/// This is a short description
/// - Parameter param1: The first parameter
/// - Returns: an arbitrary value.
/// - Throws:
/// - `.FirstIssue`: when case ABC occurs.
/// - `.SecondIssue`: when case XYZ occurs.
/// - `.ThirdIssue`: when all hope is lost.
func mySampleFunction(param1: String) throws(MyHorribleError) -> String