[Debian-in-commits] [SCM] Git repository for debian-in branch, master, updated. 16563a2f62eb38b2ab7b7c4aaef993c4f023bedd
Vasudev Kamath
kamathvasudev at gmail.com
Sat Dec 24 14:43:56 UTC 2011
The following commit has been merged in the master branch:
commit 16563a2f62eb38b2ab7b7c4aaef993c4f023bedd
Author: Vasudev Kamath <kamathvasudev at gmail.com>
Date: Sat Dec 24 20:13:32 2011 +0530
Added howto for importing new upstream. Exported .txt (markdown syntax) to html
diff --git a/docs/debian-in-git-packaging-how-to.html b/docs/debian-in-git-packaging-how-to.html
new file mode 100644
index 0000000..5a5898b
--- /dev/null
+++ b/docs/debian-in-git-packaging-how-to.html
@@ -0,0 +1,194 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>debian-in-git-packaging-how-to.txt</title>
+
+</head>
+
+<body>
+
+<h1>Debian-In-workers: Packaging How-To</h1>
+
+<p>Author: AbdulKarim <a href="mailto:abdulkarimmemon@gmail.com">abdulkarimmemon@gmail.com</a>,
+ Kartik Mistry <a href="mailto:kartik@debian.org">kartik@debian.org</a></p>
+
+<h2>Checking out Repository</h2>
+
+<ol>
+<li><p>Install git-buildpackage, mr:</p>
+
+<p>$sudo apt-get install git-buildpackage mr</p></li>
+<li><p>Add the following 2 lines in ~/.ssh/config</p>
+
+<p>Host alioth.debian.org svn.debian.org git.debian.org
+User user-guest</p></li>
+</ol>
+
+<p>Again the username will be the same as in step 2</p>
+
+<p>Probably the file ~/.ssh/config won't be present, so create it If it exists
+append to it.</p>
+
+<ol>
+<li><p>Clone the debian-in repository. (Note: you will be asked to enter your
+ssh-passphrase)</p>
+
+<p>$git clone git+ssh://username@git.debian.org/git/debian-in/debian-in.git</p></li>
+</ol>
+
+<p>Here, username is you alioth username, in my case it is techmaniack-guest.</p>
+
+<ol>
+<li>Execute ./make-mrconfig</li>
+</ol>
+
+<p>You can find this file inside debian-in/ directory created after step 2.</p>
+
+<ol>
+<li>Add the path to .mrconfig in ~/.mrtrust</li>
+</ol>
+
+<p>Step 4 will create ".mrconfig" inside debian-in/ Add the ABSOLUTE PATH of
+".mrconfig" to ~/.mrtrust. In my case the path was "/home/abdulkarim/projects/debian-in/.mrconfig"
+Most probably the file ~/.mrtrust won't be present, so create a new one. If it
+exists just append to it.</p>
+
+<ol>
+<li><p>Run "mr checkout"</p>
+
+<p>$debian-in/mr checkout</p></li>
+</ol>
+
+<p>This will populate your debian-in with the existing debian-in projects.</p>
+
+<h1>Build Packages</h1>
+
+<h2>Pushing the Debianized package to Debian-in repo</h2>
+
+<ol>
+<li><p>ssh into git.debian.org</p>
+
+<p><code>$ ssh username-guest at git.debian.org</code></p></li>
+</ol>
+
+<p>in my case it was $ssh techmaniack-guest at git.debian.org</p>
+
+<ol>
+<li><p>change the directory to "/git/debian-in"</p>
+
+<p><code>(ssh)$ cd /git/debian-in</code></p></li>
+<li><p>setup an empty repo for 'your package'</p>
+
+<p><code>(ssh)$ ./setup-repository package</code></p></li>
+</ol>
+
+<p>e.g. (ssh)$./setup-repository fonts-lohit-bn</p>
+
+<ul>
+<li>This is all that is to be done on the 'git.debian.org' server.</li>
+<li><p>You may close the ssh connection now.</p>
+
+<ol>
+<li>run "./make-mrconfig" on your local system</li>
+</ol>
+
+<p><code>$ ./make-mrconfig</code></p></li>
+</ul>
+
+<p>Note: execute this inside the "debian-in/" directory on your local system.</p>
+
+<ol>
+<li><p>Update your local debian-in repo</p>
+
+<p><code>$ mr update</code></p></li>
+</ol>
+
+<p>Note: execute this inside the "debian-in/" directory on your local system.</p>
+
+<ul>
+<li><p>this will add the empty repo created by you in step3 to your local system.</p>
+
+<ol>
+<li><p>Go to your package directory, the one created during step3.</p></li>
+<li><p>Import the .dsc file of 'your package' using "git-import-dsc"</p></li>
+</ol>
+
+<p><code>$git-import-dsc --pristine-tar /path/to/packagenameXYZ.dsc</code></p></li>
+<li><p>This should populate 'your project' directory.</p></li>
+<li><p>If any modification is to be done, do it now itself.</p>
+
+<ol>
+<li>Deleting the debian tag</li>
+</ol>
+
+<p><code>$git tag -d debian/version</code></p></li>
+</ul>
+
+<p>e.g. git tag -d debian/2.4.4-1</p>
+
+<ol>
+<li><p>push 'your package' to "Debian-in" repo at git.debian.org</p>
+
+<p><code>$ git push --all
+$ git push --tags
+</code>
+Note: if git push doesn't work, execute the following command once
+$git push origin master</p></li>
+<li><p>Inside package directory execute,</p>
+
+<p><code>$git-buildpackage</code></p>
+
+<p>You may need to update your ~/.gbp.conf
+See: https://gitorious.org/personal-configuration-files/conffiles/blobs/master/gbp.conf</p>
+
+<p>Your package will be built at: /var/cache/pbuilder/result by default.</p>
+
+<p>Check package for any Debian Policy violations using 'lintian' tool.</p></li>
+</ol>
+
+<p>[Sponsor/Uploaders only]</p>
+
+<ol>
+<li><p>Upload package. Make sure you run lintian tool before upload.</p></li>
+<li><p>Once package is uploaded, tag it:</p>
+
+<p><code>$ git tag debian/version
+$ git push --tags
+</code></p></li>
+<li>When new upstream version is available see below.</li>
+</ol>
+
+<h1>Importing New Upstream version</h1>
+
+<ol>
+<li><p>When there is a new version available for your package run following</p>
+
+<p><code>$ uscan</code></p></li>
+<li><p>This will download the new upstream tarball and create orig.tar symbolic link
+to it</p></li>
+<li><p>Run following command to import this new upstream version into git repo</p>
+
+<p><code>$ git-import-orig --pristine-tar ../package_version.orig.tar.gz</code></p></li>
+<li><p>Don't forget pristine-tar switch </p></li>
+<li><p>Additionally this import will run the git-dch for you but in case it fails due to
+error run git-dch yourself to update the debian/changelog</p></li>
+<li><p>Verify changes in new version if new files added / license changed update appropriates</p></li>
+<li><p>Once everything is done commit changes and push the changes to repository using following</p>
+
+<p><code>$ git push --all
+$ git push --tags</code></p></li>
+</ol>
+
+<h1>TODO</h1>
+
+<ol>
+<li>New upstream version - how-to?</li>
+<li>Prepare other format, probably HTML, MarkDown, PDF.</li>
+</ol>
+
+</body>
+</html>
diff --git a/docs/debian-in-git-packaging-how-to.txt b/docs/debian-in-git-packaging-how-to.txt
index 8766eaf..c4b55cd 100644
--- a/docs/debian-in-git-packaging-how-to.txt
+++ b/docs/debian-in-git-packaging-how-to.txt
@@ -54,17 +54,17 @@ Pushing the Debianized package to Debian-in repo
1. ssh into git.debian.org
- $ssh username-guest at git.debian.org
+ `$ ssh username-guest at git.debian.org`
in my case it was $ssh techmaniack-guest at git.debian.org
2. change the directory to "/git/debian-in"
- (ssh)$cd /git/debian-in
+ `(ssh)$ cd /git/debian-in`
3. setup an empty repo for 'your package'
- (ssh)$./setup-repository package
+ `(ssh)$ ./setup-repository package`
e.g. (ssh)$./setup-repository fonts-lohit-bn
@@ -73,13 +73,13 @@ e.g. (ssh)$./setup-repository fonts-lohit-bn
4. run "./make-mrconfig" on your local system
- $./make-mrconfig
+ `$ ./make-mrconfig`
Note: execute this inside the "debian-in/" directory on your local system.
5. Update your local debian-in repo
- $mr update
+ `$ mr update`
Note: execute this inside the "debian-in/" directory on your local system.
@@ -89,28 +89,28 @@ Note: execute this inside the "debian-in/" directory on your local system.
7. Import the .dsc file of 'your package' using "git-import-dsc"
- $git-import-dsc --pristine-tar /path/to/packagenameXYZ.dsc
+ `$git-import-dsc --pristine-tar /path/to/packagenameXYZ.dsc`
- This should populate 'your project' directory.
- If any modification is to be done, do it now itself.
8. Deleting the debian tag
- $git tag -d debian/version
+ `$git tag -d debian/version`
e.g. git tag -d debian/2.4.4-1
9. push 'your package' to "Debian-in" repo at git.debian.org
- $git push --all
- $git push --tags
-
+ `$ git push --all
+ $ git push --tags
+ `
Note: if git push doesn't work, execute the following command once
$git push origin master
10. Inside package directory execute,
- $git-buildpackage
+ `$git-buildpackage`
You may need to update your ~/.gbp.conf
See: https://gitorious.org/personal-configuration-files/conffiles/blobs/master/gbp.conf
@@ -125,12 +125,38 @@ Note: if git push doesn't work, execute the following command once
12. Once package is uploaded, tag it:
- $git tag debian/version
- $git push --tags
+ `$ git tag debian/version
+ $ git push --tags
+ `
+13. When new upstream version is available see below.
+
+
+Importing New Upstream version
+==============================
+
+1. When there is a new version available for your package run following
+
+ `$ uscan`
+
+2. This will download the new upstream tarball and create orig.tar symbolic link
+ to it
+
+3. Run following command to import this new upstream version into git repo
+
+ `$ git-import-orig --pristine-tar ../package_version.orig.tar.gz`
+
+4. Don't forget pristine-tar switch
+
+5. Additionally this import will run the git-dch for you but in case it fails due to
+ error run git-dch yourself to update the debian/changelog
+
+6. Verify changes in new version if new files added / license changed update appropriates
+
+7. Once everything is done commit changes and push the changes to repository using following
-13. When new upstream version is available,
+ `$ git push --all
+ $ git push --tags`
- $ See TODO 1.
TODO
====
--
Git repository for debian-in
More information about the Debian-in-commits
mailing list