From 66eb440d79f767f2fadf39e68dfba0fbd702e90f Mon Sep 17 00:00:00 2001
From: Peter Limkilde Svendsen <peter.limkilde@gmail.com>
Date: Wed, 13 Nov 2024 18:19:22 +0100
Subject: [PATCH] Add docs for pty.h and utmp.h

---
 src/header/pty/mod.rs  | 6 +++++-
 src/header/utmp/mod.rs | 5 ++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/header/pty/mod.rs b/src/header/pty/mod.rs
index e356a531e5..5ebb9b231c 100644
--- a/src/header/pty/mod.rs
+++ b/src/header/pty/mod.rs
@@ -1,4 +1,6 @@
-//! pty.h implementation, not POSIX specified
+//! `pty.h` implementation.
+//!
+//! Non-POSIX, see <https://www.man7.org/linux/man-pages/man3/openpty.3.html>.
 
 use core::{mem, ptr, slice};
 
@@ -15,6 +17,7 @@ mod imp;
 #[path = "redox.rs"]
 mod imp;
 
+/// See <https://www.man7.org/linux/man-pages/man3/openpty.3.html>.
 #[no_mangle]
 pub unsafe extern "C" fn openpty(
     amaster: *mut c_int,
@@ -49,6 +52,7 @@ pub unsafe extern "C" fn openpty(
     return 0;
 }
 
+/// See <https://www.man7.org/linux/man-pages/man3/openpty.3.html>.
 #[no_mangle]
 pub unsafe extern "C" fn forkpty(
     pm: *mut c_int,
diff --git a/src/header/utmp/mod.rs b/src/header/utmp/mod.rs
index 35b4811854..8e4142b2fb 100644
--- a/src/header/utmp/mod.rs
+++ b/src/header/utmp/mod.rs
@@ -1,10 +1,13 @@
-//! utmp.h implementation, not POSIX specified
+//! `utmp.h` implementation.
+//!
+//! Non-POSIX, see <https://www.man7.org/linux/man-pages/man3/openpty.3.html>.
 
 use crate::{
     header::{sys_ioctl, unistd},
     platform::types::*,
 };
 
+/// See <https://www.man7.org/linux/man-pages/man3/openpty.3.html>.
 #[no_mangle]
 pub unsafe extern "C" fn login_tty(fd: c_int) -> c_int {
     // Create a new session