Rollup merge of rust-lang#130168 - juliusl:pr/fix-win-fs-change-time-links, r=ChrisDenton

maint: update docs for change_time ext and doc links maint: update docs for change_time ext and doc links Related: rust-lang#121478 r? tgross35

Author: workingjubilee

std/src/os/windows/fs.rs

@@ -298,7 +298,7 @@ impl OpenOptionsExt for OpenOptions {
 /// of the [`BY_HANDLE_FILE_INFORMATION`] structure.
 ///
 /// [`BY_HANDLE_FILE_INFORMATION`]:
-/// https://docs.microsoft.com/en-us/windows/win32/api/fileapi/ns-fileapi-by_handle_file_information
+/// https://docs.microsoft.com/windows/win32/api/fileapi/ns-fileapi-by_handle_file_information
 #[stable(feature = "metadata_ext", since = "1.1.0")]
 pub trait MetadataExt {
  /// Returns the value of the `dwFileAttributes` field of this metadata.
@@ -322,7 +322,7 @@ pub trait MetadataExt {
  /// ```
  ///
  /// [File Attribute Constants]:
- /// https://docs.microsoft.com/en-us/windows/win32/fileio/file-attribute-constants
+ /// https://docs.microsoft.com/windows/win32/fileio/file-attribute-constants
  #[stable(feature = "metadata_ext", since = "1.1.0")]
  fn file_attributes(&self) -> u32;
 
@@ -351,7 +351,7 @@ pub trait MetadataExt {
  /// }
  /// ```
  ///
- /// [`FILETIME`]: https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime
+ /// [`FILETIME`]: https://docs.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-filetime
  #[stable(feature = "metadata_ext", since = "1.1.0")]
  fn creation_time(&self) -> u64;
 
@@ -386,7 +386,7 @@ pub trait MetadataExt {
  /// }
  /// ```
  ///
- /// [`FILETIME`]: https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime
+ /// [`FILETIME`]: https://docs.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-filetime
  #[stable(feature = "metadata_ext", since = "1.1.0")]
  fn last_access_time(&self) -> u64;
 
@@ -419,11 +419,11 @@ pub trait MetadataExt {
  /// }
  /// ```
  ///
- /// [`FILETIME`]: https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime
+ /// [`FILETIME`]: https://docs.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-filetime
  #[stable(feature = "metadata_ext", since = "1.1.0")]
  fn last_write_time(&self) -> u64;
 
- /// Returns the value of the `nFileSize{High,Low}` fields of this
+ /// Returns the value of the `nFileSize` fields of this
  /// metadata.
  ///
  /// The returned value does not have meaning for directories.
@@ -462,7 +462,7 @@ pub trait MetadataExt {
  #[unstable(feature = "windows_by_handle", issue = "63010")]
  fn number_of_links(&self) -> Option<u32>;
 
- /// Returns the value of the `nFileIndex{Low,High}` fields of this
+ /// Returns the value of the `nFileIndex` fields of this
  /// metadata.
  ///
  /// This will return `None` if the `Metadata` instance was created from a
@@ -471,10 +471,14 @@ pub trait MetadataExt {
  #[unstable(feature = "windows_by_handle", issue = "63010")]
  fn file_index(&self) -> Option<u64>;
 
- /// Returns the change time, which is the last time file metadata was changed, such as
- /// renames, attributes, etc
+ /// Returns the value of the `ChangeTime` fields of this metadata.
  ///
- /// This will return `None` if the `Metadata` instance was not created using the `FILE_BASIC_INFO` type.
+ /// `ChangeTime` is the last time file metadata was changed, such as
+ /// renames, attributes, etc.
+ ///
+ /// This will return `None` if `Metadata` instance was created from a call to
+ /// `DirEntry::metadata` or if the `target_vendor` is outside the current platform
+ /// support for this api.
  #[unstable(feature = "windows_change_time", issue = "121478")]
  fn change_time(&self) -> Option<u64>;
 }