aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2010-02-17 21:39:06 -0800
committerGlenn Morris2010-02-17 21:39:06 -0800
commit83a5f630d4de941e356bd9ef8da004ce50a9072b (patch)
treec7268f174178c9e4ca5f43792b3c44912e06b621
parent154d394bd37bd21516a1c4967d9acf4f1c47ddb4 (diff)
downloademacs-83a5f630d4de941e356bd9ef8da004ce50a9072b.tar.gz
emacs-83a5f630d4de941e356bd9ef8da004ce50a9072b.zip
CONTRIBUTE: Various minor updates and changes.
Mostly related to the change from CVS to Bazaar.
-rw-r--r--etc/CONTRIBUTE53
1 files changed, 30 insertions, 23 deletions
diff --git a/etc/CONTRIBUTE b/etc/CONTRIBUTE
index 1ae0a690018..99f24653ac9 100644
--- a/etc/CONTRIBUTE
+++ b/etc/CONTRIBUTE
@@ -1,4 +1,5 @@
1Copyright (C) 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. 1Copyright (C) 2006, 2007, 2008, 2009, 2010
2 Free Software Foundation, Inc.
2See end for license conditions. 3See end for license conditions.
3 4
4 5
@@ -30,7 +31,7 @@ Here are some style and legal conventions for contributors to Emacs:
30 31
31* Coding Standards 32* Coding Standards
32 33
33Contributed code should follow the GNU Coding Standard. 34Contributed code should follow the GNU Coding Standards.
34 35
35If it doesn't, we'll need to find someone to fix the code before we 36If it doesn't, we'll need to find someone to fix the code before we
36can use it. 37can use it.
@@ -44,24 +45,24 @@ Ref: The "Tips" Appendix in the Emacs Lisp Reference.
44 45
45* Copyright Assignment 46* Copyright Assignment
46 47
47We can accept small changes without legal papers, and for medium-size 48We can accept small changes (roughly, fewer than 15 lines) without
48changes a copyright disclaimer is ok too. To accept substantial 49legal papers. Anything more substantial requires a copyright
49contributions from you, we need a copyright assignment form filled out 50disclaimer or assignment (the latter is preferred, especially for
50and filed with the FSF. 51larger changes). Both of these involved filling out a short form and
51 52filing it with the FSF. The process is straightforward -- contact us
52Contact us at emacs-devel@gnu.org to obtain the relevant forms. 53at emacs-devel@gnu.org to obtain the relevant forms.
53 54
54 55
55* Getting the Source Code 56* Getting the Source Code
56 57
57The latest version of Emacs can be downloaded using CVS (or other 58The latest version of Emacs can be downloaded using Bazaar from the
58version control systems) from the Savannah web site. It is important 59Savannah web site. It is important to write your patch based on the
59to write your patch based on this version; if you start from an older 60latest version. If you start from an older version, your patch may be
60version, your patch may be outdated when you write it, and maintainers 61outdated (so that maintainers will have a hard time applying it), or
61will have a hard time applying it. 62changes in Emacs may have made your patch unnecessary.
62 63
63After you have downloaded the CVS source, you should read the file 64After you have downloaded the Bazaar source, you should read the file
64INSTALL.CVS for build instructions (they differ to some extent from a 65INSTALL.BZR for build instructions (they differ to some extent from a
65normal build). 66normal build).
66 67
67Ref: http://savannah.gnu.org/projects/emacs 68Ref: http://savannah.gnu.org/projects/emacs
@@ -75,7 +76,7 @@ can properly evaluate it.
75When you have all these pieces, bundle them up in a mail message and 76When you have all these pieces, bundle them up in a mail message and
76send it to bug-gnu-emacs@gnu.org or emacs-devel@gnu.org. 77send it to bug-gnu-emacs@gnu.org or emacs-devel@gnu.org.
77 78
78All subsequent discussion should also be sent to the mailing list. 79All subsequent discussion should be sent to the same mailing list.
79 80
80** Description 81** Description
81 82
@@ -88,7 +89,7 @@ For new features, a description of the feature and your implementation.
88 89
89A ChangeLog entry as plaintext (separate from the patch). 90A ChangeLog entry as plaintext (separate from the patch).
90 91
91See the various ChangeLog files for format and content. Note that, 92See the various ChangeLog files for format and content. Note that,
92unlike some other projects, we do require ChangeLogs also for 93unlike some other projects, we do require ChangeLogs also for
93documentation, i.e. Texinfo files. 94documentation, i.e. Texinfo files.
94 95
@@ -99,9 +100,10 @@ Manual, for how to write good log entries.
99 100
100Please use "Context Diff" format. 101Please use "Context Diff" format.
101 102
102If you are accessing the CVS repository use 103If you are accessing the Bazaar repository, make sure your copy is
103 cvs update; cvs diff -cp 104up-to-date (e.g. with `bzr pull'), then use
104else, use 105 bzr diff --no-aliases --diff-options=-cp
106Else, use
105 diff -cp OLD NEW 107 diff -cp OLD NEW
106 108
107If your version of diff does not support these options, then get the 109If your version of diff does not support these options, then get the
@@ -122,6 +124,11 @@ as a last resort, uuencoded gzipped text.
122If you send several unrelated changes together, we will ask you to 124If you send several unrelated changes together, we will ask you to
123separate them so we can consider each of the changes by itself. 125separate them so we can consider each of the changes by itself.
124 126
127** Do not make formatting changes.
128
129Making cosmetic formatting changes (indentation, etc) makes it harder
130to see what you have really changed.
131
125 132
126* Coding style and conventions. 133* Coding style and conventions.
127 134
@@ -139,17 +146,17 @@ included in Emacs.
139 146
140* Supplemental information for Emacs Developers. 147* Supplemental information for Emacs Developers.
141 148
142** Write access to Emacs' CVS repository. 149** Write access to the Emacs repository.
143 150
144Once you become a frequent contributor to Emacs, we can consider 151Once you become a frequent contributor to Emacs, we can consider
145giving you write access to the CVS repository. 152giving you write access to the Bazaar repository.
146 153
147 154
148** Emacs Mailing lists. 155** Emacs Mailing lists.
149 156
150Discussion about Emacs development takes place on emacs-devel@gnu.org. 157Discussion about Emacs development takes place on emacs-devel@gnu.org.
151 158
152Bug reports are sent to bug-gnu-emacs@gnu.org. 159Bug reports and feature requests are sent to bug-gnu-emacs@gnu.org.
153 160
154You can subscribe to the mailing lists at savannah.gnu.org/projects/emacs. 161You can subscribe to the mailing lists at savannah.gnu.org/projects/emacs.
155 162