aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2018-11-26 15:19:58 +0100
committerLoïc Hoguin <[email protected]>2018-11-26 15:20:09 +0100
commit54df98c780eec454a4ac0a9357c7e7a8a837c0b9 (patch)
treecf8131c626805ef18971cf7286c0a672f5426778 /doc
parent5d710a24027dd56f5c0d9b3d3b4c85055440df44 (diff)
downloaderlang.mk-54df98c780eec454a4ac0a9357c7e7a8a837c0b9.tar.gz
erlang.mk-54df98c780eec454a4ac0a9357c7e7a8a837c0b9.tar.bz2
erlang.mk-54df98c780eec454a4ac0a9357c7e7a8a837c0b9.zip
Add a guide section about dealing with duplicate modules
While the solution is not the best we could do it's better than nothing.
Diffstat (limited to 'doc')
-rw-r--r--doc/src/guide/deps.asciidoc22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/src/guide/deps.asciidoc b/doc/src/guide/deps.asciidoc
index 47e1bee..3ba7a39 100644
--- a/doc/src/guide/deps.asciidoc
+++ b/doc/src/guide/deps.asciidoc
@@ -515,6 +515,28 @@ projects using the `NO_AUTOPATCH` variable:
[source,make]
NO_AUTOPATCH = cowboy ranch cowlib
+=== Dealing with duplicate modules
+
+When there are duplicate modules found in both applications
+and their dependencies, some tasks may fail. Erlang expects
+modules to be unique in general.
+
+When the duplicates are found in dependencies, you will need
+to remove one of the duplicates at fetch time. To do so, you
+can add a rule similar to this to your Makefile before including
+'erlang.mk':
+
+[source,make]
+----
+DEPS_DIR = $(CURDIR)/deps
+
+deps:: $(DEPS_DIR)/cowlib
+ $(verbose) rm -f $(DEPS_DIR)/cowlib/src/cow_ws.erl
+----
+
+This must be done from the application that has this dependency.
+Only define the `DEPS_DIR` variable if necessary.
+
=== Skipping deps
It is possible to temporarily skip all dependency operations.