druntime docs generator: replaces src/* by import/* #15880
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Actually, we want to generate documentation for modules that user can import. Files from
import/
are almost same files as insrc/
.This may help us to avoid tricky errors related to documenting inaccessible for end users modules
(asrt.llmath
module, which is not copied intoimport/
and yet presented inmak/DOCS
)My motivation for this PR: this is need for #15822 - switchable OS-depended source files is too hard to use for docs generation.
The fact is that the paths of these modules are differ depending on the target system. And only
import/
dir contains them always at same places because they are automatically copied intoimport/
as usual(If #15822 will be accepted it opens way to generate sub-documents for each OS-specific module by a single pass)
Caution! PR changes site links!
Upd: https://github.com/dlang/druntime/ repository has been archived on Oct 12, 2022. It is now read-only. So I think this links changes isn't matter
Upd2: Or matter? This generated html is used somewhere, albeit with a different base site name?