COR-321 : Document the behavior of restoreIdentity param - SetCurrentIdentityFilter

COR-321 : Document the behavior of restoreIdentity param - SetCurrentIdentityFilter