PR#6885: documentation for index operators
PR#6885: documentation for index operators

Patch Author: octachron <octa@polychoron.fr>

This commit documents the new syntax for index operators
(.(), .[], .{}) and updates the documentation of the bigarray
specific syntax:

  * A new section "Customizable index operators" (7.28) describes the
  index operator syntax. Within this section, two subsections details
  respectively the particularities of the multidimensional index
  operator (.{}) and some potential source compatibility problem with
  the previous  bigarray specific syntax.

  * The "Syntax for bigarray access" section (7.21) has been partially
  removed and only mention that this extension has been superseded by
  the new extension and deprecated, with forward references to the new
  section 7.28 and compatibility subsection

  TODO:
  * The documentation would have to be updated again when/if the
  mantis issue #6765 is integrated in trunk : for now, the
  documentation only mention that using the ( .{} ) syntax without
  opening the Bigarray module is "deprecated".

git-svn-id: e40234e4c881bffaae8eee4067ddafaf89232d37@16195 f963ae5c-01c2-4b8c-9fe0-0dff7051ff02

eliberis/ocaml,eliberis/ocaml,yunxing/ocaml,msprotz/ocaml,gerdstolpmann/ocaml,eliberis/ocaml,eliberis/ocaml,yunxing/ocaml,gerdstolpmann/ocaml,yunxing/ocaml,gerdstolpmann/ocaml,msprotz/ocaml,eliberis/ocaml,yunxing/ocaml,msprotz/ocaml,yunxing/ocaml,msprotz/ocaml,gerdstolpmann/ocaml,msprotz/ocaml,gerdstolpmann/ocaml