Commit Graph

867 Commits (c4e8117c2bf2b17e60c5d141456a3628d150513c)

Author SHA1 Message Date
Gabriel Scherer e83607d8b6 remove ocamlbuild from the manual
We leave a gutted-out chapter with a redirection to the github page
for stability of anchors and to inform users.
2016-02-18 11:41:20 -05:00
Damien Doligez ee8f71101b clean up whitespace and cut long lines 2016-02-17 13:36:27 +01:00
Damien Doligez 2a3e2176eb rename LICENSE file for the manual 2016-02-16 13:22:57 +01:00
Damien Doligez c28749fc01 remove old .cvsignore files 2016-02-16 13:21:44 +01:00
octachron 58c6347420 Manual: fix toplevel directives 2016-02-11 22:16:47 +01:00
octachron 461b2597c2 Manual: immediate attribute 2016-02-11 16:56:22 +01:00
octachron 213f51a77b Manual: synchronize the manual and toplevel help 2016-02-11 16:56:16 +01:00
Damien Doligez 7715890db2 document GPR#234: Allow ``[]`` as a user-defined constructor 2016-02-08 18:23:04 +01:00
Damien Doligez e92e57d456 document GPR#112: octal escape sequences for char and string literals 2016-02-08 18:13:51 +01:00
Drup a917a29c9c Manual for attributes. 2016-02-05 14:47:09 +01:00
Drup 5775d99388 Manual for extension shortcut. 2016-02-05 14:47:09 +01:00
David Allsopp fe4b643c4e Support OCAML_FLEXLINK environment variable
OCAML_FLEXLINK is inspected by ocamlopt, ocamlc and ocamlmklib and allows
the flexlink command to be overriden. This is primarily intended as a
solution for bootstrapping OCaml with FlexDLL, thus allowing a bytecode
image of flexlink launched with ocamlrun to be executed, instead of
requiring flexlink to be in PATH.
2016-01-15 17:07:11 +00:00
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