update README

README.md

@@ -1,10 +1,10 @@
 # AmigDev Docker Crosstools
 
-Currently AmigaOS 3.x, AmigaOS 4.x and MorphOS 3.9+ are supported. 
+Currently AmigaOS 3.x, AmigaOS 4.x and MorphOS 3.9+ are supported.
 WarpOS and AROS will get supported in the forseeable future
 
 ## Supported toolchains
-Platform | Toolchain | Supported 
+Platform | Toolchain | Supported
 ------------ | ------------ | -------------
 AmigaOS 3.x | @bebbo toolchain - gcc 6 | **Yes**
 AmigaOS 4.x | @sba1 adtools - gcc 8 | **Yes**
@@ -12,34 +12,77 @@ ## Supported toolchains
 ~WarpOS~ | ~gcc 6~ | Not yet
 ~AROS ABIv1 x86_64~ | ~AROS Team Official - gcc 9~ | Not yet
 ~AROS ABIv1 x86~ | ~AROS Team Official - gcc 9~ | Not yet
+~AROS ABIv0 x86~ | ~AROS Team Official - gcc 9~ | Not yet
 ~AROS ABIv1 ARM BE (RasPi)~ | ~AROS Team Official - gcc 9~ | Not yet
 
+## Build the Docker container
+
+Example for AROSv1 x86_64
+
+docker build -t "aros:arosv1-cross-toolchain" --rm -f x86_64-aros.docker .
+
+For other toolchains, use the appropriate Dockerfile:
+
+- AmigaOS 3.x (M680x0): m68k-amigaos.docker
+
+- AmigaOS 4.x (PPC): ppc-amigaos.docker
+
+- MorphOS (PPC): ppc-morphos.docker
+
+## Run the Docker container for compiling a third party application
 
 ### AmigaOS4.x example:
 ```bash
-docker run --rm \
-	-v ${PWD}:/work \
-	-v /path/to/extra/ppc-amigaos/lib:/tools/usr/lib \
-	-v /path/to/extra/ppc-amigaos/include:/tools/usr/include \
-	-it amigadev/crosstools:ppc-amigaos bash
+docker run
+
+    # Destroy the container, once exited.
+    # Comment this line out if you want to keep container after execution
+    # for debugging
+    --rm \
+
+    # expose to the container the following local directories
+    # format is:
+    # <local_dir>:<container_dir>
+    -v ${PWD}:/work \
+    -v /path/to/extra/ppc-amigaos/lib:/tools/usr/lib \
+    -v /path/to/extra/ppc-amigaos/include:/tools/usr/include \
+
+    # Pass current UID and GID to container, so that it can change the
+    # ownership of output files which are otherwise writen to outdir as
+    # root
+    -e USER=$( id -u ) -e GROUP=$( id -g ) \
+
+    # Use this Docker image and then enter into it using the shell
+    -it amigadev/crosstools:ppc-amigaos /bin/bash
 ```
 
 ### AmigaOS3.x example
 ```bash
 docker run --rm \
-	-v ${PWD}:/work \
-	-v /path/to/extra/m68k-amigaos/lib:/tools/usr/lib \
-	-v /path/to/extra/m68k-amigaos/include:/tools/usr/include \
-	-it amigadev/crosstools:m68k-amigaos bash
+    -v ${PWD}:/work \
+    -v /path/to/extra/m68k-amigaos/lib:/tools/usr/lib \
+    -v /path/to/extra/m68k-amigaos/include:/tools/usr/include \
+    -e USER=$( id -u ) -e GROUP=$( id -g ) \
+    -it amigadev/crosstools:m68k-amigaos bash
 ```
 
 ### MorphOS example
 ```bashS
 docker run --rm \
-	-v ${PWD}:/work \
-	-v /path/to/extra/ppc-morphos/lib:/tools/usr/lib \
-	-v /path/to/extra/ppc-morphos/include:/tools/usr/include \
-	-it amigadev/crosstools:ppc-morphos bash
+    -v ${PWD}:/work \
+    -v /path/to/extra/ppc-morphos/lib:/tools/usr/lib \
+    -v /path/to/extra/ppc-morphos/include:/tools/usr/include \
+    -e USER=$( id -u ) -e GROUP=$( id -g ) \
+    -it amigadev/crosstools:ppc-morphos bash
+```
+
+### ArosV1 x86_64 example
+```bashS
+docker run --rm \
+    -v ${PWD}:/work \
+    -v /tmp/aros:/tmp/aros \
+    -e USER=$( id -u ) -e GROUP=$( id -g ) \
+    -it aros:arosv1-cross-toolchain bash
 ```
 
 * *${PWD}* is the current dir