docs: update

FossilOrigin-Name: 143ea57c3d8309faf15399199d0e2930f07371a34c08ff16e9a9f5fbb0be6a23

1 files changed, 20 insertions, 0 deletions

diff --git a/contrib/cpt-owns b/contrib/cpt-owns
index c9bc457..9bc7d77 100755
--- a/contrib/cpt-owns
+++ b/contrib/cpt-owns
@@ -1,6 +1,26 @@
 #!/bin/sh -e
 # Check which package owns a file
 
+## SYNOPSIS:
+## .Nm
+## .Op Ar file
+## DESCRIPTION:
+## .Nm
+## searches package manifests to determine which package owns
+## .Ar file .
+## If the
+## .Ar file
+## is not a realpath,
+## .Nm
+## will first check if the file exists as a relative path, and then it will
+## check if it exists as an executable
+## in
+## .Ev PATH .
+##
+## .Nm
+## does not check directories, as they can be used by multiple packages at the
+## same time.
+
 # Source the package manager library.
 # shellcheck disable=1091
 . cpt-lib