added note to documenation about nil object values