Open lucaswerkmeister opened 8 years ago
I think that this requirement doesn't happen much often and can be workaround by direct link into herd. So I wouldn't add something special just for it.
This looks reasonable to me. We have needed it in a couple of places.
Sorry, but is there any reason that you can't allow reference to modules that are not imported? Can't you just look at the module in the link and assume the doc import
? Maybe it's more useful when referencing members of the modules?
I propose to add documentation-only imports, which ceylondoc can use to resolve doclinks to modules not otherwise imported.
Consider, for example, the following modules:
Only one of these three doclinks will work – and it’s impossible to make the other two work, since that would require circular dependencies between modules, and a dependency of
ceylon.ast.core
onto a module which it shouldn’t depend on (ceylon.formatter
).To solve this, I suggest the following syntax:
These
doc import
s serve only to inform ceylondoc that these modules will be available, and that links to them should be allowed (with correct output). They do not introduce a module dependency, and are not available at runtime.(Sorry if this isn’t the correct repo, but I don’t think this belongs in .language or -compiler.)