diff options
| author | Glenn Morris | 2010-02-17 21:39:06 -0800 |
|---|---|---|
| committer | Glenn Morris | 2010-02-17 21:39:06 -0800 |
| commit | 83a5f630d4de941e356bd9ef8da004ce50a9072b (patch) | |
| tree | c7268f174178c9e4ca5f43792b3c44912e06b621 | |
| parent | 154d394bd37bd21516a1c4967d9acf4f1c47ddb4 (diff) | |
| download | emacs-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/CONTRIBUTE | 53 |
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 @@ | |||
| 1 | Copyright (C) 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. | 1 | Copyright (C) 2006, 2007, 2008, 2009, 2010 |
| 2 | Free Software Foundation, Inc. | ||
| 2 | See end for license conditions. | 3 | See 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 | ||
| 33 | Contributed code should follow the GNU Coding Standard. | 34 | Contributed code should follow the GNU Coding Standards. |
| 34 | 35 | ||
| 35 | If it doesn't, we'll need to find someone to fix the code before we | 36 | If it doesn't, we'll need to find someone to fix the code before we |
| 36 | can use it. | 37 | can 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 | ||
| 47 | We can accept small changes without legal papers, and for medium-size | 48 | We can accept small changes (roughly, fewer than 15 lines) without |
| 48 | changes a copyright disclaimer is ok too. To accept substantial | 49 | legal papers. Anything more substantial requires a copyright |
| 49 | contributions from you, we need a copyright assignment form filled out | 50 | disclaimer or assignment (the latter is preferred, especially for |
| 50 | and filed with the FSF. | 51 | larger changes). Both of these involved filling out a short form and |
| 51 | 52 | filing it with the FSF. The process is straightforward -- contact us | |
| 52 | Contact us at emacs-devel@gnu.org to obtain the relevant forms. | 53 | at 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 | ||
| 57 | The latest version of Emacs can be downloaded using CVS (or other | 58 | The latest version of Emacs can be downloaded using Bazaar from the |
| 58 | version control systems) from the Savannah web site. It is important | 59 | Savannah web site. It is important to write your patch based on the |
| 59 | to write your patch based on this version; if you start from an older | 60 | latest version. If you start from an older version, your patch may be |
| 60 | version, your patch may be outdated when you write it, and maintainers | 61 | outdated (so that maintainers will have a hard time applying it), or |
| 61 | will have a hard time applying it. | 62 | changes in Emacs may have made your patch unnecessary. |
| 62 | 63 | ||
| 63 | After you have downloaded the CVS source, you should read the file | 64 | After you have downloaded the Bazaar source, you should read the file |
| 64 | INSTALL.CVS for build instructions (they differ to some extent from a | 65 | INSTALL.BZR for build instructions (they differ to some extent from a |
| 65 | normal build). | 66 | normal build). |
| 66 | 67 | ||
| 67 | Ref: http://savannah.gnu.org/projects/emacs | 68 | Ref: http://savannah.gnu.org/projects/emacs |
| @@ -75,7 +76,7 @@ can properly evaluate it. | |||
| 75 | When you have all these pieces, bundle them up in a mail message and | 76 | When you have all these pieces, bundle them up in a mail message and |
| 76 | send it to bug-gnu-emacs@gnu.org or emacs-devel@gnu.org. | 77 | send it to bug-gnu-emacs@gnu.org or emacs-devel@gnu.org. |
| 77 | 78 | ||
| 78 | All subsequent discussion should also be sent to the mailing list. | 79 | All 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 | ||
| 89 | A ChangeLog entry as plaintext (separate from the patch). | 90 | A ChangeLog entry as plaintext (separate from the patch). |
| 90 | 91 | ||
| 91 | See the various ChangeLog files for format and content. Note that, | 92 | See the various ChangeLog files for format and content. Note that, |
| 92 | unlike some other projects, we do require ChangeLogs also for | 93 | unlike some other projects, we do require ChangeLogs also for |
| 93 | documentation, i.e. Texinfo files. | 94 | documentation, i.e. Texinfo files. |
| 94 | 95 | ||
| @@ -99,9 +100,10 @@ Manual, for how to write good log entries. | |||
| 99 | 100 | ||
| 100 | Please use "Context Diff" format. | 101 | Please use "Context Diff" format. |
| 101 | 102 | ||
| 102 | If you are accessing the CVS repository use | 103 | If you are accessing the Bazaar repository, make sure your copy is |
| 103 | cvs update; cvs diff -cp | 104 | up-to-date (e.g. with `bzr pull'), then use |
| 104 | else, use | 105 | bzr diff --no-aliases --diff-options=-cp |
| 106 | Else, use | ||
| 105 | diff -cp OLD NEW | 107 | diff -cp OLD NEW |
| 106 | 108 | ||
| 107 | If your version of diff does not support these options, then get the | 109 | If your version of diff does not support these options, then get the |
| @@ -122,6 +124,11 @@ as a last resort, uuencoded gzipped text. | |||
| 122 | If you send several unrelated changes together, we will ask you to | 124 | If you send several unrelated changes together, we will ask you to |
| 123 | separate them so we can consider each of the changes by itself. | 125 | separate them so we can consider each of the changes by itself. |
| 124 | 126 | ||
| 127 | ** Do not make formatting changes. | ||
| 128 | |||
| 129 | Making cosmetic formatting changes (indentation, etc) makes it harder | ||
| 130 | to 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 | ||
| 144 | Once you become a frequent contributor to Emacs, we can consider | 151 | Once you become a frequent contributor to Emacs, we can consider |
| 145 | giving you write access to the CVS repository. | 152 | giving you write access to the Bazaar repository. |
| 146 | 153 | ||
| 147 | 154 | ||
| 148 | ** Emacs Mailing lists. | 155 | ** Emacs Mailing lists. |
| 149 | 156 | ||
| 150 | Discussion about Emacs development takes place on emacs-devel@gnu.org. | 157 | Discussion about Emacs development takes place on emacs-devel@gnu.org. |
| 151 | 158 | ||
| 152 | Bug reports are sent to bug-gnu-emacs@gnu.org. | 159 | Bug reports and feature requests are sent to bug-gnu-emacs@gnu.org. |
| 153 | 160 | ||
| 154 | You can subscribe to the mailing lists at savannah.gnu.org/projects/emacs. | 161 | You can subscribe to the mailing lists at savannah.gnu.org/projects/emacs. |
| 155 | 162 | ||