doc: documented the new feature getlifetime