From ef8bcd1b9145b4db56146ebad40b1ae46f543015 Mon Sep 17 00:00:00 2001
From: Felix Fietkau <nbd@openwrt.org>
Date: Fri, 28 Dec 2007 17:03:48 +0000
Subject: [PATCH] document Build/InstallDev
SVN-Revision: 9993
---
docs/build.tex | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/docs/build.tex b/docs/build.tex
index c45b905040..730451ede6 100644
--- a/docs/build.tex
+++ b/docs/build.tex
@@ -342,6 +342,19 @@ directly as the Nth argument to \texttt{BuildPackage}.
Contains all environment variables that are passed to the make command
\end{itemize}
+\textbf{\texttt{Build/InstallDev} (optional):} \\
+ If your package provides a library that needs to be made available to other packages,
+ you can use the \texttt{Build/InstallDev} template to copy it into the staging directory
+ which is used to collect all files that other packages might depend on at build time.
+ When it is called by the build system, two parameters are passed to it. \texttt{\$(1)} points to
+ the regular staging dir, typically \texttt{staging\_dir/\textit{ARCH}}, while \texttt{\$(2)} points
+ to \texttt{staging\_dir/host}. The host staging dir is only used for binaries, which are
+ to be executed or linked against on the host and its \texttt{bin/} subdirectory is included
+ in the \texttt{PATH} which is passed down to the build system processes.
+ Please use \texttt{\$(1)} and \texttt{\$(2)} here instead of the build system variables
+ \texttt{\$(STAGING\_DIR)} and \texttt{\$(STAGING\_DIR\_HOST)}, because the build system behavior
+ when staging libraries might change in the future to include automatic uninstallation.
+
\textbf{\texttt{Package/\textit{<name>}/install}:} \\
A set of commands to copy files out of the compiled source and into the ipkg
which is represented by the \texttt{\$(1)} directory. Note that there are currently
--
GitLab