xref: /aosp_15_r20/external/grpc-grpc/doc/cpp/pending_api_cleanups.md (revision cc02d7e222339f7a4f6ba5f422e6413f4bd931f2)
1*cc02d7e2SAndroid Build Coastguard WorkerThere are times when we make changes that include a temporary shim for
2*cc02d7e2SAndroid Build Coastguard Workerbackward-compatibility (e.g., a macro or some other function to preserve
3*cc02d7e2SAndroid Build Coastguard Workerthe original API) to avoid having to bump the major version number in
4*cc02d7e2SAndroid Build Coastguard Workerthe next release.  However, when we do eventually want to release a
5*cc02d7e2SAndroid Build Coastguard Workerfeature that does change the API in a non-backward-compatible way, we
6*cc02d7e2SAndroid Build Coastguard Workerwill wind up bumping the major version number anyway, at which point we
7*cc02d7e2SAndroid Build Coastguard Workercan take the opportunity to clean up any pending backward-compatibility
8*cc02d7e2SAndroid Build Coastguard Workershims.
9*cc02d7e2SAndroid Build Coastguard Worker
10*cc02d7e2SAndroid Build Coastguard WorkerThis file lists all pending backward-compatibility changes that should
11*cc02d7e2SAndroid Build Coastguard Workerbe cleaned up the next time we are going to bump the major version
12*cc02d7e2SAndroid Build Coastguard Workernumber:
13*cc02d7e2SAndroid Build Coastguard Worker
14*cc02d7e2SAndroid Build Coastguard Worker- remove `ServerBuilder::SetMaxMessageSize()` method from
15*cc02d7e2SAndroid Build Coastguard Worker  `include/grpc++/server_builder.h` (commit `6980362`)
16*cc02d7e2SAndroid Build Coastguard Worker- remove `ClientContext::set_fail_fast()` method from
17*cc02d7e2SAndroid Build Coastguard Worker  `include/grpc++/client_context.h` (commit `9477724`)
18*cc02d7e2SAndroid Build Coastguard Worker- remove directory `include/grpc++` and all headers in it
19*cc02d7e2SAndroid Build Coastguard Worker  (commit `eb06572`)
20*cc02d7e2SAndroid Build Coastguard Worker- make all `Request` and `Mark` methods in `grpc::Service` take a
21*cc02d7e2SAndroid Build Coastguard Worker  `size_t` argument for `index` rather than `int` (since that is only
22*cc02d7e2SAndroid Build Coastguard Worker  used as a vector index)
23