summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--lib/metadata.sh15
-rw-r--r--man/local.mk1
2 files changed, 16 insertions, 0 deletions
diff --git a/lib/metadata.sh b/lib/metadata.sh
index fd64a13..5628a18 100644
--- a/lib/metadata.sh
+++ b/lib/metadata.sh
@@ -329,6 +329,21 @@ ob_plat_is_concerned()
fi
}
+## @brief Get a system path
+## @details \fBob_get_system_path\fP gets a system path consisting of \fIargs\fP
+## formatted, by the metadata plugin selected at libopkbuild's build
+## time, according to a path format identified by \fIpath_id\fP. The
+## arguments for a \fIpath_id\fP of either \fBpackage-source\fP or
+## \fBpackage-docs\fP are \fIsource\fP and \fIversion\fP. For
+## \fBbuildflags\fP the argument is \fI arch\fP. For \fBplatconf\fP
+## they are \fIsource\fP, \fIversion\fP, and \fIplat\fP.
+## @operand path_id req One of \fBpackage-source\fP, \fBpackage-docs\fP,
+## \fBbuildflags\fP, or \fBplatconf\fP.
+## @operand args req Additional arguments specific to each \fIpath_id\fP.
+## @return Returns 0 on success, or 125 if given an incorrect number of
+## arguments.
+## @stdout Prints the requested path with \fIargs\fP.
+## @pure yes This function has no side effects.
ob_get_system_path()
{
local path_id=
diff --git a/man/local.mk b/man/local.mk
index 535fad8..e213d34 100644
--- a/man/local.mk
+++ b/man/local.mk
@@ -33,6 +33,7 @@ man3_MANS = \
%reldir%/ob_error.3 \
%reldir%/ob_get_msg.3 \
%reldir%/ob_get_system_arch.3 \
+ %reldir%/ob_get_system_path.3 \
%reldir%/ob_get_system_plat.3 \
%reldir%/ob_get_text_domain.3 \
%reldir%/ob_info.3 \