Skip to content

Commit 9bbf6f5

Browse files
LogofileLogofile
authored
Merge pull request #12 from Logofile/sync
Project import generated by Copybara.
2 parents 422eaf7 + 0a8fabf commit 9bbf6f5

File tree

132 files changed

+2558
-2552
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

132 files changed

+2558
-2552
lines changed

‎.github/workflows/gh-pages.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ jobs:
2020
with:
2121
hugo-version: 'latest'
2222
extended: true
23-
23+
2424
- name: Install Dependencies
2525
run: npm install autoprefixer postcss postcss-cli
2626

@@ -33,4 +33,4 @@ jobs:
3333
with:
3434
github_token: ${{ secrets.GITHUB_TOKEN }}
3535
publish_dir: ./public
36-
cname: protobuf.dev
36+
cname: protobuf.dev

‎config.toml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -85,8 +85,8 @@ weight = 1
8585
# Everything below this are Site Params
8686

8787
# Comment out if you don't want the "print entire section" link enabled.
88-
[outputs]
89-
section = ["HTML", "print", "RSS"]
88+
# [outputs]
89+
# section = ["HTML", "print", "RSS"]
9090

9191
[params]
9292
description = "Protocol buffers is a language-neutral, platform-neutral extensible mechanism for serializing structured data."
@@ -160,10 +160,10 @@ ui.sidebar_menu_foldable = true
160160
# If you want this feature, but occasionally need to remove the "Feedback" section from a single page,
161161
# add "hide_feedback: true" to the page's front matter.
162162
[params.ui.feedback]
163-
enable = true
163+
enable = false
164164
# The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful).
165-
yes = 'Glad to hear it! Please <a href="https://github.com/USERNAME/REPOSITORY/issues/new">tell us how we can improve</a>.'
166-
no = 'Sorry to hear that. Please <a href="https://github.com/USERNAME/REPOSITORY/issues/new">tell us how we can improve</a>.'
165+
yes = 'Glad to hear it! Please <a href="https://github.com/protocolbuffers/protocolbuffers.github.io/issues/new">tell us how we can improve</a>.'
166+
no = 'Sorry to hear that. Please <a href="https://github.com/protocolbuffers/protocolbuffers.github.io/issues/new">tell us how we can improve</a>.'
167167

168168
# Adds a reading time to the top of each doc.
169169
# If you want this feature, but occasionally need to remove the Reading time from a single page,

‎content/programming-guides/api.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -424,9 +424,10 @@ message Foo {
424424
}
425425
```
426426

427-
Only fields with high [cohesion](http://what/cohesion) should be nested. If the
428-
fields are genuinely related, you'll often want to pass them around together
429-
inside a server. That's easier if they're defined together in a message. Think:
427+
Only fields with high cohesion should be
428+
nested. If the fields are genuinely related, you'll often want to pass them
429+
around together inside a server. That's easier if they're defined together in a
430+
message. Think:
430431

431432
```java
432433
CurrencyAmount calculateLocalTax(CurrencyAmount price, Location where)

‎content/reference/_index.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ details, see [Other Languages](/reference/other).
2525

2626
- [C++ Generated Code Guide](/reference/cpp/cpp-generated)
2727
- [C++ Arena Allocation Guide](/reference/cpp/arenas)
28-
- [C++ Static Reflection](/reference/cpp/cpp-static-reflection)
28+
2929
- [C++ API](/reference/cpp/api-docs/)
3030

3131
### C\# Reference
@@ -48,6 +48,7 @@ details, see [Other Languages](/reference/other).
4848
### Java Reference
4949

5050
- [Java Generated Code Guide](/reference/java/java-generated)
51+
- [Java Proto Names](/reference/java/java-proto-names)
5152
- [Java API (Javadoc)](/reference/java/api-docs/overview-summary.html)
5253

5354
### Kotlin Reference

‎content/reference/cpp/api-docs/google.protobuf.compiler.plugin.pb.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
toc_hide: "true"
33
---
44

5-
<html devsite><head><title>plugin.pb.h</title><meta name="project_path" value="/protocol-buffers/_project.yaml" /><meta name="book_path" value="/protocol-buffers/_book.yaml" /></head><body><h1>plugin.pb.h</h1><p><code>#include &lt;google/protobuf/compiler/plugin.pb.h&gt;<br>namespace <a href="#google.protobuf.compiler">google::protobuf::compiler</a></code></p><p>API for protoc plugins.</p><p>This file defines a set of protocol message classes which make up the API to protoc code generator plugins. Plugins written in C++ should probably build on the API in <a href='google.protobuf.compiler.plugin'>plugin.h</a> instead of dealing with the protobuf-level API, but plugins in other languages will need to deal with the raw messages as defined below.</p><p>The protocol compiler currently doesn't support auto-generated documentation, hence this page contains no descriptions. This file was generated by the protocol compiler from <code>plugin.proto</code>, whose contents are as follows:</p>
5+
<html devsite><head><title>plugin.pb.h</title><meta name="project_path" value="/protocol-buffers/_project.yaml" /><meta name="book_path" value="/protocol-buffers/_book.yaml" /></head><body><h1>plugin.pb.h</h1><p><code>#include &lt;google/protobuf/compiler/plugin.pb.h&gt;<br>namespace <a href="#google.protobuf.compiler">google::protobuf::compiler</a></code></p><p>API for protoc plugins.</p><p>This file defines a set of protocol message classes which make up the API to protoc code generator plugins. Plugins written in C++ should probably build on the API in <a href="google.protobuf.compiler.plugin">plugin.h</a> instead of dealing with the protobuf-level API, but plugins in other languages will need to deal with the raw messages as defined below.</p><p>The protocol compiler currently doesn't support auto-generated documentation, hence this page contains no descriptions. This file was generated by the protocol compiler from <code>plugin.proto</code>, whose contents are as follows:</p>
66
<pre>// Protocol Buffers - Google's data interchange format
77
// Copyright 2008 Google Inc. All rights reserved.
88
// https://developers.google.com/protocol-buffers/

‎content/reference/cpp/api-docs/google.protobuf.message.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
toc_hide: "true"
33
---
44

5-
<html devsite><head><title>message.h</title><meta name="project_path" value="/protocol-buffers/_project.yaml" /><meta name="book_path" value="/protocol-buffers/_book.yaml" /></head><body><h1>message.h</h1><p><code>#include &lt;google/protobuf/message.h&gt;<br>namespace <a href="#google.protobuf">google::protobuf</a></code></p><p>Defines <a href='google.protobuf.message#Message'>Message</a>, the abstract interface implemented by non-lite protocol message objects. </p><p>Although it's possible to implement this interface manually, most users will use the protocol compiler to generate implementations.</p>
5+
<html devsite><head><title>message.h</title><meta name="project_path" value="/protocol-buffers/_project.yaml" /><meta name="book_path" value="/protocol-buffers/_book.yaml" /></head><body><h1>message.h</h1><p><code>#include &lt;google/protobuf/message.h&gt;<br>namespace <a href="#google.protobuf">google::protobuf</a></code></p><p>Defines <a href="google.protobuf.message#Message">Message</a>, the abstract interface implemented by non-lite protocol message objects. </p><p>Although it's possible to implement this interface manually, most users will use the protocol compiler to generate implementations.</p>
66
<p>Example usage:</p>
77
<p>Say you have a message defined as:</p>
88
<pre>message Foo {

‎content/reference/go/go-generated.md‎

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ for any given protocol definition. Any differences between proto2 and proto3
1414
generated code are highlighted - note that these differences are in the
1515
generated code as described in this document, not the base API, which are the
1616
same in both versions. You should read the
17-
[proto2 language guide](/programming-guides/proto) and/or the
18-
[proto3 language guide](/programming-guides/proto3) before reading this
19-
document.
17+
[proto2 language guide](/programming-guides/proto) and/or
18+
the [proto3 language guide](/programming-guides/proto3)
19+
before reading this document.
2020

2121
## Compiler Invocation {#invocation}
2222

@@ -124,10 +124,10 @@ the same package). The import path is also used to construct output filenames.
124124
See the \"Compiler Invocation\" section above for details.
125125

126126
There is no correlation between the Go import path and the
127-
[`package` specifier](/programming-guides/proto3#packages) in the `.proto`
128-
file. The latter is only relevant to the protobuf namespace, while the former is
129-
only relevant to the Go namespace. Also, there is no correlation between the Go
130-
import path and the `.proto` import path.
127+
[`package` specifier](/programming-guides/proto3#packages)
128+
in the `.proto` file. The latter is only relevant to the protobuf namespace,
129+
while the former is only relevant to the Go namespace. Also, there is no
130+
correlation between the Go import path and the `.proto` import path.
131131

132132
## Messages {#message}
133133

@@ -175,8 +175,8 @@ it is a singular, repeated, map, or oneof field.
175175

176176
Note that the generated Go field names always use camel-case naming, even if the
177177
field name in the `.proto` file uses lower-case with underscores
178-
([as it should](/programming-guides/style)). The case-conversion works as
179-
follows:
178+
([as it should](/programming-guides/style)). The
179+
case-conversion works as follows:
180180

181181
1. The first letter is capitalized for export. If the first character is an
182182
underscore, it is removed and a capital X is prepended.
@@ -220,8 +220,8 @@ if the field is unset (`0` for numbers, the empty string for strings).
220220

221221
For other scalar field types (including `bool`, `bytes`, and `string`), `int32`
222222
is replaced with the corresponding Go type according to the
223-
[scalar value types table](/programming-guides/proto3#scalar). Unset values
224-
in the proto will be represented as the
223+
[scalar value types table](/programming-guides/proto3#scalar).
224+
Unset values in the proto will be represented as the
225225
[zero value](https://golang.org/ref/spec#The_zero_value) of that type
226226
(`0` for numbers, the empty string for strings).
227227

@@ -459,6 +459,9 @@ returns the corresponding pointer:
459459
func (Foo) Enum() *Foo
460460
```
461461

462+
If you use proto3 syntax for your `.proto` definition, the `Enum()` method is
463+
not generated.
464+
462465
The protocol buffer compiler generates a constant for each value in the enum.
463466
For enums within a message, the constants begin with the enclosing message's
464467
name:

‎content/reference/php/api-docs-link.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,5 +4,5 @@
44
title: "PHP API"
55
manualLink: "/reference/php/api-docs/"
66
manualLinkTarget: "_blank"
7-
weight: 530
7+
weight: 735
88
---

‎content/reference/php/api-docs/Google.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="UTF-8" />
55
<meta name="robots" content="index, follow, all" />
6-
<title>Google | Google Protobuf - v21.10</title>
6+
<title>Google | Google Protobuf - v3.21.10</title>
77

88
<link rel="stylesheet" type="text/css" href="css/bootstrap.min.css">
99
<link rel="stylesheet" type="text/css" href="css/bootstrap-theme.min.css">
@@ -57,7 +57,7 @@
5757
<span class="icon-bar"></span>
5858
<span class="icon-bar"></span>
5959
</button>
60-
<a class="navbar-brand" href="index.html">Google Protobuf - v21.10</a>
60+
<a class="navbar-brand" href="index.html">Google Protobuf - v3.21.10</a>
6161
</div>
6262
<div class="collapse navbar-collapse" id="navbar-elements">
6363
<ul class="nav navbar-nav">

‎content/reference/php/api-docs/Google/Protobuf.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="UTF-8" />
55
<meta name="robots" content="index, follow, all" />
6-
<title>Google\Protobuf | Google Protobuf - v21.10</title>
6+
<title>Google\Protobuf | Google Protobuf - v3.21.10</title>
77

88
<link rel="stylesheet" type="text/css" href="../css/bootstrap.min.css">
99
<link rel="stylesheet" type="text/css" href="../css/bootstrap-theme.min.css">
@@ -57,7 +57,7 @@
5757
<span class="icon-bar"></span>
5858
<span class="icon-bar"></span>
5959
</button>
60-
<a class="navbar-brand" href="../index.html">Google Protobuf - v21.10</a>
60+
<a class="navbar-brand" href="../index.html">Google Protobuf - v3.21.10</a>
6161
</div>
6262
<div class="collapse navbar-collapse" id="navbar-elements">
6363
<ul class="nav navbar-nav">

0 commit comments

Comments
 (0)