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

Doc Bug #10675 Clear some errors.html items
Submitted: 2007-04-09 21:55 UTC
From: ashnazg Assigned: ashnazg
Status: Closed Package: PhpDocumentor (version 1.3.1)
PHP Version: Irrelevant OS: WinXP
Roadmaps: 1.4.0a1    
Subscription  


 [2007-04-09 21:55 UTC] ashnazg (Chuck Burgess)
Description: ------------ Clear up most of the warnings/errors visible on errors.html when using PhpDocumentor to document itself, based on options set in user/makedocs.ini.

Comments

 [2007-04-09 22:01 UTC] ashnazg (Chuck Burgess)
These patches help clear several warnings/errors I see on errors.html when I run PhpDocumentor against itself, using the makedocs.ini options. Though the patches mostly concern adding a vague docblock here and there, Greg & Josh, you may want to be sure I did ok with the page-level docblocks I added.
 [2007-04-18 20:59 UTC] cellog (Greg Beaver)
Lexer.inc and create_package.xml.php should simply be added to the ignored files
 [2007-04-19 15:52 UTC] ashnazg (Chuck Burgess)
Along that vein, should I just add the DocBlock/ and scripts/ subdirectories to the ignore list? Or do you specifically want the other items in scripts/ to continue to be included?
 [2007-04-19 16:15 UTC] cellog (Greg Beaver)
yes ignoring the directories is a good idea
 [2007-04-19 19:05 UTC] ashnazg (Chuck Burgess)
Added makedocs.ini patch, while "removing" Lexer and create_package.xml patch. This manages to ignore those two subdirectories, clearing those files' errors from errors.html. That leaves these errors appearing: CHMdefaultConverter.inc - Warning on line 54 - package phpDocumentor is already in category documentation, will now replace with category default - Warning on line 56 - package Converters is already in category documentation, will now replace with category default Config_File.class.php - Warning on line 33 - package phpDocumentor is already in category documentation, will now replace with category default I haven't a clue what those errors mean. Greg/Josh, can you clue me in? I'd like to tackle those as well if I can.
 [2007-04-24 21:47 UTC] ashnazg (Chuck Burgess)
Going ahead with what progress I've made so far... committing these patches to CVS. Will leave those other errors for another day.
 [2007-04-25 17:53 UTC] ashnazg (Chuck Burgess)
Found that pear-makedocs.ini needed the same IGNORE dir settings. I've attached that patch.
 [2007-04-25 18:33 UTC] ashnazg (Chuck Burgess)
While revisiting this bug, I figured out how to clear those "category" errors. I've attached patches for Setup.inc.php and Converter.inc with those fixes.
 [2007-04-25 19:03 UTC] ashnazg (Chuck Burgess)
Last three patches committed.