Clarify some more internal/deprecated docs.
diff --git a/auth_results.go b/auth_results.go
index de69d4a..856a233 100644
--- a/auth_results.go
+++ b/auth_results.go
@@ -2,9 +2,9 @@
import "time"
-// AuthResults is a leftover type from the v0.x days. It was intended to
-// describe common functionality among identity service results, but is not
-// actually used anywhere.
+// AuthResults [deprecated] is a leftover type from the v0.x days. It was
+// intended to describe common functionality among identity service results, but
+// is not actually used anywhere.
type AuthResults interface {
// TokenID returns the token's ID value from the authentication response.
TokenID() (string, error)
diff --git a/results.go b/results.go
index 7851d75..6585eba 100644
--- a/results.go
+++ b/results.go
@@ -6,7 +6,8 @@
)
/*
-Result is an internal type to be used by individual resource packages.
+Result is an internal type to be used by individual resource packages, but its
+methods will be available on a wide variety of user-facing embedding types.
It acts as a base struct that other Result types, returned from request
functions, can embed for convenience. All Results capture basic information
@@ -42,10 +43,15 @@
return string(pretty)
}
-// ErrResult represents results that only contain a potential error and
+// ErrResult is an internal type to be used by individual resource packages, but
+// its methods will be available on a wide variety of user-facing embedding
+// types.
+//
+// It represents results that only contain a potential error and
// nothing else. Usually, if the operation executed successfully, the Err field
// will be nil; otherwise it will be stocked with a relevant error. Use the
-// ExtractErr method to cleanly pull it out.
+// ExtractErr method
+// to cleanly pull it out.
type ErrResult struct {
Result
}
@@ -56,7 +62,8 @@
}
/*
-HeaderResult is an internal type to be used by individual resource packages.
+HeaderResult is an internal type to be used by individual resource packages, but
+its methods will be available on a wide variety of user-facing embedding types.
It represents a result that only contains an error (possibly nil) and an
http.Header. This is used, for example, by the objectstorage packages in