annotate DOCS/tech/patches.txt @ 4202:408302343afe

mail formatting added
author arpi
date Thu, 17 Jan 2002 00:26:40 +0000
parents 95b8a1e7962d
children ff80fbfa06f5
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
4202
408302343afe mail formatting added
arpi
parents: 2121
diff changeset
27 bzip2 *only* if it's really big or if you know that your mailer messes
408302343afe mail formatting added
arpi
parents: 2121
diff changeset
28 up (re-format) text attachments).
408302343afe mail formatting added
arpi
parents: 2121
diff changeset
29 Subject line should be: '[PATCH] very short description of the patch'.
408302343afe mail formatting added
arpi
parents: 2121
diff changeset
30 In the mail, describe in a few sentences what (and why) are the changes.
408302343afe mail formatting added
arpi
parents: 2121
diff changeset
31 If you made independent changes, try to send them as separate patches.
2121
95b8a1e7962d sending patches
arpi
parents:
diff changeset
32
95b8a1e7962d sending patches
arpi
parents:
diff changeset
33 Thank you!
95b8a1e7962d sending patches
arpi
parents:
diff changeset
34
95b8a1e7962d sending patches
arpi
parents:
diff changeset
35 A'rpi