From fc8de2a8f48485ad8b035a4e76098c4a7dbadb05 Mon Sep 17 00:00:00 2001
From: merakor <cem@ckyln.com>
Date: Fri, 12 Mar 2021 13:58:36 +0000
Subject: docs: update

FossilOrigin-Name: 143ea57c3d8309faf15399199d0e2930f07371a34c08ff16e9a9f5fbb0be6a23
---
 contrib/cpt-owns | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'contrib/cpt-owns')

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
-- 
cgit v1.2.3