Commit Graph

855 Commits (92c41647a1e5969363802c0c0a451b1eb8ad8ba8)

Author SHA1 Message Date
octachron e37632d6c8 Manual: improve [%extension_constructor] example 2016-01-14 19:56:07 +02:00
octachron e2005f02f9 Manual: fix verbatim type errors 2016-01-14 19:56:07 +02:00
octachron 709da524e7 Manual: fix deprecated lowercase 2016-01-14 19:56:07 +02:00
octachron 4ac8df2dcf Manual: multiple locally abstract type example 2016-01-14 19:56:07 +02:00
octachron c21c473d5e Manual: fix multiple locally abstract type syntax 2016-01-14 19:55:43 +02:00
octachron 4ae8c3220f Manual: fix missing quote in verbatim environment 2016-01-14 19:54:45 +02:00
octachron fb503c7c48 Manual: type variable macro for refman/exten 2016-01-14 01:48:22 +02:00
octachron 5f86dc2dbf Manual: fix existential names 2016-01-14 01:08:49 +02:00
octachron 21595becbf Manual: compiler existential name nomenclature
This commit documents the nomenclature used for naming existential
types when these types are exposed through error messages.
2016-01-13 19:02:02 +02:00
Jacques Garrigue 29c907de13 add description of refutation cases 2016-01-13 15:14:15 +09:00
Armael f60e1d7a5c PR#7108: ocamldoc, have -html preserve custom/extended html generators
Previsously
  ocamldoc -g better_html.cmo -html
would just use the standard HTML generator instead of keeping the
generator extended by better_html.cmo. This patch makes sure that when
a standard option (-html, -latex, -texi, -man, -dot) is requested,
extended generators for the same format are chosen if they are
present.

Note that there is still a global "current generator setting", so in particular
  -g better_html.cmo -man
will throw away the extended generator, and
  -g better_html.cmo -man -html
corresponds to the old behaviour.
2016-01-02 07:01:14 +01:00
Damien Doligez 6533f3bc06 PR#5995 (cont): add a note saying that you can still pack without -for-pack but exception names will be wrong 2015-12-28 14:23:43 +01:00
octachron 8dc147614b Manual: detail warn_on_literal_pattern limitation 2015-12-28 11:28:47 +01:00
octachron 7cb78e33eb Manual: fix built-in attributes section
-more homogeneous warning notation
-fix warn_on_literal_pattern warning number
-more in-details explanation of warn_on_literal_pattern
-fix grammar for inline attribute
2015-12-28 11:10:59 +01:00
octachron a7b5d1b60b Manual: fix typo in code examples
in built-in attributes and extension subsection
2015-12-28 01:36:12 +01:00
octachron e38bb78157 Manual: better tailcall description 2015-12-28 01:27:54 +01:00
octachron 97e423ad9c Manual: add a line break to hex float literals 2015-12-28 01:04:56 +01:00
octachron c6ecf3ec26 Manual: extension-only syntax, extension literals 2015-12-28 01:04:55 +01:00
octachron 61393c6f5a Manual: built-in [%extension_constructor] 2015-12-28 01:04:55 +01:00
octachron df1dbcc665 Manual: more built-in attributes
Add a description for
-inline
-inlined
-tailcall
-warn_on_literal_pattern

and a cross-reference for
-noalloc
-unboxed
-untagged
2015-12-28 01:03:53 +01:00
Leonid Rozenberg fb19acde51 Editing the infix form extension documention
Clear up infix usage of the extension points.
2015-12-25 20:00:05 -05:00
FDSouthern 75a89e87a0 Manual: Update heading to match content.
Fixes http://caml.inria.fr/mantis/view.php?id=7105#c15187
2015-12-23 23:12:41 +00:00
Gabriel Scherer 00158cd226 manual: change 'class ref' to 'class oref' to avoid beginner confusion
https://sympa.inria.fr/sympa/arc/caml-list/2015-12/msg00116.html
2015-12-23 07:11:42 +01:00
Gabriel Scherer 7c71653524 Merge pull request #364 from Octachron/manual_new_syntax_sugar
Manual: new purely syntactic forms
2015-12-21 14:07:14 +01:00
octachron b4245167cb Manual: result type constraint warning 2015-12-21 13:51:20 +01:00
octachron c007c77b70 Manual: result type constraint for fun 2015-12-21 12:41:39 +01:00
octachron 5af5540bd4 Manual: optional type constraint for record label 2015-12-21 12:41:39 +01:00
octachron d4bb184cea Manual: functor short syntax 2015-12-21 12:41:38 +01:00
octachron a095100c57 Manual: "_" as anonymous type parameters 2015-12-21 12:41:38 +01:00
octachron ec47e312fe Manual: object copy notation 2015-12-21 12:41:38 +01:00
octachron e83d8a642d Manual: multiple locally abstract types sugar 2015-12-21 12:41:38 +01:00
octachron 4f131e3803 manual: alternative polymorphic variants intro 2015-12-18 21:42:55 +01:00
Gabriel Scherer b1f6abc45c PR#7096: remove wrong superscript CSS from manual/style.css 2015-12-17 09:10:27 +01:00
Gabriel Scherer 673957f6f0 Merge pull request #354 from Octachron/manual_fix_escape_intfc
Manual: fix missing escape characters in subsection 19.10
2015-12-14 23:22:45 +01:00
octachron 7659a19c1d manual: fix missing escape characters in intf-c 2015-12-14 21:35:09 +01:00
Alain Frisch 2b4779e73b Document inlined records. 2015-12-14 17:43:12 +01:00
alainfrisch 74ac42c856 PR#6912: more faithful doc for placement of attributes on record label declarations (they can also be put after the semi-colon). 2015-12-14 16:54:18 +01:00
Gabriel Scherer d071da2880 Revert GPR#305 (exception patterns under or-patterns) from trunk
This week we merged several changes from Thomas Refis, to allow the
use of exception patterns under or-patterns, to write code such as

  match foo x with
    | None | exception Not_found -> ...
    | Some -> ...

Unfortunately, I failed to properly assess the impact of this change,
and in particular to make sure that Luc Maranget had properly reviewed
this code -- any change to the pattern-matching machinery should be
reviewed by Luc.

The problem that I had not foreseen and that he would have immediately
realized is that, while adapting the pattern-matching *compiler* is
relatively easy (Thomas inserted a transformation at the right place
to separate exception patterns from the others and handle them
separately, using the staticraise construct used by the
pattern-matching compiler to avoid duplicating the
right-hand-side branch), adapting the pattern-matching warnings
machinery is both more subtle and easier to overlook (it may fail
silently and nobody notices, unlike wrong code production). This part
of the compiler is subtle and best understood by Luc, but he does not
have the time to do a proper review of those changes in the timeframe
for the 4.03 feature freeze (mid-December).

I believe the right move in this case, implemented in the present
commit, is to revert the change from trunk (this is not a feature that
we must *imperatively* have in 4.03), do a proper job of understanding
the changes, and integrate the change when we are confident it is
ready. I hope to do this in 2016, together with Luc Maranget and
Thomas Refis -- hopefully this would allow Thomas and I to be more
confident when changing the pattern-matching machinery in the future.

Revert "Merge pull request #343 from trefis/pr7083"
This reverts commit 22681b8d2a, reversing
changes made to a24e4edf0a.

Revert "Merge pull request #341 from trefis/or-exception"
This reverts commit f8f68bd329, reversing
changes made to 1534fe8082.

Revert "Merge pull request #305 from trefis/or-exception"
This reverts commit cfeda89396, reversing
changes made to 77cf36cf82.
2015-12-12 11:20:21 +01:00
alainfrisch a9854a4a3e #5995: document -for-pack as mandatory including in bytecode. This is required to get proper names for exceptions. 2015-12-11 12:58:43 +01:00
Drup 6d467c823b Add signature payloads in the manual. 2015-12-09 14:40:34 +01:00
Thomas Refis 3674fdb6bd manual: post GPR#305 update (allow exceptions under or-patterns) 2015-12-09 13:05:15 +00:00
Luc Maranget 533e0cdd29 info manual: erase one useless file. 2015-12-08 15:48:15 +01:00
Gabriel Scherer c6b5a28d77 Merge pull request #320 from gasche/revert-user-defined-indexing-operators
Revert user defined indexing operators
2015-12-06 17:56:40 +01:00
Xavier Leroy 9f7f3cefb7 PR#6854: Manual example does not initialize compare_ext field 2015-12-06 17:54:48 +01:00
Xavier Leroy b2449a3120 Document hexadecimal floating-point literals. 2015-12-05 12:10:36 +01:00
alainfrisch 6b9d72d532 A new builtin attribute ocaml.deprecated_mutable; can be applied to a record label so as to trigger a Deprecated warning if the field is mutated. 2015-12-02 18:20:24 +01:00
alainfrisch 0121d05c90 Update manual. 2015-12-02 12:04:58 +01:00
Jacques Garrigue ed1c289836 update documentation for ocamldep 2015-12-01 00:54:22 +09:00
Alain Frisch 9a09b322a5 Promote 'let module' to core language. 2015-11-30 14:33:24 +01:00
Alain Frisch 32e00b063c Lazy expressions promoted to core language. 2015-11-30 14:17:25 +01:00