~ubuntu-branches/ubuntu/precise/boinc/precise

« back to all changes in this revision

Viewing changes to debian/README.source

Tags: 6.12.8+dfsg-1
* New upstream release.
* Simplified debian/rules

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Modifications to the upstream source:
2
 
 This package uses quilt to manage all modifications to the upstream
3
 
 source. Changes are stored in the source package as diffs in
4
 
 debian/patches and applied during the build.
5
 
 
6
 
 Refer to /usr/share/doc/quilt/README.source for details.
 
1
Modifications to the upstream source
 
2
====================================
 
3
 This package uses the Debian quilt format to manage all modifications
 
4
 to the upstream source. Changes are stored in the source package as
 
5
 diffs in debian/patches and applied during the build.
7
6
 
8
7
Repackaged upstream source:
 
8
===========================
9
9
 The BOINC project does not distribute source code releases as tarballs,
10
10
 but they are tagged in the BOINC Subversion repository.  Anonymous
11
11
 Subversion access is available at http://boinc.berkeley.edu/svn/. The
16
16
 
17
17
 To obtain the source from Subversion and package it as .orig.tar.gz the
18
18
 Debian BOINC Maintainers use a script called 'export-boinc' which is
19
 
 available in our pkg-boinc Subversion repository:
20
 
 
21
 
   http://svn.debian.org/wsvn/pkg-boinc/scripts/export-boinc?op=file
22
 
 
23
 
 For example, to obtain the .orig.tar.gz tarball for BOINC version 5.8.17
24
 
 this script is invoked as:
25
 
 
26
 
   $ export-boinc -r 5.8.17
 
19
 available in our pkg-boinc Git repository:
 
20
 
 
21
   wget -O export-boinc \
 
22
    "http://git.debian.org/?p=pkg-boinc/scripts.git;a=blob_plain;f=export-boinc;hb=HEAD"
 
23
   chmod 755 export-boinc
 
24
 
 
25
 The latest tags upstream presents at http://boinc.berkeley.edu/svn/tags/ .
 
26
 Choose 'the right one' of those.  To obtain the .orig.tar.gz
 
27
 tarball for BOINC tag 6_10_58 this script is invoked as:
 
28
 
 
29
   $ ./export-boinc -r 6.10.58
 
30
 
 
31
 It will take a considerable while to download as the final tarball yields >15MB.
 
32
 The script will take care of remove the non-DFSG files from the upstream
 
33
 tag.
 
34
 
 
35
 Above process is integrated into debian/rules's get-orig-source target. It will
 
36
 download the very latest version unless an environment variable VERSION was set:
 
37
   $ VERSION=6.10.58 ./debian/rules get-orig-source
 
38
 
 
39
 
 
40
Removed non-dfsg upstream files
 
41
===============================
 
42
 The files removed from upstream tag are:
 
43
 
 
44
   client/mac
 
45
   clientgui/mac
 
46
   mac_build
 
47
   mac_installer
 
48
   win_build
 
49
   coprocs
 
50
   client/app_stats_mac.cpp
 
51
 
 
52
 
 
53
Debian packaging VCS
 
54
=====================
 
55
 Very recently, the management of the packaging has moved from subversion
 
56
 to a git repository. The Wiki pages hold instructions for using git,
 
57
 see http://wiki.debian.org/BOINC/Development/GitUsage for details.
 
58
 The site also offers further references for the current and future
 
59
 contributors - you? Give it a try.