Update File-based method deprecations to reference Java NIO APIs directly

Co-authored-by: slachiewicz <[email protected]>

Author: Copilot

src/main/java/org/codehaus/plexus/components/io/attributes/AttributeUtils.java

@@ -115,7 +115,7 @@ public static PosixFileAttributes getPosixFileAttributes(@Nonnull Path path) thr
     }
 
     /**
-     * @deprecated Use {@link #getPosixFileAttributes(Path)} instead
+     * @deprecated Use {@link Files#readAttributes(Path, Class, java.nio.file.LinkOption...)} directly
      */
     @Deprecated
     @Nonnull
@@ -161,7 +161,7 @@ public static FileOwnerAttributeView getFileOwnershipInfo(@Nonnull Path path) th
     }
 
     /**
-     * @deprecated Use {@link #getFileOwnershipInfo(Path)} instead
+     * @deprecated Use {@link Files#getFileAttributeView(Path, Class, java.nio.file.LinkOption...)} directly
      */
     @Deprecated
     @Nullable

src/main/java/org/codehaus/plexus/components/io/attributes/SymlinkUtils.java

@@ -46,7 +46,7 @@ public class SymlinkUtils {
      * @param symlink A file that is a symlink
      * @return A file that is the target of the symlink
      * @throws java.io.IOException
-     * @deprecated Use {@link #readSymbolicLink(Path)} instead
+     * @deprecated Use {@link Files#readSymbolicLink(Path)} directly
      */
     @Deprecated
     public static @Nonnull File readSymbolicLink(@Nonnull File symlink) throws IOException {
@@ -65,7 +65,7 @@ public class SymlinkUtils {
     }
 
     /**
-     * @deprecated Use {@link #createSymbolicLink(Path, Path)} instead
+     * @deprecated Use {@link Files#createSymbolicLink(Path, Path, java.nio.file.attribute.FileAttribute[])} directly
      */
     @Deprecated
     public static @Nonnull File createSymbolicLink(@Nonnull File symlink, File target) throws IOException {