Description: ------------ The attached patch allows to parse and include RIC files from any directory. The -ric parameter still takes a list of file (base) names, but all files in all parsed directories that match the name are included. To distinguish files with the same name in different directories, the subdirectory relative to the base directory is prefixed. The patch was only tested on Linux but should work on Windows too. The patch is unobtrusive, i.e. it doesn't change anything for existing projects that have all their RIC files in the base directory. Thus I would appreciate if it could be applied for 1.4.1 and doesn't have to wait for 1.5.0.

Am testing this now... I expect, though, that I won't be able to get this into 1.4.1 unless I can extend the same capability into the other converters that Jan did not already patch.

The patches seem to test ok, in that I do see the additional subdir'd RIC files shown on the left-side menu (tested using HTML:Smarty:HandS). Haven't done full regression testing across my three platforms yet. However, this capability will require more "default" control, in that by default there should not be any subdir'd RIC files picked up... any desired subdir RICs should be explicitly specified by the -ric argument. That will allow normal default behavior to remain unchanged, rather than people's doc gens to suddenly have additional RICs they didn't intend to show. At first I had thought perhaps there needed to be a way to control which Package view contained the subdir'd RICs, but the method above may help avoid that need altogether... not to mention I couldn't think of a good way to tie a RIC file to an actual Package. I don't think I can get these changes developed quick enough myself to make 1.4.1 :(

I personally think that it makes much more sense to include all RIC files in all scanned directories by default. And if some doc files suddenly appear in some API docs, I expect the users to be positively surprised, rather than annoyed. But of course it's your choice whether you want this by default or not.

No more feature work on phpDocumentor 1.x. Check out the new phpDocumentor 2.x (http://www.phpdoc.org/).

Patch will be included in 1.5.0a1.