improved commentary on functions file