truncate

# File lib/rdoc/markup/to_html_snippet.rb, line 269
  def truncate text
    length = text.length
    characters = @characters
    @characters += length

    return text if @characters < @character_limit

    remaining = @character_limit - characters

    text =~ /\A(.{#{remaining},}?)(\s|$)/ # TODO word-break instead of \s?

    $1
  end