cvs: pear /PhpDocumentor/phpDocumentor Setup.inc.php

ashnazg		Tue Apr 22 15:48:55 2008 UTC

  Modified files:              
    /pear/PhpDocumentor/phpDocumentor	Setup.inc.php 
  Log:
  add comment to highlight the tokenizer_test.php file as a manual backup method for verifying the tokenizer library works, from outside the phpdoc code;
  
http://cvs.php.net/viewvc.cgi/pear/PhpDocumentor/phpDocumentor/Setup.inc.php?r1=1.28&r2=1.29&diff_format=u
Index: pear/PhpDocumentor/phpDocumentor/Setup.inc.php
diff -u pear/PhpDocumentor/phpDocumentor/Setup.inc.php:1.28 pear/PhpDocumentor/phpDocumentor/Setup.inc.php:1.29
--- pear/PhpDocumentor/phpDocumentor/Setup.inc.php:1.28	Sun Mar 30 23:48:51 2008
+++ pear/PhpDocumentor/phpDocumentor/Setup.inc.php	Tue Apr 22 15:48:55 2008
@@ -29,7 +29,7 @@
  * @author     Gregory Beaver <[email protected]>
  * @copyright  2002-2006 Gregory Beaver
  * @license    http://www.opensource.org/licenses/lgpl-license.php LGPL
- * @version    CVS: $Id: Setup.inc.php,v 1.28 2008/03/30 23:48:51 ashnazg Exp $
+ * @version    CVS: $Id: Setup.inc.php,v 1.29 2008/04/22 15:48:55 ashnazg Exp $
  * @link       http://www.phpdoc.org
  * @link       http://pear.php.net/PhpDocumentor
  * @since      1.2
@@ -201,12 +201,19 @@
         $this->parseIni();
         $this->setMemoryLimit();
 
-        if (tokenizer_ext)
-        {
+        /*
+         * NOTE:  
+         * It is possible for the tokenizer extension to be loaded,
+         * but actually be broken in the OS, and therefore not working...
+         * the conditional below will NOT recognize this scenario.
+         * You can separately run the {@link tokenizer_test.php} to
+         * verify that the tokenizer library is working correctly
+         * from the OS perspective.
+         */
+        if (tokenizer_ext) {
             phpDocumentor_out("using tokenizer Parser\n");
             $this->parse = new phpDocumentorTParser;
-        } else
-        {
+        } else {
             phpDocumentor_out("No Tokenizer support detected, so using default (slower) Parser..." . PHP_EOL);
 
             if (version_compare(phpversion(), '4.3.0', '<')) {