Author: buildbot
Date: Sat Sep 26 12:54:26 2015
New Revision: 966892
Log:
Staging update by buildbot for thrift
Modified:
websites/staging/thrift/trunk/content/ (props changed)
websites/staging/thrift/trunk/content/about.html
websites/staging/thrift/trunk/content/developers.html
websites/staging/thrift/trunk/content/docs/BuildingFromSource.html
websites/staging/thrift/trunk/content/docs/HowToContribute.html
websites/staging/thrift/trunk/content/docs/HowToNewLanguage.html
websites/staging/thrift/trunk/content/docs/committers/AdditionalReading.html
websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html
websites/staging/thrift/trunk/content/docs/committers/HowToPublish.html
websites/staging/thrift/trunk/content/docs/committers/HowToRelease.html
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
websites/staging/thrift/trunk/content/docs/committers/HowToVersion.html
websites/staging/thrift/trunk/content/docs/committers/index.html
websites/staging/thrift/trunk/content/docs/concepts.html
websites/staging/thrift/trunk/content/docs/features.html
websites/staging/thrift/trunk/content/docs/idl.html
websites/staging/thrift/trunk/content/docs/index.html
websites/staging/thrift/trunk/content/docs/install/centos.html
websites/staging/thrift/trunk/content/docs/install/debian.html
websites/staging/thrift/trunk/content/docs/install/index.html
websites/staging/thrift/trunk/content/docs/install/os_x.html
websites/staging/thrift/trunk/content/docs/install/windows.html
websites/staging/thrift/trunk/content/docs/types.html
websites/staging/thrift/trunk/content/download.html
websites/staging/thrift/trunk/content/index.html
websites/staging/thrift/trunk/content/lib/c_glib.html
websites/staging/thrift/trunk/content/lib/cpp.html
websites/staging/thrift/trunk/content/lib/csharp.html
websites/staging/thrift/trunk/content/lib/d.html
websites/staging/thrift/trunk/content/lib/delphi.html
websites/staging/thrift/trunk/content/lib/erl.html
websites/staging/thrift/trunk/content/lib/go.html
websites/staging/thrift/trunk/content/lib/haxe.html
websites/staging/thrift/trunk/content/lib/hs.html
websites/staging/thrift/trunk/content/lib/index.html
websites/staging/thrift/trunk/content/lib/java.html
websites/staging/thrift/trunk/content/lib/js.html
websites/staging/thrift/trunk/content/lib/nodejs.html
websites/staging/thrift/trunk/content/lib/ocaml.html
websites/staging/thrift/trunk/content/lib/perl.html
websites/staging/thrift/trunk/content/lib/php.html
websites/staging/thrift/trunk/content/lib/py.html
websites/staging/thrift/trunk/content/lib/rb.html
websites/staging/thrift/trunk/content/lib/st.html
websites/staging/thrift/trunk/content/mailing.html
websites/staging/thrift/trunk/content/sitemap.html
websites/staging/thrift/trunk/content/test/ThriftTest.html
websites/staging/thrift/trunk/content/test/index.html
websites/staging/thrift/trunk/content/test/keys.html
websites/staging/thrift/trunk/content/tutorial/as3.html
websites/staging/thrift/trunk/content/tutorial/c_glib.html
websites/staging/thrift/trunk/content/tutorial/cpp.html
websites/staging/thrift/trunk/content/tutorial/csharp.html
websites/staging/thrift/trunk/content/tutorial/d.html
websites/staging/thrift/trunk/content/tutorial/delphi.html
websites/staging/thrift/trunk/content/tutorial/go.html
websites/staging/thrift/trunk/content/tutorial/graphviz.html
websites/staging/thrift/trunk/content/tutorial/haxe.html
websites/staging/thrift/trunk/content/tutorial/hs.html
websites/staging/thrift/trunk/content/tutorial/index.html
websites/staging/thrift/trunk/content/tutorial/java.html
websites/staging/thrift/trunk/content/tutorial/js.html
websites/staging/thrift/trunk/content/tutorial/nodejs.html
websites/staging/thrift/trunk/content/tutorial/ocaml.html
websites/staging/thrift/trunk/content/tutorial/perl.html
websites/staging/thrift/trunk/content/tutorial/php.html
websites/staging/thrift/trunk/content/tutorial/py.html
websites/staging/thrift/trunk/content/tutorial/rb.html
Propchange: websites/staging/thrift/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sat Sep 26 12:54:26 2015
@@ -1 +1 @@
-1683859
+1705448
Modified: websites/staging/thrift/trunk/content/about.html
==============================================================================
--- websites/staging/thrift/trunk/content/about.html (original)
+++ websites/staging/thrift/trunk/content/about.html Sat Sep 26 12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <p>Apache Thrift is a software project spanning a variety of
programming languages and use cases. Our goal is to make reliable, performant
communication and data serialization across languages as efficient and seamless
as possible. Originally developed at Facebook, Thrift was open sourced in April
2007 and entered the Apache Incubator in May, 2008. Thrift became an Apache TLP
in October, 2010. </p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>Apache Thrift is a software project spanning a variety of programming
languages and use cases. Our goal is to make reliable, performant communication
and data serialization across languages as efficient and seamless as possible.
Originally developed at Facebook, Thrift was open sourced in April 2007 and
entered the Apache Incubator in May, 2008. Thrift became an Apache TLP in
October, 2010. </p>
<p>Apache Thrift aims to embody the following values:</p>
<ul>
<li>
@@ -94,8 +105,8 @@
</li>
</ul>
<hr />
-<h2 id="project-team">Project Team</h2>
-<h3 id="committers">Committers</h3>
+<h2 id="project-team">Project Team<a class="headerlink" href="#project-team"
title="Permanent link">¶</a></h2>
+<h3 id="committers">Committers<a class="headerlink" href="#committers"
title="Permanent link">¶</a></h3>
<div class="committers">
<table class="table table-bordered table-striped">
<tbody>
@@ -250,18 +261,18 @@
</table>
</div>
-<h3 id="champion">Champion</h3>
+<h3 id="champion">Champion<a class="headerlink" href="#champion"
title="Permanent link">¶</a></h3>
<ul>
<li>Doug Cutting</li>
</ul>
-<h3 id="mentors">Mentors</h3>
+<h3 id="mentors">Mentors<a class="headerlink" href="#mentors" title="Permanent
link">¶</a></h3>
<ul>
<li>Paul Querna</li>
<li>Upayavira</li>
<li>Jason van Zyl</li>
</ul>
<hr />
-<h2 id="powered-by-apache-thrift">Powered by Apache Thrift</h2>
+<h2 id="powered-by-apache-thrift">Powered by Apache Thrift<a
class="headerlink" href="#powered-by-apache-thrift" title="Permanent
link">¶</a></h2>
<p>The following companies are known to employ Apache Thrift in their
production services.</p>
<div class="committers">
<table class="table table-bordered table-striped">
@@ -321,6 +332,11 @@
<td class="website"><a
href="http://www.siemens.com";>http://www.siemens.com</a></td>
</tr>
+ <tr class="">
+ <td class="company">Uber</td>
+ <td class="website"><a
href="http://uber.com";>http://uber.com</a></td>
+ </tr>
+
</tbody>
</table>
</div>
Modified: websites/staging/thrift/trunk/content/developers.html
==============================================================================
--- websites/staging/thrift/trunk/content/developers.html (original)
+++ websites/staging/thrift/trunk/content/developers.html Sat Sep 26 12:54:26
2015
@@ -73,17 +73,28 @@
</div>
<div class="container">
- <h2 id="contributing">Contributing</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="contributing">Contributing<a class="headerlink" href="#contributing"
title="Permanent link">¶</a></h2>
<p>Anyone interested in contributing to Apache Thrift should read the <a
href="/docs/HowToContribute">How to Contribute</a> guide prior to submitting
any patches to <a href="http://issues.apache.org/jira/browse/THRIFT";>Jira</a>.
There's also a short guide on <a href="/docs/HowToNewLanguage">how to add new
language bindings</a>. If you have any questions about this please <a
href="/mailing">contact us</a>.</p>
<hr />
-<h2 id="issue-tracking">Issue Tracking</h2>
+<h2 id="issue-tracking">Issue Tracking<a class="headerlink"
href="#issue-tracking" title="Permanent link">¶</a></h2>
<p>Apache Thrift tracks both bugs and enhancements using <a
href="http://issues.apache.org/jira/browse/THRIFT";>Jira</a>. Before filing new
requests, we ask that you first do the following:</p>
<ul>
<li>Search the <a href="http://issues.apache.org/jira/browse/THRIFT";>Jira</a>
database</li>
<li>Check the <a href="/mailing">user mailing list</a> via searching the
archives or asking a question</li>
</ul>
<hr />
-<h2 id="source-control">Source Control</h2>
+<h2 id="source-control">Source Control<a class="headerlink"
href="#source-control" title="Permanent link">¶</a></h2>
<p>The Apache Thrift source code resides in the Apache git repository. Four
types of access are available:</p>
<ul>
<li>
Modified: websites/staging/thrift/trunk/content/docs/BuildingFromSource.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/BuildingFromSource.html
(original)
+++ websites/staging/thrift/trunk/content/docs/BuildingFromSource.html Sat Sep
26 12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <h2 id="building-from-source">Building from source</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="building-from-source">Building from source<a class="headerlink"
href="#building-from-source" title="Permanent link">¶</a></h2>
<p>First make sure your system meets all necessary <a
href="/docs/install">Apache Thrift Requirements</a></p>
<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 released 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>
@@ -128,7 +139,7 @@ From the top directory, do:</p>
</pre></div>
-<h3 id="issues-while-compiling">Issues while compiling</h3>
+<h3 id="issues-while-compiling">Issues while compiling<a class="headerlink"
href="#issues-while-compiling" title="Permanent link">¶</a></h3>
<ul>
<li>
<p>"compiler/cpp/thriftl.cc:2190: undefined reference to `yywrap'"</p>
@@ -149,7 +160,7 @@ From the top directory, do:</p>
<p>Although the thrift compiler build appears to be compatible with parallel
make without libtool lock, the thrift runtime build is not.</p>
</li>
</ul>
-<h2 id="installing">Installing</h2>
+<h2 id="installing">Installing<a class="headerlink" href="#installing"
title="Permanent link">¶</a></h2>
<p>From the top directory, become superuser and do:</p>
<div class="codehilite"><pre><span class="n">make</span> <span
class="n">install</span>
</pre></div>
Modified: websites/staging/thrift/trunk/content/docs/HowToContribute.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/HowToContribute.html (original)
+++ websites/staging/thrift/trunk/content/docs/HowToContribute.html Sat Sep 26
12:54:26 2015
@@ -73,32 +73,47 @@
</div>
<div class="container">
- <h2 id="how-to-contribute">How to contribute</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="how-to-contribute">How to contribute<a class="headerlink"
href="#how-to-contribute" title="Permanent link">¶</a></h2>
<ol>
+<li>Help to review and verify existing patches</li>
<li>Make sure your issue is not all ready in the <a
href="http://issues.apache.org/jira/browse/THRIFT";>Jira issue tracker</a></li>
<li>If not, create a ticket describing the change you're proposing in the <a
href="http://issues.apache.org/jira/browse/THRIFT";>Jira issue tracker</a></li>
<li>Contribute your patch using one of the two methods below</li>
</ol>
-<h3 id="contributing-via-a-patch">Contributing via a patch</h3>
+<h3 id="contributing-via-a-patch">Contributing via a patch<a
class="headerlink" href="#contributing-via-a-patch" title="Permanent
link">¶</a></h3>
<ol>
<li>
<p>Check out the latest version of the source code</p>
-<ul>
-<li>git clone https://git-wip-us.apache.org/repos/asf/thrift.git thrift </li>
-</ul>
+</li>
+<li>
+<p>git clone https://git-wip-us.apache.org/repos/asf/thrift.git thrift</p>
</li>
<li>
<p>Modify the source to include the improvement/bugfix</p>
-<ul>
-<li>Verify that you follow the same CodingStyle you see within the language
you are working on</li>
-<li>Verify that your change works by adding a unit test.</li>
-</ul>
+</li>
+<li>
+<p>Remember to provide <em>tests</em> for all submited changes</p>
+</li>
+<li>When bugfixing: add test that will isolate bug <em>before</em> applying
change that fixes it</li>
+<li>
+<p>Verify that you follow <a href="/coding_standards">Thrift Coding
Standards</a> (you can run 'make style', which ensures proper format for some
languages)</p>
</li>
<li>
<p>Create a patch from project root directory (e.g. you@dev:~/thrift $ ):</p>
-<ul>
-<li>git diff > ../thrift-XXX-my-new-feature.patch</li>
-</ul>
+</li>
+<li>
+<p>git diff > ../thrift-XXX-my-new-feature.patch</p>
</li>
<li>
<p>Attach the newly generated patch to the issue</p>
@@ -106,24 +121,29 @@
<li>Wait for other contributors or committers to review your new addition</li>
<li>Wait for a committer to commit your patch</li>
</ol>
-<h3 id="contributing-via-github-pull-requests">Contributing via GitHub pull
requests</h3>
+<h3 id="contributing-via-github-pull-requests">Contributing via GitHub pull
requests<a class="headerlink" href="#contributing-via-github-pull-requests"
title="Permanent link">¶</a></h3>
<ol>
<li>Create a fork for http://github.com/apache/thrift</li>
-<li>Create a branch with the jira ticket number you are working on</li>
+<li>Create a branch for your changes(best practice is issue as branch name,
e.g. THRIFT-9999)</li>
<li>
<p>Modify the source to include the improvement/bugfix</p>
-<ul>
-<li>Verify that you follow the same CodingStyle you see within the language
you are working on</li>
-<li>Verify that your change works by adding a unit test. </li>
-</ul>
</li>
<li>
-<p>Issue a pull request for your new feature</p>
+<p>Remember to provide <em>tests</em> for all submited changes</p>
+</li>
+<li>When bugfixing: add test that will isolate bug <em>before</em> applying
change that fixes it</li>
+<li>Verify that you follow <a href="/coding_standards">Thrift Coding
Standards</a> (you can run 'make style', which ensures proper format for some
languages)</li>
+<li>
+<p>Verify that your change works on other platforms by adding a GitHub service
hook to <a
href="http://docs.travis-ci.com/user/getting-started/#Step-one%3A-Sign-in";>Travis
CI</a> and <a href="http://www.appveyor.com/docs";>AppVeyor</a></p>
+</li>
+<li>
+<p>Commit and push changes to your branch (please use issue name and
description as commit title, e.g. THRIFT-9999 make it perfect)</p>
</li>
+<li>Issue a pull request with the jira ticket number you are working on in
it's name</li>
<li>Wait for other contributors or committers to review your new addition</li>
<li>Wait for a committer to commit your patch</li>
</ol>
-<h3 id="more-info">More info</h3>
+<h3 id="more-info">More info<a class="headerlink" href="#more-info"
title="Permanent link">¶</a></h3>
<p>Plenty of information on why and how to contribute is available on the
Apache Software Foundation (ASF) web site. In particular, we recommend the
following:</p>
<ul>
<li><a href="http://www.apache.org/dev/contributors";>Contributors Tech
Guide</a></li>
Modified: websites/staging/thrift/trunk/content/docs/HowToNewLanguage.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/HowToNewLanguage.html (original)
+++ websites/staging/thrift/trunk/content/docs/HowToNewLanguage.html Sat Sep 26
12:54:26 2015
@@ -73,16 +73,27 @@
</div>
<div class="container">
- <h2 id="roadmap-for-adding-new-language-bindings">Roadmap for adding
new language bindings</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="roadmap-for-adding-new-language-bindings">Roadmap for adding new
language bindings<a class="headerlink"
href="#roadmap-for-adding-new-language-bindings" title="Permanent
link">¶</a></h2>
<p>When considering new language bindings, there are certain points to think
about. First, you should find out, if you are about to implement completely new
language bindings that are not yet supported with Thrift, or if you just want
to add support for a specific "flavour" of an already implemented language.</p>
-<h3
id="q-the-language-exists-but-it-lacks-support-for-feature-or-version-what-should-i-do">Q:
The language exists, but it lacks support for $feature or $version! What
should I do?</h3>
+<h3
id="q-the-language-exists-but-it-lacks-support-for-feature-or-version-what-should-i-do">Q:
The language exists, but it lacks support for $feature or $version! What
should I do?<a class="headerlink"
href="#q-the-language-exists-but-it-lacks-support-for-feature-or-version-what-should-i-do"
title="Permanent link">¶</a></h3>
<p>In that case, it is recommended to add the new feature as an option to the
existing language. For a good model on how to do this take look at the
js/nodejs implementations, or the various options that already exist for
Python. <code>thrift --help</code> gives a great start. Depending on the amount
of changes necessary, you will still find the rest of the document useful.</p>
-<h2 id="general-workflow">General workflow</h2>
-<h3 id="preparation">Preparation</h3>
+<h2 id="general-workflow">General workflow<a class="headerlink"
href="#general-workflow" title="Permanent link">¶</a></h2>
+<h3 id="preparation">Preparation<a class="headerlink" href="#preparation"
title="Permanent link">¶</a></h3>
<p>The good news is, although there is some work required, the process is not
as hard as it looks. First, make sure you have a fully functional build
environment and are able to <a href="/docs/BuildingFromSource">build the
compiler from source</a>. Read the <a href="/docs/HowToContribute">How to
Contribute</a> section to understand, how the general contribution process
works.</p>
<p>Next, search <a href="http://issues.apache.org/jira/browse/THRIFT";>Jira</a>
and maybe the mailing list archives. If you do not find anything similar,
create a new ticket, shortly describing what you are planning. If you are not
quite sure, ask on the <a href="/mailing">developer's mailing list</a>.</p>
<p>Now fork the <a href="https://thrift.apache.org/developers";>Apache Thrift
code base</a> on GitHub. Although we accept patch files, especially for
comparingly long-living feature branches (such as adding a new language) a
GitHub branch is much easier to handle.</p>
-<h3 id="implement-a-minimal-feature-set">Implement a minimal feature set</h3>
+<h3 id="implement-a-minimal-feature-set">Implement a minimal feature set<a
class="headerlink" href="#implement-a-minimal-feature-set" title="Permanent
link">¶</a></h3>
<ul>
<li>
<p>Implement the <a
href="https://github.com/apache/thrift/tree/master/compiler/cpp/src/generate";>code
generator</a>, typically by picking one from the existing pool that is close
to what you need. There are already plenty of languages supported, and you'll
find oop, procedural and functional styles. If in doubt, which one to choose of
the two or three candidates you found, head to the next point</p>
@@ -97,21 +108,21 @@
<p>Implement the <a
href="https://github.com/apache/thrift/tree/master/tutorial";>Tutorial code</a>
and test it against some other language. If you did everything well, this last
step is comparingly easy.</p>
</li>
</ul>
-<h3 id="the-minimal-feature-set">The minimal feature set</h3>
+<h3 id="the-minimal-feature-set">The minimal feature set<a class="headerlink"
href="#the-minimal-feature-set" title="Permanent link">¶</a></h3>
<p>The minimum required feature set should cover at least:</p>
<ul>
<li>Transports: Sockets, Buffered, Framed required, HTTP client
recommended</li>
<li>Protocols: Binary and Multiplex required, JSON recommended</li>
<li>Server types: SimpleServer required</li>
</ul>
-<h3 id="other-recommended-features">Other recommended features</h3>
+<h3 id="other-recommended-features">Other recommended features<a
class="headerlink" href="#other-recommended-features" title="Permanent
link">¶</a></h3>
<p>These are not strictly required in the first run, but are commonly used.
Depending on the language, some things may be easier to implement than others.
Alternatively, consider adding the features listed below later as additional
contributions instead of trying to press them into the initial contribution.
<strong>If in doubt, focus on quality rather than quantity</strong>.</p>
<ul>
<li>Transports: HTTP server, Pipes, NamedPipes (where it makes sense)</li>
<li>Protocols: Compact</li>
<li>Server types: Nonblocking, Threaded and/or Threadpool server
implementation</li>
</ul>
-<h3 id="final-things">Final things</h3>
+<h3 id="final-things">Final things<a class="headerlink" href="#final-things"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Add a <code>Readme.md</code> file to your library's folder, describing
requirements, dependencies and what else might be important. Look at the
existing Readme files if you are unsure about what to put into that file.</p>
@@ -123,7 +134,7 @@
<p>Your done, now open a pull request! </p>
</li>
</ul>
-<h2 id="remarks">Remarks</h2>
+<h2 id="remarks">Remarks<a class="headerlink" href="#remarks" title="Permanent
link">¶</a></h2>
<p>Note that the 4 implementation steps are not really a linear process, it is
more kind of an iteration. Even if the code that comes out of the generator
finally is compileable and does not spit out any warnings and seems to run
fine, you still will run into problems as you move on with implementing library
and tests. This is fully normal and expected.</p>
<p>It is a good idea to post your work early on the mailing lists, and to
create the JIRA ticket early - that's why this particular point is on top of
the list. This serves not only the purpose of announcing the work you are about
to do, it is also a good starting point for other people who might be just
looking for exactly that stuff. You will be able not only to get valuable early
feedback, but probably also be able to raise some support with implementation
and/or testing. Having someone else looking over your code (or reviewing each
other) is generally a good thing, especially with regard to the overall quality
of the contribution you are about to do.</p>
<p>Happy coding!</p>
Modified:
websites/staging/thrift/trunk/content/docs/committers/AdditionalReading.html
==============================================================================
---
websites/staging/thrift/trunk/content/docs/committers/AdditionalReading.html
(original)
+++
websites/staging/thrift/trunk/content/docs/committers/AdditionalReading.html
Sat Sep 26 12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <h2 id="useful-articles-for-committers">Useful articles for
committers</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="useful-articles-for-committers">Useful articles for committers<a
class="headerlink" href="#useful-articles-for-committers" title="Permanent
link">¶</a></h2>
<ul>
<li><a href="http://www.apache.org/dev/release.html";>ASF Releases FAQ</a></li>
<li><a href="http://www.apache.org/dev/release-signing.html";>Signing
Releases</a></li>
Modified: websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html
(original)
+++ websites/staging/thrift/trunk/content/docs/committers/HowToCommit.html Sat
Sep 26 12:54:26 2015
@@ -73,26 +73,39 @@
</div>
<div class="container">
- <h2
id="process-used-by-committers-to-review-and-submit-patches">Process used by
committers to review and submit patches</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="process-used-by-committers-to-review-and-submit-patches">Process used
by committers to review and submit patches<a class="headerlink"
href="#process-used-by-committers-to-review-and-submit-patches"
title="Permanent link">¶</a></h2>
<ol>
<li>
-<p>Make sure that there is an issue for the patch(s) you are about to commit
in our <a href="{{%20conf.jira_url%20}}">Jira issue tracker</a></p>
+<p>Make sure that there is an issue for the patch(s) you are about to commit
in our <a href="http://issues.apache.org/jira/browse/THRIFT";>Jira issue
tracker</a></p>
</li>
<li>
<p>Check out the latest version of the source code</p>
-<ul>
-<li>git clone https://git-wip-us.apache.org/repos/asf/thrift.git thrift </li>
-</ul>
+</li>
+<li>
+<p>git clone https://git-wip-us.apache.org/repos/asf/thrift.git thrift</p>
</li>
<li>
<p>Apply the patch</p>
-<ul>
-<li>curl https://issues.apache.org/jira/... |git apply
--ignore-space-change</li>
-</ul>
+</li>
+<li>
+<p>curl https://issues.apache.org/jira/... |git apply --ignore-space-change</p>
+</li>
+</ol>
<p>or</p>
<ul>
-<li>curl https://github.com/<GitHub User>/thrift/commit/<Commit ID>.patch |git
apply --ignore-space-change</li>
-</ul>
+<li>
+<p>curl https://github.com/<GitHub User>/thrift/commit/<Commit ID>.patch |git
apply --ignore-space-change</p>
</li>
<li>
<p>Inspect the applied patch to ensure that all <a
href="http://www.apache.org/licenses/LICENSE-2.0.html#contributions";>Legal
aspects on Submission of Contributions (Patches)</a> are met</p>
@@ -112,47 +125,30 @@
</li>
<li>
<p>The commit message should be in the format:</p>
-<div class="codehilite"><pre><span class="x">THRIFT-###:<Jira
description></span>
-<span class="x">Client: <component></span>
-<span class="x">Patch: <Name of person contributing the patch></span>
-
-<span class="x">Description of what was fixed or addressed.</span>
-
-<span class="cp"><%</span>
- <span class="k">if</span> <span class="n">this</span> <span
class="n">is</span> <span class="n">a</span> <span class="n">github</span>
<span class="n">pull</span> <span class="n">request</span> <span
class="k">then</span> <span class="n">copy</span> <span class="n">the</span>
<span class="n">below</span> <span class="n">block</span>
- <span class="n">from</span> <span class="n">the</span> <span
class="no">GitHub</span> <span class="n">email</span> <span
class="n">that</span> <span class="n">came</span> <span class="n">to</span>
<span class="n">dev</span><span class="err">@</span> <span
class="n">list</span><span class="p">,</span> <span class="n">this</span> <span
class="n">will</span>
- <span class="n">automatically</span> <span class="n">close</span> <span
class="n">the</span> <span class="no">GitHub</span> <span class="n">pull</span>
<span class="n">request</span>
-<span class="cp">%></span><span class="x"></span>
-<span class="x">Github Pull Request: This closes #XX</span>
-<span class="x">----</span>
-<span class="x">commit 1234567</span>
-<span class="x">Author: docbrown <[email protected]></span>
-<span class="x">Date: 1985-06-03T01:21:00Z</span>
-
-<span class="x"> fix for THRIFT-1234</span>
-
-<span class="x"> fix for THRIFT-1234 fixes the flux capacitor</span>
-</pre></div>
-
-
+<p>THRIFT-###:<Jira description>
+ Client: <component>
+ Patch: <Name of person contributing the patch></p>
+<p>Description of what was fixed or addressed.</p>
+<p><%
+ if this is a github pull request then add below comment
+ to automaticaly close GitHub request.
+ %>
+ This closes #XX</p>
</li>
<li>
<p>Double check the patch committed and that nothing was missed then push the
patch</p>
-<div class="codehilite"><pre><span class="n">git</span> <span
class="n">status</span>
-<span class="n">git</span> <span class="n">show</span> <span
class="n">HEAD</span>
-<span class="n">git</span> <span class="n">push</span> <span
class="n">origin</span> <span class="n">master</span>
-</pre></div>
-
-
+<p>git status
+ git show HEAD
+ git push origin master</p>
</li>
<li>
<p>Resolve the jira issue and set the following for the changelog</p>
-<ul>
-<li>Component the patch is for </li>
+</li>
+<li>
+<p>Component the patch is for</p>
+</li>
<li>fixVersion to the current version on master</li>
</ul>
-</li>
-</ol>
<p class='snippet_footer'>
This snippet was generated by Apache Thrift's <strong>source tree
docs</strong>:
<a
href="http://git-wip-us.apache.org/repos/asf?p=thrift.git;a=blob;f=doc/committers.md;hb=HEAD";</a>doc/committers.md</a>
Modified:
websites/staging/thrift/trunk/content/docs/committers/HowToPublish.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/committers/HowToPublish.html
(original)
+++ websites/staging/thrift/trunk/content/docs/committers/HowToPublish.html Sat
Sep 26 12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <h2 id="publishing-an-apache-thrift-release">Publishing an Apache
Thrift release</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="publishing-an-apache-thrift-release">Publishing an Apache Thrift
release<a class="headerlink" href="#publishing-an-apache-thrift-release"
title="Permanent link">¶</a></h2>
<ol>
<li>ssh people.apache.org and set ''umask 0002''</li>
<li>Copy the tarball, signature, and hashes to the official artifact rep:<ol>
Modified:
websites/staging/thrift/trunk/content/docs/committers/HowToRelease.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/committers/HowToRelease.html
(original)
+++ websites/staging/thrift/trunk/content/docs/committers/HowToRelease.html Sat
Sep 26 12:54:26 2015
@@ -73,9 +73,20 @@
</div>
<div class="container">
- <h2 id="how-to-create-a-release">How to create a release</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="how-to-create-a-release">How to create a release<a class="headerlink"
href="#how-to-create-a-release" title="Permanent link">¶</a></h2>
<p>This guide will walk you through the process of creating a release
candidate. Once the release candidate has passed a successful vote you can then
<a href="/docs/committers/HowToPublish">publish the release</a></p>
-<h3 id="preparing-the-release">Preparing the Release</h3>
+<h3 id="preparing-the-release">Preparing the Release<a class="headerlink"
href="#preparing-the-release" title="Permanent link">¶</a></h3>
<ol>
<li>Create a branch from TRUNK to branches/N.x where N is the version you are
attempting to release. For instance, 0.5.x or 1.2.x.</li>
<li>Check out the new branch locally.</li>
@@ -102,7 +113,7 @@
<li>After this vote has been open for 72 hours, check if it has passed.</li>
<li>If the vote has passed, congratulations, you have a valid release. Now you
are ready to <a href="/docs/committers/HowToPublish">publish the
release</a></li>
</ol>
-<h3 id="creating-a-binary-version-of-thrift-compiler-for-windows">Creating a
binary version of thrift compiler for Windows</h3>
+<h3 id="creating-a-binary-version-of-thrift-compiler-for-windows">Creating a
binary version of thrift compiler for Windows<a class="headerlink"
href="#creating-a-binary-version-of-thrift-compiler-for-windows"
title="Permanent link">¶</a></h3>
<ol>
<li>unpack release tarball: tar -xzf thrift-[version].tar.gz ; cd
thrift-[version]/</li>
<li>cross compile using i586-mingw32msvc<ol>
Modified:
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
==============================================================================
---
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
(original)
+++
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
Sat Sep 26 12:54:26 2015
@@ -73,10 +73,21 @@
</div>
<div class="container">
- <h2 id="apache-thrift-website">Apache Thrift Website</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="apache-thrift-website">Apache Thrift Website<a class="headerlink"
href="#apache-thrift-website" title="Permanent link">¶</a></h2>
<p>The thrift website is made up of markdown files with YAML headers and
templates,
and uses the <a href="http://www.apache.org/dev/cms";>Apache CMS</a>.</p>
-<h3 id="website-development">Website Development</h3>
+<h3 id="website-development">Website Development<a class="headerlink"
href="#website-development" title="Permanent link">¶</a></h3>
<p>Publishing the staging site is doable through the <a
href="https://cms.apache.org/thrift/";>CMS webgui</a>
or via shell command:</p>
<div class="codehilite"><pre><span class="c">% ssh -t people.apache.org
publish.pl thrift</span>
@@ -111,7 +122,7 @@ ensure your source content is easily und
</ul>
<p>Not only will your readers prefer a clean style, it will result in fewer
bugs and a more
consistent experience with the various markdown parsers deployed by the
CMS.</p>
-<h3 id="updating-release-versions">Updating Release Versions</h3>
+<h3 id="updating-release-versions">Updating Release Versions<a
class="headerlink" href="#updating-release-versions" title="Permanent
link">¶</a></h3>
<p>The current release versioning is kept in the YAML <strong>DATA</strong>
section of the global "configuration
file" <a
href="https://svn.apache.org/repos/asf/thrift/cms-site/trunk/lib/path.pm";>lib/path.pm</a>.
Update
the following values and then following <b>Updating the Website</b> section
below </p>
@@ -120,7 +131,7 @@ the following values and then following
</pre></div>
-<h3 id="updating-the-website">Updating the website</h3>
+<h3 id="updating-the-website">Updating the website<a class="headerlink"
href="#updating-the-website" title="Permanent link">¶</a></h3>
<p>After you have updated any content or added new markdown files you will
need to commit them to
svn to trigger a <a
href="http://ci.apache.org/builders/thrift-site-staging";>CMS build</a> of your
changes.
After a few seconds have passed your build will be ready for viewing on the <a
href="http://thrift.staging.apache.org/";>staging
Modified:
websites/staging/thrift/trunk/content/docs/committers/HowToVersion.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/committers/HowToVersion.html
(original)
+++ websites/staging/thrift/trunk/content/docs/committers/HowToVersion.html Sat
Sep 26 12:54:26 2015
@@ -73,13 +73,24 @@
</div>
<div class="container">
- <h2 id="versioning-client-libraries-for-a-release">Versioning client
libraries for a release</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="versioning-client-libraries-for-a-release">Versioning client libraries
for a release<a class="headerlink"
href="#versioning-client-libraries-for-a-release" title="Permanent
link">¶</a></h2>
<p>The current process for versioning the client libraries for a new release
is as follows. This will be required until the process is automated as outlined
in</p>
<ul>
<li>https://issues.apache.org/jira/browse/THRIFT-6</li>
<li>https://issues.apache.org/jira/browse/THRIFT-274</li>
</ul>
-<h3 id="client-version-information-locations">Client version information
locations</h3>
+<h3 id="client-version-information-locations">Client version information
locations<a class="headerlink" href="#client-version-information-locations"
title="Permanent link">¶</a></h3>
<div class="committers">
<table class="table table-bordered table-striped">
<tbody>
@@ -237,7 +248,7 @@
</table>
</div>
-<h3 id="information-for-all-new-client-libraries">Information for all new
client libraries</h3>
+<h3 id="information-for-all-new-client-libraries">Information for all new
client libraries<a class="headerlink"
href="#information-for-all-new-client-libraries" title="Permanent
link">¶</a></h3>
<p>These values should be used for all new client libraries and are the same
values across all libraries:</p>
<ul>
<li>Name: libthrift</li>
@@ -249,7 +260,7 @@
<li>Maintainer: [email protected]</li>
<li>Description: Lang-xx bindings for the Apache Thrift RPC system</li>
</ul>
-<h3 id="versioning-schema">Versioning Schema</h3>
+<h3 id="versioning-schema">Versioning Schema<a class="headerlink"
href="#versioning-schema" title="Permanent link">¶</a></h3>
<p>The versioning scheme used for any clients is based on the <a
href="http://semver.org";>Semantic Versioning Specification</a></p>
<ul>
<li>Major: Incremented for backward incompatible changes</li>
Modified: websites/staging/thrift/trunk/content/docs/committers/index.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/committers/index.html (original)
+++ websites/staging/thrift/trunk/content/docs/committers/index.html Sat Sep 26
12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <ul>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<ul>
<li><a href="/docs/committers/AdditionalReading">General articles and links
for committers</a></li>
<li><a href="/docs/committers/HowToCommit">How To Commit</a></li>
<li><a href="/docs/committers/HowToPublish">How to publish a release</a></li>
Modified: websites/staging/thrift/trunk/content/docs/concepts.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/concepts.html (original)
+++ websites/staging/thrift/trunk/content/docs/concepts.html Sat Sep 26
12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <h2 id="thrift-network-stack">Thrift network stack</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="thrift-network-stack">Thrift network stack<a class="headerlink"
href="#thrift-network-stack" title="Permanent link">¶</a></h2>
<p>Simple representation of the Apache Thrift networking stack
<pre><code>
+-------------------------------------------+
@@ -90,7 +101,7 @@
| (raw TCP, HTTP etc) |
+-------------------------------------------+
</code></pre></p>
-<h2 id="transport">Transport</h2>
+<h2 id="transport">Transport<a class="headerlink" href="#transport"
title="Permanent link">¶</a></h2>
<p>The Transport layer provides a simple abstraction for reading/writing
from/to the network. This enables Thrift to decouple the underlying transport
from the rest of the system (serialization/deserialization, for instance).</p>
<p>Here are some of the methods exposed by the <strong>Transport</strong>
interface:</p>
<ul>
@@ -112,7 +123,7 @@
<li>file: read/write to/from a file on disk</li>
<li>http: as the name suggests</li>
</ul>
-<h2 id="protocol">Protocol</h2>
+<h2 id="protocol">Protocol<a class="headerlink" href="#protocol"
title="Permanent link">¶</a></h2>
<p>The Protocol abstraction defines a mechanism to map in-memory data
structures to a wire-format. In other words, a protocol specifies how datatypes
use the
underlying Transport to encode/decode themselves. Thus the protocol
implementation governs the encoding scheme and is responsible for
(de)serialization. Some examples of protocols in this sense include JSON, XML,
plain text, compact binary etc.</p>
<p>Here is the <strong>Protocol</strong> interface:</p>
@@ -167,7 +178,7 @@ languages are:</p>
<li>compact: Described in <a
href="https://issues.apache.org/jira/browse/THRIFT-110";>THRIFT-110</a></li>
<li>json</li>
</ul>
-<h2 id="processor">Processor</h2>
+<h2 id="processor">Processor<a class="headerlink" href="#processor"
title="Permanent link">¶</a></h2>
<p>A Processor encapsulates the ability to read data from input streams and
write to output streams. The input and output streams are represented by
Protocol
objects. The Processor interface is extremely simple</p>
<pre><code class="language-java">
@@ -178,7 +189,7 @@ interface TProcessor {
<p>Service-specific processor implementations are generated by the compiler.
The Processor essentially reads data from the wire (using the input protocol),
delegates processing to the handler (implemented by the user) and writes the
response over the wire (using the output protocol).</p>
-<h2 id="server">Server</h2>
+<h2 id="server">Server<a class="headerlink" href="#server" title="Permanent
link">¶</a></h2>
<p>A Server pulls together all of the various features described above:</p>
<ul>
<li>Create a transport</li>
Modified: websites/staging/thrift/trunk/content/docs/features.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/features.html (original)
+++ websites/staging/thrift/trunk/content/docs/features.html Sat Sep 26
12:54:26 2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <h2 id="apache-thrift-features">Apache Thrift Features</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="apache-thrift-features">Apache Thrift Features<a class="headerlink"
href="#apache-thrift-features" title="Permanent link">¶</a></h2>
<ul>
<li>interface description language - Everything is specified in an IDL file
from which bindings for many languages can be generated. See <a
href="/docs/idl">Thrift IDL</a></li>
<li>language bindings - Thrift is supported in many languages and
environments</li>
@@ -106,7 +117,7 @@
<li>exceptions - If an error occurs a function can throw a standard or
user-defined exception. See <a href="/docs/types">Thrift Types</a></li>
<li>cyclic structs - Starting with version 0.9.2, Thrift supports structs that
contain themselves, or other structs to be declared later. </li>
</ul>
-<h2 id="non-features">Non-features</h2>
+<h2 id="non-features">Non-features<a class="headerlink" href="#non-features"
title="Permanent link">¶</a></h2>
<p>The following are not supported by Apache Thrift:</p>
<ul>
<li>struct inheritance - Use struct composition instead</li>
Modified: websites/staging/thrift/trunk/content/docs/idl.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/idl.html (original)
+++ websites/staging/thrift/trunk/content/docs/idl.html Sat Sep 26 12:54:26 2015
@@ -73,36 +73,47 @@
</div>
<div class="container">
- <h2 id="thrift-interface-description-language">Thrift interface
description language</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="thrift-interface-description-language">Thrift interface description
language<a class="headerlink" href="#thrift-interface-description-language"
title="Permanent link">¶</a></h2>
<p>The Thrift interface definition language (IDL) allows for the definition of
<a href="/docs/types">Thrift Types</a>. A Thrift IDL file is processed by the
Thrift code generator to produce code for the various target languages to
support the defined structs and services in the IDL file.</p>
-<h2 id="description">Description</h2>
+<h2 id="description">Description<a class="headerlink" href="#description"
title="Permanent link">¶</a></h2>
<p><em>Under construction</em></p>
<p>Here is a description of the Thrift IDL.</p>
-<h2 id="document">Document</h2>
+<h2 id="document">Document<a class="headerlink" href="#document"
title="Permanent link">¶</a></h2>
<p>Every Thrift document contains 0 or more headers followed by 0 or more
definitions.</p>
<div class="codehilite"><pre><span class="p">[</span>1<span class="p">]</span>
<span class="n">Document</span> <span class="p">::=</span> <span
class="n">Header</span><span class="o">*</span> <span
class="n">Definition</span><span class="o">*</span>
</pre></div>
-<h2 id="header">Header</h2>
+<h2 id="header">Header<a class="headerlink" href="#header" title="Permanent
link">¶</a></h2>
<p>A header is either a Thrift include, a C++ include, or a namespace
declaration.</p>
<div class="codehilite"><pre><span class="p">[</span>2<span class="p">]</span>
<span class="n">Header</span> <span class="p">::=</span> <span
class="n">Include</span> <span class="o">|</span> <span
class="n">CppInclude</span> <span class="o">|</span> <span
class="n">Namespace</span>
</pre></div>
-<h3 id="thrift-include">Thrift Include</h3>
+<h3 id="thrift-include">Thrift Include<a class="headerlink"
href="#thrift-include" title="Permanent link">¶</a></h3>
<p>An include makes all the symbols from another file visible (with a prefix)
and adds corresponding include statements into the code generated for this
Thrift document.</p>
<div class="codehilite"><pre><span class="p">[</span>3<span class="p">]</span>
<span class="n">Include</span> <span class="p">::=</span> <span
class="s">'include'</span> <span class="n">Literal</span>
</pre></div>
-<h3 id="c-include">C++ Include</h3>
+<h3 id="c-include">C++ Include<a class="headerlink" href="#c-include"
title="Permanent link">¶</a></h3>
<p>A C++ include adds a custom C++ include to the output of the C++ code
generator for this Thrift document. </p>
<div class="codehilite"><pre><span class="p">[</span>4<span class="p">]</span>
<span class="n">CppInclude</span> <span class="p">::=</span> <span
class="s">'cpp_include'</span> <span class="n">Literal</span>
</pre></div>
-<h3 id="namespace">Namespace</h3>
+<h3 id="namespace">Namespace<a class="headerlink" href="#namespace"
title="Permanent link">¶</a></h3>
<p>A namespace declares which namespaces/package/module/etc. the type
definitions in this file will be declared in for the target languages. The
namespace scope indicates which language the namespace applies to; a scope of
'*' indicates that the namespace applies to all target languages.</p>
<div class="codehilite"><pre><span class="p">[</span>5<span class="p">]</span>
<span class="n">Namespace</span> <span class="p">::=</span> <span
class="p">(</span> <span class="s">'namespace'</span> <span
class="p">(</span> <span class="n">NamespaceScope</span> <span
class="n">Identifier</span> <span class="p">)</span> <span class="o">|</span>
<span class="p">(</span> <span
class="s">'smalltalk.category'</span> <span
class="n">STIdentifier</span> <span class="p">)</span> <span class="o">|</span>
@@ -131,76 +142,76 @@
</ul>
<p>N.B.: The <code>php_namespace</code> directive will be deprecated at some
point in the future in favor of the scoped syntax, but the scoped syntax is not
yet supported for PHP.</p>
<p>N.B.: The <code>xsd_namespace</code> directive has some purpose internal to
Facebook but serves no purpose in Thrift itself. Use of this feature is
strongly discouraged</p>
-<h2 id="definition">Definition</h2>
+<h2 id="definition">Definition<a class="headerlink" href="#definition"
title="Permanent link">¶</a></h2>
<div class="codehilite"><pre><span class="p">[</span>7<span class="p">]</span>
<span class="n">Definition</span> <span class="p">::=</span> <span
class="n">Const</span> <span class="o">|</span> <span class="n">Typedef</span>
<span class="o">|</span> <span class="n">Enum</span> <span class="o">|</span>
<span class="n">Senum</span> <span class="o">|</span> <span
class="n">Struct</span> <span class="o">|</span> <span class="n">Union</span>
<span class="o">|</span> <span class="n">Exception</span> <span
class="o">|</span> <span class="n">Service</span>
</pre></div>
-<h3 id="const">Const</h3>
+<h3 id="const">Const<a class="headerlink" href="#const" title="Permanent
link">¶</a></h3>
<div class="codehilite"><pre><span class="p">[</span>8<span class="p">]</span>
<span class="n">Const</span> <span class="p">::=</span> <span
class="s">'const'</span> <span class="n">FieldType</span> <span
class="n">Identifier</span> <span class="s">'='</span> <span
class="n">ConstValue</span> <span class="n">ListSeparator</span>?
</pre></div>
-<h3 id="typedef">Typedef</h3>
+<h3 id="typedef">Typedef<a class="headerlink" href="#typedef" title="Permanent
link">¶</a></h3>
<p>A typedef creates an alternate name for a type.</p>
<div class="codehilite"><pre><span class="p">[</span>9<span class="p">]</span>
<span class="n">Typedef</span> <span class="p">::=</span> <span
class="s">'typedef'</span> <span class="n">DefinitionType</span> <span
class="n">Identifier</span>
</pre></div>
-<h3 id="enum">Enum</h3>
+<h3 id="enum">Enum<a class="headerlink" href="#enum" title="Permanent
link">¶</a></h3>
<p>An enum creates an enumerated type, with named values. If no constant value
is supplied, the value is either 0 for the first element, or one greater than
the preceding value for any subsequent element. Any constant value that is
supplied must be non-negative.</p>
<div class="codehilite"><pre><span class="p">[</span>10<span
class="p">]</span> <span class="n">Enum</span> <span
class="p">::=</span> <span class="s">'enum'</span> <span
class="n">Identifier</span> <span class="s">'{'</span> <span
class="p">(</span><span class="n">Identifier</span> <span
class="p">(</span><span class="s">'='</span> <span
class="n">IntConstant</span><span class="p">)</span>? <span
class="n">ListSeparator</span>?<span class="p">)</span><span class="o">*</span>
<span class="s">'}'</span>
</pre></div>
-<h3 id="senum">Senum</h3>
+<h3 id="senum">Senum<a class="headerlink" href="#senum" title="Permanent
link">¶</a></h3>
<p>Senum (and Slist) are now deprecated and should both be replaced with
String.</p>
<div class="codehilite"><pre><span class="p">[</span>11<span
class="p">]</span> <span class="n">Senum</span> <span
class="p">::=</span> <span class="s">'senum'</span> <span
class="n">Identifier</span> <span class="s">'{'</span> <span
class="p">(</span><span class="n">Literal</span> <span
class="n">ListSeparator</span>?<span class="p">)</span><span class="o">*</span>
<span class="s">'}'</span>
</pre></div>
-<h3 id="struct">Struct</h3>
+<h3 id="struct">Struct<a class="headerlink" href="#struct" title="Permanent
link">¶</a></h3>
<p>Structs are the fundamental compositional type in Thrift. The name of each
field must be unique within the struct.</p>
<div class="codehilite"><pre><span class="p">[</span>12<span
class="p">]</span> <span class="n">Struct</span> <span
class="p">::=</span> <span class="s">'struct'</span> <span
class="n">Identifier</span> <span class="s">'xsd_all'</span>? <span
class="s">'{'</span> <span class="n">Field</span><span
class="o">*</span> <span class="s">'}'</span>
</pre></div>
<p>N.B.: The <code>xsd_all</code> keyword has some purpose internal to
Facebook but serves no purpose in Thrift itself. Use of this feature is
strongly discouraged</p>
-<h3 id="union">Union</h3>
+<h3 id="union">Union<a class="headerlink" href="#union" title="Permanent
link">¶</a></h3>
<p>Unions are similar to structs, except that they provide a means to
transport exactly one field of a possible set of fields, just like union {} in
C++. Consequently, union members cannot be required fields.</p>
<div class="codehilite"><pre><span class="p">[</span>13<span
class="p">]</span> <span class="n">Union</span> <span
class="p">::=</span> <span class="s">'union'</span> <span
class="n">Identifier</span> <span class="s">'xsd_all'</span>? <span
class="s">'{'</span> <span class="n">Field</span><span
class="o">*</span> <span class="s">'}'</span>
</pre></div>
<p>N.B.: The <code>xsd_all</code> keyword has some purpose internal to
Facebook but serves no purpose in Thrift itself. Use of this feature is
strongly discouraged</p>
-<h3 id="exception">Exception</h3>
+<h3 id="exception">Exception<a class="headerlink" href="#exception"
title="Permanent link">¶</a></h3>
<p>Exceptions are similar to structs except that they are intended to
integrate with the native exception handling mechanisms in the target
languages. The name of each field must be unique within the exception.</p>
<div class="codehilite"><pre><span class="p">[</span>14<span
class="p">]</span> <span class="n">Exception</span> <span
class="p">::=</span> <span class="s">'exception'</span> <span
class="n">Identifier</span> <span class="s">'{'</span> <span
class="n">Field</span><span class="o">*</span> <span
class="s">'}'</span>
</pre></div>
-<h3 id="service">Service</h3>
+<h3 id="service">Service<a class="headerlink" href="#service" title="Permanent
link">¶</a></h3>
<p>A service provides the interface for a set of functionality provided by a
Thrift server. The interface is simply a list of functions. A service can
extend another service, which simply means that it provides the functions of
the extended service in addition to its own.</p>
<div class="codehilite"><pre><span class="p">[</span>15<span
class="p">]</span> <span class="n">Service</span> <span
class="p">::=</span> <span class="s">'service'</span> <span
class="n">Identifier</span> <span class="p">(</span> <span
class="s">'extends'</span> <span class="n">Identifier</span> <span
class="p">)</span>? <span class="s">'{'</span> <span
class="n">Function</span><span class="o">*</span> <span
class="s">'}'</span>
</pre></div>
-<h2 id="field">Field</h2>
+<h2 id="field">Field<a class="headerlink" href="#field" title="Permanent
link">¶</a></h2>
<div class="codehilite"><pre><span class="p">[</span>16<span
class="p">]</span> <span class="n">Field</span> <span
class="p">::=</span> <span class="n">FieldID</span>? <span
class="n">FieldReq</span>? <span class="n">FieldType</span> <span
class="n">Identifier</span> <span class="p">(</span><span
class="s">'</span><span class="err">= ConstValue)? XsdFieldOptions
ListSeparator?</span>
</pre></div>
-<h3 id="field-id">Field ID</h3>
+<h3 id="field-id">Field ID<a class="headerlink" href="#field-id"
title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="p">[</span>17<span
class="p">]</span> <span class="n">FieldID</span> <span
class="p">::=</span> <span class="n">IntConstant</span> <span
class="s">':'</span>
</pre></div>
-<h3 id="field-requiredness">Field Requiredness</h3>
+<h3 id="field-requiredness">Field Requiredness<a class="headerlink"
href="#field-requiredness" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="p">[</span>18<span
class="p">]</span> <span class="n">FieldReq</span> <span
class="p">::=</span> <span class="s">'required'</span> <span
class="o">|</span> <span class="s">'optional'</span>
</pre></div>
-<h3 id="xsd-options">XSD Options</h3>
+<h3 id="xsd-options">XSD Options<a class="headerlink" href="#xsd-options"
title="Permanent link">¶</a></h3>
<p>N.B.: These have some internal purpose at Facebook but serve no current
purpose in Thrift. Use of these options is strongly discouraged.</p>
<div class="codehilite"><pre><span class="p">[</span>19<span
class="p">]</span> <span class="n">XsdFieldOptions</span> <span
class="p">::=</span> <span class="s">'xsd_optional'</span>? <span
class="s">'xsd_nillable'</span>? <span class="n">XsdAttrs</span>?
@@ -208,7 +219,7 @@
</pre></div>
-<h2 id="functions">Functions</h2>
+<h2 id="functions">Functions<a class="headerlink" href="#functions"
title="Permanent link">¶</a></h2>
<div class="codehilite"><pre><span class="p">[</span>21<span
class="p">]</span> <span class="n">Function</span> <span
class="p">::=</span> <span class="s">'oneway'</span>? <span
class="n">FunctionType</span> <span class="n">Identifier</span> <span
class="s">'('</span> <span class="n">Field</span><span
class="o">*</span> <span class="s">')'</span> <span
class="n">Throws</span>? <span class="n">ListSeparator</span>?
<span class="p">[</span>22<span class="p">]</span> <span
class="n">FunctionType</span> <span class="p">::=</span> <span
class="n">FieldType</span> <span class="o">|</span> <span
class="s">'void'</span>
@@ -217,7 +228,7 @@
</pre></div>
-<h2 id="types">Types</h2>
+<h2 id="types">Types<a class="headerlink" href="#types" title="Permanent
link">¶</a></h2>
<div class="codehilite"><pre><span class="p">[</span>24<span
class="p">]</span> <span class="n">FieldType</span> <span
class="p">::=</span> <span class="n">Identifier</span> <span
class="o">|</span> <span class="n">BaseType</span> <span class="o">|</span>
<span class="n">ContainerType</span>
<span class="p">[</span>25<span class="p">]</span> <span
class="n">DefinitionType</span> <span class="p">::=</span> <span
class="n">BaseType</span> <span class="o">|</span> <span
class="n">ContainerType</span>
@@ -236,7 +247,7 @@
</pre></div>
-<h2 id="constant-values">Constant Values</h2>
+<h2 id="constant-values">Constant Values<a class="headerlink"
href="#constant-values" title="Permanent link">¶</a></h2>
<div class="codehilite"><pre><span class="p">[</span>32<span
class="p">]</span> <span class="n">ConstValue</span> <span
class="p">::=</span> <span class="n">IntConstant</span> <span
class="o">|</span> <span class="n">DoubleConstant</span> <span
class="o">|</span> <span class="n">Literal</span> <span class="o">|</span>
<span class="n">Identifier</span> <span class="o">|</span> <span
class="n">ConstList</span> <span class="o">|</span> <span
class="n">ConstMap</span>
<span class="p">[</span>33<span class="p">]</span> <span
class="n">IntConstant</span> <span class="p">::=</span> <span
class="p">(</span><span class="s">'+'</span> <span class="o">|</span>
<span class="s">'-'</span><span class="p">)</span>? <span
class="n">Digit</span><span class="o">+</span>
@@ -249,32 +260,32 @@
</pre></div>
-<h2 id="basic-definitions">Basic Definitions</h2>
-<h3 id="literal">Literal</h3>
+<h2 id="basic-definitions">Basic Definitions<a class="headerlink"
href="#basic-definitions" title="Permanent link">¶</a></h2>
+<h3 id="literal">Literal<a class="headerlink" href="#literal" title="Permanent
link">¶</a></h3>
<div class="codehilite"><pre><span class="p">[</span>37<span
class="p">]</span> <span class="n">Literal</span> <span
class="p">::=</span> <span class="p">(</span><span
class="s">'"'</span> <span class="p">[</span>^"<span
class="p">]</span><span class="o">*</span> <span
class="s">'"'</span><span class="p">)</span> <span
class="o">|</span> <span class="p">(</span>"<span class="s">'"
[^'</span><span class="p">]</span><span class="o">*</span> "<span
class="s">'</span><span class="err">")</span>
</pre></div>
-<h3 id="identifier">Identifier</h3>
+<h3 id="identifier">Identifier<a class="headerlink" href="#identifier"
title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="p">[</span>38<span
class="p">]</span> <span class="n">Identifier</span> <span
class="p">::=</span> <span class="p">(</span> <span class="n">Letter</span>
<span class="o">|</span> <span class="s">'_'</span> <span
class="p">)</span> <span class="p">(</span> <span class="n">Letter</span> <span
class="o">|</span> <span class="n">Digit</span> <span class="o">|</span> <span
class="s">'.'</span> <span class="o">|</span> <span
class="s">'_'</span> <span class="p">)</span><span class="o">*</span>
<span class="p">[</span>39<span class="p">]</span> <span
class="n">STIdentifier</span> <span class="p">::=</span> <span
class="p">(</span> <span class="n">Letter</span> <span class="o">|</span> <span
class="s">'_'</span> <span class="p">)</span> <span class="p">(</span>
<span class="n">Letter</span> <span class="o">|</span> <span
class="n">Digit</span> <span class="o">|</span> <span
class="s">'.'</span> <span class="o">|</span> <span
class="s">'_'</span> <span class="o">|</span> <span
class="s">'-'</span> <span class="p">)</span><span class="o">*</span>
</pre></div>
-<h3 id="list-separator">List Separator</h3>
+<h3 id="list-separator">List Separator<a class="headerlink"
href="#list-separator" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="p">[</span>40<span
class="p">]</span> <span class="n">ListSeparator</span> <span
class="p">::=</span> <span class="s">','</span> <span
class="o">|</span> <span class="s">';'</span>
</pre></div>
-<h3 id="letters-and-digits">Letters and Digits</h3>
+<h3 id="letters-and-digits">Letters and Digits<a class="headerlink"
href="#letters-and-digits" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="k">[41] Letter ::=
['A'-'Z'] | ['a'-'z']</span>
<span class="k">[42] Digit ::= ['0'-'9']</span>
</pre></div>
-<h2 id="examples">Examples</h2>
+<h2 id="examples">Examples<a class="headerlink" href="#examples"
title="Permanent link">¶</a></h2>
<p>Here are some examples of Thrift definitions, using the Thrift IDL:</p>
<ul>
<li><a
href="https://git-wip-us.apache.org/repos/asf?p=thrift.git;a=blob_plain;f=test/ThriftTest.thrift;hb=HEAD";>ThriftTest.thrift</a>
used by the Thrift TestFramework</li>
@@ -283,7 +294,7 @@
<li><a href="http://cassandra.apache.org/";>Apache Cassandra's</a> Thrift IDL:
<a
href="http://svn.apache.org/viewvc/cassandra/trunk/interface/cassandra.thrift?view=co";>cassandra.thrift</a></li>
<li><a href="http://www.evernote.com/about/developer/api/";>Evernote
API</a></li>
</ul>
-<h2 id="to-doquestions">To Do/Questions</h2>
+<h2 id="to-doquestions">To Do/Questions<a class="headerlink"
href="#to-doquestions" title="Permanent link">¶</a></h2>
<p>Initialization of Base Types for all Languages?</p>
<ul>
<li>Do all Languages initialize them to 0, bool=false and string=""? or null,
undefined?</li>
Modified: websites/staging/thrift/trunk/content/docs/index.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/index.html (original)
+++ websites/staging/thrift/trunk/content/docs/index.html Sat Sep 26 12:54:26
2015
@@ -73,7 +73,18 @@
</div>
<div class="container">
- <ul>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<ul>
<li><a href="/docs/BuildingFromSource">Building From Source</a></li>
<li><a href="/docs/HowToContribute">How To Contribute</a></li>
<li><a href="/docs/HowToNewLanguage">How to add new language bindings</a></li>
Modified: websites/staging/thrift/trunk/content/docs/install/centos.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/install/centos.html (original)
+++ websites/staging/thrift/trunk/content/docs/install/centos.html Sat Sep 26
12:54:26 2015
@@ -73,24 +73,35 @@
</div>
<div class="container">
- <h1 id="building-apache-thrift-on-centos-65">Building Apache Thrift
on CentOS 6.5</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="building-apache-thrift-on-centos-65">Building Apache Thrift on CentOS
6.5<a class="headerlink" href="#building-apache-thrift-on-centos-65"
title="Permanent link">¶</a></h1>
<p>Starting with a minimal installation, the following steps are required to
build Apache Thrift on Centos 6.5. This example builds from source, using the
current development master branch. These instructions should also work with
Apache Thrift releases beginning with 0.9.2.</p>
-<h2 id="update-the-system">Update the System</h2>
+<h2 id="update-the-system">Update the System<a class="headerlink"
href="#update-the-system" title="Permanent link">¶</a></h2>
<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">yum</span> <span class="o">-</span><span class="n">y</span> <span
class="n">update</span>
</pre></div>
-<h2 id="install-the-platform-development-tools">Install the Platform
Development Tools</h2>
+<h2 id="install-the-platform-development-tools">Install the Platform
Development Tools<a class="headerlink"
href="#install-the-platform-development-tools" title="Permanent
link">¶</a></h2>
<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">yum</span> <span class="o">-</span><span class="n">y</span> <span
class="n">groupinstall</span> "<span class="n">Development</span> <span
class="n">Tools</span>"
</pre></div>
-<h2 id="upgrade-autoconfautomakebison">Upgrade autoconf/automake/bison</h2>
+<h2 id="upgrade-autoconfautomakebison">Upgrade autoconf/automake/bison<a
class="headerlink" href="#upgrade-autoconfautomakebison" title="Permanent
link">¶</a></h2>
<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">yum</span> <span class="n">install</span> <span
class="o">-</span><span class="n">y</span> <span class="n">wget</span>
</pre></div>
-<h3 id="upgrade-autoconf">Upgrade autoconf</h3>
+<h3 id="upgrade-autoconf">Upgrade autoconf<a class="headerlink"
href="#upgrade-autoconf" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="n">wget</span> <span
class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">ftp</span><span class="p">.</span><span class="n">gnu</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">gnu</span><span class="o">/</span><span
class="n">autoconf</span><span class="o">/</span><span
class="n">autoconf</span><span class="o">-</span>2<span
class="p">.</span>69<span class="p">.</span><span class="n">tar</span><span
class="p">.</span><span class="n">gz</span>
<span class="n">tar</span> <span class="n">xvf</span> <span
class="n">autoconf</span><span class="o">-</span>2<span
class="p">.</span>69<span class="p">.</span><span class="n">tar</span><span
class="p">.</span><span class="n">gz</span>
<span class="n">cd</span> <span class="n">autoconf</span><span
class="o">-</span>2<span class="p">.</span>69
@@ -101,7 +112,7 @@
</pre></div>
-<h3 id="upgrade-automake">Upgrade automake</h3>
+<h3 id="upgrade-automake">Upgrade automake<a class="headerlink"
href="#upgrade-automake" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="n">wget</span> <span
class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">ftp</span><span class="p">.</span><span class="n">gnu</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">gnu</span><span class="o">/</span><span
class="n">automake</span><span class="o">/</span><span
class="n">automake</span><span class="o">-</span>1<span
class="p">.</span>14<span class="p">.</span><span class="n">tar</span><span
class="p">.</span><span class="n">gz</span>
<span class="n">tar</span> <span class="n">xvf</span> <span
class="n">automake</span><span class="o">-</span>1<span
class="p">.</span>14<span class="p">.</span><span class="n">tar</span><span
class="p">.</span><span class="n">gz</span>
<span class="n">cd</span> <span class="n">automake</span><span
class="o">-</span>1<span class="p">.</span>14
@@ -112,7 +123,7 @@
</pre></div>
-<h3 id="upgrade-bison">Upgrade bison</h3>
+<h3 id="upgrade-bison">Upgrade bison<a class="headerlink"
href="#upgrade-bison" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="n">wget</span> <span
class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">ftp</span><span class="p">.</span><span class="n">gnu</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">gnu</span><span class="o">/</span><span class="n">bison</span><span
class="o">/</span><span class="n">bison</span><span class="o">-</span>2<span
class="p">.</span>5<span class="p">.</span>1<span class="p">.</span><span
class="n">tar</span><span class="p">.</span><span class="n">gz</span>
<span class="n">tar</span> <span class="n">xvf</span> <span
class="n">bison</span><span class="o">-</span>2<span class="p">.</span>5<span
class="p">.</span>1<span class="p">.</span><span class="n">tar</span><span
class="p">.</span><span class="n">gz</span>
<span class="n">cd</span> <span class="n">bison</span><span
class="o">-</span>2<span class="p">.</span>5<span class="p">.</span>1
@@ -123,24 +134,24 @@
</pre></div>
-<h2 id="add-optional-c-language-library-dependencies">Add Optional C++
Language Library Dependencies</h2>
+<h2 id="add-optional-c-language-library-dependencies">Add Optional C++
Language Library Dependencies<a class="headerlink"
href="#add-optional-c-language-library-dependencies" title="Permanent
link">¶</a></h2>
<p>All languages require the Apache Thrift IDL Compiler and at this point
everything needed to make the IDL Compiler is installed (if you only need the
compiler you can skip to the Build step). </p>
<p>If you will be developing Apache Thrift clients/servers in C++ you will
also need additional packages to support the C++ shared library build.</p>
-<h3 id="install-c-lib-dependencies">Install C++ Lib Dependencies</h3>
+<h3 id="install-c-lib-dependencies">Install C++ Lib Dependencies<a
class="headerlink" href="#install-c-lib-dependencies" title="Permanent
link">¶</a></h3>
<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">yum</span> <span class="o">-</span><span class="n">y</span> <span
class="n">install</span> <span class="n">libevent</span><span
class="o">-</span><span class="n">devel</span> <span class="n">zlib</span><span
class="o">-</span><span class="n">devel</span> <span
class="n">openssl</span><span class="o">-</span><span class="n">devel</span>
</pre></div>
-<h3 id="upgrade-boost">Upgrade Boost</h3>
-<div class="codehilite"><pre><span class="n">wget</span> <span
class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">sourceforge</span><span class="p">.</span><span
class="n">net</span><span class="o">/</span><span
class="n">projects</span><span class="o">/</span><span
class="n">boost</span><span class="o">/</span><span class="n">files</span><span
class="o">/</span><span class="n">boost</span><span class="o">/</span>1<span
class="p">.</span>55<span class="p">.</span>0<span class="o">/</span><span
class="n">boost_1_55_0</span><span class="p">.</span><span
class="n">tar</span><span class="p">.</span><span class="n">gz</span>
-<span class="n">tar</span> <span class="n">xvf</span> <span
class="n">boost_1_55_0</span><span class="p">.</span><span
class="n">tar</span><span class="p">.</span><span class="n">gz</span>
-<span class="n">cd</span> <span class="n">boost_1_55_0</span>
+<h3 id="upgrade-boost-153">Upgrade Boost >= 1.53<a class="headerlink"
href="#upgrade-boost-153" title="Permanent link">¶</a></h3>
+<div class="codehilite"><pre><span class="n">wget</span> <span
class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">sourceforge</span><span class="p">.</span><span
class="n">net</span><span class="o">/</span><span
class="n">projects</span><span class="o">/</span><span
class="n">boost</span><span class="o">/</span><span class="n">files</span><span
class="o">/</span><span class="n">boost</span><span class="o">/</span>1<span
class="p">.</span>53<span class="p">.</span>0<span class="o">/</span><span
class="n">boost_1_53_0</span><span class="p">.</span><span
class="n">tar</span><span class="p">.</span><span class="n">gz</span>
+<span class="n">tar</span> <span class="n">xvf</span> <span
class="n">boost_1_53_0</span><span class="p">.</span><span
class="n">tar</span><span class="p">.</span><span class="n">gz</span>
+<span class="n">cd</span> <span class="n">boost_1_53_0</span>
<span class="o">./</span><span class="n">bootstrap</span><span
class="p">.</span><span class="n">sh</span>
<span class="n">sudo</span> <span class="o">./</span><span class="n">b2</span>
<span class="n">install</span>
</pre></div>
-<h2 id="build-and-install-the-apache-thrift-idl-compiler">Build and Install
the Apache Thrift IDL Compiler</h2>
+<h2 id="build-and-install-the-apache-thrift-idl-compiler">Build and Install
the Apache Thrift IDL Compiler<a class="headerlink"
href="#build-and-install-the-apache-thrift-idl-compiler" title="Permanent
link">¶</a></h2>
<div class="codehilite"><pre><span class="n">git</span> <span
class="n">clone</span> <span class="n">https</span><span
class="p">:</span><span class="o">//</span><span class="n">git</span><span
class="o">-</span><span class="n">wip</span><span class="o">-</span><span
class="n">us</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">repos</span><span class="o">/</span><span class="n">asf</span><span
class="o">/</span><span class="n">thrift</span><span class="p">.</span><span
class="n">git</span>
<span class="n">cd</span> <span class="n">thrift</span>
<span class="o">./</span><span class="n">bootstrap</span><span
class="p">.</span><span class="n">sh</span>
Modified: websites/staging/thrift/trunk/content/docs/install/debian.html
==============================================================================
--- websites/staging/thrift/trunk/content/docs/install/debian.html (original)
+++ websites/staging/thrift/trunk/content/docs/install/debian.html Sat Sep 26
12:54:26 2015
@@ -73,9 +73,20 @@
</div>
<div class="container">
- <h2 id="debian-or-ubuntu-setup">Debian or Ubuntu setup</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="debian-or-ubuntu-setup">Debian or Ubuntu setup<a class="headerlink"
href="#debian-or-ubuntu-setup" title="Permanent link">¶</a></h2>
<p>The following command install all the required tools and libraries to build
and install the Apache Thrift compiler on a Debian/Ubuntu Linux based
system.</p>
-<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">apt</span><span class="o">-</span><span class="n">get</span> <span
class="n">install</span> <span class="n">libboost</span><span
class="o">-</span><span class="n">dev</span> <span
class="n">libboost</span><span class="o">-</span><span
class="n">test</span><span class="o">-</span><span class="n">dev</span> <span
class="n">libboost</span><span class="o">-</span><span
class="n">program</span><span class="o">-</span><span
class="n">options</span><span class="o">-</span><span class="n">dev</span>
<span class="n">libboost</span><span class="o">-</span><span
class="n">system</span><span class="o">-</span><span class="n">dev</span> <span
class="n">libboost</span><span class="o">-</span><span
class="n">filesystem</span><span class="o">-</span><span class="n">dev</span>
<span class="n">libevent</span><span class="o">-</span><span
class="n">dev</span> <span class="n">automake</span> <span
class="n">libtool</span> <span cl
ass="n">flex</span> <span class="n">bison</span> <span
class="n">pkg</span><span class="o">-</span><span class="n">config</span> <span
class="n">g</span><span class="o">++</span> <span class="n">libssl</span><span
class="o">-</span><span class="n">dev</span>
+<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">apt</span><span class="o">-</span><span class="n">get</span> <span
class="n">install</span> <span class="n">libboost</span><span
class="o">-</span><span class="n">dev</span> <span
class="n">libboost</span><span class="o">-</span><span
class="n">test</span><span class="o">-</span><span class="n">dev</span> <span
class="n">libboost</span><span class="o">-</span><span
class="n">program</span><span class="o">-</span><span
class="n">options</span><span class="o">-</span><span class="n">dev</span>
<span class="n">libboost</span><span class="o">-</span><span
class="n">system</span><span class="o">-</span><span class="n">dev</span> <span
class="n">libboost</span><span class="o">-</span><span
class="n">filesystem</span><span class="o">-</span><span class="n">dev</span>
<span class="n">libevent</span><span class="o">-</span><span
class="n">dev</span> <span class="n">automake</span> <span
class="n">libtool</span> <span cl
ass="n">flex</span> <span class="n">bison</span> <span
class="n">pkg</span><span class="o">-</span><span class="n">config</span> <span
class="n">g</span><span class="o">++</span> <span class="n">libssl</span><span
class="o">-</span><span class="n">dev</span> <span class="n">ant</span>
</pre></div>
@@ -86,7 +97,7 @@
</pre></div>
-<h2 id="optional-packages">Optional packages</h2>
+<h2 id="optional-packages">Optional packages<a class="headerlink"
href="#optional-packages" title="Permanent link">¶</a></h2>
<p>Some other packages depend on what languages you want Thrift to support.</p>
<ul>
<li>Ruby <ul>
@@ -126,7 +137,7 @@
</ul>
</li>
</ul>
-<h2 id="additional-reading">Additional reading</h2>
+<h2 id="additional-reading">Additional reading<a class="headerlink"
href="#additional-reading" title="Permanent link">¶</a></h2>
<p>For more information on the requirements see: <a
href="/docs/install">Apache Thrift Requirements</a></p>
<p>For more information on building and installing Thrift see: <a
href="/docs/BuildingFromSource">Building from source</a></p>
<p class='snippet_footer'>
