Fix URL formatting in comments.

Author: sunfishcode

src/imp/libc/fs/syscalls.rs

@@ -865,11 +865,11 @@ pub(crate) fn getpath(fd: BorrowedFd<'_>) -> io::Result<ZString> {
     // instead.
     let mut buf = vec![0; c::PATH_MAX as usize];
 
-    // From the macOS `fcntl` man page:
+    // From the [macOS `fcntl` man page]:
     // `F_GETPATH` - Get the path of the file descriptor `Fildes`. The argument
     //               must be a buffer of size `MAXPATHLEN` or greater.
     //
-    // https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/fcntl.2.html
+    // [macOS `fcntl` man page]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/fcntl.2.html
     unsafe {
         ret(c::fcntl(borrowed_fd(fd), c::F_GETPATH, buf.as_mut_ptr()))?;
     }
@@ -886,7 +886,7 @@ pub(crate) fn getpath(fd: BorrowedFd<'_>) -> io::Result<ZString> {
 
 #[cfg(any(target_os = "ios", target_os = "macos"))]
 pub(crate) fn fcntl_rdadvise(fd: BorrowedFd<'_>, offset: u64, len: u64) -> io::Result<()> {
-    // From the macOS `fcntl` man page:
+    // From the [macOS `fcntl` man page]:
     // `F_RDADVISE` - Issue an advisory read async with no copy to user.
     //
     // The `F_RDADVISE` command operates on the following structure which holds
@@ -899,7 +899,7 @@ pub(crate) fn fcntl_rdadvise(fd: BorrowedFd<'_>, offset: u64, len: u64) -> io::R
     // };
     // ```
     //
-    // https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/fcntl.2.html
+    // [macOS `fcntl` man page]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/fcntl.2.html
     let ra_offset = match offset.try_into() {
         Ok(len) => len,
         // If this conversion fails, the user is providing an offset outside

src/imp/libc/io/syscalls.rs

@@ -378,7 +378,7 @@ pub(crate) fn isatty(fd: BorrowedFd<'_>) -> bool {
             c::ENOTTY => false,
 
             // Old Linux versions reportedly return `EINVAL`.
-            // https://man7.org/linux/man-pages/man3/isatty.3.html#ERRORS
+            // <https://man7.org/linux/man-pages/man3/isatty.3.html#ERRORS>
             #[cfg(any(target_os = "android", target_os = "linux"))]
             c::ENOTTY | c::EINVAL => false,
 

src/imp/linux_raw/fs/syscalls.rs

@@ -317,7 +317,7 @@ pub(crate) fn tell(fd: BorrowedFd<'_>) -> io::Result<u64> {
 
 #[inline]
 pub(crate) fn ftruncate(fd: BorrowedFd<'_>, length: u64) -> io::Result<()> {
-    // https://github.com/torvalds/linux/blob/fcadab740480e0e0e9fa9bd272acd409884d431a/arch/arm64/kernel/sys32.c#L81-L83
+    // <https://github.com/torvalds/linux/blob/fcadab740480e0e0e9fa9bd272acd409884d431a/arch/arm64/kernel/sys32.c#L81-L83>
     #[cfg(all(target_pointer_width = "32", target_arch = "arm"))]
     unsafe {
         ret(syscall4_readonly(

src/imp/linux_raw/io/syscalls.rs

@@ -83,7 +83,7 @@ pub(crate) fn read(fd: BorrowedFd<'_>, buf: &mut [u8]) -> io::Result<usize> {
 pub(crate) fn pread(fd: BorrowedFd<'_>, buf: &mut [u8], pos: u64) -> io::Result<usize> {
     let (buf_addr_mut, buf_len) = slice_mut(buf);
 
-    // https://github.com/torvalds/linux/blob/fcadab740480e0e0e9fa9bd272acd409884d431a/arch/arm64/kernel/sys32.c#L75
+    // <https://github.com/torvalds/linux/blob/fcadab740480e0e0e9fa9bd272acd409884d431a/arch/arm64/kernel/sys32.c#L75>
     #[cfg(all(target_pointer_width = "32", target_arch = "arm"))]
     unsafe {
         ret_usize(syscall6(
@@ -213,7 +213,7 @@ pub(crate) fn write(fd: BorrowedFd<'_>, buf: &[u8]) -> io::Result<usize> {
 pub(crate) fn pwrite(fd: BorrowedFd<'_>, buf: &[u8], pos: u64) -> io::Result<usize> {
     let (buf_addr, buf_len) = slice(buf);
 
-    // https://github.com/torvalds/linux/blob/fcadab740480e0e0e9fa9bd272acd409884d431a/arch/arm64/kernel/sys32.c#L81-L83
+    // <https://github.com/torvalds/linux/blob/fcadab740480e0e0e9fa9bd272acd409884d431a/arch/arm64/kernel/sys32.c#L81-L83>
     #[cfg(all(target_pointer_width = "32", target_arch = "arm"))]
     unsafe {
         ret_usize(syscall6_readonly(