update availability to 9999

Author: rauhul

Sources/System/FileStatus/FileFlags.swift

@@ -11,7 +11,7 @@
 
 // FIXME: Document
 @frozen
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 public struct FileFlags: OptionSet {
   /// The raw C file flags.
   @_alwaysEmitIntoClient

Sources/System/FileStatus/FileMode/FileMode.swift

@@ -13,7 +13,7 @@
 
 // FIXME: Document
 @frozen
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 public struct FileMode: RawRepresentable {
   /// The raw C file mode.
   @_alwaysEmitIntoClient

Sources/System/FileStatus/FileMode/FileModeOther.swift

@@ -12,8 +12,8 @@
 // FIXME: Rename
 // FIXME: Document
 @frozen
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
-public struct FileModeOther: OptionSet {
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
+public struct FileModeOther: OptionSet, Hashable, Codable {
   /// The raw C file mode other.
   @_alwaysEmitIntoClient
   public var rawValue: CInterop.Mode
@@ -46,4 +46,24 @@ public struct FileModeOther: OptionSet {
   public static var saveText: FileModeOther { FileModeOther(0o1000) }
 }
 
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
+extension FileModeOther
+  : CustomStringConvertible, CustomDebugStringConvertible
+{
+  /// A textual representation of the file permissions.
+  @inline(never)
+  public var description: String {
+    let descriptions: [(Element, StaticString)] = [
+      (.setUserID, ".setUserID"),
+      (.setGroupID, ".setGroupID"),
+      (.saveText, ".saveText")
+    ]
+
+    return _buildDescription(descriptions)
+  }
+
+  /// A textual representation of the file permissions, suitable for debugging.
+  public var debugDescription: String { self.description }
+}
+
 #endif

Sources/System/FileStatus/FileMode/FileType.swift

@@ -11,7 +11,7 @@
 
 // FIXME: Document
 @frozen
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 public struct FileType: RawRepresentable {
   /// The raw C file type.
   @_alwaysEmitIntoClient

Sources/System/FileStatus/FileStatus.swift

@@ -11,7 +11,7 @@
 
 // FIXME: Document
 @frozen
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 public struct FileStatus: RawRepresentable {
   /// The raw C file status.
   @_alwaysEmitIntoClient

Sources/System/FileStatus/FileStatusOperations.swift

@@ -11,7 +11,7 @@
 
 // FIXME: this is wrong and should be done with wrapping fcntrl
 // FIXME: go through and figure out the right way to express `at` methods
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FileDescriptor {
   public struct ControlFlags {
     let rawValue: Int32
@@ -29,7 +29,7 @@ extension FileDescriptor {
 // [ ] int lstatx_np(const char *, struct stat *, filesec_t)
 // [ ] int fstatx_np(int, struct stat *, filesec_t)
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FilePath {
   @_alwaysEmitIntoClient
   public func stat(
@@ -62,7 +62,7 @@ extension FilePath {
   //  }
 }
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FileDescriptor {
   internal func fstat(retryOnInterrupt: Bool = true) throws -> FileStatus {
     var result = CInterop.Stat()
@@ -92,7 +92,7 @@ extension FileDescriptor {
 // [ ] int chmodx_np(const char *, filesec_t)
 // [ ] int fchmodx_np(int, filesec_t)
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FilePath {
   @_alwaysEmitIntoClient
   public func chmod(
@@ -122,7 +122,7 @@ extension FilePath {
   }
 }
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FileDescriptor {
   internal func fchmod(permissions: FilePermissions, retryOnInterrupt: Bool = true) throws {
     try nothingOrErrno(retryOnInterrupt: retryOnInterrupt) {
@@ -147,7 +147,7 @@ extension FileDescriptor {
 // [x] int fchown(int, uid_t, gid_t)
 // [x] int fchownat(int, const char *, uid_t, gid_t, int)
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FilePath {
   @_alwaysEmitIntoClient
   public func chown(
@@ -180,7 +180,7 @@ extension FilePath {
   }
 }
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FileDescriptor {
   internal func fchown(userId: CInterop.UserId, groupId: CInterop.GroupId, retryOnInterrupt: Bool = true) throws {
     try nothingOrErrno(retryOnInterrupt: retryOnInterrupt) {
@@ -204,7 +204,7 @@ extension FileDescriptor {
 // [x] int fchflags(int, __uint32_t)
 // [x] int chflagsat(int, const char *, __uint32_t, int)
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FilePath {
   @_alwaysEmitIntoClient
   public func chflags(
@@ -234,7 +234,7 @@ extension FilePath {
   }
 }
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FileDescriptor {
   internal func fchflags(flags: FileFlags, retryOnInterrupt: Bool = true) throws {
     try nothingOrErrno(retryOnInterrupt: retryOnInterrupt) {
@@ -282,7 +282,7 @@ public func umask(newMask: FilePermissions) -> FilePermissions {
 // [ ] int mkfifox_np(const char *, filesec_t)
 // [ ] int mkdirx_np(const char *, filesec_t)
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FilePath {
   @_alwaysEmitIntoClient
   public func mkfifo(
@@ -370,7 +370,7 @@ extension FileDescriptor {
 // [x] int futimens(int, const struct timespec[2])
 // [x] int utimensat(int, const char *, const struct timespec[2], int)
 
-// @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
+// @available(macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, *)
 extension FileDescriptor {
   @available(macOS 12, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
   internal func futimens(accessTime: TimeSpecification, modificationTime: TimeSpecification, retryOnInterrupt: Bool = true) throws {