Skip to content

Commit 000aee7

Browse files
committed
Clean-up Evolving-Java-based-APIs document
Remove IBM copyright Remove Revision history (not really useful for project documentation) This is part 1 or 3, most likely the three documents will be merged once migrated
1 parent 953ede3 commit 000aee7

File tree

1 file changed

+5
-15
lines changed

1 file changed

+5
-15
lines changed

docs/Evolving-Java-based-APIs.md

Lines changed: 5 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,15 @@
11
Evolving Java-based APIs
22
========================
33

4-
By Jim des Rivières, IBM
5-
6-
Revision history:
7-
8-
October 1, 2007 - revision 1.2 - Clarified moving methods up and down type hierarchy; added note about Java reflection; split document into 3 parts because it was getting too large to edit:
4+
Document is currently split in 3 parts:
95

106
* Part 1: What is an API? (this page)
117
* [Part 2: Achieving API Binary Compatibility](/Evolving_Java-based_APIs_2 "Evolving Java-based APIs 2")
128
* [Part 3: Other Notes](/Evolving_Java-based_APIs_3 "Evolving Java-based APIs 3")
139

14-
February 14, 2007 - revision 1.1 - Add coverage for JDK 1.5 language features: generics, enums, annotation types, variable arity methods.
15-
16-
June 8, 2001 - revision 1.02 - Added note about breakage due to adding API method to classes that may be subclassed.
17-
18-
January 15, 2001 - revision 1.01 - Added suggestion about making obsolete hook methods final.
19-
20-
October 6, 2000 - revision 1.0
21-
22-
This document is about how to evolve Java-based APIs while maintaining compatibility with existing client code. Without loss of generality, we'll assume that there is a generic **Component** with a **Component API**, with one party providing the Component and controlling its API. The other party, or parties, write **Client** code that use the Component's services through its API. This is a very typical arrangement.
10+
This document is about how to evolve Java-based APIs while maintaining compatibility with existing client code.
11+
Without loss of generality, we'll assume that there is a generic **Component** with a **Component API**, with one party providing the Component and controlling its API.
12+
The other party, or parties, write **Client** code that use the Component's services through its API. This is a very typical arrangement.
2313

2414
Contents
2515
--------
@@ -229,4 +219,4 @@ Bundle Versioning
229219

230220
See [Version Numbering](/Version_Numbering "Version Numbering")
231221

232-
Copyright © 2000, 2009 IBM Corporation
222+

0 commit comments

Comments
 (0)