Package home | Report new bug | New search | Development Roadmap Status: Open | Feedback | All | Closed Since Version 1.5.0a1

Bug #7773 "nothing parsed" error when parsing in a directory under "tutorials"
Submitted: 2006-05-31 23:54 UTC
From: nhyde at bigdrift dot com Assigned:
Status: Wont fix Package: PhpDocumentor (version 1.3.0RC6)
PHP Version: 5.1.1 OS: Windows XP SP2
Roadmaps: (Not assigned)    
Subscription  


 [2006-05-31 23:54 UTC] nhyde at bigdrift dot com (Nathan Hyde)
Description: ------------ The error "nothing parsed" is thrown when parsing a dir within a directory named "tutorials". Discovered this while attempting to run through the manual's sample files. Test script: --------------- cd PhpDocumentor-1.3.0RC6/tutorials/phpDocumentor phpdoc -t docs -d examples diff -r -U 3 PhpDocumentor-1.3.0RC6/phpDocumentor/Io.inc PhpDocumentor-1.3.0RC6.mod/phpDocumentor/Io.inc --- PhpDocumentor-1.3.0RC6/phpDocumentor/Io.inc 2006-05-01 14:52:19.000000000 -0700 +++ PhpDocumentor-1.3.0RC6.mod/phpDocumentor/Io.inc 2006-05-31 16:44:39.037545408 -0700 @@ -435,9 +435,10 @@ $list = $tutorials = array(); foreach($filelist as $file) { - if (strpos($file,'tutorials/') !== false) + $child = str_replace(PHPDOCUMENTOR_BASE,'',$file); + if (strpos($child,'tutorials/') !== false) { - $tutedir = explode('/',substr($file,strpos($file,'tutorials/'))); + $tutedir = explode('/',substr($child,strpos($child,'tutorials/'))); array_shift($tutedir); if (count($tutedir) <= 3) { Expected result: ---------------- Parse the contents of the examples directory. Actual result: -------------- Error: nothing parsed.

Comments

 [2006-08-16 16:50 UTC] cellog (Greg Beaver)
This should really be "Can't fix" Although the patch is not quite accurate, an accurate patch will cause examples inside the tutorial directory to be parsed as part of the package, and there is no automatic way to fix this. However, since this is very much an edge case, I have modified the quickstart documentation to tell users to copy the sample files to another directory before attempting to parse. Thanks for the report.
 [2006-09-13 00:41 UTC] martian at yahoo dot com (martian)
The docs should specify copying the sample files to another directory OUTSIDE of tutorials.