Author: dlester
Date: Mon Apr 27 17:56:09 2015
New Revision: 1676349
URL: http://svn.apache.org/r1676349
Log:
Updates Mesos documentation.
Modified:
mesos/site/publish/documentation/clang-format/index.html
mesos/site/publish/documentation/latest/clang-format/index.html
mesos/site/publish/documentation/latest/mesos-c++-style-guide/index.html
mesos/site/publish/documentation/latest/powered-by-mesos/index.html
mesos/site/publish/documentation/latest/release-guide/index.html
mesos/site/publish/documentation/mesos-c++-style-guide/index.html
mesos/site/publish/documentation/powered-by-mesos/index.html
mesos/site/publish/documentation/release-guide/index.html
mesos/site/publish/sitemap.xml
mesos/site/source/documentation/latest/clang-format.md
mesos/site/source/documentation/latest/mesos-c++-style-guide.md
mesos/site/source/documentation/latest/powered-by-mesos.md
mesos/site/source/documentation/latest/release-guide.md
Modified: mesos/site/publish/documentation/clang-format/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/clang-format/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/clang-format/index.html (original)
+++ mesos/site/publish/documentation/clang-format/index.html Mon Apr 27
17:56:09 2015
@@ -83,17 +83,13 @@
<div class="col-md-8">
<h1>ClangFormat</h1>
-<p><a
href="http://llvm.org/releases/3.5.0/tools/clang/docs/ClangFormat.html";>ClangFormat</a>
is an automatic source code formatting tool which help us focus on the code
rather than the formatting.</p>
+<p><a
href="http://llvm.org/releases/3.5.1/tools/clang/docs/ClangFormat.html";>ClangFormat</a>
is an automatic source code formatting tool which helps us focus on the code
rather than the formatting.</p>
-<blockquote><p>The provided configurations try to honor the <a
href="http://mesos.apache.org/documentation/latest/mesos-c++-style-guide/";>Mesos
C++ Style Guide</a> as much as possible, but there are some limitations. Even
with these limitations however, ClangFormat will likely be extremely useful for
your workflow!</p></blockquote>
-
-<h2>Quick Start</h2>
-
-<p>If you already have an installation of <code>clang-format</code> version >=
3.5, follow your editor’s <a
href="#integrate-with-your-editor">integration instructions</a> then start
formatting!</p>
+<blockquote><p>The provided configurations try to honor the <a
href="http://mesos.apache.org/documentation/latest/mesos-c++-style-guide/";>Mesos
C++ Style Guide</a> as much as possible, but there are some limitations which
require manual attention. Even with these limitations however, ClangFormat will
be extremely useful for your workflow!</p></blockquote>
<h2>Setup</h2>
-<h3>Install clang 3.5</h3>
+<h3>Install <code>clang-format-3.5</code></h3>
<h4>Ubuntu 14.04</h4>
@@ -106,32 +102,26 @@ sudo apt-get install clang-format-3.5
<h4>OS X Yosemite</h4>
-<pre><code class="bash"># Download and extract the clang-3.5 source.
-$ wget http://llvm.org/releases/3.5.0/cfe-3.5.0.src.tar.xz
-$ tar -xzf cfe-3.5.0.src.tar.xz
-
-# Download and extract the clang-3.5 pre-built binaries.
-$ wget
http://llvm.org/releases/3.5.0/clang+llvm-3.5.0-macosx-apple-darwin.tar.xz
-$ tar -xzf clang+llvm-3.5.0-macosx-apple-darwin.tar.xz
+<pre><code class="bash"># Install clang-3.5. The binaries are suffixed with
'-3.5', e.g. 'clang++-3.5'.
+$ brew install llvm35 --with-clang
-# Create a directory for clang.
-$ mkdir `brew --cellar`/clang
-
-# Install the pre-built binaries.
-$ mv clang+llvm-3.5.0-macosx-apple-darwin `brew --cellar`/clang/3.5
+# Download and install the clang-format scripts.
+$ wget http://llvm.org/releases/3.5.1/cfe-3.5.1.src.tar.xz
+$ tar -xzf cfe-3.5.1.src.tar.xz
+$ cp cfe-3.5.1.src/tools/clang-format/clang-format* `brew
--cellar`/llvm35/3.5.1/share/clang-3.5
+</code></pre>
-# Install the clang-format tools.
-$ mkdir `brew --cellar`/clang/3.5/share/clang
-$ cp cfe-3.5.0.src/tools/clang-format/clang-format* `brew
--cellar`/clang/3.5/share/clang
+<h3>Formatting Configuration</h3>
-# Link!
-$ brew link clang
-Linking /usr/local/Cellar/clang/3.5... 491 symlinks created
+<p>By default, ClangFormat uses the configuration defined in a
<code>.clang-format</code> or
+<code>_clang-format</code> file located in the nearest parent directory of the
input file.
+The <code>bootstrap</code> script creates a <code>.clang-format</code> symlink
at the top-level
+directory which points to <code>support/clang-format</code> for ClangFormat to
find.</p>
-# You can delete cleanly by running `brew uninstall clang`
-</code></pre>
+<blockquote><p>NOTE: If you’re using <code>clang-format-3.6</code>,
you’ll need to add a new option
+<code>BinPackArguments: false</code> to the <code>.clang-format</code>
file!</p></blockquote>
-<h3>Integrate with your editor</h3>
+<h3>Editor Integration</h3>
<h4>Vim</h4>
@@ -145,8 +135,8 @@ imap <C-K> <c-o>:pyf /usr/sh
<p>OS X:</p>
-<pre><code>map <C-K> :pyf
/usr/local/share/clang/clang-format.py<cr>
-imap <C-K> <c-o>:pyf
/usr/local/share/clang/clang-format.py<cr>
+<pre><code>map <C-K> :pyf
/usr/local/share/clang-3.5/clang-format.py<cr>
+imap <C-K> <c-o>:pyf
/usr/local/share/clang-3.5/clang-format.py<cr>
</code></pre>
<p>The first line enables clang-format for <code>NORMAL</code> and
<code>VISUAL</code> mode, the second line adds support for <code>INSERT</code>
mode. Change <code>C-K</code> to another binding if you need clang-format on a
different key (<code>C-K</code> stands for <code>Ctrl+k</code>).</p>
@@ -155,7 +145,7 @@ imap <C-K> <c-o>:pyf /usr/lo
<p>It operates on the current, potentially unsaved buffer and does not create
or save any files. To revert a formatting, just undo.</p>
-<blockquote><p>Source:
http://llvm.org/releases/3.5.0/tools/clang/docs/ClangFormat.html</p></blockquote>
+<blockquote><p>Source:
http://llvm.org/releases/3.5.1/tools/clang/docs/ClangFormat.html</p></blockquote>
<h4>Emacs</h4>
@@ -169,13 +159,13 @@ imap <C-K> <c-o>:pyf /usr/lo
<p>OS X:</p>
-<pre><code>(load "/usr/local/share/clang/clang-format.el")
+<pre><code>(load "/usr/local/share/clang-3.5/clang-format.el")
(global-set-key [C-M-tab] 'clang-format-region)
</code></pre>
<p>This binds the function <code>clang-format-region</code> to
<code>C-M-tab</code>, which then formats the current line or selected
region.</p>
-<blockquote><p>Source:
http://llvm.org/releases/3.5.0/tools/clang/docs/ClangFormat.html</p></blockquote>
+<blockquote><p>Source:
http://llvm.org/releases/3.5.1/tools/clang/docs/ClangFormat.html</p></blockquote>
<h2>Known Limitations</h2>
Modified: mesos/site/publish/documentation/latest/clang-format/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/clang-format/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/clang-format/index.html (original)
+++ mesos/site/publish/documentation/latest/clang-format/index.html Mon Apr 27
17:56:09 2015
@@ -83,17 +83,13 @@
<div class="col-md-8">
<h1>ClangFormat</h1>
-<p><a
href="http://llvm.org/releases/3.5.0/tools/clang/docs/ClangFormat.html";>ClangFormat</a>
is an automatic source code formatting tool which help us focus on the code
rather than the formatting.</p>
+<p><a
href="http://llvm.org/releases/3.5.1/tools/clang/docs/ClangFormat.html";>ClangFormat</a>
is an automatic source code formatting tool which helps us focus on the code
rather than the formatting.</p>
-<blockquote><p>The provided configurations try to honor the <a
href="http://mesos.apache.org/documentation/latest/mesos-c++-style-guide/";>Mesos
C++ Style Guide</a> as much as possible, but there are some limitations. Even
with these limitations however, ClangFormat will likely be extremely useful for
your workflow!</p></blockquote>
-
-<h2>Quick Start</h2>
-
-<p>If you already have an installation of <code>clang-format</code> version >=
3.5, follow your editor’s <a
href="#integrate-with-your-editor">integration instructions</a> then start
formatting!</p>
+<blockquote><p>The provided configurations try to honor the <a
href="http://mesos.apache.org/documentation/latest/mesos-c++-style-guide/";>Mesos
C++ Style Guide</a> as much as possible, but there are some limitations which
require manual attention. Even with these limitations however, ClangFormat will
be extremely useful for your workflow!</p></blockquote>
<h2>Setup</h2>
-<h3>Install clang 3.5</h3>
+<h3>Install <code>clang-format-3.5</code></h3>
<h4>Ubuntu 14.04</h4>
@@ -106,32 +102,26 @@ sudo apt-get install clang-format-3.5
<h4>OS X Yosemite</h4>
-<pre><code class="bash"># Download and extract the clang-3.5 source.
-$ wget http://llvm.org/releases/3.5.0/cfe-3.5.0.src.tar.xz
-$ tar -xzf cfe-3.5.0.src.tar.xz
-
-# Download and extract the clang-3.5 pre-built binaries.
-$ wget
http://llvm.org/releases/3.5.0/clang+llvm-3.5.0-macosx-apple-darwin.tar.xz
-$ tar -xzf clang+llvm-3.5.0-macosx-apple-darwin.tar.xz
+<pre><code class="bash"># Install clang-3.5. The binaries are suffixed with
'-3.5', e.g. 'clang++-3.5'.
+$ brew install llvm35 --with-clang
-# Create a directory for clang.
-$ mkdir `brew --cellar`/clang
-
-# Install the pre-built binaries.
-$ mv clang+llvm-3.5.0-macosx-apple-darwin `brew --cellar`/clang/3.5
+# Download and install the clang-format scripts.
+$ wget http://llvm.org/releases/3.5.1/cfe-3.5.1.src.tar.xz
+$ tar -xzf cfe-3.5.1.src.tar.xz
+$ cp cfe-3.5.1.src/tools/clang-format/clang-format* `brew
--cellar`/llvm35/3.5.1/share/clang-3.5
+</code></pre>
-# Install the clang-format tools.
-$ mkdir `brew --cellar`/clang/3.5/share/clang
-$ cp cfe-3.5.0.src/tools/clang-format/clang-format* `brew
--cellar`/clang/3.5/share/clang
+<h3>Formatting Configuration</h3>
-# Link!
-$ brew link clang
-Linking /usr/local/Cellar/clang/3.5... 491 symlinks created
+<p>By default, ClangFormat uses the configuration defined in a
<code>.clang-format</code> or
+<code>_clang-format</code> file located in the nearest parent directory of the
input file.
+The <code>bootstrap</code> script creates a <code>.clang-format</code> symlink
at the top-level
+directory which points to <code>support/clang-format</code> for ClangFormat to
find.</p>
-# You can delete cleanly by running `brew uninstall clang`
-</code></pre>
+<blockquote><p>NOTE: If you’re using <code>clang-format-3.6</code>,
you’ll need to add a new option
+<code>BinPackArguments: false</code> to the <code>.clang-format</code>
file!</p></blockquote>
-<h3>Integrate with your editor</h3>
+<h3>Editor Integration</h3>
<h4>Vim</h4>
@@ -145,8 +135,8 @@ imap <C-K> <c-o>:pyf /usr/sh
<p>OS X:</p>
-<pre><code>map <C-K> :pyf
/usr/local/share/clang/clang-format.py<cr>
-imap <C-K> <c-o>:pyf
/usr/local/share/clang/clang-format.py<cr>
+<pre><code>map <C-K> :pyf
/usr/local/share/clang-3.5/clang-format.py<cr>
+imap <C-K> <c-o>:pyf
/usr/local/share/clang-3.5/clang-format.py<cr>
</code></pre>
<p>The first line enables clang-format for <code>NORMAL</code> and
<code>VISUAL</code> mode, the second line adds support for <code>INSERT</code>
mode. Change <code>C-K</code> to another binding if you need clang-format on a
different key (<code>C-K</code> stands for <code>Ctrl+k</code>).</p>
@@ -155,7 +145,7 @@ imap <C-K> <c-o>:pyf /usr/lo
<p>It operates on the current, potentially unsaved buffer and does not create
or save any files. To revert a formatting, just undo.</p>
-<blockquote><p>Source:
http://llvm.org/releases/3.5.0/tools/clang/docs/ClangFormat.html</p></blockquote>
+<blockquote><p>Source:
http://llvm.org/releases/3.5.1/tools/clang/docs/ClangFormat.html</p></blockquote>
<h4>Emacs</h4>
@@ -169,13 +159,13 @@ imap <C-K> <c-o>:pyf /usr/lo
<p>OS X:</p>
-<pre><code>(load "/usr/local/share/clang/clang-format.el")
+<pre><code>(load "/usr/local/share/clang-3.5/clang-format.el")
(global-set-key [C-M-tab] 'clang-format-region)
</code></pre>
<p>This binds the function <code>clang-format-region</code> to
<code>C-M-tab</code>, which then formats the current line or selected
region.</p>
-<blockquote><p>Source:
http://llvm.org/releases/3.5.0/tools/clang/docs/ClangFormat.html</p></blockquote>
+<blockquote><p>Source:
http://llvm.org/releases/3.5.1/tools/clang/docs/ClangFormat.html</p></blockquote>
<h2>Known Limitations</h2>
Modified:
mesos/site/publish/documentation/latest/mesos-c++-style-guide/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/mesos-c%2B%2B-style-guide/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/mesos-c++-style-guide/index.html
(original)
+++ mesos/site/publish/documentation/latest/mesos-c++-style-guide/index.html
Mon Apr 27 17:56:09 2015
@@ -91,9 +91,30 @@
<ul>
<li>We use <a
href="http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms";>lowerCamelCase</a>
for variable names (Google uses snake_case, and their class member variables
have trailing underscores).</li>
+<li>We prepend constructor and function arguments with a leading underscore to
avoid ambiguity and / or shadowing:</li>
</ul>
+<pre><code>Try(State _state, T* _t = NULL, const std::string& _message =
"")
+ : state(_state), t(_t), message(_message) {}
+</code></pre>
+
+<ul>
+<li><p>Prefer trailing underscores for use as member fields (but not
required). Some trailing underscores are used to distinguish between similar
variables in the same scope (think prime symbols), <em>but this should be
avoided as much as possible, including removing existing instances in the code
base.</em></p></li>
+<li><p>If you find yourself creating a copy of an argument passed by const
reference, consider passing it by value instead (if you don’t want to use
a leading underscore and copy in the body of the function):</p></li>
+</ul>
+
+
+<pre><code>// You can pass-by-value in ProtobufProcess::install() handlers.
+void Slave::statusUpdate(StatusUpdate update, const UPID& pid)
+{
+ ...
+ update.mutable_status()->set_source(
+ pid == UPID() ? TaskStatus::SOURCE_SLAVE : TaskStatus::SOURCE_EXECUTOR);
+ ...
+}
+</code></pre>
+
<h3>Constant Names</h3>
<ul>
@@ -126,7 +147,7 @@
<h2>Comments</h2>
<ul>
-<li>End each sentence with a period.</li>
+<li>End each sentence within a comment with a punctuation mark (please note
that we generally prefer periods); this applies to incomplete sentences as
well.</li>
<li>At most 70 characters per line in comments.</li>
<li>For trailing comments, leave one space.</li>
</ul>
@@ -157,16 +178,15 @@
</ul>
-<pre>
-// 1: OK.
-allocator->resourcesRecovered(frameworkId, slaveId, resources, filters);
+<pre><code>// 1: OK.
+allocator->resourcesRecovered(frameworkId, slaveId, resources, filters);
// 2: Don't use.
-allocator->resourcesRecovered(frameworkId, slaveId,
- resources, filters);
+allocator->resourcesRecovered(frameworkId, slaveId,
+ resources, filters);
// 3: Don't use in this case due to "jaggedness".
-allocator->resourcesRecovered(frameworkId,
+allocator->resourcesRecovered(frameworkId,
slaveId,
resources,
filters);
@@ -177,17 +197,16 @@ foobar(someArgument,
theLastArgument);
// 4: OK.
-allocator->resourcesRecovered(
+allocator->resourcesRecovered(
frameworkId,
slaveId,
resources,
filters);
// 5: OK.
-allocator->resourcesRecovered(
+allocator->resourcesRecovered(
frameworkId, slaveId, resources, filters);
-</pre>
-
+</code></pre>
<h3>Continuation</h3>
@@ -196,11 +215,9 @@ allocator->resourcesRecovered(
</ul>
-<pre>
-Try<Duration> failoverTimeout =
+<pre><code>Try&lt;Duration&gt; failoverTimeout =
Duration::create(FrameworkInfo().failover_timeout());
-</pre>
-
+</code></pre>
<h2>Empty Lines</h2>
@@ -218,28 +235,25 @@ Try<Duration> failoverTimeout =
<ul>
<li>Static assertions.</li>
<li>Multiple right angle brackets.</li>
-<li>Type inference (<code>auto</code> and <code>decltype</code>). The main
goal is to increase code readability. This is safely the case if the exact same
type omitted on the left is already fully stated on the right.</li>
-<li>Here are several examples:</li>
+<li>Type inference (<code>auto</code> and <code>decltype</code>). The main
goal is to increase code readability. This is safely the case if the exact same
type omitted on the left is already fully stated on the right. Here are several
examples:</li>
</ul>
-<pre>
-// 1: OK.
-const auto& i = values.find(keys.front());
+<pre><code>// 1: OK.
+const auto& i = values.find(keys.front());
// Compare with
-const typename map::iterator& i = values.find(keys.front());
+const typename map::iterator& i = values.find(keys.front());
// 2: OK.
-auto names = shared_ptr<list<string>>(new list<string>());
+auto names = shared_ptr<list<string>>(new list<string>());
// Compare with
-shared_ptr<list<string>> names = shared_ptr<list<string>>(new list<string>());
+shared_ptr<list<string>> names =
shared_ptr<list<string>>(new list<string>());
// 3: Don't use.
auto authorizer = LocalAuthorizer::create(acls);
// Compare with
-Try<Owned<LocalAuthorizer>> authorizer = LocalAuthorizer::create();
-</pre>
-
+Try&lt;Owned&lt;LocalAuthorizer>> authorizer =
LocalAuthorizer::create();
+</code></pre>
<ul>
<li>Rvalue references.</li>
@@ -247,16 +261,16 @@ Try<Owned<LocalAuthorizer>> author
<li>Mutexes.
<ul>
-<li>std::mutex.</li>
-<li>std::lock_guard<std::mutex>.</li>
-<li>std::unique_lock<std::mutex>.</li>
+<li><code>std::mutex</code></li>
+<li><code>std::lock_guard<std::mutex></code></li>
+<li><code>std::unique_lock<std::mutex></code></li>
</ul>
</li>
<li>Shared from this.
<ul>
-<li>class T : public std::enable_shared_from_this<T>.</li>
-<li>shared_from_this().</li>
+<li><code>class T : public std::enable_shared_from_this<T></code></li>
+<li><code>shared_from_this()</code></li>
</ul>
</li>
</ul>
Modified: mesos/site/publish/documentation/latest/powered-by-mesos/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/powered-by-mesos/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/powered-by-mesos/index.html
(original)
+++ mesos/site/publish/documentation/latest/powered-by-mesos/index.html Mon Apr
27 17:56:09 2015
@@ -87,6 +87,7 @@
<ul>
<li><a href="http://www.airbnb.com";>Airbnb</a></li>
+<li><a href="http://www.apple.com";>Apple</a></li>
<li><a href="http://www.artirix.com";>Artirix</a></li>
<li><a href="http://www.atigeo.com";>Atigeo</a></li>
<li><a href="http://www.atlassian.com";>Atlassian</a></li>
Modified: mesos/site/publish/documentation/latest/release-guide/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/release-guide/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/release-guide/index.html (original)
+++ mesos/site/publish/documentation/latest/release-guide/index.html Mon Apr 27
17:56:09 2015
@@ -99,7 +99,10 @@ e.g., <code>(gpg --list-sigs <your na
<li><p>Submit your GPG public key to a keyserver, e.g., <a
href="https://pgp.mit.edu";>MIT PGP Public Key Server</a>.</p></li>
<li><p>Add your GPG fingerprint to your <a
href="https://id.apache.org/";>Apache account</a>.</p></li>
<li><p>Create a Maven settings file (<code>~/.m2/settings.xml</code>) for the
Apache
-servers. Encrypt your Apache password using <code>mvn
--encrypt-password</code>.
+servers where you must copy your encrypted Apache password which
+you can get from running <code>mvn --encrypt-password</code> (NOTE: you may
+need to first generate a <a
href="http://maven.apache.org/guides/mini/guide-encryption.html";>master
+password</a>.
<code>
<settings>
<servers>
Modified: mesos/site/publish/documentation/mesos-c++-style-guide/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/mesos-c%2B%2B-style-guide/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/mesos-c++-style-guide/index.html (original)
+++ mesos/site/publish/documentation/mesos-c++-style-guide/index.html Mon Apr
27 17:56:09 2015
@@ -91,9 +91,30 @@
<ul>
<li>We use <a
href="http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms";>lowerCamelCase</a>
for variable names (Google uses snake_case, and their class member variables
have trailing underscores).</li>
+<li>We prepend constructor and function arguments with a leading underscore to
avoid ambiguity and / or shadowing:</li>
</ul>
+<pre><code>Try(State _state, T* _t = NULL, const std::string& _message =
"")
+ : state(_state), t(_t), message(_message) {}
+</code></pre>
+
+<ul>
+<li><p>Prefer trailing underscores for use as member fields (but not
required). Some trailing underscores are used to distinguish between similar
variables in the same scope (think prime symbols), <em>but this should be
avoided as much as possible, including removing existing instances in the code
base.</em></p></li>
+<li><p>If you find yourself creating a copy of an argument passed by const
reference, consider passing it by value instead (if you don’t want to use
a leading underscore and copy in the body of the function):</p></li>
+</ul>
+
+
+<pre><code>// You can pass-by-value in ProtobufProcess::install() handlers.
+void Slave::statusUpdate(StatusUpdate update, const UPID& pid)
+{
+ ...
+ update.mutable_status()->set_source(
+ pid == UPID() ? TaskStatus::SOURCE_SLAVE : TaskStatus::SOURCE_EXECUTOR);
+ ...
+}
+</code></pre>
+
<h3>Constant Names</h3>
<ul>
@@ -126,7 +147,7 @@
<h2>Comments</h2>
<ul>
-<li>End each sentence with a period.</li>
+<li>End each sentence within a comment with a punctuation mark (please note
that we generally prefer periods); this applies to incomplete sentences as
well.</li>
<li>At most 70 characters per line in comments.</li>
<li>For trailing comments, leave one space.</li>
</ul>
@@ -157,16 +178,15 @@
</ul>
-<pre>
-// 1: OK.
-allocator->resourcesRecovered(frameworkId, slaveId, resources, filters);
+<pre><code>// 1: OK.
+allocator->resourcesRecovered(frameworkId, slaveId, resources, filters);
// 2: Don't use.
-allocator->resourcesRecovered(frameworkId, slaveId,
- resources, filters);
+allocator->resourcesRecovered(frameworkId, slaveId,
+ resources, filters);
// 3: Don't use in this case due to "jaggedness".
-allocator->resourcesRecovered(frameworkId,
+allocator->resourcesRecovered(frameworkId,
slaveId,
resources,
filters);
@@ -177,17 +197,16 @@ foobar(someArgument,
theLastArgument);
// 4: OK.
-allocator->resourcesRecovered(
+allocator->resourcesRecovered(
frameworkId,
slaveId,
resources,
filters);
// 5: OK.
-allocator->resourcesRecovered(
+allocator->resourcesRecovered(
frameworkId, slaveId, resources, filters);
-</pre>
-
+</code></pre>
<h3>Continuation</h3>
@@ -196,11 +215,9 @@ allocator->resourcesRecovered(
</ul>
-<pre>
-Try<Duration> failoverTimeout =
+<pre><code>Try&lt;Duration&gt; failoverTimeout =
Duration::create(FrameworkInfo().failover_timeout());
-</pre>
-
+</code></pre>
<h2>Empty Lines</h2>
@@ -218,28 +235,25 @@ Try<Duration> failoverTimeout =
<ul>
<li>Static assertions.</li>
<li>Multiple right angle brackets.</li>
-<li>Type inference (<code>auto</code> and <code>decltype</code>). The main
goal is to increase code readability. This is safely the case if the exact same
type omitted on the left is already fully stated on the right.</li>
-<li>Here are several examples:</li>
+<li>Type inference (<code>auto</code> and <code>decltype</code>). The main
goal is to increase code readability. This is safely the case if the exact same
type omitted on the left is already fully stated on the right. Here are several
examples:</li>
</ul>
-<pre>
-// 1: OK.
-const auto& i = values.find(keys.front());
+<pre><code>// 1: OK.
+const auto& i = values.find(keys.front());
// Compare with
-const typename map::iterator& i = values.find(keys.front());
+const typename map::iterator& i = values.find(keys.front());
// 2: OK.
-auto names = shared_ptr<list<string>>(new list<string>());
+auto names = shared_ptr<list<string>>(new list<string>());
// Compare with
-shared_ptr<list<string>> names = shared_ptr<list<string>>(new list<string>());
+shared_ptr<list<string>> names =
shared_ptr<list<string>>(new list<string>());
// 3: Don't use.
auto authorizer = LocalAuthorizer::create(acls);
// Compare with
-Try<Owned<LocalAuthorizer>> authorizer = LocalAuthorizer::create();
-</pre>
-
+Try&lt;Owned&lt;LocalAuthorizer>> authorizer =
LocalAuthorizer::create();
+</code></pre>
<ul>
<li>Rvalue references.</li>
@@ -247,16 +261,16 @@ Try<Owned<LocalAuthorizer>> author
<li>Mutexes.
<ul>
-<li>std::mutex.</li>
-<li>std::lock_guard<std::mutex>.</li>
-<li>std::unique_lock<std::mutex>.</li>
+<li><code>std::mutex</code></li>
+<li><code>std::lock_guard<std::mutex></code></li>
+<li><code>std::unique_lock<std::mutex></code></li>
</ul>
</li>
<li>Shared from this.
<ul>
-<li>class T : public std::enable_shared_from_this<T>.</li>
-<li>shared_from_this().</li>
+<li><code>class T : public std::enable_shared_from_this<T></code></li>
+<li><code>shared_from_this()</code></li>
</ul>
</li>
</ul>
Modified: mesos/site/publish/documentation/powered-by-mesos/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/powered-by-mesos/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/powered-by-mesos/index.html (original)
+++ mesos/site/publish/documentation/powered-by-mesos/index.html Mon Apr 27
17:56:09 2015
@@ -87,6 +87,7 @@
<ul>
<li><a href="http://www.airbnb.com";>Airbnb</a></li>
+<li><a href="http://www.apple.com";>Apple</a></li>
<li><a href="http://www.artirix.com";>Artirix</a></li>
<li><a href="http://www.atigeo.com";>Atigeo</a></li>
<li><a href="http://www.atlassian.com";>Atlassian</a></li>
Modified: mesos/site/publish/documentation/release-guide/index.html
URL:
http://svn.apache.org/viewvc/mesos/site/publish/documentation/release-guide/index.html?rev=1676349&r1=1676348&r2=1676349&view=diff
==============================================================================
--- mesos/site/publish/documentation/release-guide/index.html (original)
+++ mesos/site/publish/documentation/release-guide/index.html Mon Apr 27
17:56:09 2015
@@ -99,7 +99,10 @@ e.g., <code>(gpg --list-sigs <your na
<li><p>Submit your GPG public key to a keyserver, e.g., <a
href="https://pgp.mit.edu";>MIT PGP Public Key Server</a>.</p></li>
<li><p>Add your GPG fingerprint to your <a
href="https://id.apache.org/";>Apache account</a>.</p></li>
<li><p>Create a Maven settings file (<code>~/.m2/settings.xml</code>) for the
Apache
-servers. Encrypt your Apache password using <code>mvn
--encrypt-password</code>.
+servers where you must copy your encrypted Apache password which
+you can get from running <code>mvn --encrypt-password</code> (NOTE: you may
+need to first generate a <a
href="http://maven.apache.org/guides/mini/guide-encryption.html";>master
+password</a>.
<code>
<settings>
<servers>
