updated ace document functions