doc, filling in the blanks