← Back to branch summary

~ubuntu-branches/ubuntu/utopic/module-assistant/utopic

« back to all changes in this revision

Viewing changes to debian/README.source

  • Committer: Bazaar Package Importer
  • Author(s): Bhavani Shankar
  • Date: 2009-06-11 12:33:16 UTC
  • mfrom: (2.1.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090611123316-yjd5peu4pzh18y1v
Tags: 0.11.1ubuntu1
https://launchpad.net/bugs/311100
* Merge from debian unstable, remaining changes: LP: #311100
  - fglrx-kernel-src -> fglrx-kernel-source.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.source
 
1
Source README for module-assistant:
 
2
-----------------------------------
 
3
 
 
4
Some extra targets exist in debian/rules to help with common tasks.
 
5
 
 
6
 
 
7
 + Build the final source package:
 
8
   -------------------------------
 
9
 
 
10
   How:
 
11
      make -f debian/rules source-package
 
12
 
 
13
   Why:
 
14
    - For native packages, the directory can't be changed when
 
15
      dpkg-source is run, so the tarball needs to be of the
 
16
      $package-$version form.
 
17
    - The .git/ directory would be embedded, even with “-i”.
 
18
 
 
19
   Summary of what it does:
 
20
    - Use “git archive | gzip” to create the tarball.
 
21
    - Extract it, run “debuild -S” there, clean.
 
22
 
 
23
   What it needs:
 
24
    - git (git-core).
 
25
 
 
26
 
 
27
 + Prepare a changelog entry:
 
28
   --------------------------
 
29
 
 
30
   How:
 
31
      make -f debian/rules prepare-changelog
 
32
 
 
33
   Why:
 
34
    - In order to avoid duplicating git log messages directly in
 
35
      debian/changelog (although it could be done thanks to
 
36
      “debcommit”), and to make debian/changelog more concise (when a
 
37
      commit fixes a mistake in a previous one or improves one, a
 
38
      single line could be written), that target is to be called when
 
39
      finalizing an upload. That way, a prospective changelog entry is
 
40
      written, and can then be rephrased as wanted before it is
 
41
      committed.
 
42
 
 
43
   Summary of what it does:
 
44
    - Determine the last known tag, using “git describe”.
 
45
    - Determine the current branch, using “git branch”.
 
46
    - Call “git-dch” with those parameters, so as to prepare a
 
47
      changelog entry with all commit messages since the last known
 
48
      tag.
 
49
 
 
50
   What it needs:
 
51
    - git-dch (git-buildpackage).
 
52
    - git (git-core).
 
53
 
 
54
 
 
55
 + Commit the tarball to the pristine-tar branch:
 
56
   ----------------------------------------------
 
57
 
 
58
   How:
 
59
      make -f debian/rules pristine-tar-commit
 
60
 
 
61
   Why:
 
62
    - Make it possible to commit very easily the tarball once a
 
63
      version has been built, uploaded, and tagged, so that it is
 
64
      possible to regenerate the exact tarball that was uploaded, only
 
65
      from the git repository.
 
66
 
 
67
   Summary of what it does:
 
68
    - Determine the version, and the tarball name.
 
69
    - Make sure the tarball is available in the parent directory.
 
70
    - Commit it using “pristine-tar” and the determined version.
 
71
 
 
72
   What it needs:
 
73
    - pristine-tar (pristine-tar).
 
74
 
 
75
 
 
76
 -- Cyril Brulebois <kibi@debian.org>, Wed, 25 Mar 2009 00:57:43 +0100