]>
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 | [email protected] |
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 | [email protected] |
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 ([email protected] and |
eacf2b70 | 28 | [email protected]). |
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 | 35 | Nick Clifton <[email protected]> (head maintainer) |
3517749c | 36 | Ian Lance Taylor <[email protected]> |
1b577b00 | 37 | Jeff Law <[email protected]> |
4b3be0b6 | 38 | Jim Wilson <[email protected]> |
1b577b00 | 39 | DJ Delorie <[email protected]> |
ebc5095a | 40 | Alan Modra <[email protected]> |
2445335e | 41 | Michael Meissner <[email protected]> |
9483a6ee | 42 | Daniel Jacobowitz <[email protected]> |
93abc97a | 43 | Richard Sandiford <[email protected]> |
1b577b00 NC |
44 | |
45 | --------- Maintainers --------- | |
46 | ||
47 | Maintainers are individuals who are responsible for, and have | |
48 | permission to check in changes in, certain subsets of the code. Note | |
49 | that maintainers still need approval to check in changes outside of | |
50 | the immediate domain that they maintain. | |
302ab118 DD |
51 | |
52 | If there is no maintainer for a given domain then the responsibility | |
1b577b00 NC |
53 | falls to the head maintainer (above). If there are several |
54 | maintainers for a given domain then responsibility falls to the first | |
55 | maintainer. The first maintainer is free to devolve that | |
56 | responsibility among the other maintainers. | |
57 | ||
2141b110 | 58 | ALPHA Richard Henderson <[email protected]> |
a06ea964 | 59 | AARCH64 Richard Earnshaw <[email protected]> |
5b2ab150 | 60 | AARCH64 Marcus Shawcroft <[email protected]> |
1b577b00 | 61 | ARM Nick Clifton <[email protected]> |
3a7e524e | 62 | ARM Richard Earnshaw <[email protected]> |
6c1965f9 | 63 | ARM Ramana Radhakrishnan <[email protected]> |
e8b338d0 | 64 | AVR Denis Chertykov <[email protected]> |
e0159aa9 | 65 | AVR Marek Michalkiewicz <[email protected]> |
4161fbb0 | 66 | BFIN Jie Zhang <[email protected]> |
3d5ff620 | 67 | BFIN Mike Frysinger <[email protected]> |
9483a6ee | 68 | BUILD SYSTEM Daniel Jacobowitz <[email protected]> |
ec8cbbf6 | 69 | CR16 M R Swami Reddy <[email protected]> |
1b577b00 | 70 | CRIS Hans-Peter Nilsson <[email protected]> |
ec8cbbf6 | 71 | CRX M R Swami Reddy <[email protected]> |
4b3dc01d | 72 | DLX Nikolaos Kavvadias <[email protected]> |
1b577b00 | 73 | DWARF2 Jason Merrill <[email protected]> |
1cd48f98 | 74 | DWARF2 Jakub Jelinek <[email protected]> |
5b169225 | 75 | EPIPHANY Joern Rennecke <[email protected]> |
a9f0b5e7 DB |
76 | FR30 Dave Brolley <[email protected]> |
77 | FRV Dave Brolley <[email protected]> | |
ec2dfb42 | 78 | FRV Alexandre Oliva <[email protected]> |
ee441d9a | 79 | GOLD Ian Lance Taylor <[email protected]> |
08e4f608 | 80 | GOLD Cary Coutant <[email protected]> |
db448d50 | 81 | H8300 Prafulla Thakare <[email protected]> |
6b10f68d | 82 | HPPA Dave Anglin <[email protected]> |
ebc5095a | 83 | HPPA elf32 Alan Modra <[email protected]> |
f52e0eb8 | 84 | HPPA elf64 Jeff Law <[email protected]> [Basic maintainance only] |
4b3be0b6 | 85 | IA-64 Jim Wilson <[email protected]> |
3b36097d | 86 | IQ2000 Stan Cox <[email protected]> |
d68c07bb | 87 | i860 Jason Eckhardt <[email protected]> |
ccdb9c9f | 88 | ix86 H.J. Lu <[email protected]> |
bd5a94b0 | 89 | ix86 PE Christopher Faylor <[email protected]> |
b54e7460 | 90 | ix86 COFF DJ Delorie <[email protected]> |
57f6e0bc | 91 | ix86 PE/COFF Dave Korn <[email protected]> |
53260797 | 92 | ix86 INTEL MODE Jan Beulich <[email protected]> |
84e94c90 | 93 | LM32 Jon Beniston <[email protected]> |
5d0c4f10 | 94 | M32R Doug Evans <[email protected]> |
a481d14b | 95 | M68HC11 M68HC12 Stephane Carrez <[email protected]> |
554adb2c | 96 | M68HC11 M68HC12 Sean Keys <[email protected]> |
163730f0 | 97 | M88k Mark Kettenis <[email protected]> |
c91933e9 | 98 | MACH-O Tristan Gingold <[email protected]> |
c4cf3821 | 99 | MAXQ Inderpreet Singh <[email protected]> |
0dd5bc5e | 100 | MEP Dave Brolley <[email protected]> |
d5c7e0e9 | 101 | METAG Markos Chandras <[email protected]> |
7ba29e2a | 102 | MICROBLAZE Michael Eager <[email protected]> |
16e1d727 | 103 | MIPS Maciej W. Rozycki <[email protected]> |
9b19141a | 104 | MMIX Hans-Peter Nilsson <[email protected]> |
91593c9d | 105 | MN10300 Alexandre Oliva <[email protected]> |
17eb60e9 | 106 | Moxie Anthony Green <[email protected]> |
1acfb01b | 107 | MSP430 Dmitry Diky <[email protected]> |
35c08157 KLC |
108 | NDS32 Kuan-Lin Chen <[email protected]> |
109 | NDS32 Wei-Cheng Wang <[email protected]> | |
5ad507ee | 110 | NetBSD support Matt Thomas <[email protected]> |
36591ba1 SL |
111 | Nios II Sandra Loosemore <[email protected]> |
112 | Nios II Andrew Jenner <[email protected]> | |
b2bcb4bd CS |
113 | OR1K Christian Svensson <[email protected]> |
114 | OR1K Stefan Kristiansson <[email protected]> | |
a926ab2f | 115 | PPC Geoff Keating <[email protected]> |
ebc5095a | 116 | PPC Alan Modra <[email protected]> |
4bc0608a | 117 | PPC Peter Bergner <[email protected]> |
42ea8716 | 118 | PPC vector ext Aldy Hernandez <[email protected]> |
13be4805 PD |
119 | RISC-V Palmer Dabbelt <[email protected]> |
120 | RISC-V Andrew Waterman <[email protected]> | |
99c513f6 | 121 | RL78 DJ Delorie <[email protected]> |
c7927a3c NC |
122 | RX DJ Delorie <[email protected]> |
123 | RX Nick Clifton <[email protected]> | |
54589086 | 124 | s390, s390x Martin Schwidefsky <[email protected]> |
6604eb5f | 125 | s390, s390x Andreas Krebbel <[email protected]> |
9f77fa06 | 126 | SH Alexandre Oliva <[email protected]> |
cdd30861 | 127 | SPARC David S. Miller <[email protected]> |
9b5481c6 | 128 | SPARC Jose E. Marchesi <[email protected]> |
ebc5095a | 129 | SPU Alan Modra <[email protected]> |
e5f129ad | 130 | TIC4X Svein Seldal <[email protected]> |
6e917903 | 131 | TIC54X Timothy Wall <[email protected]> |
40b36596 | 132 | TIC6X Joseph Myers <[email protected]> |
ab8b6d29 WL |
133 | TILE-Gx Walter Lee <[email protected]> |
134 | TILEPro Walter Lee <[email protected]> | |
5ad507ee | 135 | VAX Matt Thomas <[email protected]> |
677c6f3a | 136 | VAX Jan-Benedict Glaw <[email protected]> |
c91933e9 | 137 | VMS Tristan Gingold <[email protected]> |
91593c9d AM |
138 | x86_64 Jan Hubicka <[email protected]> |
139 | x86_64 Andreas Jaeger <[email protected]> | |
fabda5a7 | 140 | x86_64 H.J. Lu <[email protected]> |
93abc97a | 141 | XCOFF Richard Sandiford <[email protected]> |
8d88d7ec | 142 | XGATE Sean Keys <[email protected]> |
3aade688 | 143 | Xtensa Sterling Augustine <[email protected]> |
190668a2 | 144 | z80 Arnold Metselaar <[email protected]> |
3c25c5f6 NC |
145 | z8k Christian Groessler <[email protected]> |
146 | ||
13364275 NC |
147 | --------- Past Maintainers ------------- |
148 | ||
149 | These folks have acted as maintainers in the past, but have now | |
150 | moved on to other things. Our thanks for all their hard work | |
151 | goes with them. | |
152 | ||
fd13a84b | 153 | Paul Brook |
7c723eec | 154 | Eric Christopher |
71d01c69 | 155 | Mei Ligang |
13364275 | 156 | Mark Mitchell |
cf581a9b | 157 | Bernd Schmidt |
1b577b00 NC |
158 | |
159 | --------- CGEN Maintainers ------------- | |
dac850af | 160 | |
08c404a5 | 161 | CGEN is a tool for building, amongst other things, assemblers, |
1b577b00 NC |
162 | disassemblers and simulators from a single description of a CPU. |
163 | It creates files in several of the binutils directories, but it | |
164 | is mentioned here since there is a single group that maintains | |
eacf2b70 | 165 | CGEN and the files that it creates. |
dac850af NC |
166 | |
167 | If you have CGEN related problems you can send email to; | |
168 | ||
eacf2b70 | 169 | [email protected] |
dac850af NC |
170 | |
171 | The current CGEN maintainers are: | |
172 | ||
b893fd29 | 173 | Doug Evans, Frank Eigler |
302ab118 | 174 | |
1b577b00 | 175 | --------- Write After Approval --------- |
302ab118 DD |
176 | |
177 | Individuals with "write after approval" have the ability to check in | |
178 | changes, but they must get approval for each change from someone in | |
179 | one of the above lists (blanket write or maintainers). | |
180 | ||
181 | [It's a huge list, folks. You know who you are. If you have the | |
1b577b00 NC |
182 | *ability* to do binutils checkins, you're in this group. Just |
183 | remember to get approval before checking anything in.] | |
a9f10786 | 184 | |
1b577b00 | 185 | ------------- Obvious Fixes ------------- |
a9f10786 NC |
186 | |
187 | Fixes for obvious mistakes do not need approval, and can be checked in | |
188 | right away, but the patch should still be sent to the binutils list. | |
189 | The definition of obvious is a bit hazy, and if you are not sure, then | |
190 | you should seek approval first. Obvious fixes include fixes for | |
191 | spelling mistakes, blatantly incorrect code (where the correct code is | |
192 | also blatantly obvious), and so on. Obvious fixes should always be | |
193 | small, the larger they are, the more likely it is that they contain | |
194 | some un-obvious side effect or consequence. | |
90ab7e9a | 195 | |
1b577b00 | 196 | --------- Branch Checkins --------- |
90ab7e9a NC |
197 | |
198 | If a patch is approved for check in to the mainline sources, it can | |
199 | also be checked into the current release branch. Normally however | |
200 | only bug fixes should be applied to the branch. New features, new | |
201 | ports, etc, should be restricted to the mainline. (Otherwise the | |
eacf2b70 | 202 | burden of maintaining the branch in sync with the mainline becomes too |
90ab7e9a NC |
203 | great). If you are uncertain as to whether a patch is appropriate for |
204 | the branch, ask the branch maintainer. This is: | |
205 | ||
c91933e9 | 206 | (cf global maintainers) |
873e0588 NC |
207 | |
208 | -------- Testsuites --------------- | |
209 | ||
210 | In general patches to any of the binutils testsuites should be | |
211 | considered generic and sent to the binutils mailing list for | |
212 | approval. Patches to target specific tests are the responsibility the | |
13364275 | 213 | relevant port maintainer(s), and can be approved/checked in by them. |
873e0588 NC |
214 | Other testsuite patches need the approval of a blanket-write-priveleges |
215 | person. | |
216 | ||
217 | -------- Configure patches ---------- | |
218 | ||
219 | Patches to the top level configure files (config.sub & config.guess) | |
220 | are not the domain of the binutils project and they cannot be approved | |
221 | by the binutils group. Instead they should be submitted to the config | |
222 | maintainer at: | |
223 | ||
224 | [email protected] | |
619b8b60 MM |
225 | |
226 | --------- Creating Branches --------- | |
227 | ||
228 | Anyone with at least write-after-approval access may create a branch | |
229 | to use for their own development purposes. In keeping with FSF | |
230 | policies, all patches applied to such a branch must come from people | |
231 | with appropriate copyright assignments on file. All legal | |
232 | requirements that would apply to any other contribution apply equally | |
233 | to contributions on a branch. | |
234 | ||
235 | Before creating the branch, you should select a name for the branch of | |
236 | the form: | |
237 | ||
eacf2b70 | 238 | binutils-<org>-<name> |
619b8b60 MM |
239 | |
240 | where "org" is the initials of your organization, or your own initials | |
241 | if you are acting as an individual. For example, for a branch created | |
242 | by The GNUDist Company, "tgc" would be an appropriate choice for | |
243 | "org". It's up to each organization to select an appropriate choice | |
244 | for "name"; some organizations may use more structure than others, so | |
245 | "name" may contain additional hyphens. | |
246 | ||
247 | Suppose that The GNUDist Company was creating a branch to develop a | |
248 | port of Binutils to the FullMonty processor. Then, an appropriate | |
249 | choice of branch name would be: | |
250 | ||
251 | binutils-tgc-fm | |
252 | ||
45781998 | 253 | A date stamp is not required as part of the name field, but some |
619b8b60 MM |
254 | organizations like to have one. If you do include the date, you |
255 | should follow these rules: | |
256 | ||
257 | 1. The date should be the date that the branch was created. | |
258 | ||
259 | 2. The date should be numerical and in the form YYYYMMDD. | |
260 | ||
261 | For example: | |
262 | ||
263 | binutils-tgc-fm_20050101 | |
264 | ||
265 | would be appropriate if the branch was created on January 1st, 2005. | |
266 | ||
267 | Having selected the branch name, create the branch as follows: | |
268 | ||
20cef68c | 269 | 1. Check out binutils, so that you have a git checkout corresponding |
619b8b60 MM |
270 | to the initial state of your branch. |
271 | ||
272 | 2. Create a tag: | |
273 | ||
20cef68c | 274 | git tag binutils-<org>-<name>-branchpoint |
619b8b60 MM |
275 | |
276 | That tag will allow you, and others, to easily determine what's | |
277 | changed on the branch relative to the initial state. | |
278 | ||
20cef68c | 279 | 3. Create and push the branch: |
619b8b60 | 280 | |
20cef68c TT |
281 | git checkout -b binutils-<org>-<name>-branch |
282 | git push origin HEAD | |
619b8b60 MM |
283 | |
284 | 4. Document the branch: | |
285 | ||
286 | Add a description of the branch to binutils/BRANCHES, and check | |
287 | that file in. All branch descriptions should be added to the | |
288 | HEAD revision of the file; it doesn't help to modify | |
289 | binutils/BRANCHES on a branch! | |
290 | ||
291 | Please do not commit any patches to a branch you did not create | |
292 | without the explicit permission of the person who created the branch. | |
5bf135a7 | 293 | \f |
2571583a | 294 | Copyright (C) 2012-2017 Free Software Foundation, Inc. |
5bf135a7 NC |
295 | |
296 | Copying and distribution of this file, with or without modification, | |
297 | are permitted in any medium without royalty provided the copyright | |
298 | notice and this notice are preserved. |