From a9e71a822ca443c0e0772d954689ba86e9d288fa Mon Sep 17 00:00:00 2001
From: Jan Kaluza <jkaluza@redhat.com>
Date: Aug 17 2017 13:25:09 +0000
Subject: Update building-local.rst to mention --add-local-builds


---

diff --git a/source/development/building-modules/building-local.rst b/source/development/building-modules/building-local.rst
index 4c30dd4..eb45d4c 100644
--- a/source/development/building-modules/building-local.rst
+++ b/source/development/building-modules/building-local.rst
@@ -5,7 +5,7 @@ To build a modulemd, you need to have the
 `Module Build Service <https://pagure.io/fm-orchestrator>`__
 installed on your system.
 
-On **Fedora rawhide** and **Fedora 26**, install it by:
+Install it by:
 
 ::
 
@@ -15,21 +15,21 @@ On **Fedora rawhide** and **Fedora 26**, install it by:
 due to a missing runtime dependency declaration in the
 ``module-build-service`` RPM.
 
-On **Fedora 25**, install the latest version from
-`https://koji.fedoraproject.org/koji/packageinfo?packageID=23564`:
+Then add your user name to the mock group:
 
 ::
 
-    $ sudo dnf install mock-scm <URL_to_noarch_package>
+    $ sudo usermod -a -G mock myusername
 
-To build your module, run a command similar to the following:
+To build your module, run a command similar to the following in local git
+repository with your module:
 
 ::
 
-    $ sudo mbs-build local
+    $ mbs-build local
 
 An output will be a yum/dnf repository beneath the modulebuild directory in the
-home of the user. Right now, using sudo, this will be root.
+home of the user.
 
 To test your local build environment on Fedora, the ``httpd`` module is a
 reasonable example module to start with::
@@ -48,3 +48,34 @@ reasonable example module to start with::
 
    Replacing that bulk download with proper build dependency management more
    generally is part of the work being undertaken in F27.
+
+Building against other locally built modules
+--------------------------------------------
+
+Normally, the Module Build Service obtains all the build-time dependencies of
+your module from the Koji server. In case you want to build multiple modules
+depending on each other, you can do it by ``--add-local-build`` (or ``-l``)
+Module Build Service option.
+
+Note that this option is available only in Module Build Service version 1.3.26 and
+higher.
+
+For example, to build a module against local build of ``perl`` module, you
+can do following:
+
+::
+
+    $ mbs-build local --add-local-build perl
+
+You can also specify multiple local module builds like this:
+
+::
+
+    $ msb-build local --add-local-build perl --add-local-build python
+
+You can even specify particular stream and version of the local module builds
+which should be used as a dependencies:
+
+::
+
+    $ mbs-build local -l perl:master -l python:master:2017080910103423