TSCBasic: clarify AbsolutePath.init deprecation (#384)

MaxDesiatov · web-flow · commit dd1717f2d322 · 2023-01-24T11:45:28.000-08:00
Explicitly point to the recommended version of the initializer.
diff --git a/Sources/TSCBasic/Path.swift b/Sources/TSCBasic/Path.swift
@@ -1064,12 +1064,12 @@ private func mayNeedNormalization(absolute string: String) -> Bool {
 // MARK: - `AbsolutePath` backwards compatibility, delete after deprecation period.
 
 extension AbsolutePath {
-    @available(*, deprecated, message: "use throwing variant instead")
+    @available(*, deprecated, message: "use throwing `init(validating:)` variant instead")
     public init(_ absStr: String) {
         try! self.init(validating: absStr)
     }
 
-    @available(*, deprecated, message: "use throwing variant instead")
+    @available(*, deprecated, message: "use throwing `init(validating:relativeTo:)` variant instead")
     public init(_ str: String, relativeTo basePath: AbsolutePath) {
         try! self.init(validating: str, relativeTo: basePath)
     }

Original file line number	Diff line number	Diff line change
`@@ -1064,12 +1064,12 @@ private func mayNeedNormalization(absolute string: String) -> Bool {`
`1064`	`1064`	// MARK: - `AbsolutePath` backwards compatibility, delete after deprecation period.
`1065`	`1065`
`1066`	`1066`	`extension AbsolutePath {`
`1067`		`- @available(*, deprecated, message: "use throwing variant instead")`
	`1067`	+ @available(*, deprecated, message: "use throwing `init(validating:)` variant instead")
`1068`	`1068`	`public init(_ absStr: String) {`
`1069`	`1069`	`try! self.init(validating: absStr)`
`1070`	`1070`	`}`
`1071`	`1071`
`1072`		`- @available(*, deprecated, message: "use throwing variant instead")`
	`1072`	+ @available(*, deprecated, message: "use throwing `init(validating:relativeTo:)` variant instead")
`1073`	`1073`	`public init(_ str: String, relativeTo basePath: AbsolutePath) {`
`1074`	`1074`	`try! self.init(validating: str, relativeTo: basePath)`
`1075`	`1075`	`}`