docs: def add_tagged_publisher(reading_line,
                           matched_publisher,
                           startpos,
                           true_replacement_index,
                           extras,
                           kb_publishers):
      """In rebuilding the line, add an identified periodical TITLE (standardised
         and tagged) into the line.
         @param reading_line: (string) The reference line before capitalization
          was performed, and before REPORT-NUMBERs and TITLEs were stripped out.
         @param len_title: (integer) the length of the matched TITLE.
         @param matched_title: (string) the matched TITLE text.
         @param previous_match: (string) the previous periodical TITLE citation to
          have been matched in the current reference line. It is used when
          replacing an IBID instance in the line.
         @param startpos: (integer) the pointer to the next position in the
          reading-line from which to start rebuilding.
         @param true_replacement_index: (integer) the replacement index of the
          matched TITLE in the reading-line, with stripped punctuation and
          whitespace accounted for.
         @param extras: (integer) extras to be added into the replacement index.
         @param standardised_titles: (dictionary) the standardised versions of
          periodical titles, keyed by their various non-standard versions.
         @return: (tuple) containing a string (the rebuilt line segment), an
          integer (the next 'startpos' in the reading-line), and an other string
          (the newly updated previous-match).
      """
      # Fill 'rebuilt_line' (the segment of the line that is being rebuilt to
      # include the tagged and standardised periodical TITLE) with the contents
      # of the reading-line, up to the point of the matched TITLE:
      rebuilt_line = reading_line[startpos:true_replacement_index]
      # This is a normal title, not an IBID
      rebuilt_line += "<cds.PUBLISHER>%(title)s</cds.PUBLISHER>" \
                      % {'title': kb_publishers[matched_publisher]['repl']}
      # Compute new start pos
      startpos = true_replacement_index + len(matched_publisher) + extras
  
      # return the rebuilt line-segment, the position (of the reading line) from
      # which the next part of the rebuilt line should be started, and the newly
      # updated previous match.
  
      return rebuilt_line, startpos