/usr/share/php/Icinga/Cli/Documentation/CommentParser.php is in php-icinga 2.1.0-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | <?php
/* Icinga Web 2 | (c) 2013-2015 Icinga Development Team | GPLv2+ */
namespace Icinga\Cli\Documentation;
class CommentParser
{
protected $raw;
protected $plain;
protected $title;
protected $paragraphs = array();
public function __construct($raw)
{
$this->raw = $raw;
if ($raw) {
$this->parse();
}
}
public function getTitle()
{
return $this->title;
}
protected function parse()
{
$plain = $this->raw;
// Strip comment start /**
$plain = preg_replace('~^/\s*\*\*\n~s', '', $plain);
// Strip comment end */
$plain = preg_replace('~\n\s*\*/\s*~s', "\n", $plain);
$p = null;
foreach (preg_split('~\n~', $plain) as $line) {
// Strip * at line start
$line = preg_replace('~^\s*\*\s?~', '', $line);
$line = rtrim($line);
if ($this->title === null) {
$this->title = $line;
continue;
}
if ($p === null && empty($this->paragraphs)) {
$p = & $this->paragraphs[];
}
if ($line === '') {
if ($p !== null) {
$p = & $this->paragraphs[];
}
continue;
}
if ($p === null) {
$p = $line;
} else {
if (substr($line, 0, 2) === ' ') {
$p .= "\n" . $line;
} else {
$p .= ' ' . $line;
}
}
}
if ($p === null) {
array_pop($this->paragraphs);
}
}
public function dump()
{
$res = $this->title . "\n" . str_repeat('=', strlen($this->title)) . "\n\n";
foreach ($this->paragraphs as $p) {
$res .= wordwrap($p, 72) . "\n\n";
}
return $res;
}
}
|