note 59879 added to function.halt-compiler

So what are the real world uses for this function? And why does it lack a good example? ---- Manual Page -- http://www.php.net/manual/en/function.halt-compiler.php Edit -- http://master.php.net/manage/user-notes.php?action=edit+59879 Delete: added to the manual -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes&reason=added+to+the+manual Delete: bad code -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes&reason=bad+code Delete: spam -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes&reason=spam Delete: useless -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes&reason=useless Delete: non-english -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes&reason=non-english Delete: already in docs -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes&reason=already+in+docs Delete: other reasons -- http://master.php.net/manage/user-notes.php?action=delete+59879&report=yes Reject -- http://master.php.net/manage/user-notes.php?action=reject+59879&report=yes Search -- http://master.php.net/manage/user-notes.php