I have imported the Statistics.mean function in my package and declared new methods for it. The code is fine and works well. I have documented the methods. While building the doc, Documenter gives me two Warnings and one Error:
┌ Warning: no doc found for reference ‘missing’ in src\riemannianGeometry.md.
└ @ Documenter.CrossReferences C:\Users\congedom.julia\packages\Documenter\G5Sup\src\CrossReferences.jl:160
┌ Warning: no doc found for reference ‘skipmissing’ in src\riemannianGeometry.md.
└ @ Documenter.CrossReferences C:\Users\congedom.julia\packages\Documenter\G5Sup\src\CrossReferences.jl:160
[ Info: CheckDocument: running document checks.
ERROR: SystemError: opening file “C:\cygwin\home\Administrator\buildbot\worker\package_win64\build\usr\share\julia\stdlib\v1.1\Statistics\src\Statistics.jl”: No such file or directory
I am working on Windows 10 with Julia Version 1.1.0.
I have installed cygwin, but that did not solve the error.
P.S. this seems related to 19414, but the discussion did not end there.
Yeah, it seems similar to the issue you link to. Is your code public? It’s hard to debug this without an MWE. Alternatively, if you can figure out where in Documenter the error is thrown, that might also help. What version of Documenter are you using?
Yes it is public. The branch i have tried to build that gives me the error (using Travis in the github repo but also internally on my PC) is named ‘devmean’. In the master branch the same method is named meanP and the documentation build goes fine there.
Ok, I think I have identified the problem in Documenter and have an idea for a fix (#1002).
But your setup had a configuration problem as well which exposed this. You were including the docstrings of mean from Base too. You should add modules=[PosDefManifold] to makedocs to make sure that non-PosDefManifold docstrings get filtered out.