Hi,

Please consider adding following as a starter of EXAMPLES section. The
patch is against SVN 2009-12-18 r14958.

Jari

>From f1fb09858ce08f0caf085bfac564417af39d072b Mon Sep 17 00:00:00 2001
From: Jari Aalto <[email protected]>
Date: Fri, 18 Dec 2009 02:31:21 +0200
Subject: [PATCH] doc/svn-buildpackage.xml: Add EXAMPLES section


Signed-off-by: Jari Aalto <[email protected]>
---
 doc/svn-buildpackage.xml |   35 +++++++++++++++++++++++++++++++++++
 1 files changed, 35 insertions(+), 0 deletions(-)

diff --git a/doc/svn-buildpackage.xml b/doc/svn-buildpackage.xml
index 7f50a1a..4961972 100644
--- a/doc/svn-buildpackage.xml
+++ b/doc/svn-buildpackage.xml
@@ -422,6 +422,41 @@ $ svn propset useNativeDist 1 debian
         </variablelist>
       </refsect1>
       <refsect1>
+        <title>EXAMPLES</title>
+        <para>
+	  To start working with existing Debian package from a *.dsc file, import
+	  it into the repository with command:
+	</para>
+        <screen>
+svn-inject package_1.1-1.dsc svn://host/debian/devel/packages
+	</screen>
+        <para>
+	  To test building the package from SVN repository, use command below. Refer
+	  to dpkg-buildpackage(1) manual page for the -us etc. options.
+	</para>
+        <screen>
+svn-buildpackage --svn-lintian -us -uc -rfakeroot
+	</screen>
+        <para>
+	  To check that package build in a clean state, test it with pbuilder(1):
+	</para>
+        <screen>
+mkdir ../build-area  # To store results
+svn-buildpackage \
+  --svn-ignore-new \
+  --svn-builder="pdebuild --buildresult $(pwd)/../build-area"
+	</screen>
+        <para>
+	  When a new upstream release becomes available, commit all changes and
+	  have the working tree in clean state. Then use svn-upgrade(1) to import
+	  the new release:
+	</para>
+        <screen>
+svn status   # The that there are no uncommited changed
+svn-upgrade --verbose ../package-2.0.tar.gz
+	</screen>
+      </refsect1>
+      <refsect1>
         <title>CONFIGURATION FILE</title>
         <para>svn-buildpackage's behaviour can be modified using the file
        ~/.svn-buildpackage.conf. Additional parts can be added in each package
-- 
1.6.5

Reply via email to