From aa6fab56bef9c3836068bac69355e7f84f183e10 Mon Sep 17 00:00:00 2001
From: Brett Randall <javabrett@gmail.com>
Date: Tue, 19 Dec 2017 11:01:21 +1100
Subject: Added a multi-stage build example using portage to README.md.

Fixed #35.
---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 3ceb3b1..5e24bf9 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,27 @@ docker create -v /usr/portage --name myportagesnapshot gentoo/portage:latest /bi
 docker run --volumes-from myportagesnapshot gentoo/stage3-amd64:latest /bin/bash
 ```
 
+# Using the portage container in a multi-stage build
+
+docker-17.05.0 or later supports multi-stage builds, allowing the portage volume to be used when creating images based on a stage3 image.
+
+Example _Dockerfile_
+
+```
+# name the portage image
+FROM gentoo/portage:latest as portage
+
+# image is based on stage3-amd64
+FROM gentoo/stage3-amd64:latest
+
+# copy the entire portage volume in
+COPY --from=portage /usr/portage /usr/portage
+
+# continue with image build ...
+RUN emerge -qv www-servers/apache # or whichever packages you need
+```
+
+
 # Contributing
 
 We'd love to hear any ideas.  Feel free to contact us via any of the following
-- 
cgit v1.2.3-18-g5258