5bfd9fcd38
* initial support for span, readonly refs, byref-like structs * fix proto build * make proto work with previous FSharp.Core * make proto work with previous FSharp.Core * update baselines * integrate code cleanup * integrate code cleanup * integrate code cleanup * integrate code cleanup * fix build * fix build * implicit deref of byref returns * add tests for Memory, ReadOnlySpan and ReadOnlyMemory * fix tests * simplify diff * simplify diff * remove duplicate error messages * fix build * test updates * fix build * fix build * update baselines * fix uses of NativePtr.toByRef * switch to inference using byref pointer capabilities * fix proto build * update baselines, byref extension methods * fix test errors * emit in,out,modreq attributes correctly * update tests * fix build * fix build * fix tests * fix tests * get it right silly boy * fix test * minor cleanup * add more tests * clarify overloading behaviour + test case * fix build break * fix build of tests * update tests * add more tests * byref fixes * updates for subsumption calls, error message, assign-to-return-byref * test updates, implicit deref on byref return for normal functions * update baseline * improve debug formatting, better error message on implicit deref, improve error messages * add more tests for recursive functions * update baselines * fix baselines * updates for new test cases * updates for new test cases * test updates and byref-to-byreflike * deal with 'M() <- expr' * restrict addresses of immutable top-level things * fix IsByRefLike on struct * update tests * fix test * fix test * improve check for no-return-of-struct-field-addresses * fix test case |
||
---|---|---|
.nuget | ||
.vscode | ||
artifacts | ||
build | ||
fcs | ||
mono | ||
scripts | ||
setup | ||
src | ||
tests | ||
vsintegration | ||
.gitattributes | ||
.gitignore | ||
.vsts-ci.yaml | ||
BuildToolsVersion.txt | ||
CHANGELOG.md | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
DEVGUIDE.md | ||
DotnetCLIToolsVersion.txt | ||
DotnetCLIVersion.txt | ||
FSharp.Directory.Build.props | ||
FSharp.Directory.Build.targets | ||
FSharp.sln | ||
FSharpBuild.Directory.Build.props | ||
FSharpBuild.Directory.Build.targets | ||
FSharpTests.Directory.Build.props | ||
FSharpTests.Directory.Build.targets | ||
ISSUE_TEMPLATE.md | ||
License.txt | ||
Makefile | ||
NuGet.Config | ||
PublishToBlob.proj | ||
README.md | ||
RoslynPackageVersion.txt | ||
TESTGUIDE.md | ||
VisualFSharp.sln | ||
attributions.md | ||
build-everything.proj | ||
build-nuget-packages.proj | ||
build.cmd | ||
build.sh | ||
code | ||
init-tools.cmd | ||
init-tools.sh | ||
netci.groovy | ||
packages.config | ||
verify-translations.cmd |
README.md
The F# Language, Library, and Visual F# Tools Repository
You are invited to help produce future releases of the F# language compiler, library, and tools. This repository enables development on Linux, macOS and Windows, along with some automated CI testing for these.
The F# Compiler and Tools are also mirrored in the corresponding repository of the F# Software Foundation.
Changes contributed here are eventually propagated to this repository and are included in all packagings of F# and open source F# editing tools. The process for doing this is explained in this guide by the F# Core Engineering Group. Currently, the F# community coordinates packaging other editions of F# for use on Linux, macOS, Android, iOS, and other platforms, and Microsoft coordinates packaging this repository as part of the Visual F# Tools.
For historical reasons this repository is called "visualfsharp" and currently also contains the Visual F# IDE Tools. The eventual plan is to split these repositories into "fsharp" and "visualfsharp".
Build Status
Ubuntu (Build) | Windows (Debug Build) | Windows (Release Tests 1) | Windows (Release Tests 2) | Windows (Release Tests 3) | Windows (Release Tests 4) | |
---|---|---|---|---|---|---|
master | ||||||
dev15.6 | ||||||
dev15.7 | ||||||
dev15.8 |
Help improve the Quality of the Tools by Using the Nightly Releases of Visual F# Tools
To setup Visual Studio to use the latest nightly releases of the Visual F# Tools: https://blogs.msdn.microsoft.com/dotnet/2017/03/14/announcing-nightly-releases-for-the-visual-f-tools/
Contributing
See DEVGUIDE.md and TESTGUIDE.md for details on build, development, and testing.
See CONTRIBUTING.md for general guidelines on the contribution process, also how we label issues and PRs
To contribute to the F# ecosystem more generally see the F# Software Foundation's Community Projects pages.
Branches
These are the branches in use:
-
master
= Latest branch for OSS developers and nightly users.- Most contributions go here.
- Able to be built, installed and used in the latest public Visual Studio release.
- May contain updated F# features and logic.
- Used to build nightly VSIX (see above).
- Gets integrated into https://github.com/fsharp/fsharp to form the basis of Mono releases
- Gets integrated into https://github.com/fsharp/FSharp.Compiler.Service to form the basis of FSharp.Compiler.Service releases
-
dev15.x
- Latest release branch for the particular point release of Visual Studio.
- Incorporates features and fixes from master up to a particular branch point, then selective cherry-picks.
- May contain new features that depend on new things or fixes in the corresponding Visual Studio release.
- Gets integrated back into master once the corresponding Visual Studio release is made.
- Used to build Visual F# Tool updates
Technical Documentation
-
The F# Compiler Technical Guide maintained by contributors to this repository. Please read and contribute to that guide.
License
This project is subject to the MIT License. A copy of this license can be found in License.txt at the root of this repo.
Using
For typical installs of F#, see http://fsharp.org.
Using Nightly Releases of Visual F# Tools
To setup Visual Studio to use the latest nightly releases of the Visual F# Tools:
If you wish to set up a Preview nightly atop Visual Studio preview builds, you can either download a VSIX Manually from here or set up a VSIX feed in visual studio from here.
Using CI Builds
To install F#, see http://fsharp.org.
To download the bits for the latest CI builds see these instructions. This includes and ZIPs containing the F# compiler and VSIX installers for the Visual F# IDE Tools.
Using F# on a build server or computer without an F# installation
If you wish to use the latest F# compiler on a computer without Visual Studio 2017 installed, you can add the nuget package FSharp.Compiler.Tools
to your projects. This will replace the in-box compiler with the version contained in the package.
The actual package is built in https://github.com/fsharp/fsharp.
You will need to adjust the targets reference on your project file to use the targets file from the installed FSharp.Compiler.Tools
package.
See https://github.com/fsharp/fsharp/issues/676 for how to modify your project file.
Code of Conduct
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. This code of conduct has been adopted by many other projects. For more information see the Code of conduct.
Get In Touch
Follow @VisualFSharp and @fsharporg on twitter and subscribe to the .NET Blog.
Members of the F# Software Foundation can be invited to the "F# Software Foundation" discussion rooms on slack. More details at http://fsharp.org/guides/slack/.