doc is updated with a warning about usages of null portables