I den här handboken beskrivs migrering av Eclipse 3.1-insticksprogram (eller tidigare) till Eclipse 3.2.
Ett av målen med Eclipse 3.2 var att föra Eclipse framåt samtidigt som kompatibiliteten med tidigare versioner bibehölls i så stor utsträckning som möjligt. Detta innebär att de insticksprogram som är skrivna för API:er i Eclipse 3.1 bör fungera i 3.2, trots API-ändringar.
Den viktigaste kompatibiliteten är API-kontraktskompatibilitet och binär kompatibilitet. API-kontraktskompatibilitet betyder att en giltig användning av API:er i 3.1 förblir giltig i 3.2. Det finns därför ingen orsak att gå igenom fungerande kod. Binär kompatibilitet betyder att API-metodsignaturer m.m. inte har ändrats på ett sådant sätt att befintlig, kompilerad ("binär") kod inte längre kan länkas och köras med de nya 3.2-biblioteken.
Det finns dock några områden som är inkompatibla, trots alla ansträngningar som gjorts för att undvika konflikter. I dokumentet beskrivs de områden där Eclipse har ändrats på ett inkompatibelt sätt mellan version 3.1 och 3.2. Dokumentet innehåller även instruktioner för hur du migrerar 3.1-insticksprogram till version 3.2.