Skip to content

Commit 3a5a47c

Browse files
committed
deploy: cef52e9
1 parent 2f6a098 commit 3a5a47c

File tree

11 files changed

+90
-26
lines changed

11 files changed

+90
-26
lines changed

getting-started/javatutorial/index.html

Lines changed: 3 additions & 2 deletions
Large diffs are not rendered by default.

news/2022-02-05/index.html

Lines changed: 15 additions & 0 deletions
Large diffs are not rendered by default.

news/2024-01-31/index.html

Lines changed: 19 additions & 0 deletions
Large diffs are not rendered by default.

news/index.html

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,9 @@
44
<a href="https://github.com/protocolbuffers/protocolbuffers.github.io/new/main/content/news/_index.md?filename=change-me.md&amp;value=---%0Atitle%3A+%22Long+Page+Title%22%0AlinkTitle%3A+%22Short+Nav+Title%22%0Aweight%3A+100%0Adescription%3A+%3E-%0A+++++Page+description+for+heading+and+indexes.%0A---%0A%0A%23%23+Heading%0A%0AEdit+this+template+to+create+your+new+page.%0A%0A%2A+Give+it+a+good+name%2C+ending+in+%60.md%60+-+e.g.+%60getting-started.md%60%0A%2A+Edit+the+%22front+matter%22+section+at+the+top+of+the+page+%28weight+controls+how+its+ordered+amongst+other+pages+in+the+same+directory%3B+lowest+number+first%29.%0A%2A+Add+a+good+commit+message+at+the+bottom+of+the+page+%28%3C80+characters%3B+use+the+extended+description+field+for+more+detail%29.%0A%2A+Create+a+new+branch+so+you+can+preview+your+new+file+and+request+a+review+via+Pull+Request.%0A" class=td-page-meta--child target=_blank rel=noopener><i class="fa-solid fa-pen-to-square fa-fw"></i> Create child page</a>
55
<a href="https://github.com/protocolbuffers/protocolbuffers.github.io/issues/new?title=News" class=td-page-meta--issue target=_blank rel=noopener><i class="fa-solid fa-list-check fa-fw"></i> Create documentation issue</a>
66
<a href=https://github.com/protocolbuffers/protobuf/issues/new class=td-page-meta--project-issue target=_blank rel=noopener><i class="fa-solid fa-list-check fa-fw"></i> Create project issue</a></div></aside><main class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb class="td-breadcrumbs td-breadcrumbs__single"><ol class=breadcrumb><li class="breadcrumb-item active" aria-current=page><a href=https://protobuf.dev/news/ aria-disabled=true class="btn-link disabled">News</a></li></ol></nav><div class=td-content><h1>News</h1><div class=lead>Get the latest news about Protocol Buffers.</div><header class=article-meta></header><p>News topics provide information about past events and changes with Protocol
7-
Buffers, and plans for upcoming changes.</p><ul><li><a href=/news/2024-01-05>January 5, 2024</a> - Breaking
7+
Buffers, and plans for upcoming changes.</p><ul><li><a href=/news/2024-02-05>February 5, 2024</a> - Breaking
8+
changes in Java, C++, and Python in the 26.x line.</li><li><a href=/news/2024-01-31>January 31, 2024</a> - Breaking
9+
changes in the 26.x line for Python</li><li><a href=/news/2024-01-05>January 5, 2024</a> - Breaking
810
changes in the 26.x line for Ruby and Python</li><li><a href=/news/2023-12-27>December 27, 2023</a> - Breaking
911
changes in the 26.x line for Ruby, PHP, Python, and upb</li><li><a href=/news/2023-12-13>December 13, 2023</a> - Breaking
1012
Python and C++ changes in the 26.x line</li><li><a href=/news/2023-12-05>December 5, 2023</a> - Breaking Java

programming-guides/field_presence/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -305,6 +305,6 @@
305305
</span></span><span style=display:flex><span> <span style=color:#8f5902;font-style:italic>// Field is not present, so set it.
306306
</span></span></span><span style=display:flex><span><span style=color:#8f5902;font-style:italic></span> <span style=color:#000;font-weight:700>[</span><span style=color:#000>m</span> <span style=color:#f57900>setFoo</span><span style=color:#000;font-weight:700>:</span><span style=color:#0000cf;font-weight:700>1</span><span style=color:#000;font-weight:700>];</span>
307307
</span></span><span style=display:flex><span><span style=color:#000;font-weight:700>}</span>
308-
</span></span></code></pre></div><h2 id=cheat>Cheat sheet</h2><p><strong>Proto2:</strong></p><p>Is field presence tracked?</p><table><thead><tr><th>Field type</th><th>Tracked?</th></tr></thead><tbody><tr><td>Singular field</td><td>yes</td></tr><tr><td>Singular message field</td><td>yes</td></tr><tr><td>Field in a oneof</td><td>yes</td></tr><tr><td>Repeated field & map</td><td>no</td></tr></tbody></table><p><strong>Proto3:</strong></p><p>Is field presence tracked?</p><table><thead><tr><th>Field type</th><th>Tracked?</th></tr></thead><tbody><tr><td>Singular message field</td><td>yes</td></tr><tr><td>Field in a oneof</td><td>yes</td></tr><tr><td><em>Other</em> singular field</td><td>if defined as <code>optional</code></td></tr><tr><td>Repeated field & map</td><td>no</td></tr></tbody></table><p><strong>Edition 2023:</strong></p><p>Is field presence tracked?</p><table><thead><tr><th>Field type</th><th>Tracked?</th></tr></thead><tbody><tr><td>Default</td><td>yes</td></tr><tr><td><code>features.field_presence</code> set to <code>LEGACY_REQUIRED</code></td><td>yes</td></tr><tr><td><code>features.field_presence</code> set to <code>IMPLICIT</code></td><td>no</td></tr><tr><td>Repeated field & map</td><td>no</td></tr></tbody></table></div></main></div></div><footer class="bg-dark py-5 row d-print-none"><div class="container-fluid mx-sm-5"><div class=row><div class="col-6 col-sm-4 text-xs-center order-sm-2"><ul class="list-inline mb-0"><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title="Stack Overflow" aria-label="Stack Overflow"><a class=text-white target=_blank rel=noopener href=https://stackoverflow.com/questions/tagged/protocol-buffers aria-label="Stack Overflow"><i class="fab fa-stack-overflow"></i></a></li></ul><script type=text/javascript id=cookiebanner src=https://cdn.jsdelivr.net/gh/dobarkod/[email protected]/dist/cookiebanner.min.js data-height=50px data-message="Protobuf.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic." data-bg=#ffb data-fg=#000 data-position=bottom data-padding="10px 16px" data-close-text="OK, got it" data-font-size=18px data-moreinfo=https://policies.google.com/technologies/cookies></script></div><div class="col-6 col-sm-4 text-right text-xs-center order-sm-3"><ul class="list-inline mb-0"><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title=GitHub aria-label=GitHub><a class=text-white target=_blank rel=noopener href=https://github.com/protocolbuffers/protobuf aria-label=GitHub><i class="fab fa-github"></i></a></li><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title="Developer mailing list" aria-label="Developer mailing list"><a class=text-white target=_blank rel=noopener href=https://groups.google.com/g/protobuf aria-label="Developer mailing list"><i class="fa fa-envelope"></i></a></li></ul><script type=text/javascript id=cookiebanner src=https://cdn.jsdelivr.net/gh/dobarkod/[email protected]/dist/cookiebanner.min.js data-height=50px data-message="Protobuf.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic." data-bg=#ffb data-fg=#000 data-position=bottom data-padding="10px 16px" data-close-text="OK, got it" data-font-size=18px data-moreinfo=https://policies.google.com/technologies/cookies></script></div><div class="col-12 col-sm-4 text-center py-2 order-sm-2"><small class=text-white>&copy; 2024 Google LLC All Rights Reserved</small>
308+
</span></span></code></pre></div><h2 id=cheat>Cheat sheet</h2><p><strong>Proto2:</strong></p><p>Is field presence tracked?</p><table><thead><tr><th>Field type</th><th>Tracked?</th></tr></thead><tbody><tr><td>Singular field</td><td>yes</td></tr><tr><td>Singular message field</td><td>yes</td></tr><tr><td>Field in a oneof</td><td>yes</td></tr><tr><td>Repeated field & map</td><td>no</td></tr></tbody></table><p><strong>Proto3:</strong></p><p>Is field presence tracked?</p><table><thead><tr><th>Field type</th><th>Tracked?</th></tr></thead><tbody><tr><td><em>Other</em> singular field</td><td>if defined as <code>optional</code></td></tr><tr><td>Singular message field</td><td>yes</td></tr><tr><td>Field in a oneof</td><td>yes</td></tr><tr><td>Repeated field & map</td><td>no</td></tr></tbody></table><p><strong>Edition 2023:</strong></p><p>Is field presence tracked?</p><table><thead><tr><th>Field type</th><th>Tracked?</th></tr></thead><tbody><tr><td>Default</td><td>yes</td></tr><tr><td><code>features.field_presence</code> set to <code>LEGACY_REQUIRED</code></td><td>yes</td></tr><tr><td><code>features.field_presence</code> set to <code>IMPLICIT</code></td><td>no</td></tr><tr><td>Repeated field & map</td><td>no</td></tr></tbody></table></div></main></div></div><footer class="bg-dark py-5 row d-print-none"><div class="container-fluid mx-sm-5"><div class=row><div class="col-6 col-sm-4 text-xs-center order-sm-2"><ul class="list-inline mb-0"><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title="Stack Overflow" aria-label="Stack Overflow"><a class=text-white target=_blank rel=noopener href=https://stackoverflow.com/questions/tagged/protocol-buffers aria-label="Stack Overflow"><i class="fab fa-stack-overflow"></i></a></li></ul><script type=text/javascript id=cookiebanner src=https://cdn.jsdelivr.net/gh/dobarkod/[email protected]/dist/cookiebanner.min.js data-height=50px data-message="Protobuf.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic." data-bg=#ffb data-fg=#000 data-position=bottom data-padding="10px 16px" data-close-text="OK, got it" data-font-size=18px data-moreinfo=https://policies.google.com/technologies/cookies></script></div><div class="col-6 col-sm-4 text-right text-xs-center order-sm-3"><ul class="list-inline mb-0"><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title=GitHub aria-label=GitHub><a class=text-white target=_blank rel=noopener href=https://github.com/protocolbuffers/protobuf aria-label=GitHub><i class="fab fa-github"></i></a></li><li class="list-inline-item mx-2 h3" data-toggle=tooltip data-placement=top title="Developer mailing list" aria-label="Developer mailing list"><a class=text-white target=_blank rel=noopener href=https://groups.google.com/g/protobuf aria-label="Developer mailing list"><i class="fa fa-envelope"></i></a></li></ul><script type=text/javascript id=cookiebanner src=https://cdn.jsdelivr.net/gh/dobarkod/[email protected]/dist/cookiebanner.min.js data-height=50px data-message="Protobuf.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic." data-bg=#ffb data-fg=#000 data-position=bottom data-padding="10px 16px" data-close-text="OK, got it" data-font-size=18px data-moreinfo=https://policies.google.com/technologies/cookies></script></div><div class="col-12 col-sm-4 text-center py-2 order-sm-2"><small class=text-white>&copy; 2024 Google LLC All Rights Reserved</small>
309309
<small class=ml-1><a href=https://policies.google.com/privacy target=_blank rel=noopener>Privacy Policy</a></small>
310310
<span class=text-white>Hosted by GitHub Pages.</span> <a href=https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement target=_blank>GitHub Privacy Statement</a></div></div></div></footer></div><script src=/js/main.min.ba08a6b7f24e657f0a1b9b55be3a3162585168cd862ace0957f5b44e6cb6dc61.js integrity="sha256-ugimt/JOZX8KG5tVvjoxYlhRaM2GKs4JV/W0Tmy23GE=" crossorigin=anonymous></script><script src=/js/tabpane-persist.js></script></body></html>

programming-guides/proto2/index.html

Lines changed: 15 additions & 6 deletions
Large diffs are not rendered by default.

programming-guides/proto3/index.html

Lines changed: 7 additions & 4 deletions
Large diffs are not rendered by default.

reference/python/index.xml

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -375,8 +375,11 @@ For example:&lt;/p>
375375
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#000">foo&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">.&lt;/span>&lt;span style="color:#000">bars&lt;/span>&lt;span style="color:#000;font-weight:bold">[&lt;/span>&lt;span style="color:#0000cf;font-weight:bold">0&lt;/span>&lt;span style="color:#000;font-weight:bold">]&lt;/span> &lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span> &lt;span style="color:#000">Bar&lt;/span>&lt;span style="color:#000;font-weight:bold">(&lt;/span>&lt;span style="color:#000">i&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span>&lt;span style="color:#0000cf;font-weight:bold">15&lt;/span>&lt;span style="color:#000;font-weight:bold">)&lt;/span> &lt;span style="color:#8f5902;font-style:italic"># Raises an exception&lt;/span>
376376
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#8f5902;font-style:italic"># WRONG!&lt;/span>
377377
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#000">foo&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">.&lt;/span>&lt;span style="color:#000">bars&lt;/span>&lt;span style="color:#000;font-weight:bold">[:]&lt;/span> &lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span> &lt;span style="color:#000;font-weight:bold">[&lt;/span>&lt;span style="color:#000">Bar&lt;/span>&lt;span style="color:#000;font-weight:bold">(&lt;/span>&lt;span style="color:#000">i&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span>&lt;span style="color:#0000cf;font-weight:bold">15&lt;/span>&lt;span style="color:#000;font-weight:bold">),&lt;/span> &lt;span style="color:#000">Bar&lt;/span>&lt;span style="color:#000;font-weight:bold">(&lt;/span>&lt;span style="color:#000">i&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span>&lt;span style="color:#0000cf;font-weight:bold">17&lt;/span>&lt;span style="color:#000;font-weight:bold">)]&lt;/span> &lt;span style="color:#8f5902;font-style:italic"># Also raises an exception&lt;/span>
378-
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#8f5902;font-style:italic"># RIGHT&lt;/span>
378+
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#8f5902;font-style:italic"># WRONG!&lt;/span>
379+
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#8f5902;font-style:italic"># AttributeError: Cannot delete field attribute&lt;/span>
379380
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#204a87;font-weight:bold">del&lt;/span> &lt;span style="color:#000">foo&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">.&lt;/span>&lt;span style="color:#000">bars&lt;/span>
381+
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#8f5902;font-style:italic"># RIGHT&lt;/span>
382+
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#204a87;font-weight:bold">del&lt;/span> &lt;span style="color:#000">foo&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">.&lt;/span>&lt;span style="color:#000">bars&lt;/span>&lt;span style="color:#000;font-weight:bold">[:]&lt;/span>
380383
&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#000">foo&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">.&lt;/span>&lt;span style="color:#000">bars&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">.&lt;/span>&lt;span style="color:#000">extend&lt;/span>&lt;span style="color:#000;font-weight:bold">([&lt;/span>&lt;span style="color:#000">Bar&lt;/span>&lt;span style="color:#000;font-weight:bold">(&lt;/span>&lt;span style="color:#000">i&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span>&lt;span style="color:#0000cf;font-weight:bold">15&lt;/span>&lt;span style="color:#000;font-weight:bold">),&lt;/span> &lt;span style="color:#000">Bar&lt;/span>&lt;span style="color:#000;font-weight:bold">(&lt;/span>&lt;span style="color:#000">i&lt;/span>&lt;span style="color:#ce5c00;font-weight:bold">=&lt;/span>&lt;span style="color:#0000cf;font-weight:bold">17&lt;/span>&lt;span style="color:#000;font-weight:bold">)])&lt;/span>
381384
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="groups-proto2">Groups (proto2)&lt;/h3>
382385
&lt;p>&lt;strong>Note that groups are deprecated and should not be used when creating new

reference/python/python-generated/index.html

Lines changed: 5 additions & 2 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)