/[linux-patches]/genpatches-2.6-misc/repo-doc/10_scripts
Gentoo

Contents of /genpatches-2.6-misc/repo-doc/10_scripts

Parent Directory Parent Directory | Revision Log Revision Log


Revision 26 - (show annotations) (download)
Sun Jun 12 14:16:46 2005 UTC (9 years, 4 months ago) by dsd
File size: 2687 byte(s)
script and doc updates
1 Intro
2 =====
3
4 Some scripts are used to aid maintenance (rolling releases, branching, etc).
5
6 Subversion has some nice features to maintain history while copying and
7 branching, which are used by these scripts.
8
9 For ease of use, these scripts use abbreviated arguments. The following
10 invokation would probably act on the 2.6.11 branch:
11
12 # gpwhatever 11
13
14 And the following invokation would probably act on patch with code 1014 in the
15 2.6.11 branch:
16
17 # gpwhatever 11 1014
18
19 Global Configuration
20 ====================
21
22 To use the scripts, you need to create a .genpatchesrc file in your home
23 directory. This file is sourced as raw bash. You simply set some configuration
24 variables.
25
26 Here's a sample config:
27
28 --- start ~/.genpatchesrc -----------------------------------------------------
29
30 # Your username for Gentoo SVN
31 USERNAME="dsd"
32
33 # The path to the directory where you have checked out trunk
34 GENPATCHES_TRUNK="/home/dsd/projects/gentoo/genpatches"
35
36 --- end ~/.genpatchesrc -------------------------------------------------------
37
38 gppatch
39 =======
40
41 Applies a single genpatches patch to a kernel source tree in the current
42 directory.
43
44 Usage:
45 # cd /usr/src/linux
46 # gppatch 11 1025
47
48 This will take the patch with code 1025 from the 2.6.11 branch of your trunk
49 checkout and apply it.
50
51 Any additional arguments you specify will be passed onto patch(1) as normal.
52 To dry-run a patch you can do:
53
54 # gppatch 11 1030 --dry-run
55
56 gpmultipatch
57 ============
58
59 Applies a trunk genpatches branch to a kernel source tree in the current
60 directory.
61
62 This will cycle through all the patches in numerical order and apply them.
63
64 Usage:
65 # cd /usr/src/linux
66 # gpmultipatch 11
67
68 This will apply all the patches in the 2.6.11 branch to /usr/src/linux.
69 Each patch is checked with dry-run before being applied. If a patch fails the
70 dry-run test, then it is not applied and the entire script halts there, telling
71 you which patch needs fixing.
72
73 Assume that it tells you patch 2900 fails to apply. You'd then create a new
74 kernel tree and do a rediff or whatever. Once you have fixed up the patch, you
75 can tell gpmultipatch to continue applying the series from that particular
76 patch:
77
78 # cd /usr/src/linux
79 # gpmultipatch 11 2900
80
81 This will apply the 2.6.11 branch patches in order, but ignoring all patches
82 with code less than 2900.
83
84 gpdorelease
85 ===========
86
87 Takes a branch, produces tarballs, uploads tarballs to toucan, and tags the
88 release snapshot in SVN.
89
90 See 20_release-howto
91
92 TODO:
93 QA checks
94 Sanity checks (svn status is empty etc)
95 Post-commit hooks
96
97 gpcreatebranch
98 ==============
99
100 To be written: Copy one branch to another under trunk.
101
102 gpmvhistorical
103 ==============
104
105 To be written: Move a trunk branch into historical

  ViewVC Help
Powered by ViewVC 1.1.20