annotate DOCS/tech/patches.txt @ 2121:95b8a1e7962d

sending patches
author arpi
date Sun, 07 Oct 2001 16:34:47 +0000
parents
children 408302343afe
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2121
95b8a1e7962d sending patches
arpi
parents:
diff changeset
1 Sending patches:
95b8a1e7962d sending patches
arpi
parents:
diff changeset
2 ~~~~~~~~~~~~~~~~
95b8a1e7962d sending patches
arpi
parents:
diff changeset
3 Note: We know these rules are hard, but it's hard to maintain such
95b8a1e7962d sending patches
arpi
parents:
diff changeset
4 big and complex project, so you should accept our rules. We have no
95b8a1e7962d sending patches
arpi
parents:
diff changeset
5 time for fixing buggy, broken or old patches!
95b8a1e7962d sending patches
arpi
parents:
diff changeset
6
95b8a1e7962d sending patches
arpi
parents:
diff changeset
7 1. Always make patch for the CVS version.
95b8a1e7962d sending patches
arpi
parents:
diff changeset
8 We do not accept patches for old versions or releases.
95b8a1e7962d sending patches
arpi
parents:
diff changeset
9
95b8a1e7962d sending patches
arpi
parents:
diff changeset
10 2. Make unified diffs ('diff -Naur' or 'cvs diff -u')
95b8a1e7962d sending patches
arpi
parents:
diff changeset
11
95b8a1e7962d sending patches
arpi
parents:
diff changeset
12 3. Test functionality of your patch. We'll *refuse* it if it breaks
95b8a1e7962d sending patches
arpi
parents:
diff changeset
13 something, even if it extends other features!
95b8a1e7962d sending patches
arpi
parents:
diff changeset
14
95b8a1e7962d sending patches
arpi
parents:
diff changeset
15 4. Read your patch. We'll *refuse* it if it changes indent of the
95b8a1e7962d sending patches
arpi
parents:
diff changeset
16 code or it does tab/space or other cosmetical changes!
95b8a1e7962d sending patches
arpi
parents:
diff changeset
17
95b8a1e7962d sending patches
arpi
parents:
diff changeset
18 5. Comment parts what really needs it (has tricky side-effects etc).
95b8a1e7962d sending patches
arpi
parents:
diff changeset
19 Commenting trivial code not requires. Comments must be english!
95b8a1e7962d sending patches
arpi
parents:
diff changeset
20
95b8a1e7962d sending patches
arpi
parents:
diff changeset
21 6. Do not ask for CVS write access at first time. If you contributed
95b8a1e7962d sending patches
arpi
parents:
diff changeset
22 1 or more nice, acceptable patches and they need maintaining or
95b8a1e7962d sending patches
arpi
parents:
diff changeset
23 you want to be mplayer developer, you'll get CVS write access.
95b8a1e7962d sending patches
arpi
parents:
diff changeset
24
95b8a1e7962d sending patches
arpi
parents:
diff changeset
25 7. Subscribe to the mplayer-dev-eng list (don't worry, it's low traffic)
95b8a1e7962d sending patches
arpi
parents:
diff changeset
26 and send your patch there as base64-encoded attachment (use gzip or
95b8a1e7962d sending patches
arpi
parents:
diff changeset
27 bzip2 *only* if it's really big). Also describe in a few sentences
95b8a1e7962d sending patches
arpi
parents:
diff changeset
28 what (and why) are the changes.
95b8a1e7962d sending patches
arpi
parents:
diff changeset
29
95b8a1e7962d sending patches
arpi
parents:
diff changeset
30 Thank you!
95b8a1e7962d sending patches
arpi
parents:
diff changeset
31
95b8a1e7962d sending patches
arpi
parents:
diff changeset
32 A'rpi