[IMP] Consider deprecating `apply_boolean_mask` with `apply_retention_mask`

[mhaseeb123]

Description

Currently, we have two public masking APIs called apply_boolean_mask and apply_deletion_mask. These API internally call the detail apply_mask API with a mask_type enum which has values: RETENTION, DELETION.

We should consider deprecating the apply_boolean_mask with apply_retention_mask for consistency.

Alternatives

N/A. Current state of APIs

Considerations.

cudf::apply_boolean_mask is among the most used public APIs and its deprecation would affect a lot of partners.

[lamarrr]

@mhaseeb123 is there a problem you foresee this could cause? And would it be worth the breaking change?

[mhaseeb123]

cudf::apply_boolean_mask is among the most used public APIs and its deprecation would affect a lot of partners.

Nothing besides this. Can open up a PR to add the new API and deprecate the old one.

[mhaseeb123]

Opened #23700