espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-24 12:23:31 +08:00
Code Issues Packages Projects Releases Wiki Activity

* gdbint.texinfo (Releasing GDB): Rename ``Obsoleting any code''

Browse Source 
to ``Obsoleting code''.  Revise.
This commit is contained in:
Andrew Cagney
2002-05-31 01:36:16 +00:00
parent deec17343c
commit cbb09e6a75
2 changed files with 35 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
gdb/doc/ChangeLog
View File

@ -1,3 +1,8 @@
2002-05-30 Andrew Cagney <ac131313@redhat.com>
* gdbint.texinfo (Releasing GDB): Rename ``Obsoleting any code''
to ``Obsoleting code''. Revise.
2002-05-17 Jim Blandy <jimb@redhat.com> 2002-05-17 Jim Blandy <jimb@redhat.com>
* gdb.texinfo (C Preprocessor Macros): New chapter. * gdb.texinfo (C Preprocessor Macros): New chapter.

51
gdb/doc/gdbint.texinfo
View File

@ -5158,41 +5158,50 @@ This means that changes such as adding a new architectures or (within
reason) support for a new host are considered acceptable.} reason) support for a new host are considered acceptable.}
@section Obsolete any code @section Obsoleting code
Before anything else, poke the other developers (and around the source Before anything else, poke the other developers (and around the source
code) to see if there is anything that can be removed from @value{GDBN} code) to see if there is anything that can be removed from @value{GDBN}
(an old target, an unused file). (an old target, an unused file).
Obsolete code is identified by adding an @code{OBSOLETE} prefix to every Obsolete code is identified by adding an @code{OBSOLETE} prefix to every
line. Doing this means that it is easy to identify obsolete code when line. Doing this means that it is easy to identify something that has
grepping through the sources. been obsoleted when greping through the sources.
The process has a number of steps and is intentionally slow --- this is The process is done in stages --- this is mainly to ensure that the
to mainly ensure that people have had a reasonable chance to respond. wider @value{GDBN} community has a reasonable opportunity to respond.
Remember, everything on the internet takes a week. Remember, everything on the Internet takes a week.
@itemize @bullet @enumerate
@item @item
announce the change on @email{gdb@@sources.redhat.com, GDB mailing list} Post the proposal on @email{gdb@@sources.redhat.com, the GDB mailing
list} Creating a bug report to track the task's state, is also highly
recommended.
@item @item
wait a week or so Wait a week or so.
@item @item
announce the change on @email{gdb-announce@@sources.redhat.com, GDB Post the proposal on @email{gdb-announce@@sources.redhat.com, the GDB
Announcement mailing list} Announcement mailing list}.
@item @item
wait a week or so Wait a week or so.
@item @item
go through and edit all relevant files and lines (e.g., in Go through and edit all relevant files and lines so that they are
@file{configure.tgt}) so that they are prefixed with the word prefixed with the word @code{OBSOLETE}.
@code{OBSOLETE}. @item
@end itemize Wait until the next GDB version, containing this obsolete code, has been
released.
@item
Remove the obsolete code.
@end enumerate
@noindent
@emph{Maintainer note: While removing old code is regrettable it is
hopefully better for @value{GDBN}'s long term development. Firstly it
helps the developers by removing code that is either no longer relevant
or simply wrong. Secondly since it removes any history associated with
the file (effectively clearing the slate) the developer has a much freer
hand when it comes to fixing broken files.}
@emph{Maintainer note: Removing old code, while regrettable, is a good
thing. Firstly it helps the developers by removing code that is either
no longer relevant or simply wrong. Secondly since it removes any
history associated with the file (effectively clearing the slate) the
developer has a much freer hand when it comes to fixing broken files.}
@section Before the Branch @section Before the Branch