From 39b96bbf415d65f9c09e94fe9c3a6d19980109fe Mon Sep 17 00:00:00 2001
From: Steve Gates <stgates@microsoft.com>
Date: Mon, 21 Jul 2014 18:31:00 -0700
Subject: [PATCH] Add documentation for the windows-api feature..

---
 doc/src/reference.xml | 49 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/doc/src/reference.xml b/doc/src/reference.xml
index ba5b1ead3..655e9e913 100644
--- a/doc/src/reference.xml
+++ b/doc/src/reference.xml
@@ -1160,6 +1160,55 @@ using msvc : &toolset_ops; ;
             options depending on the value of the<code>instruction-set</code>
             feature.</para>
           </section>
+          
+          <section id="v2.reference.tools.compiler.msvc.winrt">
+            <title>Windows Runtime support</title>
+
+            <indexterm><primary>Windows Runtime support</primary>
+            <secondary>Microsoft Visual Studio</secondary></indexterm>
+
+            <para>
+            Starting with version 11.0, Microsoft Visual Studio can
+            produce binaries for Windows Store and Phone in addition to 
+            traditional Win32 desktop. To specify which Windows API set
+            to target use the <command>windows-api</command> feature.
+            Available options are <command>desktop</command>, 
+            <command>store</command>, or <command>phone</command>. If not
+            specified, <command>desktop</command> will be used.
+            </para>
+            
+            <para>
+            When using <command>store</command> or <command>phone</command>
+            the specified toolset determines what Windows version is 
+            targeted. The following options are available:
+            </para>
+
+            <itemizedlist>
+              <listitem><para>Windows 8.0: toolset=msvc-11.0 windows-api=store</para>
+              </listitem>
+              <listitem><para>Windows 8.1: toolset=msvc-12.0 windows-api=store</para>
+              </listitem>
+              <listitem><para>Windows Phone 8.0: toolset=msvc-11.0 windows-api=phone</para>
+              </listitem>
+              <listitem><para>Windows Phone 8.1: toolset=msvc-12.0 windows-api=phone</para>
+              </listitem>
+            </itemizedlist>
+
+            <para>
+            For example use the following to build for Windows Store 8.1 
+            with the ARM architecture:
+            </para>
+            <programlisting>
+.\b2 toolset=msvc=12.0 windows-api=store architecture=arm</programlisting>
+            
+            <para>
+            Note that when targeting Windows Phone 8.1, version 12.0 didn't 
+            include the vcvars phone setup scripts. They can be separately 
+            downloaded from 
+            <ulink url="http://blogs.msdn.com/b/vcblog/archive/2014/07/18/using-boost-libraries-in-windows-store-and-phone-applications.aspx">here</ulink>.
+            </para>
+            
+          </section>
         </section>
 
         <section id="bbv2.reference.tools.compiler.intel">