source: branches/contrib/openwrt/patches/README @ 406

Last change on this file since 406 was 406, checked in by ehem, 10 years ago

Everyone's favorite, documentation. Hopefully this is an improvement over
the last version. Also adding a mention of the ability to include a branch
name in the filename, unlikely to be used by DebWRT patches, but quite possibly
useful for plugin patches to OpenWRT.

File size: 2.1 KB
Line 
1DebWrt patch subsystem to patch OpenWrt
2
3Reworked by ehem since r349. Thanks!
4
5all/      Patches that apply to all branches of OpenWrt
6trunk/    Patches that apply only to OpenWrt trunk
7backfire/ Patches that apply only to OpenWrt backfire branch
8
9Patches in these directories must have filenames of the form:
10
11<nnn>_<desc>
12        Apply patch to all revisions
13<nnn>[-<branch>][-[<first>]:[<last>]]_<desc>
14        The portions in brackets [] are optional.  If present, <branch> will
15        cause the patch to only be applied to the indicated branch of OpenWrt,
16        "all" will make it applIy to all branches.  <first> and <last> are used
17        to indicate an inclusive range of OpenWrt revisions which the patch
18        applies to.  If <last> is omitted, it will be applied to all revisions
19        after <first>.  If <first> is omitted, it will be applied to all
20        revisions before <last>.  If <first> equals <last>, it will be applied
21        to that single revision.  If <first> is greater than <last>, it will
22        never be used.
23
24
25<nnn>  is used to set order of application. Lower numbered patches are applied
26       first. The ordering is done by running the list of patches through
27       `sort`, as a result,  "1000_foo" will be done before "200_bar".
28
29<desc> contains a functional description of the patch. Usually separated by
30       underscores.
31
32Minor technical note: The script is actually trying to parse everything up to
33the first underscore. Everything after that is ignored.
34
35
36Patches are applied inside the checked out OpenWRT using `patch -p0`. Patches
37directly from other sources may need to be adjusted to match this (the command
38`sed -e's/^\(\(+++\)\|\(---\)\) [^\/]*\//\1 /' -i` will do this).
39
40
41Make targets
42------------
43make openwrt/patch
44maken openwrt/unpatch
45
46
47Create new patch example
48------------------------
49cd build/openwrt-<...>/
50wget -O packages/broadcom-wl/patches/999_remove_IRWF_SAMPLE_RANDOM \
51        https://dev.openwrt.org/raw-attachment/ticket/12248/remove_IRWF_SAMPLE_RANDOM.patch
52diff -Nu packages/broadcom-wl/patchesnew/999_remove_IRWF_SAMPLE_RANDOM \
53         packages/broadcom-wl/patches/999_remove_IRWF_SAMPLE_RANDOM \
54         > ../../030-33559:_broadcom-wl_remove_IRWF_SAMPLE_RANDOM.patch
55
Note: See TracBrowser for help on using the repository browser.