A terminally ill man has been granted the right to end his life in South Africa, where euthanasia is illegal.