sbergmann Wed Jan 17 08:15:18 2001 EDT Added files: /php4/pear/HTML IT.php ITX.php Removed files: /php4/pear/PHPDoc/redist IT.php ITX.php Modified files: /php4/pear/PHPDoc prepend.php Log: Move IT[x] to HTML/.
Index: php4/pear/PHPDoc/prepend.php diff -u php4/pear/PHPDoc/prepend.php:1.1 php4/pear/PHPDoc/prepend.php:1.2 --- php4/pear/PHPDoc/prepend.php:1.1 Sun Oct 8 03:03:18 2000 +++ php4/pear/PHPDoc/prepend.php Wed Jan 17 08:15:18 2001 @@ -44,9 +44,9 @@ require( PHPDOC_INCLUDE_DIR . "xmlexporter/PhpdocXMLModuleExporter.php" ); require( PHPDOC_INCLUDE_DIR . "xmlexporter/PhpdocXMLClassExporter.php" ); -// Redistributed IT[X] Templates from the PHPLib -require( PHPDOC_INCLUDE_DIR . "redist/IT.php" ); -require( PHPDOC_INCLUDE_DIR . "redist/ITX.php" ); +// IT[X] Templates +require_once "HTML/IT.php"; +require_once "HTML/ITX.php"; // XML Reader require( PHPDOC_INCLUDE_DIR . "xmlreader/PhpdocXMLReader.php" ); Index: php4/pear/HTML/IT.php +++ php4/pear/HTML/IT.php <?php // // +----------------------------------------------------------------------+ // | PHP version 4.0 | // +----------------------------------------------------------------------+ // | Copyright (c) 1997-2001 The PHP Group | // +----------------------------------------------------------------------+ // | This source file is subject to version 2.02 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | // | available at through the world-wide-web at | // | http://www.php.net/license/2_02.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | [EMAIL PROTECTED] so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ // | Authors: Ulf Wendel <[EMAIL PROTECTED]> | // +----------------------------------------------------------------------+ // // $Id: IT.php,v 1.1 2001/01/17 16:15:17 sbergmann Exp $ // /** * Integrated Template - IT * * Well there's not much to say about it. I needed a template class that * supports a single template file with multiple (nested) blocks inside. * * Usage: * $tpl = new IntegratedTemplate( [string filerootdir] ); * * // load a template or set it with setTemplate() * $tpl->loadTemplatefile( string filename [, boolean removeUnknownVariables, boolean removeEmptyBlocks] ) * * // set "global" Variables meaning variables not beeing within a (inner) block * $tpl->setVariable( string variablename, mixed value ); * * // like with the Isotopp Templates there's a second way to use setVariable() * $tpl->setVariable( array ( string varname => mixed value ) ); * * // Let's use any block, even a deeply nested one * $tpl->setCurrentBlock( string blockname ); * * // repeat this as often as you neer. * $tpl->setVariable( array ( string varname => mixed value ) ); * $tpl->parseCurrentBlock(); * * // get the parsed template or print it: $tpl->show() * $tpl->get(); * * @author Ulf Wendel <[EMAIL PROTECTED]> * @version $Id: IT.php,v 1.1 2001/01/17 16:15:17 sbergmann Exp $ * @access public * @package PHPDoc */ class IntegratedTemplate { /** * Contains the error objects * @var array * @access public * @see halt(), $printError, $haltOnError */ var $err = array(); /** * Print error messages? * @var boolean * @access public * @see halt(), $haltOnError, $err */ var $printError = false; /** * Call die() on error? * @var boolean * @access public * @see halt(), $printError, $err */ var $haltOnError = false; /** * Clear cache on get()? * @var boolean */ var $clearCache = false; /** * First character of a variable placeholder ( _{_VARIABLE} ). * @var string * @access public * @see $closingDelimiter, $blocknameRegExp, $variablenameRegExp */ var $openingDelimiter = "{"; /** * Last character of a variable placeholder ( {VARIABLE_}_ ). * @var string * @access public * @see $openingDelimiter, $blocknameRegExp, $variablenameRegExp */ var $closingDelimiter = "}"; /** * RegExp matching a block in the template. * Per default "sm" is used as the regexp modifier, "i" is missing. * That means a case sensitive search is done. * @var string * @access public * @see $variablenameRegExp, $openingDelimiter, $closingDelimiter */ var $blocknameRegExp = "[0-9A-Za-z_-]+"; /** * RegExp matching a variable placeholder in the template. * Per default "sm" is used as the regexp modifier, "i" is missing. * That means a case sensitive search is done. * @var string * @access public * @see $blocknameRegExp, $openingDelimiter, $closingDelimiter */ var $variablenameRegExp = "[0-9A-Za-z_-]+"; /** * Full RegExp used to find variable placeholder, filled by the constructor. * @var string Looks somewhat like @(delimiter varname delimiter)@ * @see IntegratedTemplate() */ var $variablesRegExp = ""; /** * Full RegExp used to find blocks an their content, filled by the constructor. * @var string * @see IntegratedTemplate() */ var $blockRegExp = ""; /** * Name of the current block. * @var string */ var $currentBlock = "__global__"; /** * Content of the template. * @var string */ var $template = ""; /** * Array of all blocks and their content. * * @var array * @see findBlocks() */ var $blocklist = array(); /** * Array with the parsed content of a block. * * @var array */ var $blockdata = array(); /** * Array of variables in a block. * @var array */ var $blockvariables = array(); /** * Array of inner blocks of a block. * @var array */ var $blockinner = array(); /** * Future versions will use this... * @var array */ var $blocktypes = array(); /** * Variable cache. * * Variables get cached before any replacement is done. * Advantage: empty blocks can be removed automatically. * Disadvantage: might take some more memory * * @var array * @see setVariable(), $clearCacheOnParse */ var $variableCache = array(); /** * @var boolean */ var $clearCacheOnParse = true; /** * Controls the handling of unknown variables, default is remove. * @var boolean */ var $removeUnknownVariables = true; /** * Controls the handling of empty blocks, default is remove. * @var boolean */ var $removeEmptyBlocks = true; /** * Root directory for all file operations. * The string gets prefixed to all filenames given. * @var string * @see IntegratedTemplate(), setRoot() */ var $fileRoot = ""; /** * Internal flag indicating that a blockname was used multiple times. * @var boolean */ var $flagBlocktrouble = false; /** * Flag indicating that the global block was parsed. * @var boolean */ var $flagGlobalParsed = false; /** * Builds some complex regular expressions and optinally sets the file root directory. * * Make sure that you call this constructor if you derive your template * class from this one. * * @param string File root directory, prefix for all filenames given to the object. * @see setRoot() */ function IntegratedTemplate($root = "") { $this->variablesRegExp = "@".$this->openingDelimiter."(".$this->variablenameRegExp.")".$this->closingDelimiter."@sm"; $this->blockRegExp = '@!--\s+BEGIN\s+('.$this->blocknameRegExp.')\s+-->(.*)<!--\s+END\s+\1\s+-->@sm'; $this->setRoot($root); } // end constructor /** * Print a certain block with all replacements done. * @brother get() */ function show($block = "__global__") { print $this->get($block); } // end func show /** * Returns a block with all replacements done. * * @param string name of the block * @return string * @access public * @see show() */ function get($block = "__global__") { if ("__global__" == $block && !$this->flagGlobalParsed) $this->parse("__global__"); if (!isset($this->blocklist[$block])) { $this->halt("The block '$block' was not found in the template.", __FILE__, __LINE__); return true; } if ($this->clearCache) { $data = (isset($this->blockdata[$block])) ? $this->blockdata[$block] : ""; unset($this->blockdata[$block]); return $data; } else { return (isset($this->blockdata[$block])) ? $this->blockdata[$block] : ""; } } // end func get() /** * Parses the given block. * * @param string name of the block to be parsed * @access public * @see parseCurrentBlock() */ function parse($block = "__global__", $flag_recursion = false) { if (!isset($this->blocklist[$block])) { $this->halt("The block '$block' was not found in the template.", __FILE__, __LINE__); return false; } if ("__global__" == $block) $this->flagGlobalParsed = true; $regs = array(); $values = array(); if ($this->clearCacheOnParse) { reset($this->variableCache); while (list($name, $value)=each($this->variableCache)) { $regs[] = "@".$this->openingDelimiter.$name.$this->closingDelimiter."@"; $values[] = $value; } $this->variableCache = array(); } else { reset($this->blockvariables[$block]); while (list($k, $allowedvar)=each($this->blockvariables[$block])) { if (isset($this->variableCache[$allowedvar])) { $regs[] = "@".$this->openingDelimiter.$allowedvar.$this->closingDelimiter."@"; $values[] = $this->variableCache[$allowedvar]; unset($this->variableCache[$allowedvar]); } } } $outer = (0 == count($regs)) ? $this->blocklist[$block] : preg_replace($regs, $values, $this->blocklist[$block]); $empty = (0 == count($values)) ? true : false; if (isset($this->blockinner[$block])) { reset($this->blockinner[$block]); while (list($k, $innerblock)=each($this->blockinner[$block])) { $this->parse($innerblock, true); if (""!=$this->blockdata[$innerblock]) $empty = false; $placeholder = $this->openingDelimiter."__".$innerblock."__".$this->closingDelimiter; $outer = str_replace($placeholder, $this->blockdata[$innerblock], $outer); $this->blockdata[$innerblock] = ""; } } if ($this->removeUnknownVariables) $outer = preg_replace($this->variablesRegExp, "", $outer); if ($empty) { if (!$this->removeEmptyBlocks) $this->blockdata[$block].= $outer; } else { $this->blockdata[$block].= $outer; } return $empty; } // end func parse /** * Parses the current block * @see parse(), setCurrentBlock(), $currentBlock * @access public */ function parseCurrentBlock() { return $this->parse($this->currentBlock); } // end func parseCurrentBlock /** * Sets a variable value. * * The function can be used eighter like setVariable( "varname", "value") * or with one array $variables["varname"] = "value" given setVariable($variables) * quite like phplib templates set_var(). * * @param mixed string with the variable name or an array %variables["varname"] = "value" * @param string value of the variable or empty if $variable is an array. * @param string prefix for variable names * @access public */ function setVariable($variable, $value="") { if (is_array($variable)) { reset($variable); while (list($var, $value)=each($variable)) $this->variableCache[$var] = $value; } else { $this->variableCache[$variable] = $value; } } // end func setVariable /** * Sets the name of the current block that is the block where variables are added. * * @param string name of the block * @return boolean false on failure otherwise true * @access public */ function setCurrentBlock($block = "__global__") { if (!isset($this->blocklist[$block])) { $this->halt("Can't find the block '$block' in the template.", __FILE__, __LINE__); return false; } $this->currentBlock = $block; return true; } // end func setCurrentBlock /** * Clears all datafields of the object and rebuild the internal blocklist * * LoadTemplatefile() and setTemplate() automatically call this function * when a new template is given. Don't use this function * unless you know what you're doing. * * @access public * @see free() */ function init() { $this->free(); $this->findBlocks($this->template); $this->buildBlockvariablelist(); } // end func init /** * Clears all datafields of the object. * * Don't use this function unless you know what you're doing. * * @access public * @see init() */ function free() { $this->err[] = ""; $this->currentBlock = "__global__"; $this->variableCache = array(); $this->blocklist = array(); $this->blockvariables = array(); $this->blockinner = array(); $this->blockdata = array(); $this->blocklookup = array(); $this->blocktypes = array(); $this->flagBlocktrouble = false; $this->flagGlobalParsed = false; } // end func free /** * Sets the template. * * You can eighter load a template file from disk with LoadTemplatefile() or set the * template manually using this function. * * @param string template content * @param boolean Unbekannte, nicht ersetzte Platzhalter entfernen? * @param boolean remove unknown/unused variables? * @param boolean remove empty blocks? * @see LoadTemplatefile(), $template * @access public */ function setTemplate($template, $removeUnknownVariables = true, $removeEmptyBlocks = false) { if (""==$template) { $this->halt("The given string is empty.", __FILE__, __LINE__); return false; } $this->removeUnknownVariables = $removeUnknownVariables; $this->removeEmptyBlocks = $removeEmptyBlocks; $this->template = '<!-- BEGIN __global__ -->'.$template.'<!-- END __global__ -->'; $this->init(); if ($this->flagBlocktrouble) return false; return true; } // end func setTemplate /** * Reads a template file from the disk. * * @param string name of the template file, full path! * @param boolean remove unknown/unused variables? * @param boolean remove empty blocks? * @access public * @return boolean false on failure, otherwise true * @see $template, setTemplate() */ function loadTemplatefile($filename, $removeUnknownVariables = true, $removeEmptyBlocks = true) { $template = $this->getfile($filename); return $this->setTemplate($this->getFile($filename), $removeUnknownVariables, $removeEmptyBlocks); } // end func LoadTemplatefile /** * Sets the file root. The file root gets prefixed to all filenames passed to the object. * * Make sure that you override this function when using the class * on windows. * * @param string * @see IntegratedTemplate() * @access public */ function setRoot($root) { if (""!=$root && "/"!= substr($root, -1)) $root.="/"; $this->fileRoot = $root; } // end func setRoot /** * Build a list of all variables within a block */ function buildBlockvariablelist() { reset($this->blocklist); while (list($name, $content)=each($this->blocklist)) { preg_match_all( $this->variablesRegExp, $content, $regs ); $this->blockvariables[$name] = $regs[1]; } } // end func buildBlockvariablelist /** * Returns a list of all */ function getGlobalvariables() { $regs = array(); $values = array(); reset($this->blockvariables["__global__"]); while (list($k, $allowedvar)=each($this->blockvariables["__global__"])) { if (isset($this->variableCache[$allowedvar])) { $regs[] = "@".$this->openingDelimiter.$allowedvar.$this->closingDelimiter."@"; $values[] = $this->variableCache[$allowedvar]; unset($this->variableCache[$allowedvar]); } } return array($regs, $values); } // end func getGlobalvariables /** * Recusively builds a list of all blocks within the template. * * @param string string that gets scanned * @access private * @see $blocklist */ function findBlocks($string) { $blocklist = array(); if (preg_match_all($this->blockRegExp, $string, $regs, PREG_SET_ORDER)) { reset($regs); while (list($k, $match)=each($regs)) { $blockname = $match[1]; $blockcontent = $match[2]; if (isset($this->blocklist[$blockname])) { $this->halt("The name of a block must be unique within a template. Found '$blockname' twice. Unpredictable results may appear.", __FILE__, __LINE__); $this->flagBlocktrouble = true; } $this->blocklist[$blockname] = $blockcontent; $this->blockdata[$blockname] = ""; $blocklist[] = $blockname; $inner = $this->findBlocks($blockcontent); reset($inner); while (list($k, $name)=each($inner)) { $pattern = sprintf('@<!--\s+BEGIN\s+%s\s+-->(.*)<!--\s+END\s+%s\s+-->@sm', $name, $name ); $this->blocklist[$blockname] = preg_replace( $pattern, $this->openingDelimiter."__".$name."__".$this->closingDelimiter, $this->blocklist[$blockname] ); $this->blockinner[$blockname][] = $name; $this->blockparents[$name] = $blockname; } } } return $blocklist; } // end func findBlocks /** * Reads a file from disk and returns its content. * @param string Filename * @return string Filecontent */ function getFile($filename) { if ("/" == substr($filename, 0, 1)) $filename = substr($filename, 1); $filename = $this->fileRoot.$filename; if ( !($fh = @fopen($filename, "r")) ) { $this->halt("Can't read '$filename'.", __FILE__, __LINE__); return ""; } $content = fread($fh, filesize($filename)); fclose($fh); return $content; } // end func getFile /** * Error Handling function. * @param string error message * @param mixed File where the error occured * @param int Line where the error occured * @see $err */ function halt($message, $file="", $line=0) { $message = sprintf("IntegratedTemplate Error: %s [File: %s, Line: %d]", $message, $file, $line ); $this->err[] = $message; if ($this->printError) print $message; if ($this->haltOnError) die($message); } // end func halt } // end class IntegratedTemplate ?> Index: php4/pear/HTML/ITX.php +++ php4/pear/HTML/ITX.php <?php // // +----------------------------------------------------------------------+ // | PHP version 4.0 | // +----------------------------------------------------------------------+ // | Copyright (c) 1997-2001 The PHP Group | // +----------------------------------------------------------------------+ // | This source file is subject to version 2.02 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | // | available at through the world-wide-web at | // | http://www.php.net/license/2_02.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | [EMAIL PROTECTED] so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ // | Authors: Ulf Wendel <[EMAIL PROTECTED]> | // +----------------------------------------------------------------------+ // // $Id: ITX.php,v 1.1 2001/01/17 16:15:17 sbergmann Exp $ // require_once "HTML/IT.php"; /** * Integrated Template Extension - ITX * * With this class you get the full power of the phplib template class. * You may have one file with blocks in it but you have as well one main file * and multiple files one for each block. This is quite usefull when you have * user configurable websites. Using blocks not in the main template allows * you to some parts of your layout easily. * * Note that you can replace an existing block and add new blocks add runtime. * Adding new blocks means changing a variable placeholder to a block. * * @author Ulf Wendel <[EMAIL PROTECTED]> * @access public * @version $ID: $ * @package PHPDoc */ class IntegratedTemplateExtension extends IntegratedTemplate { /** * Array with all warnings. * @var array * @access public * @see $printWarning, $haltOnWarning, warning() */ var $warn = array(); /** * Print warnings? * @var array * @access public * @see $haltOnWarning, $warn, warning() */ var $printWarning = false; /** * Call die() on warning? * @var boolean * @access public * @see $warn, $printWarning, warning() */ var $haltOnWarning = false; /** * RegExp used to test for a valid blockname. * @var string */ var $checkblocknameRegExp = ""; /** * Builds some complex regexps and calls the constructor of the parent class. * * Make sure that you call this constructor if you derive you own * template class from this one. * * @see IntegratedTemplate() */ function IntegratedTemplateExtension() { $this->checkblocknameRegExp = "@".$this->blocknameRegExp."@"; $this->IntegratedTemplate(); } // end func IntegratedTemplateExtension /** * Replaces an existing block with new content. Warning: not implemented yet. * * The Replacement does not affect previously added variables. All data is cached. * In case the new block does contain less or other variable placeholder the previously * passed data that is no longer referenced will be deleted. The internal list * of allowed variables gets updated as well. * * In case the original block contains other blocks it must eighter have placeholder * for the inner blocks or contain them. If you want to use placeholder the placeholder must * look like openingDelimiter."__".blockname."__".closingDelimiter . * * Due to the cache updates replaceBlock() and replaceBlockfile() are "expensive" operations * which means extensive usage will slow down your script. So try to avoid them and if * you can't do so try to use them before you pass lots of variables to the block you're * replacing. * * @param string Blockname * @param string Blockcontent * @return boolean * @see replaceBlockfile(), addBlock(), addBlockfile() * @access public */ function replaceBlock($block, $template) { if (!isset($this->blocklist[$block])) { $this->halt("The block '$block' does not exist in the template and thus it can't be replaced.", __FILE__, __LINE__); return false; } if (""==$template) { $this->halt("No block content given.", __FILE__, __LINE__); return false; } print "This function has not been coded yet."; // find inner blocks // add to variablelist // compare variable list // update caches return true; } // end func replaceBlock /** * Replaces an existing block with new content from a file. Warning: not implemented yet. * @brother replaceBlock() * @param string Blockname * @param string Name of the file that contains the blockcontent */ function replaceBlockfile($block, $filename) { return $this->replaceBlock($block, $this->getFile($filename)); } // end func replaceBlockfile /** * Adds a block to the template changing a variable placeholder to a block placeholder. * * Add means "replace a variable placeholder by a new block". * This is different to PHPLibs templates. The function loads a * block, creates a handle for it and assigns it to a certain * variable placeholder. To to the same with PHPLibs templates you would * call set_file() to create the handle and parse() to assign the * parsed block to a variable. By this PHPLibs templates assume that you tend * to assign a block to more than one one placeholder. To assign a parsed block * to more than only the placeholder you specify in this function you have * to use a combination of getBlock() and setVariable(). * * As no updates to cached data is necessary addBlock() and addBlockfile() * are rather "cheap" meaning quick operations. * * The block content must not start with <!-- BEGIN blockname --> and end with * <!-- END blockname --> this would cause overhead and produce an error. * * @param string Name of the variable placeholder, the name must be unique within the template. * @param string Name of the block to be added * @param string Content of the block * @return boolean * @see addBlockfile() * @access public */ function addBlock($placeholder, $blockname, $template) { // Don't trust any user even if it's a programmer or yourself... if (""==$placeholder) { $this->halt("No variable placeholder given.", __FILE__, __LINE__); return false; } else if (""==$blockname || !preg_match($this->checkblocknameRegExp, $blockname) ) { print $this->checkblocknameRegExp; $this->halt("No or invalid blockname '$blockname' given.", __FILE__, __LINE__); return false; } else if (""==$template) { $this->halt("No block content given.", __FILE__, __LINE__); return false; } else if (isset($this->blocklist[$blockname])) { $this->halt("The block already exists.", __FILE__, __LINE__); return false; } // Hmm, we should do some more tests. $parents = $this->findPlaceholderBlocks($placeholder); if (0==count($parents)) { $this->halt("The variable placeholder '$placeholder' was not found in the template.", __FILE__, __LINE__); return false; } else if ( count($parents)>1 ) { reset($parents); while (list($k, $parent)=each($parents)) $msg.= "$parent, "; $msg = substr($parent, -2); $this->halt("The variable placeholder '$placeholder' must be unique, found in multiple blocks '$msg'.", __FILE__, __LINE__); return false; } $template = "<!-- BEGIN $blockname -->".$template."<!-- END $blockname -->"; $this->findBlocks($template); if ($this->flagBlocktrouble) return false; // findBlocks() already throws an exception $this->blockinner[$parents[0]][] = $blockname; $this->blocklist[$parents[0]] = preg_replace( "@".$this->openingDelimiter.$placeholder.$this->closingDelimiter."@", $this->openingDelimiter."__".$blockname."__".$this->closingDelimiter, $this->blocklist[$parents[0]] ); $this->deleteFromBlockvariablelist($parents[0], $placeholder); $this->updateBlockvariablelist($blockname); return true; } // end func addBlock /** * Adds a block taken from a file to the template changing a variable placeholder to a block placeholder. * * @param string Name of the variable placeholder to be converted * @param string Name of the block to be added * @param string File that contains the block * @brother addBlock() */ function addBlockfile($placeholder, $blockname, $filename) { return $this->addBlock($placeholder, $blockname, $this->getFile($filename)); } // end func addBlockfile /** * Deletes one or many variables from the block variable list. * @param string Blockname * @param mixed Name of one variable or array of variables ( array ( name => true ) ) to be stripped. */ function deleteFromBlockvariablelist($block, $variables) { if (!is_array($variables)) $variables = array( $variables => true); reset($this->blockvariables[$block]); while (list($k, $varname)=each($this->blockvariables[$block])) if (isset($variables[$varname])) unset($this->blockvariables[$block][$k]); } // end deleteFromBlockvariablelist /** * Updates the variable list of a block. * @param string Blockname */ function updateBlockvariablelist($block) { preg_match_all( $this->variablesRegExp, $this->blocklist[$block], $regs ); $this->blockvariables[$block] = $regs[1]; } // end func updateBlockvariablelist /** * Returns an array of blocknames where the given variable placeholder is used. * @param string Variable placeholder * @return array $parents parents[0..n] = blockname */ function findPlaceholderBlocks($variable) { $parents = array(); reset($this->blocklist); while (list($blockname, $content)=each($this->blocklist)) { reset($this->blockvariables[$blockname]); while (list($k, $varname)=each($this->blockvariables[$blockname])) if ($variable == $varname) $parents[] = $blockname; } return $parents; } // end func findPlaceholderBlocks /** * Handles warnings, saves them to $warn and prints them or calls die() depending on the flags * @param string Warning * @param string File where the warning occured * @param int Linenumber where thr warning occured * @see $warn, $printWarning, $haltOnWarning */ function warning($message, $file="", $line=0) { $message = sprintf("IntegratedTemplateExtension Warning: %s [File: %s, Line: %d]", $message, $file, $line ); $this->warn[] = $message; if ($this->printWarning) print $message; if ($this->haltOnError) die($message); } // end func warning } // end class IntegratedTemplateExtension ?>
-- PHP CVS Mailing List (http://www.php.net/) To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] To contact the list administrators, e-mail: [EMAIL PROTECTED]