diff options
| author | coqbot-app[bot] | 2020-11-12 11:10:52 +0000 |
|---|---|---|
| committer | GitHub | 2020-11-12 11:10:52 +0000 |
| commit | 0245aa233e671372e9d3fb34f3b34706fd9f4bf7 (patch) | |
| tree | 9774cf8d926dfae812e055fd077ba236b711198a /doc/sphinx/proof-engine | |
| parent | 9dfc627ccac11b46bc11bcc11e9609b952d35fdd (diff) | |
| parent | b7200b190c8422ccd417c27d3e074f0ba7d7accd (diff) | |
Merge PR #13345: Addressing #13344: clarifying the role of Add ML Path vs -I
Reviewed-by: ejgallego
Reviewed-by: Zimmi48
Ack-by: ppedrot
Ack-by: jfehrle
Diffstat (limited to 'doc/sphinx/proof-engine')
| -rw-r--r-- | doc/sphinx/proof-engine/vernacular-commands.rst | 23 |
1 files changed, 13 insertions, 10 deletions
diff --git a/doc/sphinx/proof-engine/vernacular-commands.rst b/doc/sphinx/proof-engine/vernacular-commands.rst index 36c722bf9b..7baf193266 100644 --- a/doc/sphinx/proof-engine/vernacular-commands.rst +++ b/doc/sphinx/proof-engine/vernacular-commands.rst @@ -640,8 +640,9 @@ file is a particular case of a module called a *library file*. This commands dynamically loads OCaml compiled code from a :n:`.mllib` file. It is used to load plugins dynamically. The - files must be accessible in the current OCaml loadpath (see the - command :cmd:`Add ML Path`). The :n:`.mllib` suffix may be omitted. + files must be accessible in the current OCaml loadpath (see + :ref:`command line option <command-line-options>` :n:`-I` and command :cmd:`Add ML Path`). The + :n:`.mllib` suffix may be omitted. This command is reserved for plugin developers, who should provide a .v file containing the command. Users of the plugins will then generally @@ -719,17 +720,19 @@ the toplevel, and using them in source files is discouraged. .. cmd:: Add ML Path @string - This command adds the path :n:`@string` to the current OCaml - loadpath (cf. :cmd:`Declare ML Module`). - + Equivalent to the :ref:`command line option <command-line-options>` + :n:`-I @string`. Adds the path :n:`@string` to the current OCaml + loadpath (cf. :cmd:`Declare ML Module`). It is for + convenience, such as for use in an interactive session, and it + is not exported to compiled files. For separation of concerns with + respect to the relocability of files, we recommend using + :n:`-I @string`. .. cmd:: Print ML Path - This command displays the current OCaml loadpath. This - command makes sense only under the bytecode version of ``coqtop``, i.e. - using option ``-byte`` - (cf. :cmd:`Declare ML Module`). - + Displays the current OCaml loadpath, as provided by + the :ref:`command line option <command-line-options>` :n:`-I @string` or by the command :cmd:`Add + ML Path` `@string` (cf. :cmd:`Declare ML Module`). .. _backtracking_subsection: |