docs: def clean_pieces(self, pieces):
          """Cleans the list of strings given as `pieces`.  It replaces
          multiple newlines by a maximum of 2 and returns a new list.
          It also wraps the paragraphs nicely.
  
          """
          ret = []
          count = 0
          for i in pieces:
              if i == '\n':
                  count = count + 1
              else:
                  if i == '";':
                      if count:
                          ret.append('\n')
                  elif count > 2:
                      ret.append('\n\n')
                  elif count:
                      ret.append('\n'*count)
                  count = 0
                  ret.append(i)
  
          _data = "".join(ret)
          ret = []
          for i in _data.split('\n\n'):
              if i == 'Parameters:':
                  ret.extend(['Parameters:\n-----------', '\n\n'])
              elif i.find('// File:') > -1: # leave comments alone.
                  ret.extend([i, '\n'])
              else:
                  _tmp = textwrap.fill(i.strip())
                  _tmp = self.lead_spc.sub(r'\1"\2', _tmp)
                  ret.extend([_tmp, '\n\n'])
          return ret