From a650ce3f8be383561fa16039723d75c154574d28 Mon Sep 17 00:00:00 2001
From: Jonathan Nieder <jrnieder@gmail.com>
Date: Tue, 6 Jul 2010 03:22:51 -0500
Subject: Add prebuild hook

Can be used to add an upstream changelog generated from the
git repository to the build dir.

Closes: #587652
---
 docs/chapters/building.sgml         |  3 ++-
 docs/manpages/git-buildpackage.sgml | 12 ++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

(limited to 'docs')

diff --git a/docs/chapters/building.sgml b/docs/chapters/building.sgml
index 2205940d..f68e3780 100644
--- a/docs/chapters/building.sgml
+++ b/docs/chapters/building.sgml
@@ -78,7 +78,8 @@ export-dir=../build-area
     Besides the commands for cleaning the package build dir
     (<option>cleaner</option> and building the package
     (<option>builder</option>) you can also invoke hooks during the package
-    build: after a succesful build (<option>postbuild</option>) and after
+    build: immediately before a build (<option>prebuild</option>,
+    after a succesful build (<option>postbuild</option>) and after
     creating a tag (<option>posttag</option>). Typical applications are running
     <productname>lintian</productname> or pushing changes into a remote
     repository.
diff --git a/docs/manpages/git-buildpackage.sgml b/docs/manpages/git-buildpackage.sgml
index a1eac1f3..3f2ed288 100644
--- a/docs/manpages/git-buildpackage.sgml
+++ b/docs/manpages/git-buildpackage.sgml
@@ -31,6 +31,7 @@
       <arg><option>--git-keyid=</option><replaceable>gpg-keyid</replaceable></arg>
       <arg><option>--git-posttag=</option><replaceable>command</replaceable></arg>
       <arg><option>--git-postbuild=</option><replaceable>command</replaceable></arg>
+      <arg><option>--git-prebuild=</option><replaceable>command</replaceable></arg>
       <arg><option>--git-debian-tag=</option><replaceable>tag-format</replaceable></arg>
       <arg><option>--git-force-create</option></arg>
       <arg><option>--git-no-create-orig</option></arg>
@@ -192,6 +193,17 @@
 	  file), <envar>GBP_BUILD_DIR</envar> (the build dir).
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term><option>--git-prebuild=</option><replaceable>command</replaceable>
+        </term>
+        <listitem>
+          <para>execute <replaceable>command</replaceable> from the build
+          directory before calling <application>debuild</application>
+          or the application specified via <option>--git-builder</option>.</para>
+          <para>Exported environment variables are:
+          <envar>GBP_GIT_DIR</envar> (the repository the package is being built from),
+          <envar>GBP_BUILD_DIR</envar> (the build dir).
+        </listitem>
       <varlistentry>
         <term><option>--git-debian-tag=</option><replaceable>tag-format</replaceable>
         </term>
-- 
cgit v1.2.3