Skip to content

Commit 19f6721

Browse files
Update feature applicability scopes in Editions guide.
PiperOrigin-RevId: 832326981
1 parent 6c1f1f2 commit 19f6721

File tree

1 file changed

+17
-16
lines changed

1 file changed

+17
-16
lines changed

content/editions/features.md

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,7 @@ and `export` keywords to set per-field behavior. Read more about this at
103103
except for a special-case caveat for `message { enum {} reserved 0 to max;
104104
}`. This will become the default in a future edition.
105105

106-
**Applicable to the following scope:** Enum, Message
106+
**Applicable to the following scope:** file
107107

108108
**Added in:** Edition 2024
109109

@@ -170,7 +170,8 @@ protos are round-trippable by default with a feature value to opt-out to use
170170
* `STYLE_LEGACY`: Applies the pre-Edition 2024 level of style guide
171171
enforcement.
172172

173-
**Applicable to the following scope:** File
173+
**Applicable to the following scopes:** file, extension range, message, field,
174+
oneof, enum, enum value, service, method
174175

175176
**Added in:** Edition 2024
176177

@@ -229,7 +230,7 @@ and after of a proto3 file.
229230
unknown field set.
230231
* `OPEN:` Open enums parse out of range values into their fields directly.
231232

232-
**Applicable to the following scopes:** File, Enum
233+
**Applicable to the following scopes:** file, enum
233234

234235
**Added in:** Edition 2023
235236

@@ -290,7 +291,7 @@ whether a protobuf field has a value.
290291
serialized onto the wire (even if it is explicitly set). `has_*` functions
291292
are not generated for fields set to `IMPLICIT`.
292293

293-
**Applicable to the following scopes:** File, Field
294+
**Applicable to the following scopes:** file, field
294295

295296
**Added in:** Edition 2023
296297

@@ -383,7 +384,7 @@ and after of a proto3 file. Editions behavior matches the behavior in proto3.
383384
JSON. Certain protos are allowed that can result in unspecified behavior at
384385
runtime (such as many:1 or 1:many mappings).
385386

386-
**Applicable to the following scopes:** File, Message, Enum
387+
**Applicable to the following scopes:** file, message, enum
387388

388389
**Added in:** Edition 2023
389390

@@ -446,7 +447,7 @@ the following conditions are met:
446447
* `DELIMITED`: Message-typed fields are encoded as
447448
[groups](/programming-guides/proto2#groups).
448449

449-
**Applicable to the following scopes:** File, Field
450+
**Applicable to the following scopes:** file, field
450451

451452
**Added in:** Edition 2023
452453

@@ -502,7 +503,7 @@ for `repeated` fields has been migrated to in Editions.
502503
* `EXPANDED`: `Repeated` fields are each encoded with the field number for
503504
each value.
504505

505-
**Applicable to the following scopes:** File, Field
506+
**Applicable to the following scopes:** file, field
506507

507508
**Added in:** Edition 2023
508509

@@ -581,7 +582,7 @@ and after of a proto3 file.
581582
Parsers may handle this type of field in an unpredictable way, such as
582583
replacing invalid characters. This is the default proto2 behavior.
583584

584-
**Applicable to the following scopes:** File, Field
585+
**Applicable to the following scopes:** file, field
585586

586587
**Added in:** Edition 2023
587588

@@ -647,7 +648,7 @@ blog post for an introduction.
647648
longer be directly accessed. Instead, the new accessor methods allow for
648649
getting, setting, or clearing a field.
649650

650-
**Applicable to the following scopes:** Message, File
651+
**Applicable to the following scopes:** message, file
651652

652653
**Added in:** Edition 2023
653654

@@ -699,7 +700,7 @@ in the migration guide for more on this topic.
699700
* `true`: The enum uses `string_view` for its values.
700701
* `false`: The enum uses `std::string` for its values.
701702
702-
**Applicable to the following scopes:** Enum, File
703+
**Applicable to the following scopes:** file, enum
703704
704705
**Added in:** Edition 2024
705706
@@ -729,7 +730,7 @@ example, switch statements are not supported.
729730
* `true`: Java enums will use the new functionality.
730731
* `false`: Java enums will continue to use Java enums.
731732
732-
**Applicable to the following scopes:** Enum
733+
**Applicable to the following scopes:** file, enum
733734
734735
**Added in:** Edition 2024
735736
@@ -762,7 +763,7 @@ before and after of a proto3 file.
762763
* `true`: Treats the enum as closed regardless of [`enum_type`](#enum_type).
763764
* `false`: Respect whatever is set in the `enum_type`.
764765
765-
**Applicable to the following scopes:** File, Field
766+
**Applicable to the following scopes:** file, field
766767
767768
**Added in:** Edition 2023
768769
@@ -828,7 +829,7 @@ becomes `BarBazProto`). You can still override this using the
828829
* `YES`: Nest the generated class in the file class.
829830
* Legacy: An internal value used when the `java_multiple_files` option is set.
830831

831-
**Applicable to the following scopes:** Message, Enum, Service
832+
**Applicable to the following scopes:** message, enum, service
832833

833834
**Added in:** Edition 2024
834835

@@ -861,7 +862,7 @@ removed.
861862
fields.
862863
* `STRING`: Generates `string` accessors for the field.
863864

864-
**Applicable to the following scopes:** File, Field
865+
**Applicable to the following scopes:** file, field
865866

866867
**Added in:** Edition 2023
867868

@@ -942,7 +943,7 @@ before and after of a proto3 file.
942943
* `VERIFY`: Overrides the file-level `features.utf8_validation` setting to
943944
force it to `VERIFY` for Java only.
944945

945-
**Applicable to the following scopes:** Field, File
946+
**Applicable to the following scopes:** file, field
946947

947948
**Added in:** Edition 2023
948949

@@ -1023,7 +1024,7 @@ generator strips the repetitive prefix or not.
10231024
name (to help with migrating your Go code).
10241025
* `STRIP_ENUM_PREFIX_STRIP`: Strip the enum name prefix from enum value names.
10251026

1026-
**Applicable to the following scopes:** Enum, File
1027+
**Applicable to the following scopes:** file, enum, enum value
10271028

10281029
**Added in:** Edition 2024
10291030

0 commit comments

Comments
 (0)