diff options
author | Andrew Cagney <cagney@redhat.com> | 2002-03-18 16:09:32 +0000 |
---|---|---|
committer | Andrew Cagney <cagney@redhat.com> | 2002-03-18 16:09:32 +0000 |
commit | 9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09 (patch) | |
tree | eeb1e94fb7c25515e086537594d66240448e5a53 | |
parent | eb1e0e807ac769f624181bc44acdcd79d866949d (diff) | |
download | binutils-9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09.tar.gz binutils-9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09.tar.bz2 binutils-9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09.zip |
* gdbint.texinfo (Releasing GDB): Add the section``Branch Commit
Policy''.
-rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdbint.texinfo | 31 |
2 files changed, 36 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 66da57d87de..71c1ddf55cb 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2002-03-18 Andrew Cagney <ac131313@redhat.com> + + * gdbint.texinfo (Releasing GDB): Add the section``Branch Commit + Policy''. + 2002-03-04 Fred Fish <fnf@redhat.com> * gdbint.texinfo: Fix a bunch of typos (alsways, mirrorred, diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 672851a2575..5f5f93692cc 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -4822,6 +4822,37 @@ or so included files. @chapter Releasing @value{GDBN} @cindex making a new release of gdb +@section Branch Commit Policy + +The branch commit policy is pretty slack. @value{GDBN} releases 5.0, +5.1 and 5.2 all used the below: + +@itemize @bullet +@item +The @file{gdb/MAINTAINERS} file still holds. +@item +Don't fix something on the branch unless/until it is also fixed in the +trunk. If this isn't possible, mentioning it in the @file{gdb/PROBLEMS} +file is better than committing a hack +@item +When considering a patch for the branch, suggested criteria include: +Does it fix a build? Does it fix the sequence @kbd{break main; run} +when debugging a static binary? +@item +The further a change is from the core of @value{GDBN}, the less likely +the change will worry anyone (e.g., target specific code). +@item +Only post a proposal to change the core of @value{GDBN} after you've +sent individual bribes to all the people listed in the +@file{MAINTAINERS} file @t{;-)} +@end itemize + +@emph{Pragmatics: Provided updates are restricted to non-core +functionality there is little chance that a broken change will be fatal. +This means that changes such as adding a new architectures or (within +reason) support for a new host are considered acceptable.} + + @section Obsolete any code Before anything else, poke the other developers (and around the source |