Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The official windows installer (built using NSIS) for OCaml
NSIS OCaml Makefile Emacs Lisp
Branch: master

README.md

The OCaml Installer for Windows

These are the source files if you want to rebuild the installer. If you just want to download the installer, see the "website" link near the top of the page.

The installer now uses the "official" toolchain, namely Mingw64 living in a Cygwin environment. The current version of this installer works with OCaml 4.0; if you want to compile an older version of OCaml, you need to switch to and older revision.

Requirements

  • Cygwin with the mingw64 compiler suite, 32bit version (i686-w64-mingw32).
  • FlexDLL (at least 0.29)
  • NSIS (the special build that uses 8k strings)
  • the NSISunz plugin for NSIS, that lives somewhere on the NSIS wiki

Instructions for building an new version of the installer

The instructions above sometimes use the c:\...-style paths, sometimes the /c/...-style paths. This is significant, and you cannot blindly replace one for another.

  1. Install FlexDLL from Alain's website, and
    • export PATH=/cygdrive/c/path/to/flexdll:$PATH
  2. Refresh the files in the flexlink/ directory of the installer, so that the resulting installer ships the right version of flexdll (optional, recommended).
  3. Grab a copy of ActiveTCL and install it, leave the default path (c:\tcl). Make sure the URL in install.nsi is up-to-date.
  4. Grab a copy of the OCaml sources, and keep the default install path (c:\ocamlmgw), this will make your life easier.
  5. Follow the instructions in README.Win32, section "MinGW/Cygwin". Try to compile OCaml. Swear. Try again. Grab a tea. Succeed. Be happy.
  6. Make sure /cygdrive/c/ocamlmgw/bin is in your path.
  7. Clone camlp4, apply the patch for Windows, configure make all and make install
  8. Go into the emacs/ directory.
    • Make sure there's an emacs.exe in your path (install Emacs if you have to).
    • Configure the Makefile so that the output directory is /cygdrive/c/ocamlmgw/emacsfiles.
    • Run make in that directory.
  9. Checkout a copy of OCamlWin from the OCaml forge, edit Makefile.local and make && make install.
  10. Grab the latest findlib, configure, make all opt, make install.
  11. Check that install.nsi will generate a correct findlib.conf
  12. Copy findlib's src/findlib/topfind_rd1.p to topfind in the OCaml Installer directory.
  13. Install NSIS, grab nsisunz.dll somewhere on the interwebs and put it NSIS's Plugins directory.
  14. In the ocaml-installer directory (i.e. this repo), run make. This should create a variety of files:
    • version.nsh, a NSIS header file that is generated to contain the freshly compiled OCaml's version number,
    • uninstall_lines.nsi, an OCaml-generated list of files to remove from the install directory.
  15. Make should also launch NSIS with the main script file, and hopefully it should all generate an installer. The installer is quite big (thank you camlp4).

Things to test for

  1. rlwrap ocaml, then #use "topfind";;, then #camlp4r;;
  2. ocamlfind ocamlc -package unix -linkpkg test.ml where test.ml uses the Unix module, of course.
  3. odb on a sample package (e.g. lwt)
  4. labltktop, ocamlbrowser...

Bugs, issues

All patches should be submitted using GitHub pull requests. All issues should be filed using the GitHub issue tracker.

License

The MIT License (MIT)

Copyright (c) 2015 Jonathan Protzenko

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Something went wrong with that request. Please try again.