See full changelog
- Fix auto-generated
index.mld. Use correct headings for the listing. (#1925, @rgrinberg, @aantron)
Official stable release announcements and updates from the OCaml compiler, OCaml infrastructure and the OCaml Platform Tools.
index.mld. Use correct headings for the listing. (#1925,
@rgrinberg, @aantron)dune-package when version is empty string (#1919, fix #1918,
@rgrinberg)We are pleased to announce release 1.4.0 of odoc, the new, Dune-friendly documentation generator for OCaml and ReasonML.

You can install odoc and generate docs for your Dune project with:
opam update
opam install odoc
dune build @doc
Then, view the docs by opening _build/default/_doc/_html/index.html!
While release 1.4.0 has new features, it is mainly focused on stability and maintainability. See its full changelog here. The previous release, 1.3.0 last October, included a lot of new code. Because of concerns about its stability, we chose not to widely announce 1.3.0. So, this message serves as an announcement for both releases :) The full changelog for 1.3.0 can be found here.
In summary, compared with 1.2.0, odoc now has:
For now, we plan to continue improving the stability of odoc and the quality of its output. In the longer term, odoc has two significant goals:
To replace ocamldoc as OCaml's primary documentation generator. At the core of odoc is a powerful cross-referencer, capable of fully handling the complexity of OCaml's module system. Shortcomings in ocamldoc's ability to resolve cross-references in complex projects were one of the original motivations for starting odoc.
To create centrally-hosted, cross-referenced, searchable online documentation for all the published packages in opam, a “docs.ocaml.org.”
Thanks to the odoc users and contributors, and happy documenting!
Changes
{0 ...}), and top-level sections
within a page are level-1 headings ({1 ...}) (#217, Rizo Isrof).--root-uri option to --xref-base-uri (#223, Rizo Isrof).Additions
{4 ...}) and subparagraph headings ({5 ...}) (#217,
Rizo Isrof).odoc support-files-targets command (#232).bsdoc for using
odoc with BuckleScript (#269, Leandro Ostera).Bugs fixed
.mld pages (#293, Daniel Buenzli).- in them,
such as @-> (#178).. in them, such as *.
(#237)..ml file with a
type annotation, when that type annotation uses an alias of 'a option
(#101).{v ... v}) can now only be terminated if the v} is
immediately preceded by whitespace (#71, reported Daniel Buenzli).type keyword instead of and rendered in HTML for
mutually-recursive types (#105, reported @Fourchaux).nonrec keyword not rendered (#249).and not rendered for mutually-recursive modules, classes, and class types
(#251).constraint clauses (#321).odoc html option -o now creates the output directory if it does not exist
#171, #264 Rizo Isrof).odoc html-targets output now includes path prefix given through -o option
(#173, Rizo Isrof).-I and -o options to refer to non-existent directories (#32, #170,
Daniel Buenzli).odoc compile-targets match odoc compile (#273, Daniel Buenzli).odoc compile-deps does not work on .cmt files (#162, Daniel Buenzli).odoc html-deps now scans for .odoc files recursively (#307, Daniel
Buenzli).odoc html-targets ignores stop comments (#276, Daniel Buenzli).odoc html-targets and odoc html-deps segfault on .mld pages (#277, #282,
Daneil Buenzli).--theme-uri option not propagated to some subpages (#318, Thomas Refis).Build and development
make in the esy build (#308, Leandro Ostera).bos (#305, Daniel Buenzli).rresult (#306, Daniel Buenzli).bisect_ppx, previously present in development
checkouts (#316).On behalf of the dune team, I'm pleased to announce release 1.8. The highlight of this release is a standalone preprocessor that allows OCaml programs to use the new let bindings introduced in 1.8 and still be compatible with OCaml versions all the way back to 4.02.
This release includes some important contributions from a new contributor: @aalekseyev. So I would like to use this opportunity to welcome him to the team. Thanks Arseniy!
Clean up watch mode polling loop: improves signal handling and error handling during polling (#1912, fix #1907, fix #1671, @aalekseyev)
Change status messages during polling to be one-line, so that the messages are correctly erased by ^K. (#1912, @aalekseyev)
Add support for .cxx extension for C++ stubs (#1831, @rgrinberg)
Add DUNE_WORKSPACE variable. This variable is equivalent to setting
--workspace in the command line. (#1711, fix #1503, @rgrinberg)
Add c_flags and cxx_flags to env profile settings (#1700 and #1800,
@gretay-js)
Format dune printenv output (#1867, fix #1862, @emillon)
Add the (promote-into <dir>) and `(promote-until-clean-into
Improve error message when dune subst fails (#1898, fix #1897, @rgrinberg)
Add more GC counters to catapult traces (fix908, @rgrinberg)
Add a preprocessor shim for the let+ syntax of OCaml 4.08 (#1899,
implements #1891, @jeremiedimino)
Fix generation of .merlin files on Windows. \ characters needed
to be escaped (#1869, @mlasson)
Fix 0 error code when $ dune format-dune-file fails. (#1915, fix #1914,
@rgrinberg)
Configurator: deprecated query_expr and introduced query_expr_err which is
the same but with a better error in case it fails. (#1886, @ejgallego)
Make sure (menhir (mode promote) ...) stanzas are ignored when
using --ignore-promoted-rules or -p (#1917, @jeremiedimino)
Fix interpretation of META files containing archives with / in
the filename. For instance, this was causing llvm to be unusable
with dune (#1889, fix #1885, @diml)
Make errors about menhir stanzas be located (#1881, fix #1876, @diml)
Add ${corrected-suffix}, ${library-name} and a few other
variables to the list of variables to upgrade. This fixes the
support for various framework producing corrections (#1840, #1853,
@diml)
Fix $ dune subst failing because the build directory wasn't set. (#1854, fix
#1846, @rgrinberg)
Configurator: Add warning to Pkg_config.query when a full package expression
is used. Add Pkg_config.query_expr for cases when the full power of
pkg-config's querying is needed (#1842, fix #1833, @rgrinberg)
Fix unavailable, optional implementations eagerly breaking the build (#1857, fix #1856, @rgrinberg)
Fix the watch mode (#1837, #1839, fix #1836, @diml)
Configurator: Fix misquoting when running pkg-config (#1835, fix #1833, @Chris00)
On behalf of the dune team, I'm pleased to announce the release of dune 1.7.0. This release is the biggest release since 1.0 and I'm excited to present it to you. The change log is quite long so I'll summarize the most noteworthy changes:
The jbuilder binary and jbuild files are officially deprecated. But not to worry, we've created a $ dune upgrade command to do the hard work for you.
The virtual libraries feature has made it to 1.7.0. I've blogged about it before
There's now a mode to disable transitive dependencies. This mode still has some caveats because it lacks proper compiler support. But we welcome user reports regarding its usability.
Dune now has a --trace-file to profile slow builds using shiny flame graphs in Chrome.
Second step of the deprecation of jbuilder: the jbuilder binary
now emits a warning on every startup and both jbuilder and dune
emit warnings when encountering jbuild files (#1752, @jeremiedimino)
Change the layout of build artifacts inside _build. The new layout enables
optimizations that depend on the presence of .cmx files of private modules
(#1676, @bobot)
Fix merlin handling of private module visibility (#1653 @bobot)
unstable-fmt: use boxes to wrap some lists (#1608, fix #1153, @emillon, thanks to @rgrinberg)
skip directories when looking up programs in the PATH (#1628, fixes #1616, @jeremiedimino)
Use lsof on macOS to implement --stats (#1636, fixes #1634, @xclerc)
Generate dune-package files for every package. These files are installed and
read instead of META files whenever they are available (#1329, @rgrinberg)
Fix preprocessing for libraries with (include_subdirs ..) (#1624, fix #1626,
@nojb, @rgrinberg)
Do not generate targets for archive that don't match the modes field.
(#1632, fix #1617, @rgrinberg)
When executing actions, open files lazily and close them as soon as possible in order to reduce the maximum number of file descriptors opened by Dune (#1635, #1643, fixes #1633, @jonludlam, @rgrinberg, @jeremiedimino)
Reimplement the core of Dune using a new generic memoization system (#1489, @rudihorn, @jeremiedimino)
Replace the broken cycle detection algorithm by a state of the art one from this paper (#1489, @rudihorn)
Get the correct environment node for multi project workspaces (#1648, @rgrinberg)
Add dune compute to call internal memoized functions (#1528,
@rudihorn, @jeremiedimino)
Add --trace-file option to trace dune internals (#1639, fix #1180, @emillon)
Add --no-print-directory (borrowed from GNU make) to suppress
Entering directory messages. (#1668, @dra27)
Remove --stats and track fd usage in --trace-file (#1667, @emillon)
Add virtual libraries feature and enable it by default (#1430 fixes #921, @rgrinberg)
Fix handling of Control+C in watch mode (#1678, fixes #1671, @jeremiedimino)
Look for jsoo runtime in the same dir as the js_of_ocaml binary
when the ocamlfind package is not available (#1467, @nojb)
Make the seq package available for OCaml >= 4.07 (#1714, @rgrinberg)
Add locations to error messages where a rule fails to generate targets and rules that require files outside the build/source directory. (#1708, fixes #848, @rgrinberg)
Let Configurator handle sizeof (in addition to negative numbers).
(#1726, fixes #1723, @Chris00)
Fix an issue causing menhir generated parsers to fail to build in
some cases. The fix is to systematically use -short-paths when
calling ocamlc -i (#1743, fix #1504, @jeremiedimino)
Never raise when printing located errors. The code that would print the location excerpts was prone to raising. (#1744, fix #1736, @rgrinberg)
Add a dune upgrade command for upgrading jbuilder projects to Dune
(#1749, @jeremiedimino)
When automatically creating a dune-project file, insert the
detected name in it (#1749, @jeremiedimino)
Add (implicit_transitive_deps <bool>) mode to dune projects. When this mode
is turned off, transitive dependencies are not accessible. Only listed
dependencies are directly accessible. (#1734, #430, @rgrinberg, @hnrgrgr)
Add toplevel stanza. This stanza is used to define toplevels with libraries
already preloaded. (#1713, @rgrinberg)
Generate .merlin files that account for normal preprocessors defined using a
subset of the action language. (#1768, @rgrinberg)
Emit (orig_src_dir <path>) metadata in dune-package for dune packages
built with --store-orig-source-dir command line flag (also controlled by
DUNE_STORE_ORIG_SOURCE_DIR env variable). This is later used to generate
.merlin with S-directives pointed to original source locations and thus
allowing merlin to see those. (#1750, @andreypopp)
Improve the behavior of dune promote when the files to be promoted have been
deleted. (#1775, fixes #1772, @jeremiedimino)
unstable-fmt: preserve comments (#1766, @emillon)
Pass flags correctly when using staged_pps (#1779, fixes #1774, @jeremiedimino)
Fix an issue with the use of (mode promote) in the menhir
stanza. It was previously causing intermediate mock files to be
promoted (#1783, fixes #1781, @jeremiedimino)
unstable-fmt: ignore files using OCaml syntax (#1784, @emillon)
Configurator: Add which function to replace the which command line utility
in a cross platform way. (#1773, fixes #1705, @Chris00)
Make configurator append paths to $PKG_CONFIG_PATH on macOS. Previously it
was prepending paths and thus $PKG_CONFIG_PATH set by users could have been
overridden by homebrew installed libraries (#1785, @andreypopp)
Disallow c/cxx sources that share an object file in the same stubs archive.
This means that foo.c and foo.cpp can no longer exist in the same library.
(#1788, @rgrinberg)
Forbid use of %{targets} (or ${@} in jbuild files) inside
preprocessing actions
(#1812, fixes #1811, @jeremiedimino)
Add DUNE_PROFILE environment variable to easily set the profile. (#1806,
@rgrinberg)
Deprecate the undocumented (no_keep_locs) field. It was only
necessary until virtual libraries were supported (#1822, fix #1816,
@jeremiedimino)
Rename unstable-fmt to format-dune-file and remove its --inplace option.
(#1821, @emillon).
Autoformatting: (using fmt 1.1) will also format dune files (#1821, @emillon).
Autoformatting: record dependencies on .ocamlformat-ignore files (#1824,
fixes #1793, @emillon)
The new feature in this release is to automatically install
printers marked with [@@ocaml.toplevel_printer] (#269 @diml).
Adding this annotation to your libraries will remove the need
to have a separate top package to install the printers.
For example, in the uri
library, the old printing function for Uri.t was:
val pp_hum : Format.formatter -> t -> unit
Just adding this annotation results in Uri.t values being automatically
pretty printed in this version of utop.
val pp_hum : Format.formatter -> t -> unit [@@ocaml.toplevel_printer]
doc: entry to opam file (#270 @avsm)We are pleased to announce the release of opam 2.0.3.
This new version contains some backported fixes:
Installation instructions (unchanged):
From binaries: run
sh <(curl -sL https://opam.ocaml.org/install.sh)
or download manually from the Github "Releases" page to your PATH. In this case, don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed or to update you sandbox script.
From source, using opam:
opam update; opam install opam-devel
(then copy the opam binary to your PATH as explained, and don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed or to update you sandbox script)
From source, manually: see the instructions in the README.
We hope you enjoy this new major version, and remain open to bug reports and suggestions.
NOTE: this article is cross-posted on opam.ocaml.org and ocamlpro.com. Please head to the latter for the comments!
--print-transformations to list registered transformations
(#55, @rgrinberg)Add an (** @inline *) to the include generated when silencing
warning 32 (#58, @trefis)
Add Ppxlib.mk_named_sig and Ppxlib.is_polymorphic_variant (#57,
@trefis)
version=.., version<=.. and version>=.. keywords to run
a code-block depending on the currently installed OCaml version
(@gpetiot, #87, #90)ppx_tools for toplevel (@avsm, #89)mdx output: escape HTML entities in code blocks (#91, @samoht)mdx rule command to generate dune rules (@gpetiot, #44)mdx output command to generate an HTML document (@samoht, #45)cppo library, just the binary (@samoht, #53)dir=.. labels in ml code blocks (@samoht, #76)mdx rule (@samoht, #81)The dune team is pleased to announce the bug fix release of Dune 1.6.3. Normally, we don't bother announcing all bug fix releases, but this one contains quite a few fixes. I'd like to take this opportunity to encourage everyone to upgrade. Cheers.
Fix merlin handling of private module visibility (#1653 @bobot)
skip directories when looking up programs in the PATH (#1628, fixes #1616, @jeremiedimino)
Fix preprocessing for libraries with (include_subdirs ..) (#1624, fix #1626,
@nojb, @rgrinberg)
Do not generate targets for archive that don't match the modes field.
(#1632, fix #1617, @rgrinberg)
When executing actions, open files lazily and close them as soon as possible in order to reduce the maximum number of file descriptors opened by Dune (#1635, #1643, fixes #1633, @jonludlam, @rgrinberg, @jeremiedimino)
Do not generate targets for archive that don't match the modes field.
(#1632, fix #1617, @rgrinberg)
Get the correct environment node for multi project workspaces (#1648, @rgrinberg)
Fix an issue causing menhir generated parsers to fail to build in
some cases. The fix is to systematically use -short-paths when
calling ocamlc -i (#1743, fix #1504, @jeremiedimino)
The ppxlib team is pleased to announce the release of
ppxlib 0.4.0. This release adds better
support for defining compile-time interpretation of dotted operators such as
+.+ and also improves integration with other tools such as reason or metaocaml
by no longer complaining about attributes generated by these tools. In
particular, ppxlib now treats all attributes whose name start with an _ as
machine generated attributes and doesn’t complain if it can’t decide whether
they have been correctly interpreted or not. FTR, ppxlib tries to detect
attributes and extension points that are dead-code, in order to catch typing
mistakes or misplacement.
_ (#46, fix #40, @diml)special_function rule for dotted operators and allow
Longident.parse to parse dotted operators (#44, @Octachron)dune and remove use of bash (#45, @rgrinberg)_ (#46, @diml)reason and refmt namespaces (#46, @diml)metaocaml namespace (#50, @rgrinberg)-loc-filename is passed (#55, @hhugo)We are pleased to announce the release of opam 2.0.2.
As sandbox scripts have been updated, don't forget to run opam init --reinit -ni to update yours.
This new version contains mainly backported fixes:
--alias-of)no-aspcudpin-depends packages reliably/bin or /lib (#3661). Fixes sandboxing on some distributions such as CentOS 7 and Arch Linux.ocaml-base-compiler ⇄ ocaml)Installation instructions (unchanged):
From binaries: run
sh <(curl -sL https://opam.ocaml.org/install.sh)
or download manually from the Github "Releases" page to your PATH. In this case, don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed or to update your sandbox script.
From source, using opam:
opam update; opam install opam-devel
(then copy the opam binary to your PATH as explained, and don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed or to update you sandbox script)
From source, manually: see the instructions in the README.
We hope you enjoy this new minor version, and remain open to bug reports and suggestions.
NOTE: this article is cross-posted on opam.ocaml.org and ocamlpro.com. Please head to the latter for the comments!
Fix regression introduced by #1554 reported in: https://github.com/ocaml/dune/issues/734#issuecomment-444177134 (#1612, @rgrinberg)
Fix dune external-lib-deps when preprocessors are not installed
(#1607, @diml)
Fix hash collision for on-demand ppx rewriters once and for all (#1602, fixes #1524, @diml)
Add dune external-lib-deps --sexp --unstable-by-dir so that the output can
be easily processed by a machine (#1599, @diml)
The dune team is pleased to announce the release of Dune 1.6.0. This release does not contain any notable features or bug fixes that need to be specifically pointed out. Nevertheless, I expect that this will be a quality of life improvement to power users who have experienced dune's sharper corners.
Happy hacking!
Expand variables in install stanzas (#1354, @mseri)
Add predicate language support for specifying sub directories. This allows the
use globs, set operations, and special values in specifying the sub
directories used for the build. For example: (dirs :standard \ lib*) will
use all directories except those that start with lib. (#1517, #1568,
@rgrinberg)
Add binaries field to the (env ..) stanza. This field sets and overrides
binaries for rules defined in a directory. (#1521, @rgrinberg)
Fix a crash caused by using an extension in a project without dune-project file (#1535, fix #1529, @jeremiedimino)
Allow %{bin:..}, %{exe:..}, and other static expansions in the deps
field. (#1155, fix #1531, @rgrinberg)
Fix bad interaction between on-demand ppx rewriters and using multiple build contexts (#1545, @jeremiedimino)
Fix handling of installed .dune files when the backend is declared via a
dune file (#1551, fixes #1549, @jeremiedimino)
Add a --stats command line option to record resource usage (#1543, @jeremiedimino)
Fix dune build @doc deleting highlight.pack.js on rebuilds, after the
first build (#1557, @aantron).
Allow targets to be directories, which Dune will treat opaquely (#1547, @jordwalke)
Support for OCaml 4.08: List.t is now provided by OCaml (#1561, @ejgallego)
Exclude the local esy directory (_esy) from the list of watched directories
(#1578, @andreypopp)
Fix the output of dune external-lib-deps (#1594, @jeremiedimino)
Introduce data_only_dirs to replace ignored_subdirs. ignored_subdirs is
deprecated since 1.6. (#1590, @rgrinberg)
Add dune external-lib-deps --sexp --unstable-by-dir so that the output can
be easily processed by a machine (#1599, @jeremiedimino)
let f = fun x -> and let f =\n fun x ->Fix dune utop <dir> when invoked from a sub-directory of the
project (#1520, fix #1518, @diml)
Fix bad interaction between on-demand ppx rewriters and polling mode (#1525, fix #1524, @diml)
On behalf of the dune team, I'm pleased to announce the 1.5.0 release of dune. This release does not contain any major features, but it does contain a few notable bug fixes and a couple of useful little additions. First of all, $ dune exec now supports C-c again - I know this affected many of you. This releases introduces a couple of new aliases that will hopefully find their way into your workflows.
The first alias is @all and has been much requested by our users. $ dune build @dir/all will build all user defined targets in a the directory dir. This would include binaries, libraries, and user defined targets in dir. This alias should have been the defaulted instead of @install when running $ dune build, but we'll have to wait until dune 2.0 to make this compatibility breaking change. In the mean time, I highly recommend everyone to use $ dune build @all instead of $ dune build meanwhile. You may also set the default alias per project as well:
(alias
(name default)
(deps (alias_rec all)))
The second new alias is @check. It is inspired by cargo's check subcommand and roughly corresponds to type checking the project and building all artifacts necessary for editor integration - cmt, cmti's, .merlin, etc. This is the fastest target to verify that a project is in a valid state. Note that this alias will not relink binaries so it might not catch errors such as missing stubs. I find this alias handy when doing large, type driven refactoring of a codebase.
The rest of the change log is replicated below. Happy hacking!
Filter out empty paths from OCAMLPATH and PATH (#1436, @rgrinberg)
Do not add the lib.cma.js target in lib's directory. Put this target in a
sub directory instead. (#1435, fix #1302, @rgrinberg)
Install generated OCaml files with a .ml rather than a .ml-gen extension
(#1425, fix #1414, @rgrinberg)
Allow to use the bigarray library in >= 4.07 without ocamlfind and without
installing the corresponding otherlib. (#1455, @nojb)
Add @all alias to build all targets defined in a directory (#1409, fix
#1220, @rgrinberg)
Add @check alias to build all targets required for type checking and tooling
support. (#1447, fix #1220, @rgrinberg)
Produce the odoc index page with the content wrapper to make it consistent with odoc's theming (#1469, @rizo)
Unblock signals in processes started by dune (#1461, fixes #1451, @jeremiedimino)
Respect OCAMLFIND_TOOLCHAIN and add a toolchain option to contexts in the
workspace file. (#1449, fix #1413, @rgrinberg)
Fix error message when using copy_files stanza to copy files from
a non sub directory with lang set to dune < 1.3 (#1486, fixes #1485,
@NathanReb)
Install man pages in the correct subdirectory (#1483, fixes #1441, @emillon)
Fix version syntax check for test stanza's action field. Only
emits a warning for retro-compatibility (#1474, fixes #1471,
@NathanReb)
Fix interpretation of paths in env stanzas (#1509, fixes #1508, @jeremiedimino)
Add context_name expansion variable (#1507, @rgrinberg)
Use shorter paths for generated on-demand ppx drivers. This is to help Windows builds where paths are limited in length (#1511, fixes #1497, @jeremiedimino)
Fix interpretation of environment variables under setenv. Also forbid
dynamic environment names or values (#1503, @rgrinberg).
We are pleased to announce the release of opam 2.0.1.
This new version contains mainly backported fixes, some platform-specific:
gtarAnd some opam specific:
test variable warning and empty description errorlist doesn't return non-zero code if list is empty, add --silent option for a silent output and returns 1 if list is emptyInstallation instructions (unchanged):
From binaries: run
sh <(curl -sL https://opam.ocaml.org/install.sh)
or download manually from the Github "Releases" page to your PATH. In this case, don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed.
From source, using opam:
opam update; opam install opam-devel
(then copy the opam binary to your PATH as explained, and don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed)
From source, manually: see the instructions in the README.
We hope you enjoy this new major version, and remain open to bug reports and suggestions.
NOTE: this article is cross-posted on opam.ocaml.org and ocamlpro.com. Please head to the latter for the comments!
dune-release publish doc when using multiple packages (#96, @samoht)dune-project files (#104. @samoht)dune-release lint now checks that a description and a synopsis exist
in opam2 files (#101, @samoht)git checkout fails in the local
opam-repository (#98, @samoht)_html folder when publishing docs on Linux
(#94, @anuragsoni and @samoht)Additions
odoc binary is now self-contained and requires no external
files (bd3b53c).--theme-uri option (#154, Rizo Isrof)..mld to HTML fragments rather than complete pages
(#166, Rizo Isrof).Bugs fixed
page- to output file name when compiling .mld files
(#183, Rizo Isrof).floatarray type introduced in OCaml 4.06 (eb36158, Thomas
Refis).<i> tags in italics (#104, Thibault Suzanne).Build and development
odoc is now one repo.CONTRIBUTING.md, tests,
coverage analysis, CI, and issue organization.The dune team is pleased to announce the 1.4.0 release of Dune. The highlight of this release is the improved support for menhir, in particular the long awaited --infer flag. This seemingly small feature took quite a bit of coordination between the maintainers of dune and menhir. So I'd like to thank @fpottier for helping us out with this by adding better support for dune in menhir itself, and implementing the majority of the support in dune as well.
The rest of the release is mostly bug fixes, but one notable feature is that dune is now C-c friendly. Dune will now resume exactly where it's stopped after interruption instead of restarting the entire build.
EDIT: I actually forgot to mention that this release also includes integration with OCamlFormat due to @emillon. Initially, I had thought that this feature was released in 1.3.0. Sorry about that!
Do not fail if the output of ocamlc -config doesn't include
standard_runtime (#1326, @jeremiedimino)
Let Configurator.V1.C_define.import handle negative integers
(#1334, @Chris00)
Re-execute actions when a target is modified by the user inside
_build (#1343, fix #1342, @jeremiedimino)
Pass --set-switch to opam (#1341, fix #1337, @jeremiedimino)
Fix bad interaction between multi-directory libraries the menhir
stanza (#1373, fix #1372, @jeremiedimino)
Integration with automatic formatters (#1252, fix #1201, @emillon)
Better error message when using (self_build_stubs_archive ...) and
(c_names ...) or (cxx_names ...) simultaneously.
(#1375, fix #1306, @nojb)
Improve name detection for packages when the prefix isn't an actual package (#1361, fix #1360, @rgrinberg)
Support for new menhir rules (#863, fix #305, @fpottier, @rgrinberg)
Do not remove flags when compiling compatibility modules for wrapped mode (#1382, fix #1364, @rgrinberg)
Fix reason support when using staged_pps (#1384, @charlesetc)
Add support for enabled_if in rule, menhir, ocamllex,
ocamlyacc (#1387, @jeremiedimino)
Exit gracefully when a signal is received (#1366, @jeremiedimino)
Load all defined libraries recursively into utop (#1384, fix #1344, @rgrinberg)
Allow to use libraries bytes, result and uchar without findlib
installed (#1391, @nojb)
Take argument to self_build_stubs_archive into account. (#1395, @nojb)
Fix bad interaction between env customization and vendored
projects: when a vendored project didn't have its own env stanza,
the env stanza from the enclosing project was in effect (#1408,
@jeremiedimino)
Fix stop early bug when scanning for watermarks (#1423, @struktured)
:: (#452, @jberdine)function%ext (#416, @hhugo)while%ext/for%ext (@hhugo)It is my pleasure to announce the release of Dune 1.3.0. This release does not contain many features, but it does contain a few important bug fixes. Everyone is encouraged to upgrade.
Happy Hacking.
Support colors on Windows (#1290, @jeremiedimino)
Allow dune.configurator and base to be used together (#1291, fix
#1167, @jeremiedimino)
Support interrupting and restarting builds on file changes (#1246, @kodek16)
Fix findlib-dynload support with byte mode only (#1295, @bobot)
Make dune rules -m output a valid makefile (#1293, @jeremiedimino)
Expand variables in (targets ..) field (#1301, #1320, fix #1189, @nojb,
@rgrinberg, @jeremiedimino)
Fix a race condition on Windows that was introduced in 1.2.0 (#1304, fix #1303, @jeremiedimino)
Fix the generation of .merlin files to account for private modules (@rgrinberg, fix #1314)
Exclude the local opam switch directory (_opam) from the list of watched
directories (#1315, @dysinger)
Fix compilation of the module generated for findlib.dynload
(#1317, fix #1310, @jeremiedimino)
Lift restriction on copy_files and copy_files# stanzas that files to be
copied should be in a subdirectory of the current directory.
(#1323, fix #911, @nojb)
Initial release
Makefile from the distribution archives (#71, @samoht)--tag option to select the release tag (@samoht)--version option to select the release version (@samoht)--keep-v (#70, @samoht)dune-release <OPTIONS> a shorchut to dune-release bistro <OPTIONS>
(#75, @samoht)--keep-v and --no-auto-open via options in the config file
(#79, @samoht)Attribute.declare_with_name_loc (#33, @diml)We are happy to announce the final release of opam 2.0.0.
A few weeks ago, we released a last release candidate to be later promoted to 2.0.0, synchronised with the opam package repository upgrade.
You are encouraged to update as soon as you see fit, to continue to get package updates: opam 2.0.0 supports the older formats, and 1.2.2 will no longer get regular updates. See the Upgrade Guide for details about the new features and changes.
The website opam.ocaml.org has been updated, with the full 2.0.0 documentation pages. You can still find the documentation for the previous versions in the corresponding menu.
Package maintainers should be aware of the following:
opam-publish (2.0.0)For custom repositories, the advice remains the same.
Installation instructions (unchanged):
From binaries: run
sh <(curl -sL https://opam.ocaml.org/install.sh)
or download manually from the Github "Releases" page to your PATH. In this case, don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed.
From source, using opam:
opam update; opam install opam-devel
(then copy the opam binary to your PATH as explained, and don't forget to run opam init --reinit -ni to enable sandboxing if you had version 2.0.0~rc manually installed)
From source, manually: see the instructions in the README.
We hope you enjoy this new major version, and remain open to bug reports and suggestions.
NOTE: this article is cross-posted on opam.ocaml.org and ocamlpro.com. Please head to the latter for the comments!
Oops, we went looking but didn't find the changelog for this release 🙈
Dune 1.2.1 includes a few critical bug fixes over 1.2.0. Everyone is encouraged to upgrade as soon as possible.
On behalf of the dune team,
Happy hacking.
Enrich the dune Emacs mode with syntax highlighting and indentation. New
file dune-flymake to provide a hook dune-flymake-dune-mode-hook to enable
linting of dune files. (#1265, @Chris00)
Pass link_flags to cc when compiling with Configurator.V1.c_test (#1274,
@rgrinberg)
Fix digest calculation of aliases. It should take into account extra bindings passed to the alias (#1277, fix #1276, @rgrinberg)
Fix a bug causing dune to fail eagerly when an optional library
isn't available (#1281, @jeremiedimino)
ocamlmklib should use response files only if ocaml >= 4.08 (@1268, @bryphe)
On behalf of the dune team, I'm pleased to announce the release of Dune 1.2.0. This release contains many new goodies which I will not describe here. This is because Etienne Millon has prepared a blog post for this release: https://tarides.com/2018-09-06-dune-1-2-0.html
I'd also like to personally thank him for all work he's done to make this release so great.
As usual, the change log is replicated below for your convenience.
Happy hacking!
Ignore stderr output when trying to find out the number of jobs available (#1118, fix #1116, @jeremiedimino)
Fix error message when the source directory of copy_files does not exist.
(#1120, fix #1099, @emillon)
Highlight error locations in error messages (#1121, @emillon)
Display actual stanza when package is ambiguous (#1126, fix #1123, @emillon)
Add dune unstable-fmt to format dune files. The interface and syntax are
still subject to change, so use with caution. (#1130, fix #940, @emillon)
Improve error message for dune utop without a library name (#1154, fix
#1149, @emillon)
Fix parsing ocamllex stanza in jbuild files (#1150, @rgrinberg)
Highlight multi-line errors (#1131, @anuragsoni)
Do no try to generate shared libraries when this is not supported by the OS (#1165, fix #1051, @jeremiedimino)
Fix Flags.write_{sexp,lines} in configurator by avoiding the use of
Stdune.Path (#1175, fix #1161, @rgrinberg)
Add support for findlib.dynload: when linking an executable using
findlib.dynload, automatically record linked in libraries and
findlib predicates (#1172, @bobot)
Add support for promoting a selected list of files (#1192, @jeremiedimino)
Add an emacs mode providing helpers to promote correction files (#1192, @jeremiedimino)
Improve message suggesting to remove parentheses (#1196, fix #1173, @emillon)
Add (wrapped (transition "..message..")) as an option that will generate
wrapped modules but keep unwrapped modules with a deprecation message to
preserve compatibility. (#1188, fix #985, @rgrinberg)
Fix the flags passed to the ppx rewriter when using staged_pps (#1218, @jeremiedimino)
Add (env var) to add a dependency to an environment variable.
(#1186, @emillon)
Add a simple version of a polling mode: dune build -w keeps
running and restarts the build when something change on the
filesystem (#1140, @kodek16)
Cleanup the way we detect the library search path. We no longer call
opam config var lib in the default build context (#1226, @jeremiedimino)
Make test stanzas honor the -p flag. (#1236, fix #1231, @emillon)
Test stanzas take an optional (action) field to customize how they run (#1248, #1195, @emillon)
Add support for private modules via the private_modules field (#1241, fix
#427, @rgrinberg)
Add support for passing arguments to the OCaml compiler via a response file when the list of arguments is too long (#1256, @jeremiedimino)
Do not print diffs by default when running inside dune (#1260, @jeremiedimino)
Interpret $ dune build dir as building the default alias in dir. (#1259,
@rgrinberg)
Make the dynlink library available without findlib installed (#1270, fix
#1264, @rgrinberg)
# infix ops (@hhugo)in (#328, @jberdine)make -C test (@jberdine)+/- (@hhugo)%; (@hhugo)not when infix op arg (@jberdine)function cases (@jberdine)>] which is an unparsable keyword (#171, @hhugo)module type of (@jberdine)Fix $ jbuilder --dev (#1104, fixes #1103, @rgrinberg)
Fix dune exec when --build-dir is set to an absolute path (#1105, fixes
#1101, @rgrinberg)
Fix duplicate profile argument in suggested command when an external library is missing (#1109, #1106, @emillon)
-opaque wasn't correctly being added to modules without an interface.
(#1108, fix #1107, @rgrinberg)
Fix validation of library name fields and make sure this validation also
applies when the name is derived from the public_name. (#1110, fix #1102,
@rgrinberg)
Fix a bug causing the toplevel env stanza in the workspace file to
be ignored when at least one context had (merlin) (#1114, @diml)
On behalf of the dune team, I'm proud to announce the 1.1.0 release of dune. This release contains a few interesting features that I won't describe in this post, because I've already written a dedicated blog post about this release: http://rgrinberg.com/posts/dune-upcoming-1-1/
Fix lookup of command line specified files when --root is given. Previously,
passing in --root in conjunction with --workspace or --config would not
work correctly (#997, @rgrinberg)
Add support for customizing env nodes in workspace files. The env stanza is
now allowed in toplevel position in the workspace file, or for individual
contexts. This feature requires (dune lang 1.1) (#1038, @rgrinberg)
Add enabled_if field for aliases and tests. This field controls whether the
test will be ran using a boolean expression language. (#819, @rgrinberg)
Make name, names fields optional when a public_name, public_names
field is provided. (#1041, fix #1000, @rgrinberg)
Interpret X in --libdir X as relative to PREFIX when X is relative
(#1072, fix #1070, @jeremiedimino)
Add support for multi directory libraries by writing
(include_subdirs unqualified) (#1034, @jeremiedimino)
Add (staged_pps ...) to support staged ppx rewriters such as ones
using the OCaml typer like ppx_import (#1080, fix #193, @jeremiedimino)
Use -opaque in the dev profile. This option trades off binary quality for
compilation speed when compiling .cmx files. (#1079, fix #1058, @rgrinberg)
Fix placeholders in dune subst documentation (#1090, @emillon, thanks
@trefis for the bug report)
Add locations to errors when a missing binary in PATH comes from a dune file (#1096, fixes #1095, @rgrinberg)
%{lib:name:file} forms (#1022, fixes #1019, @diml)It is my pleasure to announce the 1.0.0 release of Dune!
Dune is a built system for OCaml and Reason projects. It aims at building things fast and providing a smooth user experience.
Dune 1.0.0 is now available on github and in opam.
This is a big milestone for the project as it is the first release using the new Dune name that the community helped to choose. Dune started about a year and a half ago as the more narrow scoped Jbuilder and as since then proven itself to be the right tool for the job.
A big part of the work for this release was preparing the project for long-term support. Dune is the kind of project that will pretty much continue to evolve forever: it needs to keep up with the OCaml compiler evolving, development workflows changing, new kinds of tools with specific needs, etc... While doing so, it also needs to offer stability so that projects released now will continue to build with future versions of Dune.
Meeting these two constraints is a challenge. However, we had to do this for the renaming: we changed many things in Dune using what we learned from the Jbuilder experience. Still, Dune is able to understand and build Jbuilder projects. The mechanism used to support both Jbuilder and Dune projects is fully generic and will be the basis for future evolution.
You can find the full list of changes and bug fixes since Jbuilder 1.0+beta20 on the github release page. Following is an overview of some the new features:
General cleanup of the syntax: less parentheses, better behaved variables
Introduction of a dune.configurator library to help projects with C stubs detect and query the environment
General improvement of the default behavior: more parallelism by default, development mode by default
Better support for changing the defaults: it is now possible to set the default flags or change what dune build does by default
Support for setting the build directory
Better support for expectation tests on Windows
~/.config/dune/ instead of ~/.dune
to match what dune is doing (#27, @samoht)-p <pkg> instead of -n <pkg> to follow dune convention
(#30, #42, @samoht)nano if the EDITOR environment variable is not set. (#32, @avsm)odoc creates an _html subdirectory
(#34, @samoht)dune-release help delegate) (#37, @samoht)v at the beginning of version numbers in dune-release opam
(#40, @let-def)Thanks to the people who contributed to this release: ELLIOTTCABLE, Louis Roché, Rudi Grinberg, Yotam Barnoy, Leo White, Daniel Below, Andreas Hauptmann, Christophe Troestler, Bobby Priambodo, Milo Davis.
backend
#require directive in a source file, and will treat it as a
package useeditor modes