ex2-8,9 documenting functions