Author: buildbot
Date: Fri May 22 23:06:39 2015
New Revision: 952367
Log:
Staging update by buildbot for thrift
Modified:
websites/staging/thrift/trunk/content/ (props changed)
websites/staging/thrift/trunk/content/docs/install/windows.html
Propchange: websites/staging/thrift/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri May 22 23:06:39 2015
@@ -1 +1 @@
-1680416
+1681248
Modified: websites/staging/thrift/trunk/content/docs/install/windows.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/install/windows.html (original)
+++ websites/staging/thrift/trunk/content/docs/install/windows.html Fri May 22
23:06:39 2015
@@ -74,15 +74,32 @@
<div class="container">
<h2 id="windows-setup">Windows Setup</h2>
-<p>The windows compiler is available as a prebuilt exe available <a
href="/download">here</a></p>
-<h2 id="windows-setup-from-source">Windows setup from source</h2>
-<h3 id="basic-requirements-for-win32">Basic requirements for win32</h3>
-<p>Thrift's compiler is written in C++ and designed to be portable, but there
are some system requirements:</p>
+<p>The Thrift environment consists of two main parts: The Thrift compiler EXE
and the language-dependent libraries. Most of these libraries will require some
kind of build and/or installation. But regarding the Thrift compiler utility
there are a number of different alternatives. </p>
+<p>The first one of these alternatives is to download the <strong>pre-built
Thrift Compiler EXE</strong> and only build the libraries needed from source,
following one of the "Setup from source" methods outlined below.</p>
+<p>The other two options are to build the Thrift compiler from source. The
most recommended way to achieve this is by means of the <strong>Visual Studio
C++ build project</strong>. Alternatively, the Thrift compiler can also be
built via <strong>Cygwin</strong> or <strong>MinGW</strong> build environments,
however this method is not only less comfortable, but more time-consuming and
requires much more manual effort. </p>
+<h2 id="prebuilt-thrift-compiler">Prebuilt Thrift compiler</h2>
+<p>The windows Thrift compiler is available as a prebuilt exe available <a
href="/download">here</a>. Note that there is no installation tool, rather this
EXE file <em>is</em> already the Thrift compiler utility. Download the file and
put it into some suitable location of your choice.</p>
+<p>Now pick one of the "Build and install target libraries" below to
continue.</p>
+<h2 id="setup-from-source-via-visual-studio-c-recommended">Setup from source
via Visual Studio C++ (recommended)</h2>
+<h3 id="requirements">Requirements</h3>
+<p>Thrift's compiler is written in C++ and designed to be portable, but there
are some system requirements. Thrift's runtime libraries are written in various
languages, which are also required for the particular language interface.</p>
<ul>
-<li>Cygwin or MinGW</li>
+<li>Visual Studio C++, any recent version should do</li>
+<li>Flex and Bison, e.g. the WinFlexBison package</li>
+<li><a href="/docs/install">Apache Thrift Requirements</a></li>
+</ul>
+<h3 id="build-and-install-the-compiler">Build and install the compiler</h3>
+<p>After all requirements are in place, use the
<code>compiler/cpp/compiler.vcxproj</code> build project to build the Thrift
compiler. Copy the resulting EXE file to a location of your choice. </p>
+<h3 id="build-and-install-target-libraries">Build and install target
libraries</h3>
+<p>A few of the target language libraries also do provide Visual Studio
project files, such as C++ and C#. These are located in the
<code>lib/<language>/</code> folders. </p>
+<p>Most of the language packages must be built and installed manually using
build tools better suited to those languages. Typical examples are Java, Ruby,
Delphi, or PHP. Look for the <code>README.md</code> file in the
<code>lib/<language>/</code> folder for more details on how to build and
install each language's library package.</p>
+<h2 id="setup-from-source-via-cygwin">Setup from source via Cygwin</h2>
+<h3 id="requirements_1">Requirements</h3>
+<p>Thrift's compiler is written in C++ and designed to be portable, but there
are some system requirements. Thrift's runtime libraries are written in various
languages, which are also required for the particular language interface.</p>
+<ul>
+<li>Cygwin or MinGW </li>
<li><a href="/docs/install">Apache Thrift Requirements</a></li>
</ul>
-<p>Thrift's runtime libraries are written in various languages, which are also
required for the particular language interface.</p>
<h3 id="installing-from-source">Installing from source</h3>
<p>If you are building from the first time out of the source repository, you
will need to generate the configure scripts. (This is not necessary if you
downloaded a tarball.) From the top directory, do:</p>
<div class="codehilite"><pre><span class="o">./</span><span
class="n">bootstrap</span><span class="p">.</span><span class="n">sh</span>
@@ -107,8 +124,8 @@
</pre></div>
-<p>Some language packages must be installed manually using build tools better
suited to those languages (at the time of this writing, this applies to Java,
Ruby, PHP).</p>
-<p>Look for the README file in the <code>lib/<language>/</code> folder
for more details on the installation of each language library package.</p>
+<h3 id="build-and-install-target-libraries_1">Build and install target
libraries</h3>
+<p>Some language packages must be installed manually using build tools better
suited to those languages. Typical examples are Java, Ruby, or PHP. Look for
the README file in the <code>lib/<language>/</code> folder for more
details on the installation of each language library package.</p>
<h3 id="possible-issues-with-cygwin-install">Possible issues with Cygwin
install</h3>
<p>See also Possible issues with MinGW install.</p>
<h4 id="syntax-error-in-configure">Syntax error in ./configure</h4>
@@ -151,8 +168,14 @@
<p>If your thrift C++ programs segfault on throw after fork()ing, compile them
with g++-3.</p>
<p>The issue and patch are described on the Cygwin mailing list at
http://cygwin.com/ml/cygwin/2010-05/msg00203.html</p>
<p>This issue should be fixed in Cygwin versions after 1.7.5-1, or g++
4.5.0.</p>
-<h2 id="installation-from-source-no-cygwin-dependency">Installation from
Source (No Cygwin dependency)</h2>
-<p>To compile the Thrift generator & runtime libraries (untested) without
the cygwin.dll dependency you need to install MinGW (www.mingw.org). In
addition you need to add the following entry to your windows PATH variable.</p>
+<h2 id="setup-from-source-via-mingw">Setup from source via MinGW</h2>
+<h3 id="requirements_2">Requirements</h3>
+<p>To compile the Thrift generator & runtime libraries (untested) without
the cygwin.dll dependency you need to install MinGW (www.mingw.org). </p>
+<ul>
+<li>MinGW </li>
+<li><a href="/docs/install">Apache Thrift Requirements</a></li>
+</ul>
+<p>In addition you need to add the following entry to your windows PATH
variable.</p>
<div class="codehilite"><pre><span class="n">C</span><span
class="p">:</span><span class="o">\</span><span class="n">MINGW</span><span
class="o">\</span><span class="n">BIN</span>
</pre></div>
@@ -194,7 +217,7 @@
<p>Make sure you add -lfl in your cxxflags in Makefile, also try adding
-Lc:/cygwin/libs</p>
<h4 id="boost-is-not-found">boost is not found</h4>
<p>Try and change the include dir to use the windows path from c like this:
Edit compiler/cpp/Makefile, look for the declaration of BOOST_CPPFLAGS, change
that line for</p>
-<div class="codehilite"><pre><span class="n">BOOST_CPPFLAGS</span> <span
class="p">=</span> <span class="o">-</span><span class="n">Ic</span><span
class="p">:</span><span class="o">/</span><span class="n">cygwin</span><span
class="o">/</span><span class="n">usr</span><span class="o">/</span><span
class="n">include</span><span class="o">/</span><span
class="n">boost</span><span class="o">-</span>1<span class="n">_33_1</span>
+<div class="codehilite"><pre><span class="n">BOOST_CPPFLAGS</span> <span
class="p">=</span> <span class="o">-</span><span class="n">Ic</span><span
class="p">:</span><span class="o">/</span><span class="n">cygwin</span><span
class="o">/</span><span class="n">usr</span><span class="o">/</span><span
class="n">include</span><span class="o">/</span><span
class="n">boost</span><span class="o">-</span>1<span class="n">_53_0</span>
</pre></div>
