I recently started using rst2pdf and I have a bit trouble
with publishing table which splits over multiple pages:
rst2pdf has no support for displaying table header row
in every page.

Controlling repetitive display of table header is very easy ---
just passing reportlab.platypus.Table with repeatRows=0/1 in
rst2pdf.flowables.DelayedTable.wrap()::

  class DelayedTable(Flowable):                                                                                                                                               
       ...
      def __init__(self, data, colwidths, style, repeatRows=0):                                                                                                                            
          ...
      def wrap(self,w,h):                                                                                                                                                     
          ...
          self.t=Table(self.data,colWidths=colwidths,style=TableStyle(self.style),
                       repeatRows=self.repeatRow

Here I attached a patch which implements above and passes repeatRow via --repeat-table-rows 
commandline flag option.