Commit | Line | Data |
---|---|---|
302ab118 DD |
1 | ========= Binutils Maintainers ========= |
2 | ||
3 | This is the list of individuals responsible for maintenance and update | |
1b577b00 NC |
4 | of the GNU Binary Utilities project. This includes the linker (ld), |
5 | the assembler (gas), the profiler (gprof), a whole suite of other | |
6 | programs (binutils) and the libraries that they use (bfd and | |
7 | opcodes). This project shares a common set of header files with the | |
eacf2b70 | 8 | GCC and GDB projects (include), so maintainership of those files is |
1b577b00 | 9 | shared amoungst the projects. |
302ab118 | 10 | |
1b577b00 | 11 | The home page for binutils is: |
8c2bc687 | 12 | |
1b577b00 NC |
13 | http://www.gnu.org/software/binutils/binutils.html |
14 | ||
15 | and patches should be sent to: | |
16 | ||
eacf2b70 AM |
17 | binutils@sourceware.org |
18 | ||
1b577b00 | 19 | with "[Patch]" as part of the subject line. Note - patches to the |
04fbe429 | 20 | top level config.guess and config.sub scripts should be sent to: |
302ab118 | 21 | |
1b577b00 | 22 | config-patches@gnu.org |
302ab118 | 23 | |
04fbe429 | 24 | and not to the binutils lists. Patches to the other top level |
73fb7068 RS |
25 | configure files (configure, configure.in, config-ml.in) should |
26 | be sent to the binutils lists, and copied to the gcc and gdb | |
04fbe429 | 27 | lists as well (gcc-patches@gcc.gnu.org and |
eacf2b70 | 28 | gdb-patches@sourceware.org). |
1b577b00 NC |
29 | |
30 | --------- Blanket Write Privs --------- | |
302ab118 | 31 | |
1b577b00 NC |
32 | The following people have permission to check patches into the |
33 | repository without obtaining approval first: | |
eacf2b70 | 34 | |
1b577b00 NC |
35 | Nick Clifton <nickc@redhat.com> (head maintainer) |
36 | Richard Henderson <rth@redhat.com> | |
3517749c | 37 | Ian Lance Taylor <ian@airs.com> |
1b577b00 | 38 | Jeff Law <law@redhat.com> |
4b3be0b6 | 39 | Jim Wilson <wilson@tuliptree.org> |
1b577b00 NC |
40 | DJ Delorie <dj@redhat.com> |
41 | Alan Modra <amodra@bigpond.net.au> | |
2445335e | 42 | Michael Meissner <gnu@the-meissners.org> |
41772c33 | 43 | Daniel Jacobowitz <dan@debian.org> |
93abc97a | 44 | Richard Sandiford <rdsandiford@googlemail.com> |
1b577b00 NC |
45 | |
46 | --------- Maintainers --------- | |
47 | ||
48 | Maintainers are individuals who are responsible for, and have | |
49 | permission to check in changes in, certain subsets of the code. Note | |
50 | that maintainers still need approval to check in changes outside of | |
51 | the immediate domain that they maintain. | |
302ab118 DD |
52 | |
53 | If there is no maintainer for a given domain then the responsibility | |
1b577b00 NC |
54 | falls to the head maintainer (above). If there are several |
55 | maintainers for a given domain then responsibility falls to the first | |
56 | maintainer. The first maintainer is free to devolve that | |
57 | responsibility among the other maintainers. | |
58 | ||
1b50a348 | 59 | ALPHA Richard Henderson <rth@redhat.com> |
1b577b00 | 60 | ARM Nick Clifton <nickc@redhat.com> |
3a7e524e | 61 | ARM Richard Earnshaw <rearnsha@arm.com> |
336becc7 | 62 | ARM Paul Brook <paul@codesourcery.com> |
0dffe982 | 63 | ARM (Symbian) Mark Mitchell <mark@codesourcery.com> |
1b577b00 | 64 | AVR Denis Chertykov <denisc@overta.ru> |
e0159aa9 | 65 | AVR Marek Michalkiewicz <marekm@amelek.gda.pl> |
6cc1ddc9 | 66 | BFIN Jie Zhang <jie.zhang@analog.com> |
124fe943 | 67 | BFIN Bernd Schmidt <bernd.schmidt@analog.com> |
523f6a27 | 68 | BUILD SYSTEM Ben Elliston <bje@gnu.org> |
eb18fd22 | 69 | BUILD SYSTEM Daniel Jacobowitz <dan@debian.org> |
ec8cbbf6 | 70 | CR16 M R Swami Reddy <MR.Swami.Reddy@nsc.com> |
1b577b00 | 71 | CRIS Hans-Peter Nilsson <hp@axis.com> |
ec8cbbf6 | 72 | CRX M R Swami Reddy <MR.Swami.Reddy@nsc.com> |
4b3dc01d | 73 | DLX Nikolaos Kavvadias <nkavv@physics.auth.gr> |
1b577b00 | 74 | DWARF2 Jason Merrill <jason@redhat.com> |
a9f0b5e7 DB |
75 | FR30 Dave Brolley <brolley@redhat.com> |
76 | FRV Dave Brolley <brolley@redhat.com> | |
ec2dfb42 | 77 | FRV Alexandre Oliva <aoliva@redhat.com> |
db448d50 | 78 | H8300 Prafulla Thakare <prafulla.thakare@kpitcummins.com> |
6b10f68d | 79 | HPPA Dave Anglin <dave.anglin@nrc.ca> |
1b577b00 | 80 | HPPA elf32 Alan Modra <amodra@bigpond.net.au> |
f52e0eb8 | 81 | HPPA elf64 Jeff Law <law@redhat.com> [Basic maintainance only] |
4b3be0b6 | 82 | IA-64 Jim Wilson <wilson@tuliptree.org> |
3b36097d | 83 | IQ2000 Stan Cox <scox@redhat.com> |
d68c07bb | 84 | i860 Jason Eckhardt <jle@rice.edu> |
ccdb9c9f | 85 | ix86 H.J. Lu <hjl.tools@gmail.com> |
bd5a94b0 | 86 | ix86 PE Christopher Faylor <me+binutils@cgf.cx> |
b54e7460 | 87 | ix86 COFF DJ Delorie <dj@redhat.com> |
57f6e0bc | 88 | ix86 PE/COFF Dave Korn <dave.korn.cygwin@gmail.com> |
53260797 | 89 | ix86 INTEL MODE Jan Beulich <jbeulich@novell.com> |
84e94c90 | 90 | LM32 Jon Beniston <jon@beniston.com> |
074b403e | 91 | M68HC11 M68HC12 Stephane Carrez <stcarrez@nerim.fr> |
163730f0 | 92 | M88k Mark Kettenis <kettenis@gnu.org> |
b517c9b6 | 93 | MACH-O Tristan Gingold <gingold@adacore.com> |
c4cf3821 | 94 | MAXQ Inderpreet Singh <inderpreetb@noida.hcltech.com> |
0dd5bc5e | 95 | MEP Dave Brolley <brolley@redhat.com> |
f1969386 | 96 | MIPS Eric Christopher <echristo@apple.com> |
9b19141a | 97 | MMIX Hans-Peter Nilsson <hp@bitrange.com> |
f1969386 | 98 | MN10300 Eric Christopher <echristo@apple.com> |
91593c9d | 99 | MN10300 Alexandre Oliva <aoliva@redhat.com> |
17eb60e9 | 100 | Moxie Anthony Green <green@moxielogic.com> |
1acfb01b | 101 | MSP430 Dmitry Diky <diwil@spec.ru> |
5ad507ee | 102 | NetBSD support Matt Thomas <matt@netbsd.org> |
a926ab2f | 103 | PPC Geoff Keating <geoffk@geoffk.org> |
eacf2b70 | 104 | PPC Alan Modra <amodra@bigpond.net.au> |
42ea8716 | 105 | PPC vector ext Aldy Hernandez <aldyh@redhat.com> |
54589086 | 106 | s390, s390x Martin Schwidefsky <schwidefsky@de.ibm.com> |
3c7ae2cf | 107 | SCORE Mei Ligang <ligang@sunnorth.com.cn> |
9f77fa06 | 108 | SH Alexandre Oliva <aoliva@redhat.com> |
c254c557 | 109 | SH Kaz Kojima <kkojima@rr.iij4u.or.jp> |
1b577b00 | 110 | SPARC Jakub Jelinek <jakub@redhat.com> |
ccdb9c9f | 111 | SPU Alan Modra <amodra@bigpond.net.au> |
523f6a27 | 112 | TESTSUITES Ben Elliston <bje@gnu.org> |
e5f129ad | 113 | TIC4X Svein Seldal <svein@dev.seldal.com> |
6e917903 | 114 | TIC54X Timothy Wall <twall@alum.mit.edu> |
5ad507ee | 115 | VAX Matt Thomas <matt@netbsd.org> |
677c6f3a | 116 | VAX Jan-Benedict Glaw <jbglaw@lug-owl.de> |
e7f990e2 | 117 | VMS Tristan Gingold <gingold@adacore.com> |
91593c9d AM |
118 | x86_64 Jan Hubicka <jh@suse.cz> |
119 | x86_64 Andreas Jaeger <aj@suse.de> | |
fabda5a7 | 120 | x86_64 H.J. Lu <hjl.tools@gmail.com> |
93abc97a | 121 | XCOFF Richard Sandiford <r.sandiford@uk.ibm.com> |
073f969c | 122 | Xtensa Sterling Augustine <sterling@tensilica.com> |
190668a2 | 123 | z80 Arnold Metselaar <arnold.metselaar@planet.nl> |
3c25c5f6 NC |
124 | z8k Christian Groessler <chris@groessler.org> |
125 | ||
1b577b00 NC |
126 | |
127 | --------- CGEN Maintainers ------------- | |
dac850af | 128 | |
08c404a5 | 129 | CGEN is a tool for building, amongst other things, assemblers, |
1b577b00 NC |
130 | disassemblers and simulators from a single description of a CPU. |
131 | It creates files in several of the binutils directories, but it | |
132 | is mentioned here since there is a single group that maintains | |
eacf2b70 | 133 | CGEN and the files that it creates. |
dac850af NC |
134 | |
135 | If you have CGEN related problems you can send email to; | |
136 | ||
eacf2b70 | 137 | cgen@sourceware.org |
dac850af NC |
138 | |
139 | The current CGEN maintainers are: | |
140 | ||
b893fd29 | 141 | Doug Evans, Frank Eigler |
302ab118 | 142 | |
1b577b00 | 143 | --------- Write After Approval --------- |
302ab118 DD |
144 | |
145 | Individuals with "write after approval" have the ability to check in | |
146 | changes, but they must get approval for each change from someone in | |
147 | one of the above lists (blanket write or maintainers). | |
148 | ||
149 | [It's a huge list, folks. You know who you are. If you have the | |
1b577b00 NC |
150 | *ability* to do binutils checkins, you're in this group. Just |
151 | remember to get approval before checking anything in.] | |
a9f10786 | 152 | |
1b577b00 | 153 | ------------- Obvious Fixes ------------- |
a9f10786 NC |
154 | |
155 | Fixes for obvious mistakes do not need approval, and can be checked in | |
156 | right away, but the patch should still be sent to the binutils list. | |
157 | The definition of obvious is a bit hazy, and if you are not sure, then | |
158 | you should seek approval first. Obvious fixes include fixes for | |
159 | spelling mistakes, blatantly incorrect code (where the correct code is | |
160 | also blatantly obvious), and so on. Obvious fixes should always be | |
161 | small, the larger they are, the more likely it is that they contain | |
162 | some un-obvious side effect or consequence. | |
90ab7e9a | 163 | |
1b577b00 | 164 | --------- Branch Checkins --------- |
90ab7e9a NC |
165 | |
166 | If a patch is approved for check in to the mainline sources, it can | |
167 | also be checked into the current release branch. Normally however | |
168 | only bug fixes should be applied to the branch. New features, new | |
169 | ports, etc, should be restricted to the mainline. (Otherwise the | |
eacf2b70 | 170 | burden of maintaining the branch in sync with the mainline becomes too |
90ab7e9a NC |
171 | great). If you are uncertain as to whether a patch is appropriate for |
172 | the branch, ask the branch maintainer. This is: | |
173 | ||
d434e574 | 174 | Daniel Jacobowitz <dan@debian.org> |
873e0588 NC |
175 | |
176 | -------- Testsuites --------------- | |
177 | ||
178 | In general patches to any of the binutils testsuites should be | |
179 | considered generic and sent to the binutils mailing list for | |
180 | approval. Patches to target specific tests are the responsibility the | |
181 | relevent port maintainer(s), and can be approved/checked in by them. | |
182 | Other testsuite patches need the approval of a blanket-write-priveleges | |
183 | person. | |
184 | ||
185 | -------- Configure patches ---------- | |
186 | ||
187 | Patches to the top level configure files (config.sub & config.guess) | |
188 | are not the domain of the binutils project and they cannot be approved | |
189 | by the binutils group. Instead they should be submitted to the config | |
190 | maintainer at: | |
191 | ||
192 | config-patches@gnu.org | |
619b8b60 MM |
193 | |
194 | --------- Creating Branches --------- | |
195 | ||
196 | Anyone with at least write-after-approval access may create a branch | |
197 | to use for their own development purposes. In keeping with FSF | |
198 | policies, all patches applied to such a branch must come from people | |
199 | with appropriate copyright assignments on file. All legal | |
200 | requirements that would apply to any other contribution apply equally | |
201 | to contributions on a branch. | |
202 | ||
203 | Before creating the branch, you should select a name for the branch of | |
204 | the form: | |
205 | ||
eacf2b70 | 206 | binutils-<org>-<name> |
619b8b60 MM |
207 | |
208 | where "org" is the initials of your organization, or your own initials | |
209 | if you are acting as an individual. For example, for a branch created | |
210 | by The GNUDist Company, "tgc" would be an appropriate choice for | |
211 | "org". It's up to each organization to select an appropriate choice | |
212 | for "name"; some organizations may use more structure than others, so | |
213 | "name" may contain additional hyphens. | |
214 | ||
215 | Suppose that The GNUDist Company was creating a branch to develop a | |
216 | port of Binutils to the FullMonty processor. Then, an appropriate | |
217 | choice of branch name would be: | |
218 | ||
219 | binutils-tgc-fm | |
220 | ||
45781998 | 221 | A date stamp is not required as part of the name field, but some |
619b8b60 MM |
222 | organizations like to have one. If you do include the date, you |
223 | should follow these rules: | |
224 | ||
225 | 1. The date should be the date that the branch was created. | |
226 | ||
227 | 2. The date should be numerical and in the form YYYYMMDD. | |
228 | ||
229 | For example: | |
230 | ||
231 | binutils-tgc-fm_20050101 | |
232 | ||
233 | would be appropriate if the branch was created on January 1st, 2005. | |
234 | ||
235 | Having selected the branch name, create the branch as follows: | |
236 | ||
237 | 1. Check out binutils, so that you have a CVS checkout corresponding | |
238 | to the initial state of your branch. | |
239 | ||
240 | 2. Create a tag: | |
241 | ||
242 | cvs tag binutils-<org>-<name>-branchpoint | |
243 | ||
244 | That tag will allow you, and others, to easily determine what's | |
245 | changed on the branch relative to the initial state. | |
246 | ||
247 | 3. Create the branch: | |
248 | ||
249 | cvs rtag -b -r binutils-<org>-<name>-branchpoint \ | |
eacf2b70 | 250 | binutils-<org>-<name>-branch |
619b8b60 MM |
251 | |
252 | 4. Document the branch: | |
253 | ||
254 | Add a description of the branch to binutils/BRANCHES, and check | |
255 | that file in. All branch descriptions should be added to the | |
256 | HEAD revision of the file; it doesn't help to modify | |
257 | binutils/BRANCHES on a branch! | |
258 | ||
259 | Please do not commit any patches to a branch you did not create | |
260 | without the explicit permission of the person who created the branch. |