phpDocumentor Converters
XMLDocBook
[ class tree: Converters ] [ index: Converters ] [ all elements ]

Class: XMLDocBookpeardoc2Converter

Source Location: /phpDocumentor/Converters/XML/DocBook/peardoc2/XMLDocBookpeardoc2Converter.inc

Class XMLDocBookpeardoc2Converter

Class Overview

XML DocBook converter.

This Converter takes output from the Parser and converts it to DocBook output for PEAR documentation.

This Converter differs from the parent DocBook Converter in that it does not recognize the possibility of procedural pages or of functions! All functions must be defined as static methods for namespace purposes. In addition, all constants and global variables for a package are grouped together as per peardoc2 requirements. Include statements are not documented. If you want to document a normal project, don't use the peardoc2 converter, use the DocBook converter.

Located in /phpDocumentor/Converters/XML/DocBook/peardoc2/XMLDocBookpeardoc2Converter.inc [line 58]

Converter
   |
   --XMLDocBookpeardoc2Converter
Author(s): Information Tags:
Version:  $Id: XMLDocBookpeardoc2Converter.inc,v 1.6 2006/10/24 04:18:14 cellog Exp $
Since:  1.2

Properties

Methods

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

Inherited From Converter

Converter::$all_packages
Converter::$classes
Converter::$class_contents
Converter::$class_elements
Converter::$curfile
Converter::$curpage
Converter::$define_elements
Converter::$elements
Converter::$function_elements
Converter::$global_elements
Converter::$highlightingSource
Converter::$package
Converter::$packagecategories
Converter::$package_elements
Converter::$package_output
Converter::$package_parents
Converter::$page_contents
Converter::$page_elements
Converter::$parseprivate
Converter::$pkg_elements
Converter::$quietmode
Converter::$smarty_dir
Converter::$sourcePaths
Converter::$subpackage
Converter::$targetDir
Converter::$templateDir
Converter::$templateName
Converter::$title
Converter::$todoList

Inherited From Converter

Converter::Converter()
Initialize Converter data structures
Converter::AttrToString()
Convert the attribute of a Tutorial docbook tag's attribute list
Converter::Bolden()
Used to convert the contents of <b> in a docblock
Converter::Br()
Used to convert <br> in a docblock
Converter::checkState()
Compare parserStringWithInlineTags::Convert() cache state to $state
Converter::cleanup()
Finish up parsing/cleanup directories
Converter::Convert()
Convert all elements to output format
Converter::convertClass()
Default Class Handler
Converter::convertConst()
Converts class constants for template output.
Converter::convertDefine()
Converts defines for template output
Converter::ConvertErrorLog()
Convert the phpDocumentor parsing/conversion error log
Converter::convertFunction()
Converts function for template output
Converter::convertGlobal()
Converts global variables for template output
Converter::convertInclude()
Converts includes for template output
Converter::convertMethod()
Converts method for template output
Converter::convertPage()
Default Page Handler
Converter::ConvertTitle()
Convert the title of a Tutorial docbook tag section
Converter::ConvertTodoList()
Convert the list of all @todo tags
Converter::convertTutorial()
Default Tutorial Handler
Converter::convertVar()
Converts class variables for template output.
Converter::Convert_RIC()
Convert README/INSTALL/CHANGELOG file contents to output format
Converter::copyFile()
Copies a file from the template directory to the target directory
Converter::createParentDir()
Recursively creates all subdirectories that don't exist in the $dir path
Converter::EncloseList()
Used to convert the contents of <ol> or <ul> in a docblock
Converter::EncloseParagraph()
Used to enclose a paragraph in a docblock
Converter::endClass()
Called by walk() while converting, when the last class element has been parsed.
Converter::endPage()
Called by walk() while converting, when the last procedural page element has been parsed.
Converter::exampleProgramExample()
Used to convert the {@example} inline tag in a docblock.
Converter::flushHighlightCache()
Return the close text for the current token
Converter::formatIndex()
Called by walk() while converting.
Converter::formatLeftIndex()
Called by walk() while converting.
Converter::formatPkgIndex()
Called by walk() while converting.
Converter::formatTutorialTOC()
Creates a table of contents for a {@toc} inline tag in a tutorial
Converter::generateChildClassList()
returns a list of child classes
Converter::generateFormattedClassTree()
returns an array containing the class inheritance tree from the root object to the class.
Converter::getClassesOnPage()
gets a list of all classes declared on a procedural page represented by
Converter::getClassLink()
return false or a classLink to $expr
Converter::getConstLink()
return false or a constLink to $expr in $class
Converter::getConverterDir()
Get the absolute path to the converter's base directory
Converter::getCurrentPageLink()
Converter::getCurrentPageURL()
Return the path to the current
Converter::getDefineLink()
return false or a defineLink to $expr
Converter::getFileSourceName()
Translate the path info into a unique file name for the highlighted source code.
Converter::getFileSourcePath()
Return the fixed path to the source-code file folder.
Converter::getFormattedConflicts()
Converter::getFormattedDescMethods()
Get a list of methods in child classes that override this method
Converter::getFormattedDescVars()
Get a list of vars in child classes that override this var
Converter::getFormattedImplements()
returns an array containing the class inheritance tree from the root object to the class.
Converter::getFormattedInheritedConsts()
Return template-enabled list of inherited class constants
Converter::getFormattedInheritedMethods()
Return template-enabled list of inherited methods
Converter::getFormattedInheritedVars()
Return template-enabled list of inherited variables
Converter::getFormattedMethodImplements()
Get the method this method(s) implemented from an interface, if any
Converter::getFormattedOverrides()
Get the method this method overrides, if any
Converter::getFunctionLink()
return false or a functionLink to $expr
Converter::getGlobalLink()
return false or a globalLink to $expr
Converter::getGlobalValue()
Parse a global variable's default value for class initialization.
Converter::getHighlightState()
Converter::getId()
take abstractLink descendant and text $eltext and return a
Converter::getIncludeValue()
Parse an include's file to see if it is a file documented in this project
Converter::getLink()
The meat of the @see tag and inline {@link} tag
Converter::getMethodLink()
return false or a methodLink to $expr in $class
Converter::getPageLink()
return false or a pageLink to $expr
Converter::getSortedClassTreeFromClass()
Return a tree of all classes that extend this class
Converter::getSourceLink()
Converter::getState()
Return parserStringWithInlineTags::Convert() cache state
Converter::getTutorialId()
Return a converter-specific id to distinguish tutorials and their sections
Converter::getTutorialLink()
The meat of the @tutorial tag and inline {@tutorial} tag
Converter::getTutorialTree()
Get a tree structure representing the hierarchy of tutorials
Converter::getVarLink()
return false or a varLink to $expr in $class
Converter::hasSourceCode()
Determine whether an element's file has generated source code, used for linking to line numbers of source.
Converter::hasTutorial()
Converter::highlightDocBlockSource()
Used to allow converters to format the source code of DocBlocks the way they'd like.
Converter::highlightSource()
Used to allow converters to format the source code the way they'd like.
Converter::highlightTutorialSource()
Used to allow converters to format the source code of Tutorial XML the way they'd like.
Converter::Italicize()
Used to convert the contents of <i> in a docblock
Converter::Kbdize()
Used to convert the contents of <kbd> in a docblock
Converter::ListItem()
Used to convert the contents of <li> in a docblock
Converter::newSmarty()
Return a Smarty template object to operate with
Converter::Output()
do all necessary output
Converter::postProcess()
This version does nothing
Converter::prepareDocBlock()
convert the element's DocBlock for output
Converter::PreserveWhiteSpace()
Used to convert the contents of <pre> in a docblock
Converter::ProgramExample()
Used to convert the <code> tag in a docblock
Converter::returnLink()
take URL $link and text $text and return a link in the format needed for the Converter
Converter::returnSee()
take abstractLink descendant and text $eltext and return a link
Converter::Sampize()
Used to convert the contents of <samp> in a docblock
Converter::setSourcePaths()
Mark a file as having had source code highlighted
Converter::setTargetDir()
Sets the output directory for generated documentation
Converter::setTemplateBase()
Set the template directory with a different template base directory
Converter::setTemplateDir()
sets the template directory based on the $outputformat and $name
Converter::sortPageContentsByElementType()
sorts $page_contents by element type as well as alphabetically
Converter::sourceLine()
Return a line of highlighted source code with formatted line number
Converter::startHighlight()
Initialize highlight caching
Converter::TranslateEntity()
Used to translate an XML DocBook entity like &rdquo; from a tutorial by reading the options.ini file for the template.
Converter::TranslateTag()
Used to translate an XML DocBook tag from a tutorial by reading the options.ini file for the template.
Converter::TutorialExample()
Converter::type_adjust()
Called by parserReturnTag::Convert() to allow converters to change type names to desired formatting
Converter::unmangle()
Called by parserSourceInlineTag::stringConvert() to allow converters to format the source code the way they'd like.
Converter::vardump_tree()
Debugging function for dumping $tutorial_tree
Converter::Varize()
Used to convert the contents of <var> in a docblock
Converter::walk()
called by phpDocumentor_IntermediateParser::Convert() to traverse the array of pages and their elements, converting them to the output format
Converter::walk_everything()
walk over elements by package rather than page
Converter::writeExample()
Write out the formatted source code for an example php file
Converter::writeFile()
Writes a file to target dir
Converter::writeSource()
Write out the formatted source code for a php file
Converter::_rmdir()
Completely remove a directory and its contents
Converter::_setHighlightCache()
Converter::_tutorial_path()
Returns the path to this tutorial as a string

[ Top ]
Property Summary
string   $base_dir   target directory passed on the command-line.
string   $category   peardoc2 Category
string   $class   name of current class being converted
Template   $class_data   template for the class currently being processed
string   $class_dir   output directory for the current class being processed
array   $current   contains all of the template procedural page element loop data needed for the current template
array   $currentclass   contains all of the template class element loop data needed for the current template
mixed   $function_data  
boolean   $juststarted   controls formatting of parser informative output
array   $leftindex   indexes of elements by package that need to be generated
boolean   $local   whether a @see is going to be in the $base_dir, or in a package/subpackage subdirectory of $base_dir
mixed   $method_data  
string   $name  
string   $outputformat  
Smarty   $packagexml   Contents of the packagename.xml file are stored in this template variable
array   $package_pages   array of converted package page names.
string   $page   name of current page being converted
Template   $page_data   template for the procedural page currently being processed
string   $page_dir   output directory for the current procedural page being processed
string   $path   path of current page being converted
boolean   $processSpecialRoots   This converter knows about the new root tree processing
mixed   $sort_absolutely_everything   Pass elements by package, simplifies generation of package.xml/category.xml
boolean   $sort_page_contents_by_type   XMLDocBookConverter wants elements sorted by type as well as alphabetically
mixed   $sourceloc  
array   $template_options   template options. Currently only 1 recognized option usepear
array   $_peardoc2_constants   Constants, used for constants.tpl
array   $_peardoc2_globals   Global Variables, used for globals.tpl
mixed   $_write_constants_xml  
mixed   $_write_globals_xml  

[ Top ]
Method Summary
XMLDocBookpeardoc2Converter   XMLDocBookpeardoc2Converter()   sets $base_dir to $targetDir
void   addSummaryToPackageXml()  
void   Br()  
void   convertClass()   Converts class for template output
void   convertDefine()   Converts defines for template output
void   ConvertErrorLog()   Create errors.html template file output
void   convertFunction()   Converts function for template output - does nothing in peardoc2!
void   convertGlobal()   Converts global variables for template output
void   convertInclude()   Converts include elements for template output
void   convertMethod()   Converts method for template output
void   convertPackagePage()   Does nothing - use tutorials for DocBook
void   convertPage()   converts procedural pages for template output
void   convertTutorial()   Convert tutorials for output
void   convertVar()   Does nothing in this converter
void   endClass()   Writes out the template file of $class_data and unsets the template to save memory
string   exampleProgramExample()   Used to convert the {@example} inline tag in a docblock.
void   flushPackageXml()  
void   formatIndex()   Does nothing
void   formatLeftIndex()   Creates package/lang/categoryname/packagename.xml for each package
void   formatPkgIndex()   Does nothing
void   generateChildClassList()   returns a list of child classes
void   generateElementIndex()   does nothing
array   generateFormattedClassTree()   returns an array containing the class inheritance tree from the root object to the class
void   generateFormattedClassTrees()   returns a template-enabled array of class trees
void   generateFormattedInterfaceTrees()   returns a template-enabled array of interface inheritance trees
void   generatePkgElementIndex()   Generate alphabetical index of all elements by package and subpackage
void   generatePkgElementIndexes()  
void   getCData()  
mixed   getClassLink()  
mixed   getDefineLink()  
void   getExampleLink()  
mixed   getFunctionLink()  
mixed   getGlobalLink()  
string   getId()   Get the id value needed to allow linking
void   &getLink()   do that stuff in $template_options
mixed   getMethodLink()  
mixed   getPageLink()  
void   getPageName()  
string   getRootTree()   return formatted class tree for the Class Trees page
string   getSourceAnchor()   Retrieve a Converter-specific anchor to a segment of a source code file parsed via a @filesource tag.
void   getTutorialId()  
mixed   getVarLink()  
void   makeLeft()  
void   Output()   Generate the constants.xml, packagename.xml, and globals.xml files
void   postProcess()  
void   prepareDocBlock()  
void   ProgramExample()  
int   rcNatCmp()   does a nat case sort on the specified second level value of the array
int   rcNatCmp1()   does a nat case sort on the specified second level value of the array.
string   returnLink()  
void   returnSee()   This function takes an abstractLink descendant and returns an html link
void   setTemplateDir()  
void   type_adjust()  
void   unmangle()  
void   wordwrap()  
void   writeExample()  
void   writeFile()   Writes a file to target dir, beautify any .xml files first
void   writeNewPPage()   Does nothing
void   writeSource()   Does nothing

[ Top ]
Properties
string   $base_dir [line 134]

target directory passed on the command-line.

$targetDir is malleable, always adding package/ and package/subpackage/ subdirectories onto it.


[ Top ]
string   $category [line 207]

peardoc2 Category


[ Top ]
string   $class [line 103]

name of current class being converted


Redefinition of:
Converter::$class
set to a classname if currently parsing a class, false if not

[ Top ]
Template   $class_data [line 146]

template for the class currently being processed


Redefinition of:
Converter::$class_data
template for the class currently being processed

[ Top ]
string   $class_dir [line 140]

output directory for the current class being processed


[ Top ]
array   $current [line 176]

contains all of the template procedural page element loop data needed for the current template


[ Top ]
array   $currentclass [line 182]

contains all of the template class element loop data needed for the current template


[ Top ]
mixed   $function_data = array() [line 198]

[ Top ]
boolean   $juststarted = false [line 170]

controls formatting of parser informative output

Converter prints: "Converting /path/to/file.php... Procedural Page Elements... Classes..." Since HTMLdefaultConverter outputs files while converting, it needs to send a \n to start a new line. However, if there is more than one class, output is messy, with multiple \n's just between class file output. This variable prevents that and is purely cosmetic


[ Top ]
array   $leftindex = array('classes' => true, 'pages' => false, 'functions' => false, 'defines' => true, 'globals' => true) [line 80]

indexes of elements by package that need to be generated


Redefinition of:
Converter::$leftindex
Controls which of the one-element-only indexes are generated.

[ Top ]
boolean   $local = true [line 85]

whether a @see is going to be in the $base_dir, or in a package/subpackage subdirectory of $base_dir


[ Top ]
mixed   $method_data = array() [line 199]

[ Top ]
string   $name = 'DocBook/peardoc2' [line 75]

[ Top ]
string   $outputformat = 'XML' [line 73]

Redefinition of:
Converter::$outputformat
output format of this converter

[ Top ]
Smarty   $packagexml [line 159]

Contents of the packagename.xml file are stored in this template variable


[ Top ]
array   $package_pages = array() [line 153]

array of converted package page names.

Used to link to the package page in the left index


[ Top ]
string   $page [line 91]

name of current page being converted


Redefinition of:
Converter::$page
name of current page being converted

[ Top ]
Template   $page_data [line 109]

template for the procedural page currently being processed


Redefinition of:
Converter::$page_data
template for the procedural page currently being processed

[ Top ]
string   $page_dir [line 115]

output directory for the current procedural page being processed


[ Top ]
string   $path [line 97]

path of current page being converted


Redefinition of:
Converter::$path
path of current page being converted

[ Top ]
boolean   $processSpecialRoots = true [line 65]

This converter knows about the new root tree processing

In order to fix PEAR Bug #6389


Redefinition of:
Converter::$processSpecialRoots
This converter knows about the new root tree processing

[ Top ]
mixed   $sort_absolutely_everything = true [line 187]

Pass elements by package, simplifies generation of package.xml/category.xml


Redefinition of:
Converter::$sort_absolutely_everything
This is used if the content must be passed in the order it should be read, i.e. by package, procedural then classes

[ Top ]
boolean   $sort_page_contents_by_type = true [line 71]

XMLDocBookConverter wants elements sorted by type as well as alphabetically

API Tags:
See:  Converter::$sort_page_contents_by_type


Redefinition of:
Converter::$sort_page_contents_by_type
This determines whether the $page_contents array should be sorted by element type as well as alphabetically by name

[ Top ]
mixed   $sourceloc = '' [line 202]

[ Top ]
array   $template_options = array('usepear' => false) [line 196]

template options. Currently only 1 recognized option usepear

usepear tells the getLink() function to return a package link to PEAR and PEAR_ERROR if possible, and to link directly to the fully-delimited link package#class.method or package#file.method in PEAR style, if possible, even if the package is not parsed. This will allow parsing of separate PEAR packages without parsing the entire thing at once!


Redefinition of:
Converter::$template_options
Options for each template, parsed from the options.ini file in the template base directory

[ Top ]
array   $_peardoc2_constants = false [line 121]

Constants, used for constants.tpl


[ Top ]
array   $_peardoc2_globals = false [line 127]

Global Variables, used for globals.tpl


[ Top ]
mixed   $_write_constants_xml = array() [line 200]

[ Top ]
mixed   $_write_globals_xml = array() [line 201]

[ Top ]
Methods
Constructor XMLDocBookpeardoc2Converter  [line 220]

  XMLDocBookpeardoc2Converter XMLDocBookpeardoc2Converter( &$allp, &$packp, &$classes, &$procpages, $po, $pp, $qm, $targetDir, $templateDir, $title  )

sets $base_dir to $targetDir

Parameters:
   &$allp: 
   &$packp: 
   &$classes: 
   &$procpages: 
   $po: 
   $pp: 
   $qm: 
   $targetDir: 
   $templateDir: 
   $title: 

API Tags:
See:  Converter::Converter()


[ Top ]
addSummaryToPackageXml  [line 345]

  void addSummaryToPackageXml( $template_output  )

Parameters:
   $template_output: 


[ Top ]
Br  [line 681]

  void Br( $input  )

Parameters:
   $input: 


Redefinition of:
Converter::Br()
Used to convert <br> in a docblock

[ Top ]
convertClass  [line 794]

  void convertClass( parserClass &$element  )

Converts class for template output

Parameters:
parserClass   &$element: 

API Tags:
Uses:  XMLDocBookpeardoc2Converter::flushPackageXml() - creates packagename.xml file when all classes in a package have been converted


Redefinition of:
Converter::convertClass()
Default Class Handler

[ Top ]
convertDefine  [line 1010]

  void convertDefine( parserDefine &$element  )

Converts defines for template output

Parameters:
parserDefine   &$element: 

API Tags:
See:  XMLDocBookpeardoc2Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertDefine()
Converts defines for template output

[ Top ]
ConvertErrorLog  [line 565]

  void ConvertErrorLog( )

Create errors.html template file output

This method takes all parsing errors and warnings and spits them out ordered by file and line number.


API Tags:
Global:  ErrorTracker $phpDocumentor_errors: We'll be using it's output facility


Redefinition of:
Converter::ConvertErrorLog()
Convert the phpDocumentor parsing/conversion error log

[ Top ]
convertFunction  [line 938]

  void convertFunction( parserFunction &$element  )

Converts function for template output - does nothing in peardoc2!

Parameters:
parserFunction   &$element: 


Redefinition of:
Converter::convertFunction()
Converts function for template output

[ Top ]
convertGlobal  [line 1050]

  void convertGlobal( parserGlobal &$element  )

Converts global variables for template output

Parameters:
parserGlobal   &$element: 

API Tags:
See:  XMLDocBookpeardoc2Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertGlobal()
Converts global variables for template output

[ Top ]
convertInclude  [line 990]

  void convertInclude( parserInclude &$element  )

Converts include elements for template output

Completely ignored by this converter

Parameters:
parserInclude   &$element: 


Redefinition of:
Converter::convertInclude()
Converts includes for template output

[ Top ]
convertMethod  [line 862]

  void convertMethod( parserMethod &$element  )

Converts method for template output

Parameters:
parserMethod   &$element: 

API Tags:
See:  XMLDocBookpeardoc2Converter::prepareDocBlock(), parserMethod::getFunctionCall(), Converter::getFormattedDescMethods(), Converter::getFormattedOverrides()


Redefinition of:
Converter::convertMethod()
Converts method for template output

[ Top ]
convertPackagePage  [line 709]

  void convertPackagePage( parserPackagePage &$element  )

Does nothing - use tutorials for DocBook

Parameters:
parserPackagePage   &$element: 


[ Top ]
convertPage  [line 1100]

  void convertPage( parserData &$element  )

converts procedural pages for template output

Parameters:
parserData   &$element: 

API Tags:
See:  XMLDocBookpeardoc2Converter::prepareDocBlock(), Converter::getClassesOnPage()


Redefinition of:
Converter::convertPage()
Default Page Handler

[ Top ]
convertTutorial  [line 717]

  void convertTutorial( parserTutorial &$element  )

Convert tutorials for output

Parameters:
parserTutorial   &$element: 


Redefinition of:
Converter::convertTutorial()
Default Tutorial Handler

[ Top ]
convertVar  [line 756]

  void convertVar( parserVar &$element  )

Does nothing in this converter

Parameters:
parserVar   &$element: 


Redefinition of:
Converter::convertVar()
Converts class variables for template output.

[ Top ]
endClass  [line 322]

  void endClass( )

Writes out the template file of $class_data and unsets the template to save memory


API Tags:
See:  Converter::endClass()
See:  registerCurrentClass()

Information Tags:
Todo:  move class summary into an array to be written out at the end of parsing each package

Redefinition of:
Converter::endClass()
Called by walk() while converting, when the last class element has been parsed.

[ Top ]
exampleProgramExample  [line 276]

  string exampleProgramExample( string $example, [boolean $tutorial = false], [ $inlinesourceparse = null], [ $class = null], [ $linenum = null], [ $filesourcepath = null]  )

Used to convert the {@example} inline tag in a docblock.

By default, this just wraps ProgramExample

Parameters:
string   $example: 
boolean   $tutorial:  true if this is to highlight a tutorial <programlisting>
   $inlinesourceparse: 
   $class: 
   $linenum: 
   $filesourcepath: 

API Tags:
See:  XMLDocBookpeardoc2Converter::exampleProgramExample


Redefinition of:
Converter::exampleProgramExample()
Used to convert the {@example} inline tag in a docblock.

[ Top ]
flushPackageXml  [line 353]

  void flushPackageXml( parserClass|false $element  )

Parameters:
parserClass|false   $element:  is false if this is the end of all conversion

API Tags:
Usedby:  XMLDocBookpeardoc2Converter::convertClass() - creates packagename.xml file when all classes in a package have been converted


[ Top ]
formatIndex  [line 419]

  void formatIndex( )

Does nothing



Redefinition of:
Converter::formatIndex()
Called by walk() while converting.

[ Top ]
formatLeftIndex  [line 440]

  void formatLeftIndex( )

Creates package/lang/categoryname/packagename.xml for each package



Redefinition of:
Converter::formatLeftIndex()
Called by walk() while converting.

[ Top ]
formatPkgIndex  [line 412]

  void formatPkgIndex( )

Does nothing



Redefinition of:
Converter::formatPkgIndex()
Called by walk() while converting.

[ Top ]
generateChildClassList  [line 1166]

  void generateChildClassList( parserClass $class  )

returns a list of child classes

Parameters:
parserClass   $class:  class variable

API Tags:
Uses:  parserClass::getChildClassList()


Redefinition of:
Converter::generateChildClassList()
returns a list of child classes

[ Top ]
generateElementIndex  [line 1379]

  void generateElementIndex( )

does nothing



[ Top ]
generateFormattedClassTree  [line 1125]

  array generateFormattedClassTree( parserClass $class  )

returns an array containing the class inheritance tree from the root object to the class

Parameters:
parserClass   $class:  class variable

API Tags:
Return:  Format: array(root,child,child,child,...,$class)
Uses:  parserClass::getParentClassTree()


Redefinition of:
Converter::generateFormattedClassTree()
returns an array containing the class inheritance tree from the root object to the class.

[ Top ]
generateFormattedClassTrees  [line 1202]

  void generateFormattedClassTrees( string $package  )

returns a template-enabled array of class trees

Parameters:
string   $package:  package to generate a class tree for

API Tags:
See:  $roots, HTMLConverter::getRootTree()


[ Top ]
generateFormattedInterfaceTrees  [line 1256]

  void generateFormattedInterfaceTrees( string $package  )

returns a template-enabled array of interface inheritance trees

Parameters:
string   $package:  package to generate a class tree for

API Tags:
See:  $roots, HTMLConverter::getRootTree()


[ Top ]
generatePkgElementIndex  [line 1395]

  void generatePkgElementIndex( string $package  )

Generate alphabetical index of all elements by package and subpackage

Parameters:
string   $package:  name of a package

API Tags:
See:  Converter::$pkg_elements, Converter::walk(), XMLDocBookpeardoc2Converter::generatePkgElementIndexes()


[ Top ]
generatePkgElementIndexes  [line 1403]

  void generatePkgElementIndexes( )


API Tags:
See:  XMLDocBookpeardoc2Converter::generatePkgElementIndex()


[ Top ]
getCData  [line 686]

  void getCData( $value  )

Parameters:
   $value: 


[ Top ]
getClassLink  [line 1416]

  mixed getClassLink( string $expr, string $package, [string $file = false], [boolean $text = false], [boolean $local = true], [ $with_a = true]  )

Parameters:
string   $expr:  name of class
string   $package:  package name
string   $file:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag
   $with_a: 

API Tags:
Return:  false if not found, or an html a link to the class's documentation
See:  Converter::getClassLink()


Redefinition of:
Converter::getClassLink()
return false or a classLink to $expr

[ Top ]
getDefineLink  [line 1448]

  mixed getDefineLink( string $expr, string $package, [string $file = false], [boolean $text = false], [boolean $local = true]  )

Parameters:
string   $expr:  name of define
string   $package:  package name
string   $file:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag

API Tags:
Return:  false if not found, or an html a link to the define's documentation
See:  Converter::getDefineLink()


Redefinition of:
Converter::getDefineLink()
return false or a defineLink to $expr

[ Top ]
getExampleLink  [line 290]

  void getExampleLink( $unused, $title  )

Parameters:
   $unused: 
   $title: 


[ Top ]
getFunctionLink  [line 1432]

  mixed getFunctionLink( string $expr, string $package, [string $file = false], [boolean $text = false], [boolean $local = true]  )

Parameters:
string   $expr:  name of function
string   $package:  package name
string   $file:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag

API Tags:
Return:  false if not found, or an html a link to the function's documentation
See:  Converter::getFunctionLink()


Redefinition of:
Converter::getFunctionLink()
return false or a functionLink to $expr

[ Top ]
getGlobalLink  [line 1464]

  mixed getGlobalLink( string $expr, string $package, [string $file = false], [boolean $text = false], [boolean $local = true]  )

Parameters:
string   $expr:  name of global variable
string   $package:  package name
string   $file:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag

API Tags:
Return:  false if not found, or an html a link to the global variable's documentation
See:  Converter::getGlobalLink()


Redefinition of:
Converter::getGlobalLink()
return false or a globalLink to $expr

[ Top ]
getId  [line 513]

  string getId( mixed &$el, [boolean $returnpackage = false]  )

Get the id value needed to allow linking

Parameters:
mixed   &$el:  descendant of parserElement or parserData/parserPage
boolean   $returnpackage:  true to return the id for the package page

API Tags:
Return:  the id value for this element type
See:  parserElement, parserData, parserPage


Redefinition of:
Converter::getId()
take abstractLink descendant and text $eltext and return a

[ Top ]
getLink  [line 237]

  void &getLink( $expr, [ $package = false], [ $packages = false]  )

do that stuff in $template_options

Parameters:
   $expr: 
   $package: 
   $packages: 


Redefinition of:
Converter::getLink()
The meat of the @see tag and inline {@link} tag

[ Top ]
getMethodLink  [line 1497]

  mixed getMethodLink( string $expr, string $class, string $package, [string $file = false], [boolean $text = false], [boolean $local = true]  )

Parameters:
string   $expr:  name of method
string   $class:  class containing method
string   $package:  package name
string   $file:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag

API Tags:
Return:  false if not found, or an html a link to the method's documentation
See:  Converter::getMethodLink()


Redefinition of:
Converter::getMethodLink()
return false or a methodLink to $expr in $class

[ Top ]
getPageLink  [line 1480]

  mixed getPageLink( string $expr, string $package, [string $path = false], [boolean $text = false], [boolean $local = true]  )

Parameters:
string   $expr:  name of procedural page
string   $package:  package name
string   $path:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag

API Tags:
Return:  false if not found, or an html a link to the procedural page's documentation
See:  Converter::getPageLink()


Redefinition of:
Converter::getPageLink()
return false or a pageLink to $expr

[ Top ]
getPageName  [line 1112]

  void getPageName( &$element  )

Parameters:
   &$element: 


[ Top ]
getRootTree  [line 1313]

  string getRootTree( array $tree, string $package, [ $noparent = false], boolean $nounknownparent  )

return formatted class tree for the Class Trees page

Parameters:
array   $tree:  output from getSortedClassTreeFromClass()
string   $package:  package
boolean   $nounknownparent:  if true, an object's parent will not be checked
   $noparent: 

API Tags:
See:  Classes::$definitechild, XMLDocBookpeardoc2Converter::generateFormattedClassTrees()


[ Top ]
getSourceAnchor  [line 676]

  string getSourceAnchor( string $sourcefile, string $anchor, [string $text = ''], [boolean $link = false]  )

Retrieve a Converter-specific anchor to a segment of a source code file parsed via a @filesource tag.

NOTE: unused

Parameters:
string   $sourcefile:  full path to source file
string   $anchor:  name of anchor
string   $text:  link text, if this is a link
boolean   $link:  returns either a link or a destination based on this parameter

API Tags:
Return:  link to an anchor, or the anchor


[ Top ]
getTutorialId  [line 656]

  void getTutorialId( $package, $subpackage, $tutorial, $id, $category  )

Parameters:
   $package: 
   $subpackage: 
   $tutorial: 
   $id: 
   $category: 


Redefinition of:
Converter::getTutorialId()
Return a converter-specific id to distinguish tutorials and their sections

[ Top ]
getVarLink  [line 1514]

  mixed getVarLink( string $expr, string $class, string $package, [string $file = false], [boolean $text = false], [boolean $local = true]  )

Parameters:
string   $expr:  name of var
string   $class:  class containing var
string   $package:  package name
string   $file:  full path to look in (used in index generation)
boolean   $text:  deprecated
boolean   $local:  return just the URL, or enclose it in an html a tag

API Tags:
Return:  false if not found, or an html a link to the var's documentation
See:  Converter::getVarLink()


Redefinition of:
Converter::getVarLink()
return false or a varLink to $expr in $class

[ Top ]
makeLeft  [line 405]

  void makeLeft( )



[ Top ]
Output  [line 1576]

  void Output( )

Generate the constants.xml, packagename.xml, and globals.xml files



Redefinition of:
Converter::Output()
do all necessary output

[ Top ]
postProcess  [line 626]

  void postProcess( $text  )

Parameters:
   $text: 


Redefinition of:
Converter::postProcess()
This version does nothing

[ Top ]
prepareDocBlock  [line 631]

  void prepareDocBlock( &$element, [ $nopackage = true]  )

Parameters:
   &$element: 
   $nopackage: 


Redefinition of:
Converter::prepareDocBlock()
convert the element's DocBlock for output

[ Top ]
ProgramExample  [line 691]

  void ProgramExample( $listing, [ $tutorial = false], [ $inlinesourceparse = null], [ $class = null], [ $linenum = null], [ $filesourcepath = null], [ $origsource = null]  )

Parameters:
   $listing: 
   $tutorial: 
   $inlinesourceparse: 
   $class: 
   $linenum: 
   $filesourcepath: 
   $origsource: 


Redefinition of:
Converter::ProgramExample()
Used to convert the <code> tag in a docblock

[ Top ]
rcNatCmp  [line 1528]

  int rcNatCmp( mixed $a, mixed $b  )

does a nat case sort on the specified second level value of the array

Parameters:
mixed   $a: 
mixed   $b: 


[ Top ]
rcNatCmp1  [line 1544]

  int rcNatCmp1( mixed $a, mixed $b  )

does a nat case sort on the specified second level value of the array.

this one puts constructors first

Parameters:
mixed   $a: 
mixed   $b: 


[ Top ]
returnLink  [line 400]

  string returnLink( string $link, string $text  )

Parameters:
string   $link: 
string   $text: 

API Tags:
Return:  <ulink url="'.$link.'">'.$text.'</ulink>


Redefinition of:
Converter::returnLink()
take URL $link and text $text and return a link in the format needed for the Converter

[ Top ]
returnSee  [line 453]

  void returnSee( abstractLink &$element, [string $eltext = false], [boolean $local = true], [boolean $with_a = true]  )

This function takes an abstractLink descendant and returns an html link

Parameters:
abstractLink   &$element:  a descendant of abstractlink should be passed, and never text
string   $eltext:  text to display in the link
boolean   $local:  this parameter is not used, and is deprecated
boolean   $with_a:  determines whether the returned text is enclosed in an <link> tag


Redefinition of:
Converter::returnSee()
take abstractLink descendant and text $eltext and return a link

[ Top ]
setTemplateDir  [line 1383]

  void setTemplateDir( $dir  )

Parameters:
   $dir: 


Redefinition of:
Converter::setTemplateDir()
sets the template directory based on the $outputformat and $name

[ Top ]
type_adjust  [line 296]

  void type_adjust( $typename  )

Parameters:
   $typename: 


Redefinition of:
Converter::type_adjust()
Called by parserReturnTag::Convert() to allow converters to change type names to desired formatting

[ Top ]
unmangle  [line 242]

  void unmangle( $s, $sourcecode  )

Parameters:
   $s: 
   $sourcecode: 


Redefinition of:
Converter::unmangle()
Called by parserSourceInlineTag::stringConvert() to allow converters to format the source code the way they'd like.

[ Top ]
wordwrap  [line 1568]

  void wordwrap( $string  )

Parameters:
   $string: 


[ Top ]
writeExample  [line 285]

  void writeExample( $title, $path, $source  )

Parameters:
   $title: 
   $path: 
   $source: 


Redefinition of:
Converter::writeExample()
Write out the formatted source code for an example php file

[ Top ]
writeFile  [line 254]

  void writeFile( string $file, string $data, [boolean $binary = false]  )

Writes a file to target dir, beautify any .xml files first

Parameters:
string   $file:  filename
string   $data:  file contents
boolean   $binary:  true if the data is binary and not text


Redefinition of:
Converter::writeFile()
Writes a file to target dir

[ Top ]
writeNewPPage  [line 426]

  void writeNewPPage( $key  )

Does nothing

Parameters:
   $key: 


[ Top ]
writeSource  [line 433]

  void writeSource( )

Does nothing



Redefinition of:
Converter::writeSource()
Write out the formatted source code for a php file

[ Top ]

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