summaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorAndrew Cagney <cagney@redhat.com>2002-03-18 16:09:32 +0000
committerAndrew Cagney <cagney@redhat.com>2002-03-18 16:09:32 +0000
commit9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09 (patch)
treeeeb1e94fb7c25515e086537594d66240448e5a53 /gdb/doc
parenteb1e0e807ac769f624181bc44acdcd79d866949d (diff)
downloadbinutils-9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09.tar.gz
binutils-9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09.tar.bz2
binutils-9bb0a4d8dfbb8ba68e04b4963b3c1bdc46777c09.zip
* gdbint.texinfo (Releasing GDB): Add the section``Branch Commit
Policy''.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdbint.texinfo31
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