search

fsprojects / FSharp.Linq.ComposableQuery

Compositional Query Framework for F# Queries, based on "A Practical Theory of Language-Integrated Query"
http://fsprojects.github.io/FSharp.Linq.ComposableQuery/
MIT License
67 stars 13 forks source link

Build script not generating docs #4

Closed ixtreon closed 10 years ago

ixtreon commented 10 years ago

The build script uses MSBuild to build the FSharpComposableQuery.fsproj project file. Although the process builds the library, it does not generate the XML documentation file FSharpComposableQuery.XML as required by the docs generation script.

Inspecting the project file properties reveals it should create such an Xml documentation file when built, and indeed doing this from Visual Studio actually creates the file.

It is interesting why the build script does not instruct the compiler to generate docs. It is its job to parse the project file and pass all relevant options to MSBuild.

One can confirm there is a discrepancy in the parameters passed to MSBuild by examining them in both cases: the IDE passes the additional switch --doc:..\..\bin\FSharpComposableQuery.XML as compared to FAKE v3.2.3 (and v2.1.7, too).

ixtreon commented 10 years ago

As of commit 9a57126 the build script should now generate the relevant Xml documentation file.

I am thus marking this issue as closed.