* gdbint.texinfo (Releasing GDB): Revise the section `Before the

Branch'.
This commit is contained in:
Andrew Cagney
2002-03-27 21:16:33 +00:00
parent 38e57a35dc
commit 9ae8b82c04
2 changed files with 33 additions and 43 deletions

View File

@ -1,3 +1,8 @@
2002-03-27 Andrew Cagney <ac131313@redhat.com>
* gdbint.texinfo (Releasing GDB): Revise the section `Before the
Branch'.
2002-03-18 Andrew Cagney <ac131313@redhat.com> 2002-03-18 Andrew Cagney <ac131313@redhat.com>
* gdb.texinfo: Change all examples to @smallexample. * gdb.texinfo: Change all examples to @smallexample.

View File

@ -4989,7 +4989,8 @@ no longer relevant or simply wrong. Secondly since it removes any
history associated with the file (effectively clearing the slate) the history associated with the file (effectively clearing the slate) the
developer has a much freer hand when it comes to fixing broken files.} developer has a much freer hand when it comes to fixing broken files.}
@section Before the branch
@section Before the Branch
The most important objective at this stage is to find and fix simple The most important objective at this stage is to find and fix simple
changes that become a pain to track once the branch is created. For changes that become a pain to track once the branch is created. For
@ -4997,34 +4998,17 @@ instance, configuration problems that stop @value{GDBN} from even
building. If you can't get the problem fixed, document it in the building. If you can't get the problem fixed, document it in the
@file{gdb/PROBLEMS} file. @file{gdb/PROBLEMS} file.
@subheading Organize and announce the schedule. @subheading Prompt for @file{gdb/NEWS}
The following is a possible schedule. It is based on the rule-of-thumb People always forget. Send a post reminding them but also if you know
that everything on the Internet takes a week. You may want to even something interesting happened add it yourself. The @code{schedule}
increase those times further since an analysis of the actual data script will mention this in its e-mail.
strongly suggests that the below is far to aggressive.
@itemize @bullet @subheading Review @file{gdb/README}
@item
announce it
@item
wait a week
@item
announce branch date
@item
wait a week
@item
Cut the branch
@item
wait a week
@item
start enjoying all the fun
@end itemize
As an aside, the branch tag name is probably regrettable vis: Grab one of the nightly snapshots and then walk through the
@smallexample @file{gdb/README} looking for anything that can be improved. The
gdb_N_M-YYYY-MM-DD-@{branch,branchpoint@} @code{schedule} script will mention this in its e-mail.
@end smallexample
@subheading Refresh any imported files. @subheading Refresh any imported files.
@ -5034,27 +5018,28 @@ A number of files are taken from external repositories. They include:
@item @item
@file{texinfo/texinfo.tex} @file{texinfo/texinfo.tex}
@item @item
@file{config.guess} et.@: al.@: @file{config.guess} et.@: al.@: (see the top-level @file{MAINTAINERS}
file)
@item
@file{etc/standards.texi}, @file{etc/make-stds.texi}
@end itemize @end itemize
and should be refreshed.
@subheading Prompt for @file{gdb/NEWS}
People always forget. Send a post reminding them but also if you know
something interesting happened add it your self.
@subheading Review @file{gdb/README}
Grab one of the nightly snapshots and then walk through the
@file{gdb/README} looking for anything that can be improved.
@subheading Check the ARI @subheading Check the ARI
ARI is an @code{awk} script (Awk Regression Indicator?) that checks for a @uref{http://sources.redhat.com/gdb/ari,,A.R.I.} is an @code{awk} script
number of errors and coding conventions. The checks include things like (Awk Regression Index ;-) that checks for a number of errors and coding
using @code{malloc} instead of @code{xmalloc} and file naming problems. conventions. The checks include things like using @code{malloc} instead
There shouldn't be any regressions. of @code{xmalloc} and file naming problems. There shouldn't be any
regressions.
@subsection Review the bug data base
Close anything obviously fixed.
@subsection Check all cross targets build
The targets are listed in @file{gdb/MAINTAINERS}.
@section Cut the branch @section Cut the branch