Docs For Class CHMdefaultConverter

CHMdefaultConverter (Constructor) [line 137]

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

[ Top ]

addHHP [line 1963]

void addHHP(
mixed
$file)

[ Top ]

addTOC [line 2018]

void addTOC(
mixed
$name, mixed
$file, mixed
$package, mixed
$subpackage, [mixed
$class = false], [mixed
$tutorial = false])

[ Top ]

checkState [line 1905]

void checkState(
boolean
$state)

checks $state to see if it is the same as $local

See: Converter::getState(), CHMdefaultConverter::$local

Overrides Converter::checkState() (Compare parserStringWithInlineTags::Convert() cache state to $state)

Parameters:

boolean $state — value to compare to $local

[ Top ]

Convert [line 546]

void Convert(
mixed
&$element)

Convert abstract $element for template

calls helper function based on element type

Overrides Converter::Convert() (Convert all elements to output format)

Parameters:

mixed &$element — any descendant of parserElement, or parserPage or parserPackagePage

[ Top ]

convertClass [line 849]

void convertClass(
parserClass
&$element)

Converts class for template output

Parameters:

parserClass &$element —

[ Top ]

convertDefine [line 991]

void convertDefine(
parserDefine
&$element)

Converts defines for template output

See: CHMdefaultConverter::prepareDocBlock(), CHMdefaultConverter::getFormattedConflicts()

Parameters:

parserDefine &$element —

[ Top ]

ConvertErrorLog [line 591]

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. It does not display any phpDocumentor internal errors, that is handled by exceptions, which always terminate execution.

Global: ErrorTracker $phpDocumentor_errors: We'll be using it's output facility
See: PHPDOCUMENTOR_EXCEPTIONS

Overrides Converter::ConvertErrorLog() (parent method not documented)

[ Top ]

convertFunction [line 934]

void convertFunction(
parserFunction
&$element)

Converts function for template output

See: CHMdefaultConverter::prepareDocBlock(), parserFunction::getFunctionCall(), CHMdefaultConverter::getFormattedConflicts()

Parameters:

parserFunction &$element —

[ Top ]

convertGlobal [line 1008]

void convertGlobal(
parserGlobal
&$element)

Converts global variables for template output

See: CHMdefaultConverter::prepareDocBlock(), CHMdefaultConverter::getFormattedConflicts()

Parameters:

parserGlobal &$element —

[ Top ]

convertInclude [line 971]

void convertInclude(
parserInclude
&$element)

Converts include elements for template output

See: CHMdefaultConverter::prepareDocBlock()

Parameters:

parserInclude &$element —

[ Top ]

convertMethod [line 898]

void convertMethod(
parserMethod
&$element)

Converts method for template output

See: CHMdefaultConverter::prepareDocBlock(), parserMethod::getFunctionCall(), CHMdefaultConverter::getFormattedDescMethods(), CHMdefaultConverter::getFormattedOverrides()

Parameters:

parserMethod &$element —

[ Top ]

convertPackagePage [line 746]

void convertPackagePage(
parserPackagePage
&$element)

Converts package page and sets its package as used in $package_pages

Parameters:

parserPackagePage &$element —

[ Top ]

convertPage [line 1028]

void convertPage(
parserData
&$element)

converts procedural pages for template output

See: CHMdefaultConverter::prepareDocBlock(), CHMdefaultConverter::getClassesOnPage()

Parameters:

parserData &$element —

[ Top ]

convertTutorial [line 774]

void convertTutorial(
parserTutorial
&$element)

Parameters:

parserTutorial &$element —

[ Top ]

convertVar [line 825]

void convertVar(
parserVar
&$element)

Converts class variables for template output.

See: CHMdefaultConverter::prepareDocBlock(), CHMdefaultConverter::getFormattedOverrides()

Parameters:

parserVar &$element —

[ Top ]

Convert_RIC [line 527]

void Convert_RIC(
README|INSTALL|CHANGELOG
$name, string
$contents)

Convert README/INSTALL/CHANGELOG file contents to output format

Overrides Converter::Convert_RIC() (Convert README/INSTALL/CHANGELOG file contents to output format)

Parameters:

README\|INSTALL\|CHANGELOG	`$name`	—
string	`$contents`	—	contents of the file

[ Top ]

copyMediaRecursively [line 1554]

void copyMediaRecursively(
mixed
$media, mixed
$targetdir, [mixed
$subdir = ''])

[ Top ]

endClass [line 191]

void endClass(
)

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

See: Converter::endClass()
See: registerCurrentClass()

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

[ Top ]

endPage [line 216]

void endPage(
)

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

See: Converter::endPage()
See: registerCurrent()

Overrides Converter::endPage() (Called by walk() while converting, when the last procedural page element has been parsed.)

[ Top ]

formatIndex [line 283]

void formatIndex(
)

HTMLdefaultConverter uses this function to format template index.html and packages.html

This function generates the package list from $all_packages, eliminating any packages that don't have any entries in their package index (no files at all, due to @ignore or other factors). Then it uses the default package name as the first package index to display. It sets the right pane to be either a blank file with instructions on making package-level docs, or the package-level docs for the default package.

Global: string $phpDocumentor_DefaultPackageName: Used to set the starting package to display

Overrides Converter::formatIndex() (Called by walk() while converting.)

[ Top ]

formatLeftIndex [line 377]

void formatLeftIndex(
)

Generate indexes for li_package.html and classtree output files

This function generates the li_package.html files from the template file left.html. It does this by iterating through each of the $page_elements, $class_elements and $function_elements arrays to retrieve the pre-sorted abstractLink descendants needed for index generation. Conversion of these links to text is done by returnSee(). The $local parameter is set to false to ensure that paths are correct.

Then it uses generateFormattedClassTrees() to create class trees from the template file classtrees.html. Output filename is classtrees_packagename.html. This function also unsets $elements and $pkg_elements to free up the considerable memory these two class vars use

See: Converter::$page_elements, Converter::$class_elements, Converter::$function_elements

Overrides Converter::formatLeftIndex() (Called by walk() while converting.)

[ Top ]

formatPkgIndex [line 251]

void formatPkgIndex(
)

HTMLdefaultConverter chooses to format both package indexes and the complete index here

This function formats output for the elementindex.html and pkgelementindex.html template files. It then writes them to the target directory

See: CHMdefaultConverter::generateElementIndex(), CHMdefaultConverter::generatePkgElementIndex()

Overrides Converter::formatPkgIndex() (Called by walk() while converting.)

[ Top ]

generateChildClassList [line 1156]

void generateChildClassList(
parserClass
$class)

returns a list of child classes

Uses: parserClass::getChildClassList()

Parameters:

parserClass $class — class variable

[ Top ]

generateElementIndex [line 1428]

void generateElementIndex(
)

Generate alphabetical index of all elements

See: Converter::$elements, Converter::walk()

[ Top ]

generateFormattedClassTree [line 1180]

array generateFormattedClassTree(
parserClass
$class)

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

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

Parameters:

parserClass $class — class variable

[ Top ]

generateFormattedClassTrees [line 1339]

void generateFormattedClassTrees(
string
$package)

returns a template-enabled array of class trees

See: $roots, HTMLConverter::getRootTree()

Parameters:

string $package — package to generate a class tree for

[ Top ]

generatePkgElementIndex [line 1605]

void generatePkgElementIndex(
string
$package)

Generate alphabetical index of all elements by package and subpackage

See: Converter::$pkg_elements, Converter::walk(), CHMdefaultConverter::generatePkgElementIndexes()

Parameters:

string $package — name of a package

[ Top ]

generatePkgElementIndexes [line 1746]

void generatePkgElementIndexes(
)

See: CHMdefaultConverter::generatePkgElementIndex()

[ Top ]

generateTOC [line 1971]

void generateTOC(
)

[ Top ]

getCData [line 727]

void getCData(
mixed
$value)

[ Top ]

getClassesOnPage [line 1075]

array getClassesOnPage(
parserData
&$element)

gets a list of all classes declared on a procedural page represented by $element, a parserData class

Return: links to each classes documentation

Parameters:

parserData &$element —

[ Top ]

getClassLink [line 1786]

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

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

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

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

[ Top ]

getDefineLink [line 1818]

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

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

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

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

[ Top ]

getFormattedConflicts [line 1100]

array getFormattedConflicts(
mixed
&$element, string
$type)

Return: links to conflicting elements, or empty array
Uses: parserClass::getConflicts(), - parserFunction::getConflicts(), parserDefine::getConflicts(), parserGlobal::getConflicts()

Parameters:

mixed	`&$element`	—	parserClass, parserFunction, parserDefine or parserGlobal
string	`$type`	—	type to display. either 'class','function','define' or 'global variable'

[ Top ]

getFormattedDescMethods [line 1120]

array getFormattedDescMethods(
parserMethod
&$element)

Get a list of methods in child classes that override this method

Return: empty array or array('link'=>link to method, 'sdesc'=>short description of the method
Uses: parserMethod::getOverridingMethods()

Parameters:

parserMethod &$element —

[ Top ]

getFormattedInheritedMethods [line 1289]

array getFormattedInheritedMethods(
parserMethod
$child)

Return template-enabled list of inherited methods

uses parserMethod helper function getInheritedMethods and generates a template-enabled list using getClassLink()

Return: Template-ready array
See: CHMdefaultConverter::getClassLink(), parserMethod::getInheritedMethods()

Parameters:

parserMethod $child — class method

[ Top ]

getFormattedInheritedVars [line 1244]

array getFormattedInheritedVars(
parserVar
$child)

Return template-enabled list of inherited variables

uses parserVar helper function getInheritedVars and generates a template-enabled list using getClassLink()

Return: Template-ready array
See: CHMdefaultConverter::getClassLink(), parserVar::getInheritedVars()

Parameters:

parserVar $child — class method

[ Top ]

getFormattedOverrides [line 1141]

array|false getFormattedOverrides(
parserMethod
&$element)

Get the method this method overrides, if any

Return: array('link'=>link to overridden method, 'sdesc'=>short description
See: parserMethod::getOverrides()

Parameters:

parserMethod &$element —

[ Top ]

getFunctionLink [line 1802]

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

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

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

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

[ Top ]

getGlobalLink [line 1834]

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

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

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

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

[ Top ]

getMethodLink [line 1867]

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

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

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

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

[ Top ]

getPageLink [line 1850]

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

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

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

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

[ Top ]

getPageName [line 1064]

void getPageName(
mixed
&$element)

[ Top ]

getPPageId [line 732]

void getPPageId(
mixed
$package, mixed
$subpackage, mixed
$tutorial, mixed
$id)

Overrides Converter::getPPageId() (Used by {@id})

[ Top ]

getRootTree [line 1360]

string getRootTree(
array
$tree, mixed
$package)

return formatted class tree for the Class Trees page

See: Classes::$definitechild, CHMdefaultConverter::generateFormattedClassTrees()

Parameters:

array $tree — output from getSortedClassTreeFromClass()

[ Top ]

getState [line 1895]

void getState(
)

returns $local

See: Converter::getState()

Overrides Converter::getState() (Return parserStringWithInlineTags::Convert() cache state)

[ Top ]

getVarLink [line 1884]

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

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

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

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

[ Top ]

newSmarty [line 163]

void &newSmarty(
)

[ Top ]

Output [line 2032]

void Output(
)

This function will be used by CHMdefaultConverter to call html help compiler

Overrides Converter::Output() (do all necessary output)

[ Top ]

postProcess [line 158]

void postProcess(
mixed
$text)

Uses: parserStringWithInlineTags::Convert()

Overrides Converter::postProcess() (This version does nothing)

[ Top ]

prepareDocBlock [line 660]

array prepareDocBlock(
mixed
&$element, [boolean
$nopackage = true])

convert the element's DocBlock for output

This function converts all tags and descriptions for output

Return: Format: array(short description, long description, array(array('keyword' => tagname,'data' => converted tag),...))

Parameters:

mixed	`&$element`	—	any descendant of parserElement, or parserData
boolean	`$nopackage`	—	set to false for pages and classes, the only elements allowed to specify @package

[ Top ]

ProgramExample [line 737]

void ProgramExample(
mixed
$text)

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

[ Top ]

rcNatCmp [line 1917]

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 1933]

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 239]

string returnLink(
string
$link, string
$text)

Return: <a href="'.$link.'">'.$text.'</a>

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

Parameters:

string	`$link`	—
string	`$text`	—

[ Top ]

returnSee [line 416]

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

Overrides Converter::returnSee() (take abstractLink descendant and text $eltext and return a link in the format needed for the Converter)

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 it set to $this->local. See $local
boolean	`$with_a`	—	determines whether the returned text is enclosed in an <a> tag

[ Top ]

setTargetDir [line 1584]

void setTargetDir(
mixed
$dir)

calls the converter setTargetDir, and then copies any template images and the stylesheet if they haven't been copied

See: Converter::setTargetDir()

Overrides Converter::setTargetDir() (Sets the output directory for generated documentation)

[ Top ]

setTemplateDir [line 1548]

void setTemplateDir(
mixed
$dir)

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

[ Top ]

unmangle [line 143]

void unmangle(
mixed
$sourcecode)

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

[ Top ]

writefile [line 1957]

void writefile(
mixed
$file, mixed
$contents)

[ Top ]

writeNewPPage [line 345]

void writeNewPPage(
mixed
$key)

[ Top ]

Class: CHMdefaultConverter

Class Overview

Author(s):

Version:

Variables

Methods

Inherited Variables

Class: Converter

Inherited Methods

Class: Converter

Class Details

Class Variables

$base_dir =

$class =

$class_data =

$class_dir =

$current =

$currentclass =

$juststarted = false

$leftindex = array('classes' => false, 'pages' => false, 'functions' => false, 'defines' => false, 'globals' => false)

$local = true

$name = 'default'

$outputformat = 'CHM'

$package_pages = array()

$page =

$page_data =

$page_dir =

$path =

$ric_set = array()

$sort_page_contents_by_type = true

Method Detail

CHMdefaultConverter (Constructor) [line 137]

addHHP [line 1963]

addTOC [line 2018]

checkState [line 1905]

Parameters:

Convert [line 546]

Parameters:

convertClass [line 849]

Parameters:

convertDefine [line 991]

Parameters:

ConvertErrorLog [line 591]

convertFunction [line 934]

Parameters:

convertGlobal [line 1008]

Parameters:

convertInclude [line 971]

Parameters:

convertMethod [line 898]

Parameters:

convertPackagePage [line 746]

Parameters:

convertPage [line 1028]

Parameters:

convertTutorial [line 774]

Parameters:

convertVar [line 825]

Parameters:

Convert_RIC [line 527]

Parameters:

copyMediaRecursively [line 1554]

endClass [line 191]

endPage [line 216]

formatIndex [line 283]

formatLeftIndex [line 377]

formatPkgIndex [line 251]

generateChildClassList [line 1156]

Parameters:

generateElementIndex [line 1428]

generateFormattedClassTree [line 1180]

Parameters:

generateFormattedClassTrees [line 1339]

Parameters:

generatePkgElementIndex [line 1605]

Parameters:

generatePkgElementIndexes [line 1746]

generateTOC [line 1971]

getCData [line 727]

getClassesOnPage [line 1075]