~ubuntu-branches/ubuntu/raring/doc-debian/raring

« back to all changes in this revision

Viewing changes to doc/source-unpack.txt

  • Committer: Bazaar Package Importer
  • Author(s): Josip Rodin
  • Date: 2002-04-30 19:02:09 UTC
  • Revision ID: james.westby@ubuntu.com-20020430190209-v94hhhb9wj0kz552
Tags: 3.0
* Updated for the imminent woody release.
* Updated BTS docs from the FTP site, closes: #133422, #133440.
* Updated description of frozen, closes: #142801.
* Built a PDF version.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
        HOW TO UNPACK A DEBIAN SOURCE PACKAGE
 
2
 
 
3
There are two kinds of Debian source packages: old ones and new ones.
 
4
 
 
5
A. Old ones look like this:
 
6
      hello-1.3-4.tar.gz
 
7
      hello-1.3-4.diff.gz
 
8
 You unpack them by untarring the .tar.gz.  There is NO need to apply
 
9
 the diff.
 
10
 
 
11
B. New ones look like this:
 
12
      hello_1.3-11.dsc
 
13
      hello_1.3-11.diff.gz
 
14
      hello_1.3-11.orig.tar.gz - note the `.orig' part
 
15
 Here you MUST use dpkg-source or apply the diff manually - see below.
 
16
 
 
17
 If you have `dpkg-source' you should put the files in the same
 
18
 directory and type `dpkg-source -x <whatever>.dsc'.
 
19
 
 
20
 If you do not you can extract the Debian source as follows:
 
21
   1. untar P_V.orig.tar.gz.
 
22
   2. rename the resulting P-V.orig directory to P-V.  If some other
 
23
      directory results, rename *it* to P-V.
 
24
   3. mkdir P-V/debian.
 
25
   4. apply the diff with patch -p0.
 
26
   5. do `chmod +x P-V/debian/rules'
 
27
 (where P is the package name and V the version.)
 
28
 
 
29
C. There are some packages where the Debian source is the upstream
 
30
 source.  In this case there will be no .diff.gz and you can just use
 
31
 the .tar.gz.  If a .dsc is provided you can use `dpkg-source -x'.
 
32
 
 
33
 -- Ian Jackson <ijackson@gnu.ai.mit.edu>  Sat, 31 Aug 1996