From f9ed712f922e6825465b66ea9b1455175ab8fa98 Mon Sep 17 00:00:00 2001
From: "A. Wilcox" <AWilcox@Wilcox-Tech.com>
Date: Sat, 16 May 2020 03:49:02 -0500
Subject: owner: Add manual page

---
 owner/CMakeLists.txt |  1 +
 owner/owner.1        | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 owner/owner.1

diff --git a/owner/CMakeLists.txt b/owner/CMakeLists.txt
index 05c2d36..c4b59de 100644
--- a/owner/CMakeLists.txt
+++ b/owner/CMakeLists.txt
@@ -4,6 +4,7 @@ set(OWNER_SRCS
 add_executable(hscript-printowner ${OWNER_SRCS})
 
 install(TARGETS hscript-printowner DESTINATION bin)
+install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/owner.1 DESTINATION share/man/man1 RENAME hscript-printowner.1)
 
 IF(RSPEC_EXECUTABLE)
 add_test(NAME "RSpecOwner"
diff --git a/owner/owner.1 b/owner/owner.1
new file mode 100644
index 0000000..79dc6e2
--- /dev/null
+++ b/owner/owner.1
@@ -0,0 +1,32 @@
+.Dd May 16, 2020
+.Dt HSCRIPT-PRINTOWNER 1
+.Os "Adélie Linux"
+.Sh NAME
+.Nm hscript-printowner
+.Nd print the owner of a file to stdout
+.Sh SYNOPSIS
+.Nm
+.Ar FILE
+.Sh DESCRIPTION
+The
+.Nm
+utility prints the owning user ID of
+.Ar FILE
+to stdout.
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+The following invocation will print the owner of the root directory:
+.Dl $ hscript-printowner /
+.Sh DIAGNOSTICS
+If an error occurs while trying to access the specified file, the error will
+be printed to stderr.
+.Sh SEE ALSO
+.Xr stat 1 .
+.Sh HISTORY
+The
+.Nm
+utility first appeared in Horizon 0.2.
+.Sh AUTHORS
+.An A. Wilcox
+.Aq awilfox@adelielinux.org
-- 
cgit v1.2.3-70-g09d2