where is build_new post called?

whats an example usage of build_new_post look like?

Thanks

Okay, I'm starting to understand a lot more (looking at hooks, etc). I see the mailqueue gets all the queued messages, can you tell me where I find the code that actually ends up processing the queue. I do see exec_mail_queue which fires off exec_queue but the only place I see exec_mail_queue being called is in exec_shut_down which I'd imagine there is somewhere else it's being called. Or a cron job to send (but can't seem to find it).

I have to say, the hooks system is pretty nice and overall I'm really impressed with a lot of this now that I'm starting to understand more.

exec_shut_down() is being called on every frontend-page (either though a registered shutdown function or from print_output(),and in some cases directly).