commit dd6763a6c677687ad06727af037ed9a7b018c773
author Elliott Hughes <enh@google.com> Thu Oct 04 16:35:13 2018 -0700
committer Elliott Hughes <enh@google.com> Thu Oct 04 16:35:13 2018 -0700
tree 51170c743639731a7e5a1a7540eb3f68870cb893
parent 9df26193c8adc43a7ac1ba807e70d0b0772712c0

Another round of documentation.

Bug: N/A
Test: N/A
Change-Id: I1b818fbb36ddd6d084dee56828290c2717a0c9b0

libc/include/sys/file.h

diff --git a/libc/include/sys/file.h b/libc/include/sys/file.h
index a420021..ccdfeea 100644
--- a/libc/include/sys/file.h
+++ b/libc/include/sys/file.h
@@ -26,8 +26,12 @@
  * SUCH DAMAGE.
  */
 
-#ifndef _SYS_FILE_H_
-#define _SYS_FILE_H_
+#pragma once
+
+/**
+ * @file sys/file.h
+ * @brief The flock() function.
+ */
 
 #include <sys/cdefs.h>
 #include <sys/types.h>
@@ -36,8 +40,12 @@
 
 __BEGIN_DECLS
 
+/**
+ * [flock(2)](http://man7.org/linux/man-pages/man2/flock.2.html) performs
+ * advisory file lock operations.
+ *
+ * Returns 0 on success, and returns -1 and sets `errno` on failure.
+ */
 int flock(int __fd, int __op);
 
 __END_DECLS
-
-#endif