Deployed b0cc1a9 to dev with MkDocs 1.3.0 and mike 1.1.2

Author: ArduinoBot

dev/UPGRADING/index.html

@@ -317,6 +317,13 @@
     The gRPC cc.arduino.cli.commands.v1.CompileRequest.export_binaries changed type.
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#some-grpc-responses-messages-now-uses-the-oneof-clause" class="md-nav__link">
+    Some gRPC responses messages now uses the oneof clause.
+  </a>
+  
 </li>
 
           <li class="md-nav__item">
@@ -2599,6 +2606,13 @@
     The gRPC cc.arduino.cli.commands.v1.CompileRequest.export_binaries changed type.
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#some-grpc-responses-messages-now-uses-the-oneof-clause" class="md-nav__link">
+    Some gRPC responses messages now uses the oneof clause.
+  </a>
+  
 </li>
 
           <li class="md-nav__item">
@@ -3957,6 +3971,48 @@ <h3 id="the-grpc-ccarduinoclicommandsv1compilerequestexport_binaries-changed-typ
 <p>Previously the field <code>export_binaries</code> was a <code>google.protobuf.BoolValue</code>. We used this type because it expresses this
 field's optional nature (that is, it could be <code>true</code>, <code>false</code>, and <code>null</code> if not set).</p>
 <p>Now the field is an <code>optional bool</code>, since the latest protobuf protocol changes now allows optional fields.</p>
+<h3 id="some-grpc-responses-messages-now-uses-the-oneof-clause">Some gRPC responses messages now uses the <code>oneof</code> clause.<a class="headerlink" href="#some-grpc-responses-messages-now-uses-the-oneof-clause" title="Permanent link">&para;</a></h3>
+<p>The following responses message:</p>
+<ul>
+<li><code>cc.arduino.cli.commands.v1.PlatformInstallResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.PlatformDownloadResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.PlatformUninstallResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.PlatformUpgradeResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.DebugResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.LibraryDownloadResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.LibraryInstallResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.LibraryUpgradeResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.LibraryUninstallResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.LibraryUpgradeAllResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.ZipLibraryInstallResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.GitLibraryInstallResponse</code></li>
+<li><code>cc.arduino.cli.commands.v1.MonitorResponse</code></li>
+</ul>
+<p>now use the <code>oneof</code> clause to make the stream nature of the message more explicit. Just to give an example, the
+<code>PlatformInstallResponse</code> message has been changed from:</p>
+<div class="highlight"><pre><span></span><code><span class="kd">message</span><span class="w"> </span><span class="nc">PlatformInstallResponse</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Progress of the downloads of the platform and tool files.</span>
+<span class="w">  </span><span class="n">DownloadProgress</span><span class="w"> </span><span class="na">progress</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w">  </span><span class="c1">// Description of the current stage of the installation.</span>
+<span class="w">  </span><span class="n">TaskProgress</span><span class="w"> </span><span class="na">task_progress</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="p">}</span>
+</code></pre></div>
+<p>to:</p>
+<div class="highlight"><pre><span></span><code><span class="kd">message</span><span class="w"> </span><span class="nc">PlatformInstallResponse</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kd">message</span><span class="w"> </span><span class="nc">Result</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="c1">// Empty message, reserved for future expansion.</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="k">oneof</span><span class="w"> </span><span class="kd">message</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="c1">// Progress of the downloads of the platform and tool files.</span>
+<span class="w">    </span><span class="n">DownloadProgress</span><span class="w"> </span><span class="na">progress</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w">    </span><span class="c1">// Description of the current stage of the installation.</span>
+<span class="w">    </span><span class="n">TaskProgress</span><span class="w"> </span><span class="na">task_progress</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="w">    </span><span class="c1">// The installation result.</span>
+<span class="w">    </span><span class="n">Result</span><span class="w"> </span><span class="na">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">3</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+</code></pre></div>
+<p>The other messages have been changed in a similar way.</p>
 <h3 id="the-grpc-ccarduinoclicommandsv1updateindexresponse-and-updatelibrariesindexresponse-have-changed">The gRPC <code>cc.arduino.cli.commands.v1.UpdateIndexResponse</code> and <code>UpdateLibrariesIndexResponse</code> have changed.<a class="headerlink" href="#the-grpc-ccarduinoclicommandsv1updateindexresponse-and-updatelibrariesindexresponse-have-changed" title="Permanent link">&para;</a></h3>
 <p>The responses coming from the update index commands:</p>
 <div class="highlight"><pre><span></span><code><span class="kd">message</span><span class="w"> </span><span class="nc">UpdateIndexResponse</span><span class="w"> </span><span class="p">{</span>