~rohangarg/plasma-widget-networkmanagement/ubuntu

« back to all changes in this revision

Viewing changes to debian/README.source

  • Committer: Alessandro Ghersi
  • Date: 2010-04-17 17:10:22 UTC
  • Revision ID: alessandro-ghersi@kubuntu.org-20100417171022-kkjhwhrr1e2v0utw
Initial import

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
This package uses git+topgit as the packaging VCS. Please install Debian topgit
 
2
package 0.5 or higher and read /usr/share/doc/topgit/HOWTO-tg2quilt.gz for more
 
3
information how to checkout, add, remove, modify patches (topic branches) and
 
4
do other common tasks. Branch structure of the repository is as follows:
 
5
 
 
6
* upstream   - upstream source code.
 
7
* master     - the Debianization branch (upstream source and debian directory).
 
8
               This branch also contains exported debian/patches ready for
 
9
               building.
 
10
 
 
11
Topic branches should be named as follows:
 
12
 
 
13
* general/*  - namespace for general upstream patches. Patches can be named
 
14
               freely, but it is recommended to suffix names with '_fix' for
 
15
               patches fixing bugs and with '_feature' for patches introducing
 
16
               new features. These patches should be based on the upstream
 
17
               branch.
 
18
* debian/*   - Debian specific patches should be put in this namespace. These
 
19
               patches should be based on the upstream branch or even master
 
20
               branch if necessary.
 
21
 
 
22
If a patch depends on any other patch(es), create/adjust its topic branch
 
23
dependencies as needed.
 
24
 
 
25
However, topgit is not a build dependency. Patches are exported to
 
26
debian/patches as quilt series before building. Please read
 
27
/usr/share/doc/quilt/README.source (quilt version 0.46-4.1 or later) for more
 
28
information on how to manage patches directly with quilt. Please note that this
 
29
method is not acceptable for long term package management, only for quick
 
30
patching.