From 01ae34db9f4d4e0e6e94c9537c9ba618599473ee Mon Sep 17 00:00:00 2001
From: Patrick McDermott <patrick.mcdermott@libiquity.com>
Date: Thu, 14 Mar 2019 00:25:27 -0400
Subject: ob_init_package(): Document

---
diff --git a/lib/package.sh b/lib/package.sh
index 5c78b01..85cbd98 100644
--- a/lib/package.sh
+++ b/lib/package.sh
@@ -33,6 +33,15 @@ _ob_package_do()
 	return 0
 }
 
+## @brief Initialize libopkbuild for a source package
+## @details \fBob_init_package\fP detects the version of and parses all metadata
+##          of a source package.  This function must be called before any other
+##          functions that operate on package metadata.
+## @operand dir req The root directory of the source package.
+## @return Returns 0 on success or 1 if the source package version can't be
+##         detected or if the metadata can't be parsed.
+## @stderr Prints error or warning messages on detection or parsing errors.
+## @pure no This function sets internal global variables.
 ob_init_package()
 {
 	local dir="${1}"
--
cgit v0.9.1