phpDocumentor phpDocumentor
Parsers
[ class tree: phpDocumentor ] [ index: phpDocumentor ] [ all elements ]

Class: parserDescParser

Source Location: /phpDocumentor/ParserDescCleanup.inc

Class parserDescParser

Class Overview

Parses a DocBlock description to retrieve abstract representations of

<pre>,<code>,<p>,<ul>,<ol>,<li>,<b>,<i>

Located in /phpDocumentor/ParserDescCleanup.inc [line 298]

Publisher
   |
   --Parser
      |
      --parserDescParser
Author(s): Information Tags:
Version:  $Id: Parser.inc,v 1.6 2006/08/17 03:23:26 cellog Exp $
Since:  1.2
Tutorial:  phpDocumentor 1.3.1 Tutorial

Methods

[ Top ]
Inherited Properties, Constants, and Methods
Inherited Properties Inherited Methods Inherited Constants

Inherited From Publisher

Publisher::$subscriber

Inherited From Parser

Parser::Parser()
Set up invariant parsing variables
Parser::categoryTagHandler()
handles @category
Parser::checkEventPop()
this function checks whether parameter $word is a token for popping the current event off of the Event Stack.
Parser::checkEventPush()
this function checks whether parameter $word is a token for pushing a new event onto the Event Stack.
Parser::configWordParser()
tell the parser's WordParser $wp to set up tokens to parse words by.
Parser::defaultTagHandler()
Handles all standard tags that only have a description
Parser::endTag()
Called to clean up at the end of parsing a @tag in a docblock
Parser::exampleTagHandler()
handles @example
Parser::getParserEventName()
Debugging function, takes an event number and attempts to return its name
Parser::globalTagHandler()
handles @global
Parser::invalidTagHandler()
Handles tags like '@filesource' that only work in PHP 4.3.0+
Parser::packageTagHandler()
handles @package
Parser::paramTagHandler()
handles @param
Parser::parse()
Parse a new file
Parser::returnTagHandler()
handles @return
Parser::setupStates()
setup the parser tokens, and the pushEvent/popEvent arrays
Parser::staticvarTagHandler()
handles @staticvar
Parser::usesTagHandler()
handles @uses
Parser::varTagHandler()
handles @var

Inherited From Publisher

Publisher::publishEvent()
Publisher::subscribe()
Adds a subscriber to the $subscriber array().

[ Top ]
Method Summary
parserDescParser   parserDescParser()   sets $wp to be a ObjectWordParser
boolean   doSimpleList()   Return a simple list, if found
void   getParserEventName()  
void   parse()   Parse a long or short description for tags
void   setupStates()   setup the parser tokens, and the pushEvent/popEvent arrays

[ Top ]
Methods
Constructor parserDescParser  [line 349]

  parserDescParser parserDescParser( )

sets $wp to be a ObjectWordParser

$wp is the word parser that retrieves tokens



[ Top ]
doSimpleList  [line 1176]

  boolean doSimpleList( string $word  )

Return a simple list, if found

This helper function extracts a simple list beginning with any of 'o','-'.'#','+','0','1','0.','1.' and starts parsing it.

Parameters:
string   $word:  line that may contain a simple list

API Tags:
Return:  true if a list is found, false otherwise


[ Top ]
getParserEventName  [line 1450]

  void getParserEventName( $value  )

Parameters:
   $value: 


Redefinition of:
Parser::getParserEventName()
Debugging function, takes an event number and attempts to return its name

[ Top ]
parse  [line 363]

  void parse( array &$parse_data, [boolean $sdesc = false], [string $ind_type = 'parserDesc']  )

Parse a long or short description for tags

Parameters:
array   &$parse_data:  array of strings or parserInlineTags
boolean   $sdesc:  true if the description is a short description. (only 1 paragraph allowed in short desc)
string   $ind_type:  name of the class to instantiate for each paragraph. parserDesc for desc/sdesc, parserStringWithInlineTags for tag data

API Tags:
Staticvar:  integer $endrecur: used for recursion limiting if a handler for an event is not found
Usedby:  parserDocBlock::postProcess()


Redefinition of:
Parser::parse()
Parse a new file

[ Top ]
setupStates  [line 1219]

  void setupStates( boolean $sdesc  )

setup the parser tokens, and the pushEvent/popEvent arrays

Parameters:
boolean   $sdesc:  determines whether to allow paragraph parsing

API Tags:
Global:  boolean 0: used to determine whether to slow things down or not by eliminating whitespace from comments
See:  Publisher::$tokens, Publisher::$pushEvent, Publisher::$popEvent


Redefinition of:
Parser::setupStates()
setup the parser tokens, and the pushEvent/popEvent arrays

[ Top ]

Documentation generated on Tue, 24 Oct 2006 09:24:59 -0500 by phpDocumentor 1.3.1