From 5591eeacb3f5ccb4505810b537348c98c512f806 Mon Sep 17 00:00:00 2001
From: Peter Limkilde Svendsen <peter.limkilde@gmail.com>
Date: Wed, 20 Nov 2024 23:21:48 +0100
Subject: [PATCH] Add docs for sys/file.h

---
 src/header/sys_file/mod.rs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/header/sys_file/mod.rs b/src/header/sys_file/mod.rs
index 15e0f81ec1..2f31b09853 100644
--- a/src/header/sys_file/mod.rs
+++ b/src/header/sys_file/mod.rs
@@ -1,4 +1,6 @@
-//! sys/file.h implementation
+//! `sys/file.h` implementation.
+//!
+//! Non-POSIX, see <https://man7.org/linux/man-pages/man2/flock.2.html>.
 
 use crate::{
     error::ResultExt,
@@ -14,6 +16,7 @@ pub const L_SET: usize = 0;
 pub const L_INCR: usize = 1;
 pub const L_XTND: usize = 2;
 
+/// See <https://man7.org/linux/man-pages/man2/flock.2.html>.
 #[no_mangle]
 pub extern "C" fn flock(fd: c_int, operation: c_int) -> c_int {
     Sys::flock(fd, operation).map(|()| 0).or_minus_one_errno()