From 1f09b786730956d01c48a82272617a0f8b2597f0 Mon Sep 17 00:00:00 2001 From: "ctrlaltca@gmail.com" <> Date: Sat, 19 Nov 2011 11:05:46 +0000 Subject: updating phpDocumentor, part 1: removal of the old version --- .../phpDocumentor/PackagePageElements.inc | 387 --------------------- 1 file changed, 387 deletions(-) delete mode 100644 buildscripts/PhpDocumentor/phpDocumentor/PackagePageElements.inc (limited to 'buildscripts/PhpDocumentor/phpDocumentor/PackagePageElements.inc') diff --git a/buildscripts/PhpDocumentor/phpDocumentor/PackagePageElements.inc b/buildscripts/PhpDocumentor/phpDocumentor/PackagePageElements.inc deleted file mode 100644 index 1b71b6b7..00000000 --- a/buildscripts/PhpDocumentor/phpDocumentor/PackagePageElements.inc +++ /dev/null @@ -1,387 +0,0 @@ -, - * contains every other tag and all text. - * @tutorial tutorials.pkg - * @package phpDocumentor - * @subpackage Tutorial - */ -/** - * Represents sections. - * - * These sections are interpreted as plain text - * @package phpDocumentor - * @subpackage Tutorial - */ -class parserCData extends parserStringWithInlineTags -{ - /** - * @uses Converter::getCData() convert contents to text - * @param Converter - */ - function Convert(&$c, $postprocess = true) - { - $val = $this->value; - if ($postprocess) - foreach($this->value as $key => $value) - { - if (is_string($value)) $this->value[$key] = $c->getCData($value); - } - $this->cache = false; - $x = parent::Convert($c, false); - $this->value = $val; - return $x; - } -} -/** - * a standard XML DocBook Tag - * - * This class is designed to represent all DocBook tags. It is intelligent - * enough to understand the tag, and also the <refname> tag for - * as title for <refentry> - * @since 1.2 - * @package phpDocumentor - * @subpackage Tutorial - */ -class parserXMLDocBookTag extends parserStringWithInlineTags -{ - /** - * Attributes from the XML tag - * - * Format: array(attrname => attrvalue, attrname => attrvalue,...) - * @var array - */ - var $attributes = array(); - /** - * Name of the tag - * @var string - */ - var $name; - /**#@+ @access private */ - /** @var parserCData */ - var $_cdata; - /** @var parserTag */ - var $_title; - /** @var parserIdLineTag */ - var $_id; - /** - * Set to <refpurpose> in <refsynopsisdiv> - * @var parserTag - */ - var $_description; - /**#@-*/ - /** - * @param string tag name - */ - function parserXMLDocBookTag($name) - { - $this->name = $name; - } - - /** - * @param Converter - * @param boolean - * @uses Converter::TranslateTag() Calls this to enclose the contents of the - * DocBook tag based on the values in template options.ini file - */ - function Convert(&$c, $postprocess = true) - { - $value = parent::Convert($c, $postprocess); - $simvalue = parent::Convert($c, false); - foreach($this->attributes as $a => $v) - { - $this->attributes[$a] = (is_string($v) ? $v : $v->Convert($c, $postprocess)); - } - if (isset($this->_title)) - { - list($this->attributes,$value) = $c->ConvertTitle($this->name, $this->attributes, $this->_title->Convert($c, $postprocess), $value); - } - return $c->TranslateTag($this->name,$this->attributes,$value,$simvalue); - } - - /** - * Begin a new CData section - * @see addCData() - */ - function startCData() - { - $this->_cdata = new parserCData; - } - - /** - * Adds {@link $_cdata} to {@link $value} - */ - function endCData() - { - $this->value[] = $this->_cdata; - unset($this->_cdata); - } - - /** - * Retrieve either the table of contents index, or the location that - * the TOC will go - * @see setTOC() - * @param false|integer either an index of the {@}toc} tag in $this->value - * or false, if the next index value of $this->value - * is needed - */ - function getTOC($state = false) - { - if ($state !== false) return $this->value[$state]; - return count($this->value); - } - - /** - * @param integer index of the TOC in $this->value - * @param parserTocInlineTag - */ - function setTOC($state, $val) - { - $this->value[$state] = $val; - } - - /** - * add a word to CData - * @param string - */ - function addCData($word) - { - $this->_cdata->add($word); - } - - /** - * Add an xml tag attribute name="value" pair - * - * if the attribute is id, value must be a {@link parserIdInlineTag} - * @param string attribute name - * @param string|parserIdInlineTag value of attribute - */ - function addAttribute($name,$value) - { - $this->attributes[$name] = $value; - if ($name == 'id') - { - // fix 1153593 - if (is_string($value)) - { - addWarning(PDERROR_ID_MUST_BE_INLINE,$this->name,$value,$this->name,$value); - } else { - $this->setId($value); - } - } - } - - /** - * Set the title of a DocBook tag section. - * - * For most DocBook tags, the title is represented with a <title> - * tag pair. The top-level tag is a little different. Instead - * of using , phpDocumentor uses the contents of the - * tag in the tag - * @param parserXMLDocBookTag the title element - */ - function setTitle($title) - { - $this->_title = $title; - } - - /** - * If the id attribute is present, this method will set its id - * @param parserIdInlineTag - */ - function setId($id) - { - $this->_id = $id; - } - - /** - * Return converter-specific formatting of ID. - * - * Passes $c to {@link parserIdInlineTag::Convert()} - * @param Converter - * @return string - */ - function getId(&$c) - { - if ($this->_id) return trim($this->_id->Convert($c)); - } - - /** - * Determine whether the docbook element has a title - * @return boolean - */ - function hasTitle() - { - return isset($this->_title); - } - - /** - * Retrieve Converter-specific formatting of the title of this element - * @return string - * @param Converter - */ - function getTitle(&$c) - { - if ($this->name == 'refentry') - { - foreach($this->value as $tag) - { - if (is_object($tag) && $tag->name == 'refnamediv') - { - return $tag->getTitle($c); - } - } - } - if ($this->name == 'refnamediv') - { - foreach($this->value as $tag) - { - if (is_object($tag) && $tag->name == 'refname') - { - $t = new parserStringWithInlineTags; - foreach($tag->value as $val) $t->add($val); - $this->_title = $t; - } - if (is_object($tag) && $tag->name == 'refpurpose') - { - $t = new parserStringWithInlineTags; - foreach($tag->value as $val) $t->add($val); - $this->_description = $t; - } - } - } - if (isset($this->_title)) - return $this->_title->Convert($c); - if (is_object($this->value[0])) return $this->value[0]->getTitle($c); - if (isset($this->value[1])) - if (is_object($this->value[1])) return $this->value[1]->getTitle($c); - return ''; - } - - /** - * Retrieve the contents of a subsection - * - * This method uses the $_id members of nested docbook tags to retrieve - * the section defined by $subsection - * @param Converter - * @param string converter-specific subsection - */ - function getSubsection(&$c,$subsection) - { - if (!is_object($this->_id)) { - return false; - } - $search = phpDocumentor_clone($this->_id); - if (is_string($this->_id)) return false; - if (phpDocumentor_get_class($search) != 'parseridinlinetag') return false; - $search->id = $subsection; - foreach($this->value as $el) - { - if (phpDocumentor_get_class($el) == 'parserxmldocbooktag') - { - if ($el->getId($c) == $search->Convert($c)) - { - return $el; - } elseif ($a = $el->getSubsection($c,$subsection)) - { - return $a; - } - } - } - return false; - } - - /** - * Add contents to this tag. - * - * There are four kinds of data in a DocBook tutorial: - * 1. tags - normal tags like - * 2. entities - normal entities like ” - * 3. - character data that should not be interpreted, - * like contents - * 4. text - normal non-markup text - * - * All four kinds of data are added here - * @param parserEntity|parserCData|parserXMLDocBookTag|string nested tag, - * entity, or text - */ - function add($el) - { - if (is_string($el)) return parent::add($el); - if (phpDocumentor_get_class($el) == 'parserxmldocbooktag') - { - if ($el->name == 'title') - { - $this->setTitle($el); - } else return parent::add($el); - } else return parent::add($el); - } -} - -/** - * a standard entity like ” - * - * This class is designed to represent all DocBook entities. - * @since 1.2 - * @package phpDocumentor - * @subpackage Tutorial - */ -class parserEntity -{ - /** - * @param string entity name - */ - function parserEntity($name) - { - $this->value = $name; - } - - /** - * @uses Converter::TranslateEntity() convert contents to text - * @param Converter - * @return string - */ - function Convert(&$c, $postprocess = true) - { - if ($postprocess) - return $c->TranslateEntity($this->value); - else - { - $trans_tbl = get_html_translation_table (HTML_ENTITIES); - $trans_tbl = array_flip ($trans_tbl); - $ret = strtr ('&'.$this->value.';', $trans_tbl); - return $ret; - } - } -} -?> \ No newline at end of file -- cgit v1.2.3