From ed5888ba30b0301ff763feae68020ba4190f04df Mon Sep 17 00:00:00 2001
From: jlp765 <jlp765@gmail.com>
Date: Mon, 17 Jul 2017 18:42:40 +1000
Subject: [PATCH] Compiler selection doco (#6115)

* Slices indices explanation

as per https://forum.nim-lang.org/t/2870

* Remove duplicate in note

* Doco: Selecting a different compiler
---
 doc/nimc.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/nimc.rst b/doc/nimc.rst
index 5d9ed03ab6..7b5a466294 100644
--- a/doc/nimc.rst
+++ b/doc/nimc.rst
@@ -189,6 +189,22 @@ resides in its own directory so that the generated ``nimcache`` directory
 is not shared between different projects.
 
 
+Compiler Selection
+==================
+
+To change the compiler from the default compiler (at the command line)::
+
+  nim c --cc:llvm_gcc --compile_only myfile.nim
+
+This uses the configuration defined in ``config\nim.cfg`` for ``lvm_gcc``.
+
+If nimcache already contains compiled code from a different compiler for the same project,
+add the ``-f`` flag to force all files to be recompiled.
+
+The default compiler is defined at the top of ``config\nim.cfg``.  Changing this setting
+affects the compiler used by ``koch`` to (re)build Nim.
+
+
 Cross compilation
 =================