code: private function getCommentBlock(Tokens $tokens, $index)
      {
          $commentType = $this->getCommentType($tokens[$index]->getContent());
          $empty = $this->isEmptyComment($tokens[$index]->getContent());
          $start = $index;
          $count = \count($tokens);
          ++$index;
  
          for (; $index < $count; ++$index) {
              if ($tokens[$index]->isComment()) {
                  if ($commentType !== $this->getCommentType($tokens[$index]->getContent())) {
                      break;
                  }
  
                  if ($empty) { // don't retest if already known the block not being empty
                      $empty = $this->isEmptyComment($tokens[$index]->getContent());
                  }
  
                  continue;
              }
  
              if (!$tokens[$index]->isWhitespace() || $this->getLineBreakCount($tokens, $index, $index + 1) > 1) {
                  break;
              }
          }
  
          return [$start, $index - 1, $empty];
      }
docs: Return the start index, end index and a flag stating if the comment block is empty.
  
  @param Tokens $tokens
  @param int    $index  T_COMMENT index
  
  @return array