From 9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09 Mon Sep 17 00:00:00 2001 From: Andrew Cagney Date: Mon, 18 Mar 2002 16:09:32 +0000 Subject: [PATCH] * gdbint.texinfo (Releasing GDB): Add the section``Branch Commit Policy''. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdbint.texinfo | 31 +++++++++++++++++++++++++++++++ 2 files changed, 36 insertions(+) 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 + + * gdbint.texinfo (Releasing GDB): Add the section``Branch Commit + Policy''. + 2002-03-04 Fred Fish * 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