Error running fsdocs on .NET 5.0.100 SDK #620

vilinski · 2020-11-22T19:04:00Z

Environment

MacOS Big Sur with .net 5

$dotnet --version
5.0.100

Reproducing

clone a github repo from https://github.com/PragmaticFlow/NBomber.FSharp.git
run fsdocs build in the root

Expectations

Builds API reference automagically, like it described in the docs

Actual

It outputs some exceptions and generates no htmls in the output folder

At first there is not helpful System.IO.DirectoryNotFoundException because repository has no docs folder. Could be a simple warning like Docs are not generated, because no docs folder found

I have created it manually but second error is also where I'm completely lost.

FSharp.Compiler.ErrorLogger+UnresolvedPathReferenceNoRange: Exception of type 'FSharp.Compiler.ErrorLogger+UnresolvedPathReferenceNoRange' was thrown.

What's wrong and how could it be fixed?

restored project state from '.fsdocs/cache'

Inputs for API Docs:
    /Users/avilinski/Projects/fsharp/github/NBomber.FSharp/src/NBomber.FSharp/bin/Debug/netstandard2.0/NBomber.FSharp.dll
    /Users/avilinski/Projects/fsharp/github/NBomber.FSharp/src/NBomber.FSharp.Hopac/bin/Debug/netstandard2.0/NBomber.FSharp.Hopac.dll
    /Users/avilinski/Projects/fsharp/github/NBomber.FSharp/src/NBomber.FSharp.Http/bin/Debug/netstandard2.0/NBomber.FSharp.Http.dll

Substitutions/parameters:
  root --> https://github.com/PragmaticFlow/NBomber.FSharp/
  fsdocs-authors --> PragmaticFlow
  fsdocs-collection-name --> NBomber.FSharp
  fsdocs-collection-name-link --> https://github.com/PragmaticFlow/NBomber.FSharp/
  fsdocs-copyright --> PragmaticFlow@2020
  fsdocs-logo-src --> https://github.com/PragmaticFlow/NBomber.FSharp/img/logo.png
  fsdocs-navbar-position --> fixed-right
  fsdocs-theme --> default
  fsdocs-logo-link --> https://github.com/PragmaticFlow/NBomber.FSharp/
  fsdocs-license-link --> https://github.com/PragmaticFlow/NBomber.FSharp/blob/master/LICENSE.md
  fsdocs-release-notes-link --> https://github.com/PragmaticFlow/NBomber.FSharp/blob/master/RELEASE_NOTES.md
  fsdocs-package-project-url --> https://github.com/PragmaticFlow/NBomber.FSharp/
  fsdocs-package-license-expression --> Apache-2.0
  fsdocs-package-icon-url --> {{fsdocs-package-icon-url}}
  fsdocs-package-tags --> load-testing, performance-testing, integration-testing, fsharp
  fsdocs-package-version --> 1.0.0-alpha
  fsdocs-repository-link --> https://github.com/PragmaticFlow/NBomber.FSharp/
  fsdocs-repository-branch --> {{fsdocs-repository-branch}}
  fsdocs-repository-commit --> {{fsdocs-repository-commit}}
  (NBomber.FSharp.Hopac) fsdocs-package-tags --> load-testing, performance-testing, integration-testing, fsharp, hopac
  (NBomber.FSharp.Http) fsdocs-package-tags --> load-testing, performance-testing, integration-testing, fsharp, http
using extra content from /Users/avilinski/.dotnet/tools/.store/fsharp.formatting.commandtool/7.2.9/fsharp.formatting.commandtool/7.2.9/extras

Content:
Error :
System.IO.DirectoryNotFoundException: Could not find a part of the path '/Users/avilinski/Projects/fsharp/github/NBomber.FSharp/docs'.
   at System.IO.Enumeration.FileSystemEnumerator`1.CreateDirectoryHandle(String path, Boolean ignoreNotFound)
   at System.IO.Enumeration.FileSystemEnumerator`1.Init()
   at System.IO.Enumeration.FileSystemEnumerator`1..ctor(String directory, Boolean isNormalized, EnumerationOptions options)
   at System.IO.Enumeration.FileSystemEnumerable`1..ctor(String directory, FindTransform transform, EnumerationOptions options, Boolean isNormalized)
   at System.IO.Enumeration.FileSystemEnumerableFactory.UserFiles(String directory, String expression, EnumerationOptions options)
   at System.IO.Directory.InternalEnumeratePaths(String path, String searchPattern, SearchTarget searchTarget, EnumerationOptions options)
   at <StartupCode$fsdocs>[email protected](IEnumerable`1& next) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.CommandTool\BuildCommand.fs:line 573
   at Microsoft.FSharp.Core.CompilerServices.GeneratedSequenceBase`1.MoveNextImpl() in E:\A\_work\130\s\src\fsharp\FSharp.Core\seqcore.fs:line 371
   at Microsoft.FSharp.Core.CompilerServices.GeneratedSequenceBase`1.System-Collections-IEnumerator-MoveNext() in E:\A\_work\130\s\src\fsharp\FSharp.Core\seqcore.fs:line 403
   at Microsoft.FSharp.Collections.SeqModule.ToList[T](IEnumerable`1 source)
   at <StartupCode$fsdocs>[email protected](IEnumerable`1& next) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.CommandTool\BuildCommand.fs:line 595
   at Microsoft.FSharp.Core.CompilerServices.GeneratedSequenceBase`1.MoveNextImpl() in E:\A\_work\130\s\src\fsharp\FSharp.Core\seqcore.fs:line 371
   at Microsoft.FSharp.Core.CompilerServices.GeneratedSequenceBase`1.System-Collections-IEnumerator-MoveNext() in E:\A\_work\130\s\src\fsharp\FSharp.Core\seqcore.fs:line 403
   at Microsoft.FSharp.Collections.SeqModule.ToList[T](IEnumerable`1 source)
   at <StartupCode$fsdocs>[email protected](Unit unitVar0) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.CommandTool\BuildCommand.fs:line 906
   at <StartupCode$fsdocs>.$BuildCommand.protect@710(CoreBuildOptions this, FSharpFunc`2 f) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.CommandTool\BuildCommand.fs:line 713
note, no template file 'docs/reference/_template.html' or 'docs/_template.html', using default template /Users/avilinski/.dotnet/tools/.store/fsharp.formatting.commandtool/7.2.9/fsharp.formatting.commandtool/7.2.9/templates/_template.html

API docs:
  generating model for 3 assemblies in API docs...
  loading 3 assemblies...
  registering entities for assembly NBomber.FSharp...
Error :
FSharp.Compiler.ErrorLogger+UnresolvedPathReferenceNoRange: Exception of type 'FSharp.Compiler.ErrorLogger+UnresolvedPathReferenceNoRange' was thrown.
   at FSharp.Compiler.TypedTree.CcuThunk.EnsureDerefable(String[] requiringPath) in /Users/chethusk/oss/FCS/src/fsharp/TypedTree.fs:line 5087
   at FSharp.Compiler.TypedTree.NonLocalEntityRef.TryDeref(Boolean canError) in /Users/chethusk/oss/FCS/src/fsharp/TypedTree.fs:line 3157
   at FSharp.Compiler.TypedTree.EntityRef.Resolve(Boolean canError) in /Users/chethusk/oss/FCS/src/fsharp/TypedTree.fs:line 3238
   at FSharp.Compiler.TypedTree.EntityRef.get_Deref() in /Users/chethusk/oss/FCS/src/fsharp/TypedTree.fs:line 3251
   at FSharp.Compiler.TypedTreeOps.stripTyEqnsA(TcGlobals g, Boolean canShortcut, TType ty) in /Users/chethusk/oss/FCS/src/fsharp/TypedTreeOps.fs:line 740
   at FSharp.Compiler.TypedTreeOps.isUnitTy(TcGlobals g, TType ty) in /Users/chethusk/oss/FCS/src/fsharp/TypedTreeOps.fs:line 1655
   at FSharp.Compiler.TypedTreeOps.GetTopValTypeInCompiledForm(TcGlobals g, ValReprInfo topValInfo, Int32 numEnclosingTypars, TType ty, range m) in /Users/chethusk/oss/FCS/src/fsharp/TypedTreeOps.fs:line 2313
   at FSharp.Compiler.TypedTreeOps.XmlDocSigOfVal(TcGlobals g, Boolean full, String path, Val v) in /Users/chethusk/oss/FCS/src/fsharp/TypedTreeOps.fs:line 8036
   at FSharp.Compiler.SourceCodeServices.SymbolHelpers.GetXmlDocSigOfScopedValRef(TcGlobals g, EntityRef tcref, ValRef vref) in /Users/chethusk/oss/FCS/src/fsharp/symbols/SymbolHelpers.fs:line 541
   at FSharp.Compiler.SourceCodeServices.FSharpMemberOrFunctionOrValue.get_XmlDocSig() in /Users/chethusk/oss/FCS/src/fsharp/symbols/Symbols.fs:line 1818
   at FSharp.Formatting.ApiDocs.CrossReferences.getXmlDocSigForMember(FSharpMemberOrFunctionOrValue memb) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.ApiDocs\GenerateModel.fs:line 575
   at FSharp.Formatting.ApiDocs.CrossReferenceResolver.registerMember(FSharpMemberOrFunctionOrValue memb) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.ApiDocs\GenerateModel.fs:line 649
   at FSharp.Formatting.ApiDocs.CrossReferenceResolver.registerEntity(FSharpEntity entity) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.ApiDocs\GenerateModel.fs:line 669
   at <StartupCode$FSharp-Formatting-ApiDocs>[email protected](FSharpEntity arg00) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.ApiDocs\GenerateModel.fs:line 2149
   at Microsoft.FSharp.Collections.SeqModule.Iterate[T](FSharpFunc`2 action, IEnumerable`1 source) in E:\A\_work\130\s\src\fsharp\FSharp.Core\seq.fs:line 495
   at FSharp.Formatting.ApiDocs.ApiDocModel.Generate(FSharpList`1 projects, String collectionName, FSharpOption`1 libDirs, FSharpOption`1 otherFlags, Boolean qualify, FSharpOption`1 urlRangeHighlight, String root, FSharpList`1 substitutions, Boolean strict) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.ApiDocs\GenerateModel.fs:line 2150
   at FSharp.Formatting.ApiDocs.ApiDocs.GenerateHtmlPhased[a](FSharpList`1 inputs, String output, String collectionName, FSharpList`1 substitutions, FSharpOption`1 template, FSharpOption`1 root, FSharpOption`1 qualify, FSharpOption`1 libDirs, FSharpOption`1 otherFlags, FSharpOption`1 urlRangeHighlight, FSharpOption`1 strict) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.ApiDocs\ApiDocs.fs:line 54
   at <StartupCode$fsdocs>[email protected](Unit unitVar0) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.CommandTool\BuildCommand.fs:line 963
   at <StartupCode$fsdocs>.$BuildCommand.protect@710(CoreBuildOptions this, FSharpFunc`2 f) in C:\GitHub\dsyme\FSharp.Formatting\src\FSharp.Formatting.CommandTool\BuildCommand.fs:line 713

The text was updated successfully, but these errors were encountered:

dsyme · 2020-12-01T12:46:57Z

I also am having trouble running fsdocs with .NET 5 installed.

This looks relevant: https://docs.microsoft.com/en-us/dotnet/core/whats-new/dotnet-core-3-0#major-version-runtime-roll-forward.

I tried specifying this on FsDocs but it's not enough to resolve the problem sadly

<RollForward>LatestMajor</RollForward>

Among other things I think fsdocs needs to be updated to latest FSharp.Compiler.Service

dsyme · 2020-12-01T14:50:41Z

#621 should allow fsdocs to roll forward (I think). Will release it subject to CI etc.

wallymathieu · 2020-12-01T19:02:04Z

A workaround could be to install .net core 3.1 as I did here: fsprojects/FSharpPlus@a18ea7d

dsyme · 2020-12-01T21:05:45Z

A workaround could be to install .net core 3.1 as I did here: fsprojects/FSharpPlus@a18ea7d

Yup

vilinski · 2021-01-16T09:16:23Z

seems the exception is not gone in fsdocs 8.0 regardless of .net core version

dsyme · 2021-02-10T21:52:24Z

Hmmmm I'd say this is because references can't be found. #616 is likely the same problem

vilinski · 2021-02-12T10:02:42Z

yes, looks like it's a duplicate of #616

dsyme changed the title ~~Error by fsdocs build~~ Error running fsdocs on .NET 5.0.100 SDK Dec 1, 2020

dsyme mentioned this issue Dec 1, 2020

Update testing dependencies, target net5.0 (remove netcoreapp3.1) DiffSharp/DiffSharp#266

Merged

vilinski mentioned this issue Jan 16, 2021

System.ArgumentException: The directory name 'docs' does not exist. #632

Closed

vilinski closed this as completed Feb 12, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Error running fsdocs on .NET 5.0.100 SDK #620

Error running fsdocs on .NET 5.0.100 SDK #620

vilinski commented Nov 22, 2020 •

edited

Loading

dsyme commented Dec 1, 2020

dsyme commented Dec 1, 2020

wallymathieu commented Dec 1, 2020

dsyme commented Dec 1, 2020

vilinski commented Jan 16, 2021

dsyme commented Feb 10, 2021

vilinski commented Feb 12, 2021

Error running fsdocs on .NET 5.0.100 SDK #620

Error running fsdocs on .NET 5.0.100 SDK #620

Comments

vilinski commented Nov 22, 2020 • edited Loading

Environment

Reproducing

Expectations

Actual

dsyme commented Dec 1, 2020

dsyme commented Dec 1, 2020

wallymathieu commented Dec 1, 2020

dsyme commented Dec 1, 2020

vilinski commented Jan 16, 2021

dsyme commented Feb 10, 2021

vilinski commented Feb 12, 2021

vilinski commented Nov 22, 2020 •

edited

Loading