package merlin-lib

You can search for identifiers within the package.

in-package search v0.2.0

Merlin's libraries

Install

dune-project

Dependency

github.com Readme Changelog Edit opam file Versions (18)

Authors

T

The Merlin team

Maintainers

D

defree@gmail.com

Sources

merlin-5.8-505.tbz

sha256=5642cde8486a84aad98fa5c590b70e8dcc6074d7fbdb3b9b8c46b2c5b42f653b

sha512=1d7a7751157e393d3ae248ef5ae24a6b4e81430666c61cc51a3d0ec35804523317036f3d7a3c7f18a7554337f4e5f5989fb677865b261ece3fd2b317903570ba

doc/merlin-lib.utils/Merlin_utils/Lib_config/System/index.html

Module `Lib_config.System`Source

Merlin spawns child processes for preprocessors (pp and ppx), which can be customized via System

Source

val set_run_in_directory : 
  (prog:string ->
    prog_is_quoted:bool ->
    args:string list ->
    cwd:string ->
    ?stdin:string ->
    ?stdout:string ->
    ?stderr:string ->
    unit ->
    [ `Finished of int | `Cancelled ]) ->
  unit

set_run_in_directory sets an implementation for spawning external programs. This is used by Merlin to spawn preprocessors and ppxes. For compatibility reasons, there are currently some limitations to how this should be implemented:

Implementation should expect prog to be already quoted and contain arguments. This is due to how ppx configuration is passed to Merlin. In order to prepare a future transition to more sane argument passing, the implementation can look at the prog_is_quoted argument to know if it is actually safe to quote the command normally (using Filename.quote_command for example).

prog might contain shell expansions, command substitutions etc. It should therefore be ran under a shell for maximum compatibility. However this should never happen when the configuration is generated by Dune.

Programs runned by this function should never output on stdout since it is the channel used by Merlin to communicate with the editor. One way to enforce that is to redirect stdout to stderr.

As of today Merlin handles the `Cancelled return case identically as other error codes.