phpDocumentor / phpDocumentor/phpDocumentor

3.0.0-rc: --ignore don't work with multiple --directory

Open
#2,325 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
PHP
Stars
4.3k
Forks
648
Avg merge
28m
Merged PRs (30d)
13

Description

--directory="$CMS_UPDATE_SERVICE_LOCATION/package"
--directory="/www/phpincludes"
--ignore="contentlounge-api"
--ignore="error.php"
--ignore="error_page_lounge.php"

the files to ignore are below /www/phpincludes, when using exactly the same command line without the first directory the subfolder /www/phpincludes/contentlounge-api is properly ignored

that is a partly copy of "package" with the amount of libraries and includes which can be shared and preloaded and now the classes appear twice in the list, absolute path didn't work too

it's important because besides the doubled, share dfiles below phpincludes are a lot of classes and frameworks and without extended classes show only the overriden properties and methods with no referneces

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the command using both --directory values and the listed --ignore paths, then compare it with the command using only /www/phpincludes. Trace the --directory and --ignore entry points to find where ignored subfolders are collected; done means contentlounge-api, error.php, and error_page_lounge.php are excluded without duplicate classes.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
cli
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.