* targhooks.c: Add comment explaining the migration process.

From-SVN: r71103
This commit is contained in:
DJ Delorie 2003-09-04 22:12:29 -04:00 committed by DJ Delorie
parent 09edb09355
commit dd37c5a069
2 changed files with 33 additions and 0 deletions

View File

@ -1,3 +1,7 @@
2003-09-04 DJ Delorie <dj@redhat.com>
* targhooks.c: Add comment explaining the migration process.
2003-09-04 Eric Christopher <echristo@redhat.com>
* config/frv/t-frv: Fix path for frv-abi.h.

View File

@ -18,6 +18,35 @@ along with GCC; see the file COPYING. If not, write to the Free
Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA. */
/* The migration of target macros to target hooks works as follows:
1. Create a target hook that uses the existing target macros to
implement the same functionality.
2. Convert all the MI files to use the hook instead of the macro.
3. Repeat for a majority of the remaining target macros. This will
take some time.
4. Tell target maintainers to start migrating.
5. Eventually convert the backends to override the hook instead of
defining the macros. This will take some time too.
6. TBD when, poison the macros. Unmigrated targets will break at
this point.
Note that we expect steps 1-3 to be done by the people that
understand what the MI does with each macro, and step 5 to be done
by the target maintainers for their respective targets.
Note that steps 1 and 2 don't have to be done together, but no
target can override the new hook until step 2 is complete for it.
Once the macros are poisoned, we will revert to the old migration
rules - migrate the macro, callers, and targets all at once. This
comment can thus be removed at that point. */
#include "config.h"
#include "system.h"
#include "coretypes.h"