Add extra documentation to the views_flag_refresh.api.php file

The code should be thoroughly commented for a more detailed explanation of what it does.