[ticket/11469] Have all methods of phpbb_db_sql_insert_buffer provide feedback.

PHPBB3-11469
[ticket/11469] Add note about calling flush() after batch insert is done.

PHPBB3-11469