• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
12022-09-29 version 3.20.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby)
2
3
42022-09-27 version 3.20.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby)
5  Java
6  * Refactoring java full runtime to reuse sub-message builders and prepare to
7    migrate parsing logic from parse constructor to builder.
8  * Move proto wireformat parsing functionality from the private "parsing
9    constructor" to the Builder class.
10  * Change the Lite runtime to prefer merging from the wireformat into mutable
11    messages rather than building up a new immutable object before merging. This
12    way results in fewer allocations and copy operations.
13  * Make message-type extensions merge from wire-format instead of building up
14    instances and merging afterwards. This has much better performance.
15  * Fix TextFormat parser to build up recurring (but supposedly not repeated)
16    sub-messages directly from text rather than building a new sub-message and
17    merging the fully formed message into the existing field.
18
192022-09-13 version 3.20.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby)
20
21C++
22* Reduce memory consumption of MessageSet parsing
23
242022-04-05 version 3.20.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
25
26  PHP
27  * Fix building packaged PHP extension (#9727)
28  * Fixed composer.json to only advertise compatibility with PHP 7.0+.  (#9819)
29
30  Ruby
31  * Disable the aarch64 build on macOS until it can be fixed. (#9816)
32
33  Other
34  * Fix versioning issues in 3.20.0
35
362022-03-04 version 3.20.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
37
38  Ruby
39  * Dropped Ruby 2.3 and 2.4 support for CI and releases. (#9311)
40  * Added Ruby 3.1 support for CI and releases (#9566).
41  * Message.decode/encode: Add recursion_limit option (#9218/#9486)
42  * Allocate with xrealloc()/xfree() so message allocation is visible to the
43    Ruby GC.  In certain tests this leads to much lower memory usage due to more
44    frequent GC runs (#9586).
45  * Fix conversion of singleton classes in Ruby (#9342)
46  * Suppress warning for intentional circular require (#9556)
47  * JSON will now output shorter strings for double and float fields when possible
48    without losing precision.
49  * Encoding and decoding of binary format will now work properly on big-endian
50    systems.
51  * UTF-8 verification was fixed to properly reject surrogate code points.
52  * Unknown enums for proto2 protos now properly implement proto2's behavior of
53    putting such values in unknown fields.
54
55  Java
56  * Revert "Standardize on Array copyOf" (#9400)
57  * Resolve more java field accessor name conflicts (#8198)
58  * Don't support map fields in DynamicMessage.Builder.{getFieldBuilder,getRepeatedFieldBuilder}
59  * Fix parseFrom to only throw InvalidProtocolBufferException
60  * InvalidProtocolBufferException now allows arbitrary wrapped Exception types.
61  * Fix bug in `FieldSet.Builder.mergeFrom`
62  * Flush CodedOutputStream also flushes underlying OutputStream
63  * When oneof case is the same and the field type is Message, merge the
64    subfield. (previously it was replaced.)’
65  * Add @CheckReturnValue to some protobuf types
66  * Report original exceptions when parsing JSON
67  * Add more info to @deprecated javadoc for set/get/has methods
68  * Fix initialization bug in doc comment line numbers
69  * Fix comments for message set wire format.
70
71  Kotlin
72  * Add test scope to kotlin-test for protobuf-kotlin-lite (#9518)
73  * Add orNull extensions for optional message fields.
74  * Add orNull extensions to all proto3 message fields.
75
76  Python
77  * Dropped support for Python < 3.7 (#9480)
78  * Protoc is now able to generate python stubs (.pyi) with --pyi_out
79  * Pin multibuild scripts to get manylinux1 wheels back (#9216)
80  * Fix type annotations of some Duration and Timestamp methods.
81  * Repeated field containers are now generic in field types and could be used
82    in type annotations.
83  * Protobuf python generated codes are simplified. Descriptors and message
84    classes' definitions are now dynamic created in internal/builder.py.
85    Insertion Points for messages classes are discarded.
86  * has_presence is added for FieldDescriptor in python
87  * Loosen indexing type requirements to allow valid __index__() implementations
88    rather than only PyLongObjects.
89  * Fix the deepcopy bug caused by not copying message_listener.
90  * Added python JSON parse recursion limit (default 100)
91  * Path info is added for python JSON parse errors
92  * Pure python repeated scalar fields will not able to pickle. Convert to list
93    first.
94  * Timestamp.ToDatetime() now accepts an optional tzinfo parameter. If
95    specified, the function returns a timezone-aware datetime in the given time
96    zone. If omitted or None, the function returns a timezone-naive UTC datetime
97    (as previously).
98  * Adds client_streaming and server_streaming fields to MethodDescriptor.
99  * Add "ensure_ascii" parameter to json_format.MessageToJson. This allows smaller
100    JSON serializations with UTF-8 or other non-ASCII encodings.
101  * Added experimental support for directly assigning numpy scalars and array.
102  * Improve the calculation of public_dependencies in DescriptorPool.
103  * [Breaking Change] Disallow setting fields to numpy singleton arrays or repeated fields to numpy
104    multi-dimensional arrays. Numpy arrays should be indexed or flattened explicitly before assignment.
105
106  Compiler
107  * Migrate IsDefault(const std::string*) and UnsafeSetDefault(const std::string*)
108  * Implement strong qualified tags for TaggedPtr
109  * Rework allocations to power-of-two byte sizes.
110  * Migrate IsDefault(const std::string*) and UnsafeSetDefault(const std::string*)
111  * Implement strong qualified tags for TaggedPtr
112  * Make TaggedPtr Set...() calls explicitly spell out the content type.
113  * Check for parsing error before verifying UTF8.
114  * Enforce a maximum message nesting limit of 32 in the descriptor builder to
115    guard against stack overflows
116  * Fixed bugs in operators for RepeatedPtrIterator
117  * Assert a maximum map alignment for allocated values
118  * Fix proto1 group extension protodb parsing error
119  * Do not log/report the same descriptor symbol multiple times if it contains
120    more than one invalid character.
121  * Add UnknownFieldSet::SerializeToString and SerializeToCodedStream.
122  * Remove explicit default pointers and deprecated API from protocol compiler
123
124  Arenas
125  * Change Repeated*Field to reuse memory when using arenas.
126  * Implements pbarenaz for profiling proto arenas
127  * Introduce CreateString() and CreateArenaString() for cleaner semantics
128  * Fix unreferenced parameter for MSVC builds
129  * Add UnsafeSetAllocated to be used for one-of string fields.
130  * Make Arena::AllocateAligned() a public function.
131  * Determine if ArenaDtor related code generation is necessary in one place.
132  * Implement on demand register ArenaDtor for InlinedStringField
133
134  C++
135  * Enable testing via CTest (#8737)
136  * Add option to use external GTest in CMake (#8736)
137  * CMake: Set correct sonames for libprotobuf-lite.so and libprotoc.so (#8635) (#9529)
138  * Add cmake option `protobuf_INSTALL` to not install files (#7123)
139  * CMake: Allow custom plugin options e.g. to generate mocks (#9105)
140  * CMake: Use linker version scripts (#9545)
141  * Manually *struct Cord fields to work better with arenas.
142  * Manually destruct map fields.
143  * Generate narrower code
144  * Fix https://github.com/protocolbuffers/protobuf/issues/9378 by removing
145    shadowed _cached_size_ field
146  * Remove GetPointer() and explicit nullptr defaults.
147  * Add proto_h flag for speeding up large builds
148  * Add missing overload for reference wrapped fields.
149  * Add MergedDescriptorDatabase::FindAllFileNames()
150  * RepeatedField now defines an iterator type instead of using a pointer.
151  * Remove obsolete macros GOOGLE_PROTOBUF_HAS_ONEOF and GOOGLE_PROTOBUF_HAS_ARENAS.
152
153  PHP
154  * Fix: add missing reserved classnames (#9458)
155  * PHP 8.1 compatibility (#9370)
156
157  C#
158  * Fix trim warnings (#9182)
159  * Fixes NullReferenceException when accessing FieldDescriptor.IsPacked (#9430)
160  * Add ToProto() method to all descriptor classes (#9426)
161  * Add an option to preserve proto names in JsonFormatter (#6307)
162
163  Objective-C
164  * Add prefix_to_proto_package_mappings_path option. (#9498)
165  * Rename `proto_package_to_prefix_mappings_path` to `package_to_prefix_mappings_path`. (#9552)
166  * Add a generation option to control use of forward declarations in headers. (#9568)
167
1682022-01-28 version 3.19.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
169
170  Python
171  * Make libprotobuf symbols local on OSX to fix issue #9395 (#9435)
172
173  Ruby
174  * Fixed a data loss bug that could occur when the number of `optional`
175    fields in a message is an exact multiple of 32. (#9440).
176
177  PHP
178  * Fixed a data loss bug that could occur when the number of `optional`
179    fields in a message is an exact multiple of 32. (#9440).
180
1812022-01-10 version 3.19.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
182
183  Python
184  * Fix missing Windows wheel for Python 3.10 on PyPI
185
1862022-01-05 version 3.19.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
187
188  Java
189  * Improve performance characteristics of UnknownFieldSet parsing (#9371)
190  * This release addresses a Security Advisory for Java users
191   (https://github.com/protocolbuffers/protobuf/security/advisories/GHSA-wrvw-hg22-4m67)
192
1932022-01-05 version 3.18.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
194
195  Java
196  * Improve performance characteristics of UnknownFieldSet parsing (#9371)
197  * This release addresses a Security Advisory for Java users
198   (https://github.com/protocolbuffers/protobuf/security/advisories/GHSA-wrvw-hg22-4m67)
199
2002022-01-05 version 3.16.1 (Java)
201
202  Java
203  * Improve performance characteristics of UnknownFieldSet parsing (#9371)
204  * This release addresses a Security Advisory for Java users
205   (https://github.com/protocolbuffers/protobuf/security/advisories/GHSA-wrvw-hg22-4m67)
206
2072021-10-28 version 3.19.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
208
209  Bazel
210  * Ensure that release archives contain everything needed for Bazel (#9131)
211  * Align dependency handling with Bazel best practices (#9165)
212
213  JavaScript
214  * Fix `ReferenceError: window is not defined` when getting the global object (#9156)
215
216  Ruby
217  * Fix memory leak in MessageClass.encode (#9150)
218
2192021-10-15 version 3.19.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
220
221  C++
222  * Make proto2::Message::DiscardUnknownFields() non-virtual
223  * Separate RepeatedPtrField into its own header file
224  * For default floating point values of 0, consider all bits significant
225  * cmake: support `MSVC_RUNTIME_LIBRARY` property (#8851)
226  * Fix shadowing warnings (#8926)
227  * Fix for issue #8484, constant initialization doesn't compile in msvc clang-cl environment (#8993)
228  * Fix build on AIX and SunOS (#8373) (#9065)
229  * Add Android stlport and default toolchains to BUILD. (#8290)
230
231  Java
232  * For default floating point values of 0, consider all bits significant
233  * Annotate `//java/com/google/protobuf/util/...` with nullness annotations
234  * Use ArrayList copy constructor (#7853)
235
236  Kotlin
237  * Switch Kotlin proto DSLs to be implemented with inline value classes
238  * Fix inlining and deprecation for repeated string fields in kotlin (#9120)
239
240  Python
241  * Proto2 DecodeError now includes message name in error message
242  * Make MessageToDict convert map keys to strings (#8122)
243  * Add python-requires in setup.py (#8989)
244  * Add python 3.10 (#9034)
245
246  JavaScript
247  * Skip exports if not available by CommonJS (#8856)
248  * JS: Comply with CSP no-unsafe-eval. (#8864)
249
250  PHP
251  * Added "object" as a reserved name for PHP (#8962)
252
253  Ruby
254  * Override Map.clone to use Map's dup method (#7938)
255  * Ruby: build extensions for arm64-darwin (#8232)
256  * Add class method Timestamp.from_time to ruby well known types (#8562)
257  * Adopt pure ruby DSL implementation for JRuby (#9047)
258  * Add size to Map class (#8068)
259  * Fix for descriptor_pb.rb: google/protobuf should be required first (#9121)
260
261  C#
262  * Correctly set ExtensionRegistry when parsing with MessageParser, but using an already existing CodedInputStream (#7246)
263  * [C#] Make FieldDescriptor propertyName public (#7642)
264
2652021-10-04 version 3.18.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
266
267  Python
268  * Update setup.py to reflect that we now require at least Python 3.5 (#8989)
269  * Performance fix for DynamicMessage: force GetRaw() to be inlined (#9023)
270
271  Ruby
272  * Update ruby_generator.cc to allow proto2 imports in proto3 (#9003)
273
2742021-09-13 version 3.18.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
275
276  Python
277  * Removed Python 2.x support.
278  * Pure python descriptor_pool.AddSerializedFile() will always build the
279    file and return FileDescriptor which is same with python c++ extension
280  * type errors thrown by MergeFrom now report fully qualified class names
281  * Protobuf python generated code are simplified. Some platforms that uses
282    "is"("is not") to compare the enum or descriptor's label/type may fail,
283    should use "=="("!=") instead.
284
285  C++
286  * Generated code now uses the c++11 standard integer types int{32,64}_t and
287    uint{32,64}_t
288  * Reduce memory usage of the DescriptorPool type.
289  * Moved the zero-argument New() method on messages to the base class (internal
290    optimization).
291  * Unused return values marked with `PROTOBUF_MUST_USE_RESULT` are now
292    correctly attributed.
293  * Demotes PrintPath log for maps in MessageDifferencer down from WARNING to
294    INFO.
295  * Make sure FullMessageName() is always private.
296  * Fix race condition in EnumDescriptor.
297  * Remove MessageLite::GetMaybeArenaPointer.
298
299  Java
300  * Add @deprecated javadoc for set/get/has methods
301  * correctly decode \? escape sequence in text protos
302  * Avoid depending on Objects.requireNonNull() until we can verify that no
303    users are depending on older Android versions.
304  * disallow null string map values in put and putAll
305  * Add `@CheckReturnValue` to `ByteString` API.
306  * Make the `hasPresence` method public in `FieldDescriptor`.
307  * Report more detailed messages in Duration and Timestamp proto parsing
308    errors.
309  * New Timestamps.fromDate utility method that converts a java.util.Date to a
310    Timestamp proto object.
311
312  Kotlin
313  * Generated Kotlin code is Explicit API mode compatible
314
3152021-09-13 version 3.18.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
316  C++
317  * Fix warnings raised by clang 11 (#8664)
318  * Make StringPiece constructible from std::string_view (#8707)
319  * Add missing capability attributes for LLVM 12 (#8714)
320  * Stop using std::iterator (deprecated in C++17). (#8741)
321  * Move field_access_listener from libprotobuf-lite to libprotobuf (#8775)
322  * Fix #7047 Safely handle setlocale (#8735)
323  * Remove deprecated version of SetTotalBytesLimit() (#8794)
324  * Support arena allocation of google::protobuf::AnyMetadata (#8758)
325  * Fix undefined symbol error around SharedCtor() (#8827)
326  * Fix default value of enum(int) in json_util with proto2 (#8835)
327  * Better Smaller ByteSizeLong
328  * Introduce event filters for inject_field_listener_events
329  * Reduce memory usage of DescriptorPool
330  * For lazy fields copy serialized form when allowed.
331  * Re-introduce the InlinedStringField class
332  * v2 access listener
333  * Reduce padding in the proto's ExtensionRegistry map.
334  * GetExtension performance optimizations
335  * Make tracker a static variable rather than call static functions
336  * Support extensions in field access listener
337  * Annotate MergeFrom for field access listener
338  * Fix incomplete types for field access listener
339  * Add map_entry/new_map_entry to SpecificField in MessageDifferencer. They
340    record the map items which are different in MessageDifferencer's reporter.
341  * Reduce binary size due to fieldless proto messages
342  * TextFormat: ParseInfoTree supports getting field end location in addition to
343    start.
344  * Fix repeated enum extension size in field listener
345  * Enable Any Text Expansion for Descriptors::DebugString()
346  * Switch from int{8,16,32,64} to int{8,16,32,64}_t
347  * Reduce memory usage of the DescriptorPool type.
348
349  Java
350  * Fix errorprone conflict (#8723)
351  * Removing deprecated TimeUtil class. (#8749)
352  * Optimized FieldDescriptor.valueOf() to avoid array copying.
353  * Removing deprecated TimeUtil class.
354  * Add Durations.parseUnchecked(String) and Timestamps.parseUnchecked(String)
355  * FieldMaskUtil: Add convenience method to mask the fields out of a given proto.
356
357  JavaScript
358  * Optimize binary parsing of repeated float64
359  * Fix for optimization when reading doubles from binary wire format
360  * Replace toArray implementation with toJSON.
361
362  Python
363  * Drops support for 2.7 and 3.5.
364
365  PHP
366  * Migrate PHP & Ruby to ABSL wyhash (#8854)
367  * Added support for PHP 8.1 (currently in RC1) to the C extension (#8964)
368  * Fixed PHP SEGV when constructing messages from a destructor. (#8969)
369
370  Ruby
371  * Move DSL implementation from C to pure Ruby (#8850)
372  * Fixed a memory bug with RepeatedField#+. (#8970)
373
374  Other
375  * [csharp] ByteString.CreateCodedInput should use ArraySegment offset and count (#8740)
376  * [ObjC] Add support for using the proto package to prefix symbols. (#8760)
377  * field_presence.md: fix Go example (#8788)
378
379
380  Kotlin
381  * Suppress NOTHING_TO_INLINE in Kotlin generated inline functions.
382
3832021-06-04 version 3.17.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
384  Python
385  * Note: This is the last release to support Python 2.7. Future releases will
386    require Python >= 3.5.
387
388  C++
389  * Introduce FieldAccessListener.
390  * Stop emitting boilerplate {Copy/Merge}From in each ProtoBuf class
391  * Fixed some uninitialized variable warnings in generated_message_reflection.cc.
392
393  Kotlin
394  * Fix duplicate proto files error (#8699)
395
396  Java
397  * Fixed parser to check that we are at a proper limit when a sub-message has
398    finished parsing.
399
4002021-05-25 version 3.17.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
401  Kotlin
402  * Fix duplicate class error (#8653)
403
404  PHP
405  * Fixed SEGV in sub-message getters for well-known types when message is unset
406    (#8670)
407
4082021-05-07 version 3.17.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
409  PHP
410  * Fixed PHP memory leaks and arginfo errors. (#8614)
411  * Fixed JSON parser to allow multiple values from the same oneof as long as
412    all but one are null.
413
414  Ruby
415  * Fixed memory bug: properly root repeated/map field when assigning. (#8639)
416  * Fixed JSON parser to allow multiple values from the same oneof as long as
417    all but one are null.
418
419
4202021-05-07 version 3.17.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
421
422  Protocol Compiler
423  * Fix the generated source information for reserved values in Enums.
424
425  C++
426  * Fix -Wunused-parameter in map<string, int> fields (fixes #8494) (#8500)
427  * Use byteswap.h when building against musl libc (#8503)
428  * Fix -Wundefined-inline error when using SharedCtor() or SharedDtor() (#8532)
429  * Fix bug where `Descriptor::DebugString()` printed proto3 synthetic oneofs.
430  * Provide stable versions of `SortAndUnique()`.
431  * Make sure to cache proto3 optional message fields when they are cleared.
432  * Expose UnsafeArena methods to Reflection.
433  * Use std::string::empty() rather than std::string::size() > 0.
434
435  Kotlin
436  * Restrict extension setter and getter operators to non-nullable T.
437
438  Java
439  * updating GSON and Guava to more recent versions (#8524)
440  * Reduce the time spent evaluating isExtensionNumber by storing the extension
441    ranges in a TreeMap for faster queries. This is particularly relevant for
442    protos which define a large number of extension ranges, for example when
443    each tag is defined as an extension.
444  * Fix java bytecode estimation logic for optional fields.
445  * Optimize Descriptor.isExtensionNumber.
446
447  Python
448  * Add MethodDescriptor.CopyToProto() (#8327)
449  * Remove unused python_protobuf.{cc,h} (#8513)
450  * Start publishing python aarch64 manylinux wheels normally (#8530)
451  * Fix constness issue detected by MSVC standard conforming mode (#8568)
452  * Make JSON parsing match C++ and Java when multiple fields from the same
453    oneof are present and all but one is null.
454
455  Ruby
456  * Add support for proto3 json_name in compiler and field definitions (#8356)
457  * Fixed memory leak of Ruby arena objects. (#8461)
458  * Fix source gem compilation (#8471)
459  * Fix various exceptions in Ruby on 64-bit Windows (#8563)
460  * Fix crash when calculating Message hash values on 64-bit Windows (#8565)
461
462  Conformance Tests
463  * Added a conformance test for the case of multiple fields from the same
464    oneof.
465
4662021-04-06 version 3.16.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
467  Other
468  * Opensourcing kotlin protos (#8272)
469  * Use a newer version of rules_proto, with the new rule `proto_descriptor_set` (#8469)
470
471  C++
472  * Fix compiler warnings issue found in conformance_test_runner #8189 (#8190)
473  * Fix MinGW-w64 build issues. (#8286)
474  * [Protoc] C++ Resolved an issue where NO_DESTROY and CONSTINIT are in incorrect order (#8296)
475  * Fix PROTOBUF_CONSTINIT macro redefinition (#8323)
476  * Delete StringPiecePod (#8353)
477  * Fix gcc error: comparison of unsigned expression in '>= 0' is always … (#8309)
478  * Fix cmake install on iOS (#8301)
479  * Create a CMake option to control whether or not RTTI is enabled (#8347)
480  * Fix endian.h location on FreeBSD (#8351)
481  * Refactor util::Status (#8354)
482  * Make util::Status more similar to absl::Status (#8405)
483  * Fix -Wsuggest-destructor-override for generated C++ proto classes. (#8408)
484  * Refactor StatusOr and StringPiece (#8406)
485  * Refactor uint128 (#8416)
486  * The ::pb namespace is no longer exposed due to conflicts.
487  * Allow MessageDifferencer::TreatAsSet() (and friends) to override previous
488    calls instead of crashing.
489  * Reduce the size of generated proto headers for protos with `string` or
490    `bytes` fields.
491  * Move arena() operation on uncommon path to out-of-line routine
492  * For iterator-pair function parameter types, take both iterators by value.
493  * Code-space savings and perhaps some modest performance improvements in
494    RepeatedPtrField.
495  * Eliminate nullptr check from every tag parse.
496  * Remove unused _$name$_cached_byte_size_ fields.
497  * Serialize extension ranges together when not broken by a proto field in the
498    middle.
499  * Do out-of-line allocation and deallocation of string object in ArenaString.
500  * Streamline ParseContext::ParseMessage<T> to avoid code bloat and improve
501    performance.
502  * New member functions RepeatedField::Assign, RepeatedPtrField::{Add, Assign}.
503  * Fix undefined behavior warning due to innocuous uninitialization of value
504    on an error path.
505  * Avoid expensive inlined code space for encoding message length for messages
506    >= 128 bytes and instead do a procedure call to a shared out-of-line routine.
507  * util::DefaultFieldComparator will be final in a future version of protobuf.
508    Subclasses should inherit from SimpleFieldComparator instead.
509
510  C#
511  * Add .NET 5 target and improve WriteString performance with SIMD (#8147)
512
513  Java
514  * deps: update JUnit and Truth (#8319)
515  * Detect invalid overflow of byteLimit and return InvalidProtocolBufferException as documented.
516  * Exceptions thrown while reading from an InputStream in parseFrom are now
517    included as causes.
518  * Support potentially more efficient proto parsing from RopeByteStrings.
519  * Clarify runtime of ByteString.Output.toStringBuffer().
520  * Added UnsafeByteOperations to protobuf-lite (#8426)
521
522  JavaScript
523  * Make Any.pack() chainable.
524
525  Python
526  * Fix some constness / char literal issues being found by MSVC standard conforming mode (#8344)
527  * Switch on "new" buffer API (#8339)
528  * Enable crosscompiling aarch64 python wheels under dockcross manylinux docker image (#8280)
529  * Fixed a bug in text format where a trailing colon was printed for repeated field.
530  * When TextFormat encounters a duplicate message map key, replace the current
531    one instead of merging.
532
533  Objective-C
534  * Move the class map to a CFDictionary. (#8328)
535
536  PHP
537  * read_property() handler is not supposed to return NULL (#8362)
538  * Changed parameter type from long to integer (#7613)
539  * fix: README supported PHP version for C extension (#8236)
540
541  Ruby
542  * Fixed quadratic memory usage when appending to arrays. (#8364)
543  * Fixed memory leak of Ruby arena objects. (#8461)
544  * Add support for proto3 json_name in compiler and field definitions. (#8356)
545
546  Other
547  * Some doc on AOT compilation and protobuf (#8294)
548  * [CMake] Ability to pass options to protoc executable from cmake (#8374)
549  * Add --fatal_warnings flag to treat warnings as errors (#8131)
550  * [bazel] Remove deprecated way to depend on googletest (#8396)
551  * add error returns missing from protoc to prevent it from exiting with… (#8409)
552
553
5542021-04-07 version 3.15.8 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
555
556  Ruby
557  * Fixed memory leak of Ruby arena objects (#8461)
558
5592021-04-02 version 3.15.7 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
560
561  C++
562  * Remove the ::pb namespace (alias) (#8423)
563
564  Ruby
565  * Fix unbounded memory growth for Ruby <2.7 (#8429)
566  * Fixed message equality in cases where the message type is different (#8434)
567
5682021-03-10 version 3.15.6 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
569
570  Ruby
571  * Fixed bug in string comparison logic (#8386)
572
5732021-03-04 version 3.15.5 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
574
575  Ruby
576  * Fixed quadratic memory use in array append (#8379)
577
578  PHP
579  * Fixed quadratic memory use in array append (#8379)
580
581  C++
582  * Do not disable RTTI by default in the CMake build (#8377)
583
5842021-03-02 version 3.15.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
585
586  Ruby
587  * Fixed SEGV when users pass nil messages (#8363)
588  * Fixed quadratic memory usage when appending to arrays (#8364)
589
590  C++
591  * Create a CMake option to control whether or not RTTI is enabled (#8361)
592
593  PHP
594  * read_property() handler is not supposed to return NULL (#8362)
595
5962021-02-25 version 3.15.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
597
598  Ruby
599  * Ruby <2.7 now uses WeakMap too, which prevents memory leaks. (#8341)
600
6012021-02-23 version 3.15.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
602
603  Ruby
604  * Fix for FieldDescriptor.get(msg) (#8330)
605
606  C++
607  * Fix PROTOBUF_CONSTINIT macro redefinition (#8323)
608
6092021-02-05 version 3.15.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
610
611  Ruby
612  * Bugfix for Message.[] for repeated or map fields (#8313)
613
6142021-02-05 version 3.15.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
615
616  Protocol Compiler
617  * Optional fields for proto3 are enabled by default, and no longer require
618    the --experimental_allow_proto3_optional flag.
619
620  C++
621  * MessageDifferencer: fixed bug when using custom ignore with multiple
622    unknown fields
623  * Use init_seg in MSVC to push initialization to an earlier phase.
624  * Runtime no longer triggers -Wsign-compare warnings.
625  * Fixed -Wtautological-constant-out-of-range-compare warning.
626  * DynamicCastToGenerated works for nullptr input for even if RTTI is disabled
627  * Arena is refactored and optimized.
628  * Clarified/specified that the exact value of Arena::SpaceAllocated() is an
629    implementation detail users must not rely on. It should not be used in
630    unit tests.
631  * Change the signature of Any::PackFrom() to return false on error.
632  * Add fast reflection getter API for strings.
633  * Constant initialize the global message instances
634  * Avoid potential for missed wakeup in UnknownFieldSet
635  * Now Proto3 Oneof fields have "has" methods for checking their presence in
636    C++.
637  * Bugfix for NVCC
638  * Return early in _InternalSerialize for empty maps.
639  * Adding functionality for outputting map key values in proto path logging
640    output (does not affect comparison logic) and stop printing 'value' in the
641    path. The modified print functionality is in the
642    MessageDifferencer::StreamReporter.
643  * Fixed https://github.com/protocolbuffers/protobuf/issues/8129
644  * Ensure that null char symbol, package and file names do not result in a
645    crash.
646  * Constant initialize the global message instances
647  * Pretty print 'max' instead of numeric values in reserved ranges.
648  * Removed remaining instances of std::is_pod, which is deprecated in C++20.
649  * Changes to reduce code size for unknown field handling by making uncommon
650    cases out of line.
651  * Fix std::is_pod deprecated in C++20 (#7180)
652  * Fix some -Wunused-parameter warnings (#8053)
653  * Fix detecting file as directory on zOS issue #8051 (#8052)
654  * Don't include sys/param.h for _BYTE_ORDER (#8106)
655  * remove CMAKE_THREAD_LIBS_INIT from pkgconfig CFLAGS (#8154)
656  * Fix TextFormatMapTest.DynamicMessage issue#5136 (#8159)
657  * Fix for compiler warning issue#8145 (#8160)
658  * fix: support deprecated enums for GCC < 6 (#8164)
659  * Fix some warning when compiling with Visual Studio 2019 on x64 target (#8125)
660
661  Python
662  * Provided an override for the reverse() method that will reverse the internal
663    collection directly instead of using the other methods of the BaseContainer.
664  * MessageFactory.CreateProtoype can be overridden to customize class creation.
665  * Fix PyUnknownFields memory leak (#7928)
666  * Add macOS Big Sur compatibility (#8126)
667
668  JavaScript
669  * Generate `getDescriptor` methods with `*` as their `this` type.
670  * Enforce `let/const` for generated messages.
671  * js/binary/utils.js: Fix jspb.utils.joinUnsignedDecimalString to work with negative bitsLow and low but non-zero bitsHigh parameter. (#8170)
672
673  PHP
674  * Added support for PHP 8. (#8105)
675  * unregister INI entries and fix invalid read on shutdown (#8042)
676  * Fix PhpDoc comments for message accessors to include "|null". (#8136)
677  * fix: convert native PHP floats to single precision (#8187)
678  * Fixed PHP to support field numbers >=2**28. (#8235)
679  * feat: add support for deprecated fields to PHP compiler (#8223)
680  * Protect against stack overflow if the user derives from Message. (#8248)
681  * Fixed clone for Message, RepeatedField, and MapField. (#8245)
682  * Updated upb to allow nonzero offset minutes in JSON timestamps. (#8258)
683
684  Ruby
685  * Added support for Ruby 3. (#8184)
686  * Rewrote the data storage layer to be based on upb_msg objects from the
687    upb library. This should lead to much better parsing performance,
688    particularly for large messages. (#8184).
689  * Fill out JRuby support (#7923)
690  * [Ruby] Fix: (SIGSEGV) gRPC-Ruby issue on Windows. memory alloc infinite
691    recursion/run out of memory (#8195)
692  * Fix jruby support to handle messages nested more than 1 level deep (#8194)
693
694  Java
695  * Avoid possible UnsupportedOperationException when using CodedInputSteam
696    with a direct ByteBuffer.
697  * Make Durations.comparator() and Timestamps.comparator() Serializable.
698  * Add more detailed error information for dynamic message field type
699    validation failure
700  * Removed declarations of functions declared in java_names.h from
701    java_helpers.h.
702  * Now Proto3 Oneof fields have "has" methods for checking their presence in
703    Java.
704  * Annotates Java proto generated *_FIELD_NUMBER constants.
705  * Add -assumevalues to remove JvmMemoryAccessor on Android.
706
707  C#
708  * Fix parsing negative Int32Value that crosses segment boundary (#8035)
709  * Change ByteString to use memory and support unsafe create without copy (#7645)
710  * Optimize MapField serialization by removing MessageAdapter (#8143)
711  * Allow FileDescriptors to be parsed with extension registries (#8220)
712  * Optimize writing small strings (#8149)
713
7142020-11-11 version 3.14.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
715
716  Protocol Compiler
717  * The proto compiler no longer requires a .proto filename when it is not
718    generating code.
719  * Added flag `--deterministic_output` to `protoc --encode=...`.
720  * Fixed deadlock when using google.protobuf.Any embedded in aggregate options.
721
722  C++
723  * Arenas are now unconditionally enabled. cc_enable_arenas no longer has
724    any effect.
725  * Removed inlined string support, which is incompatible with arenas.
726  * Fix a memory corruption bug in reflection when mixing optional and
727    non-optional fields.
728  * Make SpaceUsed() calculation more thorough for map fields.
729  * Add stack overflow protection for text format with unknown field values.
730  * FieldPath::FollowAll() now returns a bool to signal if an out-of-bounds
731    error was encountered.
732  * Performance improvements for Map.
733  * Minor formatting fix when dumping a descriptor to .proto format with
734    DebugString.
735  * UBSAN fix in RepeatedField (#2073).
736  * When running under ASAN, skip a test that makes huge allocations.
737  * Fixed a crash that could happen when creating more than 256 extensions in
738    a single message.
739  * Fix a crash in BuildFile when passing in invalid descriptor proto.
740  * Parser security fix when operating with CodedInputStream.
741  * Warn against the use of AllowUnknownExtension.
742  * Migrated to C++11 for-range loops instead of index-based loops where
743    possible. This fixes a lot of warnings when compiling with -Wsign-compare.
744  * Fix segment fault for proto3 optional (#7805)
745  * Adds a CMake option to build `libprotoc` separately (#7949)
746
747  Java
748  * Bugfix in mergeFrom() when a oneof has multiple message fields.
749  * Fix RopeByteString.RopeInputStream.read() returning -1 when told to read
750    0 bytes when not at EOF.
751  * Redefine remove(Object) on primitive repeated field Lists to avoid
752    autoboxing.
753  * Support "\u" escapes in textformat string literals.
754  * Trailing empty spaces are no longer ignored for FieldMask.
755  * Fix FieldMaskUtil.subtract to recursively remove mask.
756  * Mark enums with `@java.lang.Deprecated` if the proto enum has option
757    `deprecated = true;`.
758  * Adding forgotten duration.proto to the lite library (#7738)
759
760  Python
761  * Print google.protobuf.NullValue as null instead of "NULL_VALUE" when it is
762    used outside WKT Value/Struct.
763  * Fix bug occurring when attempting to deep copy an enum type in python 3.
764  * Add a setuptools extension for generating Python protobufs (#7783)
765  * Remove uses of pkg_resources in non-namespace packages. (#7902)
766  * [bazel/py] Omit google/__init__.py from the Protobuf runtime. (#7908)
767  * Removed the unnecessary setuptools package dependency for Python package (#7511)
768  * Fix PyUnknownFields memory leak (#7928)
769
770  PHP
771  * Added support for "==" to the PHP C extension (#7883)
772  * Added `==` operators for Map and Array. (#7900)
773  * Native C well-known types (#7944)
774  * Optimized away hex2bin() call in generated code (#8006)
775  * New version of upb, and a new hash function wyhash in third_party. (#8000)
776  * add missing hasOneof method to check presence of oneof fields (#8003)
777
778  Go:
779  * Update go_package options to reference google.golang.org/protobuf module.
780
781  C#:
782  * annotate ByteString.CopyFrom(ReadOnlySpan<byte>) as SecuritySafeCritical (#7701)
783  * Fix C# optional field reflection when there are regular fields too (#7705)
784  * Fix parsing negative Int32Value that crosses segment boundary (#8035)
785
786  Javascript:
787  * JS: parse (un)packed fields conditionally (#7379)
788
7892020-07-14 version 3.13.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
790
791  PHP:
792  * The C extension is completely rewritten. The new C extension has significantly
793    better parsing performance and fixes a handful of conformance issues. It will
794    also make it easier to add support for more features like proto2 and proto3 presence.
795  * The new C extension does not support PHP 5.x. PHP 5.x users can still use pure-PHP.
796
797  C++:
798  * Removed deprecated unsafe arena string accessors
799  * Enabled heterogeneous lookup for std::string keys in maps.
800  * Removed implicit conversion from StringPiece to std::string
801  * Fix use-after-destroy bug when the Map is allocated in the arena.
802  * Improved the randomness of map ordering
803  * Added stack overflow protection for text format with unknown fields
804  * Use std::hash for proto maps to help with portability.
805  * Added more Windows macros to proto whitelist.
806  * Arena constructors for map entry messages are now marked "explicit"
807    (for regular messages they were already explicit).
808  * Fix subtle aliasing bug in RepeatedField::Add
809  * Fix mismatch between MapEntry ByteSize and Serialize with respect to unset
810    fields.
811
812  Python:
813  * JSON format conformance fixes:
814    * Reject lowercase t for Timestamp json format.
815    * Print full_name directly for extensions (no camelCase).
816    * Reject boolean values for integer fields.
817    * Reject NaN, Infinity, -Infinity that is not quoted.
818    * Base64 fixes for bytes fields: accept URL-safe base64 and missing padding.
819  * Bugfix for fields/files named "async" or "await".
820  * Improved the error message when AttributeError is returned from __getattr__
821    in EnumTypeWrapper.
822
823  Java:
824  * Fixed a bug where setting optional proto3 enums with setFooValue() would
825    not mark the value as present.
826  * Add Subtract function to FieldMaskUtil.
827
828  C#:
829  * Dropped support for netstandard1.0 (replaced by support for netstandard1.1).
830    This was required to modernize the parsing stack to use the `Span<byte>`
831    type internally. (#7351)
832  * Add `ParseFrom(ReadOnlySequence<byte>)` method to enable GC friendly
833    parsing with reduced allocations and buffer copies. (#7351)
834  * Add support for serialization directly to a `IBufferWriter<byte>` or
835    to a `Span<byte>` to enable GC friendly serialization.
836    The new API is available as extension methods on the `IMessage` type. (#7576)
837  * Add `GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE` define to make
838    generated code compatible with old C# compilers (pre-roslyn compilers
839    from .NET framework and old versions of mono) that do not support
840    ref structs. Users that are still on a legacy stack that does
841    not support C# 7.2 compiler might need to use the new define
842    in their projects to be able to build the newly generated code. (#7490)
843  * Due to the major overhaul of parsing and serialization internals (#7351 and #7576),
844    it is recommended to regenerate your generated code to achieve the best
845    performance (the legacy generated code will still work, but might incur
846    a slight performance penalty).
847
8482020-07-28 version 3.12.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
849
850This release contains no significant changes, but exists because 3.12.3 was
851mistakenly tagged at the wrong commit.
852
8532020-06-01 version 3.12.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
854
855  Objective-C
856  * Tweak the union used for Extensions to support old generated code. #7573
857
8582020-05-26 version 3.12.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
859
860  C++
861  * Simplified the template export macros to fix the build for mingw32. (#7539)
862
863  Objective-C
864  * Fix for the :protobuf_objc target in the Bazel BUILD file. (#7538)
865
8662020-05-20 version 3.12.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
867
868  Ruby
869  * Re-add binary gems for Ruby 2.3 and 2.4. These are EOL upstream, however
870    many people still use them and dropping support will require more
871    coordination.
872
8732020-05-12 version 3.12.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
874
875  Protocol Compiler
876  * [experimental] Singular, non-message typed fields in proto3 now support
877    presence tracking. This is enabled by adding the "optional" field label and
878    passing the --experimental_allow_proto3_optional flag to protoc.
879    * For usage info, see docs/field_presence.md.
880    * During this experimental phase, code generators should update to support
881      proto3 presence, see docs/implementing_proto3_presence.md for instructions.
882  * Allow duplicate symbol names when multiple descriptor sets are passed on
883    the command-line, to match the behavior when multiple .proto files are passed.
884  * Deterministic `protoc --descriptor_set_out` (#7175)
885
886  C++
887  * [experimental] Added proto3 presence support.
888  * New descriptor APIs to support proto3 presence.
889  * Enable Arenas by default on all .proto files.
890  * Documented that users are not allowed to subclass Message or MessageLite.
891  * Mark generated classes as final; inheriting from protos is strongly discouraged.
892  * Add stack overflow protection for text format with unknown fields.
893  * Add accessors for map key and value FieldDescriptors.
894  * Add FieldMaskUtil::FromFieldNumbers().
895  * MessageDifferencer: use ParsePartial() on Any fields so the diff does not
896    fail when there are missing required fields.
897  * ReflectionOps::Merge(): lookup messages in the right factory, if it can.
898  * Added Descriptor::WellKnownTypes enum and Descriptor::well_known_type()
899    accessor as an easier way of determining if a message is a Well-Known Type.
900  * Optimized RepeatedField::Add() when it is used in a loop.
901  * Made proto move/swap more efficient.
902  * De-virtualize the GetArena() method in MessageLite.
903  * Improves performance of json_stream_parser.cc by factor 1000 (#7230)
904  * bug: #7076 undefine Windows OUT and OPTIONAL macros (#7087)
905  * Fixed a bug in FieldDescriptor::DebugString() that would erroneously print
906    an "optional" label for a field in a oneof.
907  * Fix bug in parsing bool extensions that assumed they are always 1 byte.
908  * Fix off-by-one error in FieldOptions::ByteSize() when extensions are present.
909  * Clarified the comments to show an example of the difference between
910    Descriptor::extension and DescriptorPool::FindAllExtensions.
911  * Add a compiler option 'code_size' to force optimize_for=code_size on all
912    protos where this is possible.
913
914  Java
915  * [experimental] Added proto3 presence support.
916  * Mark java enum _VALUE constants as @Deprecated if the enum field is deprecated
917  * reduce <clinit> size for enums with allow_alias set to true.
918  * Sort map fields alphabetically by the field's key when printing textproto.
919  * Fixed a bug in map sorting that appeared in -rc1 and -rc2 (#7508).
920  * TextFormat.merge() handles Any as top level type.
921  * Throw a descriptive IllegalArgumentException when calling
922    getValueDescriptor() on enum special value UNRECOGNIZED instead of
923    ArrayIndexOutOfBoundsException.
924  * Fixed an issue with JsonFormat.printer() where setting printingEnumsAsInts()
925    would override the configuration passed into includingDefaultValueFields().
926  * Implement overrides of indexOf() and contains() on primitive lists returned
927    for repeated fields to avoid autoboxing the list contents.
928  * Add overload to FieldMaskUtil.fromStringList that accepts a descriptor.
929  * [bazel] Move Java runtime/toolchains into //java (#7190)
930
931  Python
932  * [experimental] Added proto3 presence support.
933  * [experimental] fast import protobuf module, only works with cpp generated code linked in.
934  * Truncate 'float' fields to 4 bytes of precision in setters for pure-Python
935    implementation (C++ extension was already doing this).
936  * Fixed a memory leak in C++ bindings.
937  * Added a deprecation warning when code tries to create Descriptor objects
938    directly.
939  * Fix unintended comparison between bytes and string in descriptor.py.
940  * Avoid printing excess digits for float fields in TextFormat.
941  * Remove Python 2.5 syntax compatibility from the proto compiler generated _pb2.py module code.
942  * Drop 3.3, 3.4 and use single version docker images for all python tests (#7396)
943
944  JavaScript
945  * Fix js message pivot selection (#6813)
946
947  PHP
948  * Persistent Descriptor Pool (#6899)
949  * Implement lazy loading of php class for proto messages (#6911)
950  * Correct @return in Any.unpack docblock (#7089)
951  * Ignore unknown enum value when ignore_unknown specified (#7455)
952
953  Ruby
954  * [experimental] Implemented proto3 presence for Ruby. (#7406)
955  * Stop building binary gems for ruby <2.5 (#7453)
956  * Fix for wrappers with a zero value (#7195)
957  * Fix for JSON serialization of 0/empty-valued wrapper types (#7198)
958  * Call "Class#new" over rb_class_new_instance in decoding (#7352)
959  * Build extensions for Ruby 2.7 (#7027)
960  * assigning 'nil' to submessage should clear the field. (#7397)
961
962  C#
963  * [experimental] Add support for proto3 presence fields in C# (#7382)
964  * Mark GetOption API as obsolete and expose the "GetOptions()" method on descriptors instead (#7491)
965  * Remove Has/Clear members for C# message fields in proto2 (#7429)
966  * Enforce recursion depth checking for unknown fields (#7132)
967  * Fix conformance test failures for Google.Protobuf (#6910)
968  * Cleanup various bits of Google.Protobuf (#6674)
969  * Fix latest ArgumentException for C# extensions (#6938)
970  * Remove unnecessary branch from ReadTag (#7289)
971
972  Objective-C
973  * [experimental] ObjC Proto3 optional support (#7421)
974  * Block subclassing of generated classes (#7124)
975  * Use references to Obj C classes instead of names in descriptors. (#7026)
976  * Revisit how the WKTs are bundled with ObjC. (#7173)
977
978  Other
979  * Add a proto_lang_toolchain for javalite (#6882)
980  * [bazel] Update gtest and deprecate //external:{gtest,gtest_main} (#7237)
981  * Add application note for explicit presence tracking. (#7390)
982  * Howto doc for implementing proto3 presence in a code generator. (#7407)
983
984
9852020-02-14 version 3.11.4 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
986
987  C#
988  * Fix latest ArgumentException for C# extensions (#7188)
989  * Enforce recursion depth checking for unknown fields (#7210)
990
991  Ruby
992  * Fix wrappers with a zero value (#7195)
993  * Fix JSON serialization of 0/empty-valued wrapper types (#7198)
994
9952020-01-31 version 3.11.3 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
996
997  C++
998  * Add OUT and OPTIONAL to windows portability files (#7087)
999
1000  PHP
1001  * Refactored ulong to zend_ulong for php7.4 compatibility (#7147)
1002  * Call register_class before getClass from desc to fix segfault (#7077)
1003
1004
10052019-12-10 version 3.11.2 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1006
1007  PHP
1008  * Make c extension portable for php 7.4 (#6968)
1009
1010
10112019-12-02 version 3.11.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1012
1013  PHP
1014  * Extern declare protobuf_globals (#6946)
1015
1016
10172019-11-19 version 3.11.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1018
1019  C++
1020  * Make serialization method naming consistent
1021  * Make proto runtime + generated code free of deprecation warnings
1022  * Moved ShutdownProtobufLibrary() to message_lite.h.  For backward compatibility a declaration is still available in stubs/common.h, but users should prefer message_lite.h
1023  * Removed non-namespace macro EXPECT_OK()
1024  * Removed mathlimits.h from stubs in favor of using std::numeric_limits from C++11
1025  * Fixed bug in parser when ending on a group tag
1026  * Add a helper function to UnknownFieldSet to deal with the changing return value of message::unknown_fields()
1027  * Fix incorrect use of string_view iterators
1028  * Support direct pickling of nested messages
1029  * Skip extension tag validation for MessageSet if unknown dependencies are allowed
1030  * Updated deprecation macros to annotate deprecated code (#6612)
1031  * Remove conversion warning in MapEntryFuncs::ByteSizeLong (#6766)
1032  * Revert "Make shared libraries be able to link to MSVC static runtime libraries, so that VC runtime is not required." (#6914)
1033
1034  Java
1035  * Remove the usage of MethodHandle, so that Android users prior to API version 26 can use protobuf-java
1036  * Publish ProGuard config for javalite
1037  * Fix for StrictMode disk read violation in ExtensionRegistryLite
1038  * Include part of the ByteString's content in its toString().
1039  * Include unknown fields when merging proto3 messages in Java lite builders
1040
1041  Python
1042  * Add float_precision option in json format printer
1043  * Optionally print bytes fields as messages in unknown fields, if possible
1044  * FieldPath: fix testing IsSet on root path ''
1045  * Experimental code gen (fast import protobuf module) which only work with cpp generated code linked in
1046
1047  JavaScript
1048  * Remove guard for Symbol iterator for jspb.Map
1049
1050  PHP
1051  * Avoid too much overhead in layout_init (#6716)
1052  * Lazily Create Singular Wrapper Message (#6833)
1053  * Implement lazy loading of php class for proto messages (#6911)
1054
1055  Ruby
1056  * Ruby lazy wrappers optimization (#6797)
1057
1058  C#
1059  * (RepeatedField): Capacity property to resize the internal array (#6530)
1060  * Experimental proto2 support is now officially available (#4642, #5183, #5350, #5936)
1061  * Getting started doc: https://github.com/protocolbuffers/protobuf/blob/master/docs/csharp/proto2.md
1062  * Add length checks to ExtensionCollection (#6759)
1063  * Optimize parsing of some primitive and wrapper types (#6843)
1064  * Use 3 parameter Encoding.GetString for default string values (#6828)
1065  * Change _Extensions property to normal body rather than expression (#6856)
1066
1067  Objective C
1068  * Fixed unaligned reads for 32bit arm with newer Xcode versions (#6678)
1069
1070
10712019-09-03 version 3.10.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1072
1073  C++
1074  * Switch the proto parser to the faster MOMI parser.
1075  * Properly escape Struct keys in the proto3 JSON serializer.
1076  * Fix crash on uninitialized map entries.
1077  * Informed the compiler of has-bit invariant to produce better code
1078  * Unused imports of files defining descriptor extensions will now be reported
1079  * Add proto2::util::RemoveSubranges to remove multiple subranges in linear time.
1080  * Added BaseTextGenerator::GetCurrentIndentationSize()
1081  * Made implicit weak fields compatible with the Apple linker
1082  * Support 32 bit values for ProtoStreamObjectWriter to Struct.
1083  * Removed the internal-only header coded_stream_inl.h and the internal-only methods defined there.
1084  * Enforced no SWIG wrapping of descriptor_database.h (other headers already had this restriction).
1085  * Implementation of the equivalent of the MOMI parser for serialization. This removes one of the two serialization routines, by making the fast array serialization routine completely general. SerializeToCodedStream can now be implemented in terms of the much much faster array serialization. The array serialization regresses slightly, but when array serialization is not possible this wins big.
1086  * Do not convert unknown field name to snake case to accurately report error.
1087  * Fix a UBSAN warnings. (#6333)
1088  * Add podspec for C++ (#6404)
1089  * protoc: fix source code info location for missing label (#6436)
1090  * C++ Add move constructor for Reflection's SetString (#6477)
1091
1092  Java
1093  * Call loadDescriptor outside of synchronized block to remove one possible source of deadlock.
1094  * Have oneof enums implement a separate interface (other than EnumLite) for clarity.
1095  * Opensource Android Memory Accessors
1096  * Update TextFormat to make use of the new TypeRegistry.
1097  * Support getFieldBuilder and getRepeatedFieldBuilder in ExtendableBuilder
1098  * Update JsonFormat to make use of the new TypeRegistry.
1099  * Add proguard config generator for GmmBenchmarkSuiteLite.
1100  * Change ProtobufArrayList to use Object[] instead of ArrayList for 5-10% faster parsing
1101  * Implement ProtobufArrayList.add(E) for 20% (5%-40%) faster overall protolite2 parsing
1102  * Make a copy of JsonFormat.TypeRegistry at the protobuf top level package. This will eventually replace JsonFormat.TypeRegistry.
1103  * Fix javadoc warnings in generated files (#6231)
1104  * Java: Add Automatic-Module-Name entries to the Manifest (#6568)
1105
1106  Python
1107  * Add descriptor methods in descriptor_pool are deprecated.
1108  * Uses explicit imports to prevent multithread test failures in py3.
1109  * Added __delitem__ for Python extension dict
1110  * Update six version to 1.12.0 and fix legacy_create_init issue (#6391)
1111
1112  JavaScript
1113  * Remove deprecated boolean option to getResultBase64String().
1114  * Fix sint64 zig-zag encoding.
1115  * Simplify hash64 string conversion to avoid DIGIT array. Should reduce overhead if these functions aren't used, and be more efficient by avoiding linear array searches.
1116  * Change the parameter types of binaryReaderFn in ExtensionFieldBinaryInfo to (number, ?, ?).
1117  * Create dates.ts and time_of_days.ts to mirror Java versions. This is a near-identical conversion of c.g.type.util.{Dates,TimeOfDays} respectively.
1118  * Migrate moneys to TypeScript.
1119
1120  PHP
1121  * Fix incorrect leap day for Timestamp (#6696)
1122  * Initialize well known type values (#6713)
1123
1124  Ruby
1125  * Fix scope resolution for Google namespace (#5878)
1126  * Support hashes for struct initializers (#5716)
1127  * Optimized away the creation of empty string objects. (#6502)
1128  * Roll forward Ruby upb changes now that protobuf Ruby build is fixed (#5866)
1129  * Optimized layout_mark() for Ruby (#6521)
1130  * Optimization for layout_init() (#6547)
1131  * Fix for GC of Ruby map frames. (#6533)
1132  * Fixed leap year handling by reworking upb_mktime() -> upb_timegm(). (#6695)
1133
1134  Objective C
1135  * Remove OSReadLittle* due to alignment requirements (#6678)
1136  * Don't use unions and instead use memcpy for the type swaps. (#6672)
1137
1138  Other
1139  * Override CocoaPods module to lowercase (#6464)
1140
1141
11422019-06-28 version 3.9.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1143
1144  C++
1145  * Optimize and simplify implementation of RepeatedPtrFieldBase
1146  * Don't create unnecessary unknown field sets.
1147  * Remove branch from accessors to repeated field element array.
1148  * Added delimited parse and serialize util.
1149  * Reduce size by not emitting constants for fieldnumbers
1150  * Fix a bug when comparing finite and infinite field values with explicit tolerances.
1151  * TextFormat::Parser should use a custom Finder to look up extensions by number if one is provided.
1152  * Add MessageLite::Utf8DebugString() to make MessageLite more compatible with Message.
1153  * Fail fast for better performance in DescriptorPool::FindExtensionByNumber() if descriptor has no defined extensions.
1154  * Adding the file name to help debug colliding extensions
1155  * Added FieldDescriptor::PrintableNameForExtension() and DescriptorPool::FindExtensionByPrintableName().
1156    The latter will replace Reflection::FindKnownExtensionByName().
1157  * Replace NULL with nullptr
1158  * Created a new Add method in repeated field that allows adding a range of elements all at once.
1159  * Enabled enum name-to-value mapping functions for C++ lite
1160  * Avoid dynamic initialization in descriptor.proto generated code
1161  * Move stream functions to MessageLite from Message.
1162  * Move all zero_copy_stream functionality to io_lite.
1163  * Do not create array of matched fields for simple repeated fields
1164  * Enabling silent mode by default to reduce make compilation noise. (#6237)
1165
1166  Java
1167  * Expose TextFormat.Printer and make it configurable. Deprecate the static methods.
1168  * Library for constructing google.protobuf.Struct and google.protobuf.Value
1169  * Make OneofDescriptor extend GenericDescriptor.
1170  * Expose streamingness of service methods from MethodDescriptor.
1171  * Fix a bug where TextFormat fails to parse Any filed with > 1 embedded message sub-fields.
1172  * Establish consistent JsonFormat behavior for nulls in oneofs, regardless of order.
1173  * Update GSON version to 3.8.5. (#6268)
1174  * Add `protobuf_java_lite` Bazel target. (#6177)
1175
1176  Python
1177  * Change implementation of Name() for enums that allow aliases in proto2 in Python
1178    to be in line with claims in C++ implementation (to return first value).
1179  * Explicitly say what field cannot be set when the new value fails a type check.
1180  * Duplicate register in descriptor pool will raise errors
1181  * Add __slots__ to all well_known_types classes, custom attributes are not allowed anymore.
1182  * text_format only present 8 valid digits for float fields by default
1183
1184  JavaScript
1185  * Add Oneof enum to the list of goog.provide
1186
1187  PHP
1188  * Make php message class final to avoid mocking. (#6277)
1189  * Rename get/setXXXValue to get/setXXXWrapper. (#6295)
1190
1191  Ruby
1192  * Remove to_hash methods. (#6166)
1193
1194
11952019-04-29 version 3.8.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1196
1197  C++
1198  * Use std::atomic<int32> in case of myriad2 platform
1199  * Always declare enums to be int-sized
1200  * Added DebugString() and ShortDebugString() methods on MessageLite
1201  * Specialized different parse loop control flows
1202  * Make hasbits potentially in register. The or's start forming an obstacle because it's a read modify store on the same mem address on each iteration.
1203  * Move to an internal MACRO for parser validity checks.
1204  * Improve map parsing performance.
1205  * Make MergePartialFromCodedStream non virtual. This allows direct calls, potential inlining and is also a code health improvement
1206  * Add an overall limit to parse_context to prevent reading past it. This allows to remove a annoying level of indirection.
1207  * Fix a mistake, we shouldn't verify map key/value strings for utf8 in opt mode for proto2.
1208  * Further improvements to cut binary size.
1209  * Prepare to make MergePartialFromCodedStream non-virtual.
1210  * A report on some interesting behavior change in python (caused by b/27494216) made me realize there is a check that needs to be done in case the parse ended on a end group tag.
1211  * Add a note of caution to the comments around skip in CodedOutputStream.
1212  * Simplify end check.
1213  * Add overload for ParseMessage for MessageLite/Message types. If the explicit type is not known inlining won't help de-virtualizing the virtual call.
1214  * Reduce linker input. It turns out that ParseMessage is not inlined, producing  template instantiations that are used only once and save nothing but cost more.
1215  * Improve the parser.
1216  * [c++17] Changed proto2::RepeatedPtrField iterators to no longer derive from the deprecated std::iterator class.
1217  * Change the default value of case_insensitive_enum_parsing to false for JsonStringToMessage.
1218  * Add a warning if a field name doesn't match the style guide.
1219  * Fix TextFormat not round-trip correctly when float value is max float.
1220  * Added locationed info for some errors at compiler
1221  * Python reserved keywords are now working with getattr()/setattr() for most descriptors.
1222  * Added AllowUnknownField() in text_format
1223  * Append '_' to C++ reserved keywords for message, enum, extension
1224  * Fix MSVC warning C4244 in protobuf's parse_context.h.
1225  * Updating Iterators to be compatible with C++17 in MSVC.
1226  * Use capability annotation in mutex.h
1227  * Fix "UndefinedBehaviorSanitizer: cfi-bad-type"
1228  * CriticalSectionLock class as a lightweight replacement for std::mutex on Windows platforms.
1229  * Removed vestigial wire_format_lite_inl.h
1230
1231  C#
1232  * Added System.Memory dependency.
1233
1234  Java
1235  * Make Java protoc code generator ignore optimize_for LITE_RUNTIME. Users should instead use the Java lite protoc plugin.
1236  * Change Extension getMessageDefaultInstance() to return Message instead of MessageLite.
1237  * Prevent malicious input streams from leaking buffers for ByteString or ByteBuffer parsing.
1238  * Release new Javalite runtime.
1239  * Show warning in case potential file name conflict.
1240  * Allow Java reserved keywords to be used in extensions.
1241  * Added setAllowUnknownFields() in text format
1242  * Add memoization to ExtensionRegistryLite.getEmptyRegistry()
1243  * Improve performance of CodedOutputStream.writeUInt32NoTag
1244  * Add an optimized mismatch-finding algorithm to UnsafeUtil.
1245  * When serializing uint32 varints, check that we have MAX_VARINT32_SIZE bytes left, not just MAX_VARINT_SIZE.
1246  * Minor optimization to RopeByteString.PieceIterator
1247
1248  JavaScript
1249  * Simplify generated toObject code when the default value is used.
1250
1251  Python
1252  * Changes implementation of Name() for enums that allow aliases in proto2 in Python to be in line with claims in C++ implementation (to return first value).
1253  * Added double_format option in text format printer.
1254  * Added iter and __contains__ to extension dict
1255  * Added allow_unknown_field option in python text format parser
1256  * Fixed Timestamp.ToDatetime() loses precision issue
1257  * Support unknown field in text format printer.
1258  * Float field will be convert to inf if bigger than struct.unpack('f', b'\xff\xff\x7f\x7f')[0] which is about 3.4028234664e+38,
1259  convert to -inf if smaller than -3.4028234664e+38
1260  * Allowed casting str->bytes in Message.__setstate__
1261
1262  Ruby
1263  * Helper methods to get enum name for Ruby.
1264
1265
12662019-01-24 version 3.7.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1267
1268  C++
1269  * Introduced new MOMI (maybe-outside-memory-interval) parser.
1270  * Add an option to json_util to parse enum as case-insensitive. In the future, enum parsing in json_util will become case-sensitive.
1271  * Added conformance test for enum aliases
1272  * Added support for --cpp_out=speed:...
1273  * Added use of C++ override keyword where appropriate
1274  * Many other cleanups and fixes.
1275
1276  Java
1277  * Fix illegal reflective access warning in JDK 9+
1278  * Add BOM
1279
1280  Python
1281  * Added Python 3.7 compatibility.
1282  * Modified ParseFromString to return bytes parsed .
1283  * Introduce Proto C API.
1284  * FindFileContainingSymbol in descriptor pool is now able to find field and enum values.
1285  * reflection.MakeClass()  and  reflection.ParseMessage() are deprecated.
1286  * Added DescriptorPool.FindMethodByName() method in pure python (c extension already has it)
1287  * Flipped proto3 to preserve unknown fields by default.
1288  * Added support for memoryview in python3 proto message parsing.
1289  * Added MergeFrom for repeated scalar fields in c extension (pure python already has it)
1290  * Surrogates are now rejected at setters in python3.
1291  * Added public unknown field API.
1292  * RecursionLimit is also set to max if allow_oversize_protos is enabled.
1293  * Disallow duplicate scalars in proto3 text_format parse.
1294  * Fix some segment faults for c extension map field.
1295
1296  PHP
1297  * Most issues for json encoding/decoding in the c extension have been fixed. There are still some edge cases not fixed. For more details, check conformance/failure_list_php_c.txt.
1298  * Supports php 7.3
1299  * Added helper methods to convert between enum values and names.
1300  * Allow setting/getting wrapper message fields using primitive values.
1301  * Various bug fixes.
1302
1303  Ruby
1304  * Ruby 2.6 support.
1305  * Drops support for ruby < 2.3.
1306  * Most issues for json encoding/decoding in the c extension have been fixed. There are still some edge cases not fixed. For more details, check conformance/failure_list_ruby.txt.
1307  * Json parsing can specify an option to ignore unknown fields: msg.decode_json(data, {ignore_unknown_fields: true}).
1308  * Added support for proto2 syntax (partially).
1309  * Various bug fixes.
1310
1311  Csharp
1312  * More support for FieldMask include merge, intersect and more.
1313  * Increasing the default recursion limit to 100.
1314  * Support loading FileDescriptors dynamically.
1315  * Provide access to comments from descriptors.
1316  * Added Any.Is method.
1317  * Compatible with C# 6
1318  * Added IComparable and comparison operators on Timestamp.
1319
1320  Objective C
1321  * Add ability to introspect list of enum values (#4678)
1322  * Copy the value when setting message/data fields (#5215)
1323  * Support suppressing the objc package prefix checks on a list of files (#5309)
1324  * More complete keyword and NSObject method (via categories) checks for field names, can result in more fields being rename, but avoids the collisions at runtime (#5289)
1325  * Small fixes to TextFormat generation for extensions (#5362)
1326  * Provide more details/context in deprecation messages (#5412)
1327  * Array/Dictionary enumeration blocks NS_NOESCAPE annotation for Swift (#5421)
1328  * Properly annotate extensions for ARC when their names imply behaviors (#5427)
1329  * Enum alias name collision improvements (#5480)
1330
1331
13322018-07-27 version 3.6.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1333
1334  C++
1335  * Introduced workaround for Windows issue with std::atomic and std::once_flag
1336    initialization (#4777, #4773).
1337
1338  PHP
1339  * Added compatibility with PHP 7.3 (#4898).
1340
1341  Ruby
1342  * Fixed Ruby crash involving Any encoding (#4718).
1343
13442018-06-01 version 3.6.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1345
1346  C++
1347  * Starting from this release, we now require C++11. For those we cannot yet
1348    upgrade to C++11, we will try to keep the 3.5.x branch updated with
1349    critical bug fixes only. If you have any concerns about this, please
1350    comment on issue #2780.
1351  * Moved to C++11 types like std::atomic and std::unique_ptr and away from our
1352    old custom-built equivalents.
1353  * Added support for repeated message fields in lite protos using implicit
1354    weak fields. This is an experimental feature that allows the linker to
1355    strip out more unused messages than previously was possible.
1356  * Fixed SourceCodeInfo for interpreted options and extension range options.
1357  * Fixed always_print_enums_as_ints option for JSON serialization.
1358  * Added support for ignoring unknown enum values when parsing JSON.
1359  * Create std::string in Arena memory.
1360  * Fixed ValidateDateTime to correctly check the day.
1361  * Fixed bug in ZeroCopyStreamByteSink.
1362  * Various other cleanups and fixes.
1363
1364  Java
1365  * Dropped support for Java 6.
1366  * Added a UTF-8 decoder that uses Unsafe to directly decode a byte buffer.
1367  * Added deprecation annotations to generated code for deprecated oneof
1368    fields.
1369  * Fixed map field serialization in DynamicMessage.
1370  * Cleanup and documentation for Java Lite runtime.
1371  * Various other fixes and cleanups
1372  * Fixed unboxed arraylists to handle an edge case
1373  * Improved performance for copying between unboxed arraylists
1374  * Fixed lite protobuf to avoid Java compiler warnings
1375  * Improved test coverage for lite runtime
1376  * Performance improvements for lite runtime
1377
1378  Python
1379  * Fixed bytes/string map key incompatibility between C++ and pure-Python
1380    implementations (issue #4029)
1381  * Added __init__.py files to compiler and util subpackages
1382  * Use /MT for all Windows versions
1383  * Fixed an issue affecting the Python-C++ implementation when used with
1384    Cython (issue #2896)
1385  * Various text format fixes
1386  * Various fixes to resolve behavior differences between the pure-Python and
1387    Python-C++ implementations
1388
1389  PHP
1390  * Added php_metadata_namespace to control the file path of generated metadata
1391    file.
1392  * Changed generated classes of nested message/enum. E.g., Foo.Bar, which
1393    previously generates Foo_Bar, now generates Foo/Bar
1394  * Added array constructor. When creating a message, users can pass a php
1395    array whose content is field name to value pairs into constructor. The
1396    created message will be initialized according to the array. Note that
1397    message field should use a message value instead of a sub-array.
1398  * Various bug fixes.
1399
1400  Objective-C
1401  * We removed some helper class methods from GPBDictionary to shrink the size
1402    of the library, the functionary is still there, but you may need to do some
1403    specific +alloc / -init… methods instead.
1404  * Minor improvements in the performance of object field getters/setters by
1405    avoiding some memory management overhead.
1406  * Fix a memory leak during the raising of some errors.
1407  * Make header importing completely order independent.
1408  * Small code improvements for things the undefined behaviors compiler option
1409    was flagging.
1410
1411  Ruby
1412  * Added ruby_package file option to control the module of generated class.
1413  * Various bug fixes.
1414
1415  Javascript
1416  * Allow setting string to int64 field.
1417
1418  Csharp
1419  * Unknown fields are now parsed and then sent back on the wire. They can be
1420    discarded at parse time via a CodedInputStream option.
1421  * Movement towards working with .NET 3.5 and Unity
1422  * Expression trees are no longer used
1423  * AOT generics issues in Unity/il2cpp have a workaround (see this commit for
1424    details)
1425  * Floating point values are now compared bitwise (affects NaN value
1426    comparisons)
1427  * The default size limit when parsing is now 2GB rather than 64MB
1428  * MessageParser now supports parsing from a slice of a byte array
1429  * JSON list parsing now accepts null values where the underlying proto
1430    representation does
1431
14322017-12-20 version 3.5.1 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1433  Planned Future Changes
1434  * Make C++ implementation C++11 only: we plan to require C++11 to build
1435    protobuf code starting from 3.6.0 release. Please join this github issue:
1436    https://github.com/protocolbuffers/protobuf/issues/2780 to provide your feedback.
1437
1438  protoc
1439  * Fixed a bug introduced in 3.5.0 and protoc in Windows now accepts non-ascii
1440    characters in paths again.
1441
1442  C++
1443  * Removed several usages of C++11 features in the code base.
1444  * Fixed some compiler warnings.
1445
1446  PHP
1447  * Fixed memory leak in C-extension implementation.
1448  * Added discardUnknokwnFields API.
1449  * Removed duplicated typedef in C-extension headers.
1450  * Avoided calling private php methods (timelib_update_ts).
1451  * Fixed Any.php to use fully-qualified name for DescriptorPool.
1452
1453  Ruby
1454  * Added Google_Protobuf_discard_unknown for discarding unknown fields in
1455    messages.
1456
1457  C#
1458  * Unknown fields are now preserved by default.
1459  * Floating point values are now bitwise compared, affecting message equality
1460    check and Contains() API in map and repeated fields.
1461
1462
14632017-11-13 version 3.5.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1464  Planned Future Changes
1465  * Make C++ implementation C++11 only: we plan to require C++11 to build
1466    protobuf code starting from 3.6.0 release. Please join this github issue:
1467    https://github.com/protocolbuffers/protobuf/issues/2780 to provide your feedback.
1468
1469  General
1470  * Unknown fields are now preserved in proto3 for most of the language
1471    implementations for proto3 by default. See the per-language section for
1472    details.
1473  * reserve keyword are now supported in enums
1474
1475  C++
1476  * Proto3 messages are now preserving unknown fields by default. If you rely on
1477    unknowns fields being dropped. Please use DiscardUnknownFields() explicitly.
1478  * Deprecated the unsafe_arena_release_* and unsafe_arena_add_allocated_*
1479    methods for string fields.
1480  * Added move constructor and move assignment to RepeatedField,
1481    RepeatedPtrField and google::protobuf::Any.
1482  * Added perfect forwarding in Arena::CreateMessage
1483  * In-progress experimental support for implicit weak fields with lite protos.
1484    This feature allows the linker to strip out more unused messages and reduce
1485    binary size.
1486  * Various performance optimizations.
1487
1488  Java
1489  * Proto3 messages are now preserving unknown fields by default. If you’d like
1490    to drop unknown fields, please use the DiscardUnknownFieldsParser API. For
1491    example:
1492      Parser<Foo> parser = DiscardUnknownFieldsParser.wrap(Foo.parser());
1493      Foo foo = parser.parseFrom(input);
1494  * Added a new CodedInputStream decoder for Iterable<ByteBuffer> with direct
1495    ByteBuffers.
1496  * TextFormat now prints unknown length-delimited fields as messages if
1497    possible.
1498  * FieldMaskUtil.merge() no longer creates unnecessary empty messages when a
1499    message field is unset in both source message and destination message.
1500  * Various performance optimizations.
1501
1502  Python
1503  * Proto3 messages are now preserving unknown fields by default. Use
1504    message.DiscardUnknownFields() to drop unknown fields.
1505  * Add FieldDescriptor.file in generated code.
1506  * Add descriptor pool FindOneofByName in pure python.
1507  * Change unknown enum values into unknown field set .
1508  * Add more Python dict/list compatibility for Struct/ListValue.
1509  * Add utf-8 support for text_format.Merge()/Parse().
1510  * Support numeric unknown enum values for proto3 JSON format.
1511  * Add warning for Unexpected end-group tag in cpp extension.
1512
1513  PHP
1514  * Proto3 messages are now preserving unknown fields.
1515  * Provide well known type messages in runtime.
1516  * Add prefix ‘PB’ to generated class of reserved names.
1517  * Fixed all conformance tests for encode/decode json in php runtime. C
1518    extension needs more work.
1519
1520  Objective-C
1521  * Fixed some issues around copying of messages with unknown fields and then
1522    mutating the unknown fields in the copy.
1523
1524  C#
1525  * Added unknown field support in JsonParser.
1526  * Fixed oneof message field merge.
1527  * Simplify parsing messages from array slices.
1528
1529  Ruby
1530  * Unknown fields are now preserved by default.
1531  * Fixed several bugs for segment fault.
1532
1533  Javascript
1534  * Decoder can handle both paced and unpacked data no matter how the proto is
1535    defined.
1536  * Decoder now accept long varint for 32 bit integers.
1537
1538
15392017-08-14 version 3.4.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1540  Planned Future Changes
1541  * There are some changes that are not included in this release but are planned
1542    for the near future
1543      - Preserve unknown fields in proto3: We are going to bring unknown fields
1544        back into proto3. In this release, some languages start to support
1545        preserving unknown fields in proto3, controlled by flags/options. Some
1546        languages also introduce explicit APIs to drop unknown fields for
1547        migration. Please read the change log sections by languages for details.
1548        For general timeline and plan:
1549
1550          https://docs.google.com/document/d/1KMRX-G91Aa-Y2FkEaHeeviLRRNblgIahbsk4wA14gRk/view
1551
1552        For issues and discussions:
1553
1554          https://github.com/protocolbuffers/protobuf/issues/272
1555
1556      - Make C++ implementation C++11 only: we plan to require C++11 to build
1557        protobuf code starting from 3.5.0 or 3.6.0 release, after unknown fields
1558        semantic changes are finished. Please join this
1559        github issue:
1560
1561          https://github.com/protocolbuffers/protobuf/issues/2780
1562
1563        to provide your feedback.
1564
1565  General
1566  * Extension ranges now accept options and are customizable.
1567  * "reserve" keyword now supports “max” in field number ranges,
1568    e.g.  reserve 1000 to max;
1569
1570  C++
1571  * Proto3 messages are now able to preserve unknown fields. The default
1572    behavior is still to drop unknowns, which will be flipped in a future
1573    release. If you rely on unknowns fields being dropped. Please use
1574    Message::DiscardUnknownFields() explicitly.
1575  * Packable proto3 fields are now packed by default in serialization.
1576  * Following C++11 features are introduced when C++11 is available:
1577      - move-constructor and move-assignment are introduced to messages
1578      - Repeated fields constructor now takes std::initializer_list
1579      - rvalue setters are introduced for string fields
1580  * Experimental Table-Driven parsing and serialization available to test. To
1581    enable it, pass in table_driven_parsing table_driven_serialization protoc
1582    generator flags for C++
1583
1584      $ protoc --cpp_out=table_driven_parsing,table_driven_serialization:./ \
1585        test.proto
1586
1587  * lite generator parameter supported by the generator. Once set, all generated
1588    files, use lite runtime regardless of the optimizer_for setting in the
1589    .proto file.
1590  * Various optimizations to make C++ code more performant on PowerPC platform
1591  * Fixed maps data corruption when the maps are modified by both reflection API
1592    and generated API.
1593  * Deterministic serialization on maps reflection now uses stable sort.
1594  * file() accessors are introduced to various *Descriptor classes to make
1595    writing template function easier.
1596  * ByteSize() and SpaceUsed() are deprecated.Use ByteSizeLong() and
1597    SpaceUsedLong() instead
1598  * Consistent hash function is used for maps in DEBUG and NDEBUG build.
1599  * "using namespace std" is removed from stubs/common.h
1600  * Various performance optimizations and bug fixes
1601
1602  Java
1603  * Introduced new parser API DiscardUnknownFieldsParser in preparation of
1604    proto3 unknown fields preservation change. Users who want to drop unknown
1605    fields should migrate to use this new parser API. For example:
1606
1607      Parser<Foo> parser = DiscardUnknownFieldsParser.wrap(Foo.parser());
1608      Foo foo = parser.parseFrom(input);
1609
1610  * Introduced new TextFormat API printUnicodeFieldValue() that prints field
1611    value without escaping unicode characters.
1612  * Added Durations.compare(Duration, Duration) and
1613    Timestamps.compare(Timestamp, Timestamp).
1614  * JsonFormat now accepts base64url encoded bytes fields.
1615  * Optimized CodedInputStream to do less copies when parsing large bytes
1616    fields.
1617  * Optimized TextFormat to allocate less memory when printing.
1618
1619  Python
1620  * SerializeToString API is changed to SerializeToString(self, **kwargs),
1621    deterministic parameter is accepted for deterministic serialization.
1622  * Added sort_keys parameter in json format to make the output deterministic.
1623  * Added indent parameter in json format.
1624  * Added extension support in json format.
1625  * Added __repr__ support for repeated field in cpp implementation.
1626  * Added file in FieldDescriptor.
1627  * Added pretty-print filter to text format.
1628  * Services and method descriptors are always printed even if generic_service
1629    option is turned off.
1630  * Note: AppEngine 2.5 is deprecated on June 2017 that AppEngine 2.5 will
1631    never update protobuf runtime. Users who depend on AppEngine 2.5 should use
1632    old protoc.
1633
1634  PHP
1635  * Support PHP generic services. Specify file option php_generic_service=true
1636    to enable generating service interface.
1637  * Message, repeated and map fields setters take value instead of reference.
1638  * Added map iterator in c extension.
1639  * Support json  encode/decode.
1640  * Added more type info in getter/setter phpdoc
1641  * Fixed the problem that c extension and php implementation cannot be used
1642    together.
1643  * Added file option php_namespace to use custom php namespace instead of
1644    package.
1645  * Added fluent setter.
1646  * Added descriptor API in runtime for custom encode/decode.
1647  * Various bug fixes.
1648
1649  Objective-C
1650  * Fix for GPBExtensionRegistry copying and add tests.
1651  * Optimize GPBDictionary.m codegen to reduce size of overall library by 46K
1652    per architecture.
1653  * Fix some cases of reading of 64bit map values.
1654  * Properly error on a tag with field number zero.
1655  * Preserve unknown fields in proto3 syntax files.
1656  * Document the exceptions on some of the writing apis.
1657
1658  C#
1659  * Implemented IReadOnlyDictionary<K,V> in MapField<K,V>
1660  * Added TryUnpack method for Any message in addition to Unpack.
1661  * Converted C# projects to MSBuild (csproj) format.
1662
1663  Ruby
1664  * Several bug fixes.
1665
1666  Javascript
1667  * Added support of field option js_type. Now one can specify the JS type of a
1668    64-bit integer field to be string in the generated code by adding option
1669    [jstype = JS_STRING] on the field.
1670
16712017-04-05 version 3.3.0 (C++/Java/Python/PHP/Objective-C/C#/Ruby/JavaScript)
1672  Planned Future Changes
1673  * There are some changes that are not included in this release but are
1674    planned for the near future:
1675      - Preserve unknown fields in proto3: please read this doc:
1676
1677          https://docs.google.com/document/d/1KMRX-G91Aa-Y2FkEaHeeviLRRNblgIahbsk4wA14gRk/view
1678
1679        for the timeline and follow up this github issue:
1680
1681          https://github.com/protocolbuffers/protobuf/issues/272
1682
1683        for discussion.
1684      - Make C++ implementation C++11 only: we plan to require C++11 to build
1685        protobuf code starting from 3.4.0 or 3.5.0 release. Please join this
1686        github issue:
1687
1688          https://github.com/protocolbuffers/protobuf/issues/2780
1689
1690        to provide your feedback.
1691
1692  C++
1693  * Fixed map fields serialization of DynamicMessage to correctly serialize
1694    both key and value regardless of their presence.
1695  * Parser now rejects field number 0 correctly.
1696  * New API Message::SpaceUsedLong() that’s equivalent to
1697    Message::SpaceUsed() but returns the value in size_t.
1698  * JSON support
1699    - New flag always_print_enums_as_ints in JsonPrintOptions.
1700    - New flag preserve_proto_field_names in JsonPrintOptions. It will instruct
1701      the JSON printer to use the original field name declared in the .proto
1702      file instead of converting them to lowerCamelCase when printing JSON.
1703    - JsonPrintOptions.always_print_primtive_fields now works for oneof message
1704      fields.
1705    - Fixed a bug that doesn’t allow different fields to set the same json_name
1706      value.
1707    - Fixed a performance bug that causes excessive memory copy when printing
1708      large messages.
1709  * Various performance optimizations.
1710
1711  Java
1712  * Map field setters eagerly validate inputs and throw NullPointerExceptions
1713    as appropriate.
1714  * Added ByteBuffer overloads to the generated parsing methods and the Parser
1715    interface.
1716  * proto3 enum's getNumber() method now throws on UNRECOGNIZED values.
1717  * Output of JsonFormat is now locale independent.
1718
1719  Python
1720  * Added FindServiceByName() in the pure-Python DescriptorPool. This works only
1721    for descriptors added with DescriptorPool.Add(). Generated descriptor_pool
1722    does not support this yet.
1723  * Added a descriptor_pool parameter for parsing Any in text_format.Parse().
1724  * descriptor_pool.FindFileContainingSymbol() now is able to find nested
1725    extensions.
1726  * Extending empty [] to repeated field now sets parent message presence.
1727
1728  PHP
1729  * Added file option php_class_prefix. The prefix will be prepended to all
1730    generated classes defined in the file.
1731  * When encoding, negative int32 values are sign-extended to int64.
1732  * Repeated/Map field setter accepts a regular PHP array. Type checking is
1733    done on the array elements.
1734  * encode/decode are renamed to serializeToString/mergeFromString.
1735  * Added mergeFrom, clear method on Message.
1736  * Fixed a bug that oneof accessor didn’t return the field name that is
1737    actually set.
1738  * C extension now works with php7.
1739  * This is the first GA release of PHP. We guarantee that old generated code
1740    can always work with new runtime and new generated code.
1741
1742  Objective-C
1743  * Fixed help for GPBTimestamp for dates before the epoch that contain
1744    fractional seconds.
1745  * Added GPBMessageDropUnknownFieldsRecursively() to remove unknowns from a
1746    message and any sub messages.
1747  * Addressed a threading race in extension registration/lookup.
1748  * Increased the max message parsing depth to 100 to match the other languages.
1749  * Removed some use of dispatch_once in favor of atomic compare/set since it
1750    needs to be heap based.
1751  * Fixes for new Xcode 8.3 warnings.
1752
1753  C#
1754  * Fixed MapField.Values.CopyTo, which would throw an exception unnecessarily
1755    if provided exactly the right size of array to copy to.
1756  * Fixed enum JSON formatting when multiple names mapped to the same numeric
1757    value.
1758  * Added JSON formatting option to format enums as integers.
1759  * Modified RepeatedField<T> to implement IReadOnlyList<T>.
1760  * Introduced the start of custom option handling; it's not as pleasant as it
1761    might be, but the information is at least present. We expect to extend code
1762    generation to improve this in the future.
1763  * Introduced ByteString.FromStream and ByteString.FromStreamAsync to
1764    efficiently create a ByteString from a stream.
1765  * Added whole-message deprecation, which decorates the class with [Obsolete].
1766
1767  Ruby
1768  * Fixed Message#to_h for messages with map fields.
1769  * Fixed memcpy() in binary gems to work for old glibc, without breaking the
1770    build for non-glibc libc’s like musl.
1771
1772  Javascript
1773  * Added compatibility tests for version 3.0.0.
1774  * Added conformance tests.
1775  * Fixed serialization of extensions: we need to emit a value even if it is
1776    falsy (like the number 0).
1777  * Use closurebuilder.py in favor of calcdeps.py for compiling JavaScript.
1778
17792017-01-23 version 3.2.0 (C++/Java/Python/PHP/Ruby/Objective-C/C#/JavaScript/Lite)
1780  General
1781  * Added protoc version number to protoc plugin protocol. It can be used by
1782    protoc plugin to detect which version of protoc is used with the plugin and
1783    mitigate known problems in certain version of protoc.
1784
1785  C++
1786  * The default parsing byte size limit has been raised from 64MB to 2GB.
1787  * Added rvalue setters for non-arena string fields.
1788  * Enabled debug logging for Android.
1789  * Fixed a double-free problem when using Reflection::SetAllocatedMessage()
1790    with extension fields.
1791  * Fixed several deterministic serialization bugs:
1792    * MessageLite::SerializeAsString() now respects the global deterministic
1793      serialization flag.
1794    * Extension fields are serialized deterministically as well.  Fixed protocol
1795      compiler to correctly report importing-self as an error.
1796  * Fixed FileDescriptor::DebugString() to print custom options correctly.
1797  * Various performance/codesize optimizations and cleanups.
1798
1799  Java
1800  * The default parsing byte size limit has been raised from 64MB to 2GB.
1801  * Added recursion limit when parsing JSON.
1802  * Fixed a bug that enumType.getDescriptor().getOptions() doesn't have custom
1803    options.
1804  * Fixed generated code to support field numbers up to 2^29-1.
1805
1806  Python
1807  * You can now assign NumPy scalars/arrays (np.int32, np.int64) to protobuf
1808    fields, and assigning other numeric types has been optimized for
1809    performance.
1810  * Pure-Python: message types are now garbage-collectable.
1811  * Python/C++: a lot of internal cleanup/refactoring.
1812
1813  PHP (Alpha)
1814  * For 64-bit integers type (int64/uint64/sfixed64/fixed64/sint64), use PHP
1815    integer on 64-bit environment and PHP string on 32-bit environment.
1816  * PHP generated code also conforms to PSR-4 now.
1817  * Fixed ZTS build for c extension.
1818  * Fixed c extension build on Mac.
1819  * Fixed c extension build on 32-bit linux.
1820  * Fixed the bug that message without namespace is not found in the descriptor
1821    pool. (#2240)
1822  * Fixed the bug that repeated field is not iterable in c extension.
1823  * Message names Empty will be converted to GPBEmpty in generated code.
1824  * Added phpdoc in generated files.
1825  * The released API is almost stable. Unless there is large problem, we won't
1826    change it. See
1827    https://developers.google.com/protocol-buffers/docs/reference/php-generated
1828    for more details.
1829
1830  Objective-C
1831  * Added support for push/pop of the stream limit on CodedInputStream for
1832    anyone doing manual parsing.
1833
1834  C#
1835  * No changes.
1836
1837  Ruby
1838  * Message objects now support #respond_to? for field getters/setters.
1839  * You can now compare “message == non_message_object” and it will return false
1840    instead of throwing an exception.
1841  * JRuby: fixed #hashCode to properly reflect the values in the message.
1842
1843  Javascript
1844  * Deserialization of repeated fields no longer has quadratic performance
1845    behavior.
1846  * UTF-8 encoding/decoding now properly supports high codepoints.
1847  * Added convenience methods for some well-known types: Any, Struct, and
1848    Timestamp. These make it easier to convert data between native JavaScript
1849    types and the well-known protobuf types.
1850
18512016-09-23 version 3.1.0 (C++/Java/Python/PHP/Ruby/Objective-C/C#/JavaScript/Lite)
1852  General
1853  * Proto3 support in PHP (alpha).
1854  * Various bug fixes.
1855
1856  C++
1857  * Added MessageLite::ByteSizeLong() that’s equivalent to
1858    MessageLite::ByteSize() but returns the value in size_t. Useful to check
1859    whether a message is over the 2G size limit that protobuf can support.
1860  * Moved default_instances to global variables. This allows default_instance
1861    addresses to be known at compile time.
1862  * Adding missing generic gcc 64-bit atomicops.
1863  * Restore New*Callback into google::protobuf namespace since these are used
1864    by the service stubs code
1865  * JSON support.
1866    * Fixed some conformance issues.
1867  * Fixed a JSON serialization bug for bytes fields.
1868
1869  Java
1870  * Fixed a bug in TextFormat that doesn’t accept empty repeated fields (i.e.,
1871    “field: [ ]”).
1872  * JSON support
1873    * Fixed JsonFormat to do correct snake_case-to-camelCase conversion for
1874      non-style-conforming field names.
1875    * Fixed JsonFormat to parse empty Any message correctly.
1876    * Added an option to JsonFormat.Parser to ignore unknown fields.
1877  * Experimental API
1878    * Added UnsafeByteOperations.unsafeWrap(byte[]) to wrap a byte array into
1879      ByteString without copy.
1880
1881  Python
1882  * JSON support
1883    * Fixed some conformance issues.
1884
1885  PHP (Alpha)
1886  * We have added the proto3 support for PHP via both a pure PHP package and a
1887    native c extension. The pure PHP package is intended to provide usability
1888    to wider range of PHP platforms, while the c extension is intended to
1889    provide higher performance. Both implementations provide the same runtime
1890    APIs and share the same generated code. Users don’t need to re-generate
1891    code for the same proto definition when they want to switch the
1892    implementation later. The pure PHP package is included in the php/src
1893    directory, and the c extension is included in the php/ext directory.
1894
1895    Both implementations provide idiomatic PHP APIs:
1896    * All messages and enums are defined as PHP classes.
1897    * All message fields can only be accessed via getter/setter.
1898    * Both repeated field elements and map elements are stored in containers
1899      that act like a normal PHP array.
1900
1901    Unlike several existing third-party PHP implementations for protobuf, our
1902    implementations are built on a "strongly-typed" philosophy: message fields
1903    and array/map containers will throw exceptions eagerly when values of the
1904    incorrect type (not including those that can be type converted, e.g.,
1905    double <-> integer <-> numeric string) are inserted.
1906
1907    Currently, pure PHP runtime supports php5.5, 5.6 and 7 on linux. C
1908    extension runtime supports php5.5 and 5.6 on linux.
1909
1910    See php/README.md for more details about installment. See
1911    https://developers.google.com/protocol-buffers/docs/phptutorial for more
1912    details about APIs.
1913
1914  Objective-C
1915  * Helpers are now provided for working the Any well known type (see
1916    GPBWellKnownTypes.h for the api additions).
1917  * Some improvements in startup code (especially when extensions aren’t used).
1918
1919  Javascript
1920  * Fixed missing import of jspb.Map
1921  * Fixed valueWriterFn variable name
1922
1923  Ruby
1924  * Fixed hash computation for JRuby's RubyMessage
1925  * Make sure map parsing frames are GC-rooted.
1926  * Added API support for well-known types.
1927
1928  C#
1929  * Removed check on dependency in the C# reflection API.
1930
19312016-09-06 version 3.0.2 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript/Lite)
1932  General
1933  * Various bug fixes.
1934
1935  Objective C
1936  * Fix for oneofs in proto3 syntax files where fields were set to the zero
1937    value.
1938  * Fix for embedded null character in strings.
1939  * CocoaDocs support
1940
1941  Ruby
1942  * Fixed memory corruption bug in parsing that could occur under GC pressure.
1943
1944  Javascript
1945  * jspb.Map is now properly exported to CommonJS modules.
1946
1947  C#
1948  * Removed legacy_enum_values flag.
1949
1950
19512016-07-27 version 3.0.0 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript/Lite)
1952  General
1953  * This log only contains changes since the beta-4 release. Summarized change
1954    log since the last stable release (v2.6.1) can be found in the github
1955    release page.
1956
1957  Compatibility Notice
1958  * v3.0.0 is the first API stable release of the v3.x series. We do not expect
1959    any future API breaking changes.
1960  * For C++, Java Lite and Objective-C, source level compatibility is
1961    guaranteed.  Upgrading from v3.0.0 to newer minor version releases will be
1962    source compatible. For example, if your code compiles against protobuf
1963    v3.0.0, it will continue to compile after you upgrade protobuf library to
1964    v3.1.0.
1965  * For other languages, both source level compatibility and binary level
1966    compatibility are guaranteed. For example, if you have a Java binary built
1967    against protobuf v3.0.0. After switching the protobuf runtime binary to
1968    v3.1.0, your built binary should continue to work.
1969  * Compatibility is only guaranteed for documented API and documented
1970    behaviors. If you are using undocumented API (e.g., use anything in the C++
1971    internal namespace), it can be broken by minor version releases in an
1972    undetermined manner.
1973
1974  Ruby
1975  * When you assign a string field `a.string_field = "X"`, we now call
1976    #encode(UTF-8) on the string and freeze the copy. This saves you from
1977    needing to ensure the string is already encoded as UTF-8. It also prevents
1978    you from mutating the string after it has been assigned (this is how we
1979    ensure it stays valid UTF-8).
1980  * The generated file for `foo.proto` is now `foo_pb.rb` instead of just
1981    `foo.rb`. This makes it easier to see which imports/requires are from
1982    protobuf generated code, and also prevents conflicts with any `foo.rb` file
1983    you might have written directly in Ruby. It is a backward-incompatible
1984    change: you will need to update all of your `require` statements.
1985  * For package names like `foo_bar`, we now translate this to the Ruby module
1986    `FooBar`. This is more idiomatic Ruby than what we used to do (`Foo_bar`).
1987
1988  JavaScript
1989  * Scalar fields like numbers and boolean now return defaults instead of
1990    `undefined` or `null` when they are unset. You can test for presence
1991    explicitly by calling `hasFoo()`, which we now generate for scalar fields.
1992
1993  Java Lite
1994  * Java Lite is now implemented as a separate plugin, maintained in the
1995    `javalite` branch. Both lite runtime and protoc artifacts will be available
1996    in Maven.
1997
1998  C#
1999  * Target platforms now .NET 4.5, selected portable subsets and .NET Core.
2000  * legacy_enum_values option is no longer supported.
2001
20022016-07-15 version 3.0.0-beta-4 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript)
2003  General
2004  * Added a deterministic serialization API for C++. The deterministic
2005    serialization guarantees that given a binary, equal messages will be
2006    serialized to the same bytes. This allows applications like MapReduce to
2007    group equal messages based on the serialized bytes. The deterministic
2008    serialization is, however, NOT canonical across languages; it is also
2009    unstable across different builds with schema changes due to unknown fields.
2010    Users who need canonical serialization, e.g. persistent storage in a
2011    canonical form, fingerprinting, etc, should define their own
2012    canonicalization specification and implement the serializer using reflection
2013    APIs rather than relying on this API.
2014  * Added OneofOptions. You can now define custom options for oneof groups.
2015      import "google/protobuf/descriptor.proto";
2016      extend google.protobuf.OneofOptions {
2017        optional int32 my_oneof_extension = 12345;
2018      }
2019      message Foo {
2020        oneof oneof_group {
2021          (my_oneof_extension) = 54321;
2022          ...
2023        }
2024      }
2025
2026  C++ (beta)
2027  * Introduced a deterministic serialization API in
2028    CodedOutputStream::SetSerializationDeterministic(bool). See the notes about
2029    deterministic serialization in the General section.
2030  * Added google::protobuf::Map::swap() to swap two map fields.
2031  * Fixed a memory leak when calling Reflection::ReleaseMessage() on a message
2032    allocated on arena.
2033  * Improved error reporting when parsing text format protos.
2034  * JSON
2035      - Added a new parser option to ignore unknown fields when parsing JSON.
2036      - Added convenient methods for message to/from JSON conversion.
2037  * Various performance optimizations.
2038
2039  Java (beta)
2040  * File option "java_generate_equals_and_hash" is now deprecated. equals() and
2041    hashCode() methods are generated by default.
2042  * Added a new JSON printer option "omittingInsignificantWhitespace" to produce
2043    a more compact JSON output. The printer will pretty-print by default.
2044  * Updated Java runtime to be compatible with 2.5.0/2.6.1 generated protos.
2045
2046  Python (beta)
2047  * Added support to pretty print Any messages in text format.
2048  * Added a flag to ignore unknown fields when parsing JSON.
2049  * Bugfix: "@type" field of a JSON Any message is now correctly put before
2050    other fields.
2051
2052  Objective-C (beta)
2053  * Updated the code to support compiling with more compiler warnings
2054    enabled. (Issue 1616)
2055  * Exposing more detailed errors for parsing failures. (PR 1623)
2056  * Small (breaking) change to the naming of some methods on the support classes
2057    for map<>. There were collisions with the system provided KVO support, so
2058    the names were changed to avoid those issues.  (PR 1699)
2059  * Fixed for proper Swift bridging of error handling during parsing. (PR 1712)
2060  * Complete support for generating sources that will go into a Framework and
2061    depend on generated sources from other Frameworks. (Issue 1457)
2062
2063  C# (beta)
2064  * RepeatedField optimizations.
2065  * Support for .NET Core.
2066  * Minor bug fixes.
2067  * Ability to format a single value in JsonFormatter (advanced usage only).
2068  * Modifications to attributes applied to generated code.
2069
2070  Javascript (alpha)
2071  * Maps now have a real map API instead of being treated as repeated fields.
2072  * Well-known types are now provided in the google-protobuf package, and the
2073    code generator knows to require() them from that package.
2074  * Bugfix: non-canonical varints are correctly decoded.
2075
2076  Ruby (alpha)
2077  * Accessors for oneof fields now return default values instead of nil.
2078
2079  Java Lite
2080  * Java lite support is removed from protocol compiler. It will be supported
2081    as a protocol compiler plugin in a separate code branch.
2082
20832016-05-16 version 3.0.0-beta-3 (C++/Java/Python/Ruby/Nano/Objective-C/C#/JavaScript)
2084  General
2085  * Supported Proto3 lite-runtime in C++/Java for mobile platforms.
2086  * Any type now supports APIs to specify prefixes other than
2087    type.googleapis.com
2088  * Removed javanano_use_deprecated_package option; Nano will always has its own
2089    ".nano" package.
2090
2091  C++ (Beta)
2092  * Improved hash maps.
2093      - Improved hash maps comments. In particular, please note that equal hash
2094        maps will not necessarily have the same iteration order and
2095        serialization.
2096      - Added a new hash maps implementation that will become the default in a
2097        later release.
2098  * Arenas
2099      - Several inlined methods in Arena were moved to out-of-line to improve
2100        build performance and code size.
2101      - Added SpaceAllocatedAndUsed() to report both space used and allocated
2102      - Added convenient class UnsafeArenaAllocatedRepeatedPtrFieldBackInserter
2103  * Any
2104      - Allow custom type URL prefixes in Any packing.
2105      - TextFormat now expand the Any type rather than printing bytes.
2106  * Performance optimizations and various bug fixes.
2107
2108  Java (Beta)
2109  * Introduced an ExperimentalApi annotation. Annotated APIs are experimental
2110    and are subject to change in a backward incompatible way in future releases.
2111  * Introduced zero-copy serialization as an ExperimentalApi
2112      - Introduction of the `ByteOutput` interface. This is similar to
2113        `OutputStream` but provides semantics for lazy writing (i.e. no
2114        immediate copy required) of fields that are considered to be immutable.
2115      - `ByteString` now supports writing to a `ByteOutput`, which will directly
2116        expose the internals of the `ByteString` (i.e. `byte[]` or `ByteBuffer`)
2117        to the `ByteOutput` without copying.
2118      - `CodedOutputStream` now supports writing to a `ByteOutput`. `ByteString`
2119        instances that are too large to fit in the internal buffer will be
2120        (lazily) written to the `ByteOutput` directly.
2121      - This allows applications using large `ByteString` fields to avoid
2122        duplication of these fields entirely. Such an application can supply a
2123        `ByteOutput` that chains together the chunks received from
2124        `CodedOutputStream` before forwarding them onto the IO system.
2125  * Other related changes to `CodedOutputStream`
2126      - Additional use of `sun.misc.Unsafe` where possible to perform fast
2127        access to `byte[]` and `ByteBuffer` values and avoiding unnecessary
2128        range checking.
2129      - `ByteBuffer`-backed `CodedOutputStream` now writes directly to the
2130        `ByteBuffer` rather than to an intermediate array.
2131  * Improved lite-runtime.
2132      - Lite protos now implement deep equals/hashCode/toString
2133      - Significantly improved the performance of Builder#mergeFrom() and
2134        Builder#mergeDelimitedFrom()
2135  * Various bug fixes and small feature enhancement.
2136      - Fixed stack overflow when in hashCode() for infinite recursive oneofs.
2137      - Fixed the lazy field parsing in lite to merge rather than overwrite.
2138      - TextFormat now supports reporting line/column numbers on errors.
2139      - Updated to add appropriate @Override for better compiler errors.
2140
2141  Python (Beta)
2142  * Added JSON format for Any, Struct, Value and ListValue
2143  * [ ] is now accepted for both repeated scalar fields and repeated message
2144    fields in text format parser.
2145  * Numerical field name is now supported in text format.
2146  * Added DiscardUnknownFields API for python protobuf message.
2147
2148  Objective-C (Beta)
2149  * Proto comments now come over as HeaderDoc comments in the generated sources
2150    so Xcode can pick them up and display them.
2151  * The library headers have been updated to use HeaderDoc comments so Xcode can
2152    pick them up and display them.
2153  * The per message and per field overhead in both generated code and runtime
2154    object sizes was reduced.
2155  * Generated code now include deprecated annotations when the proto file
2156    included them.
2157
2158  C# (Beta)
2159  In general: some changes are breaking, which require regenerating messages.
2160  Most user-written code will not be impacted *except* for the renaming of enum
2161  values.
2162
2163  * Allow custom type URL prefixes in `Any` packing, and ignore them when
2164    unpacking
2165  * `protoc` is now in a separate NuGet package (Google.Protobuf.Tools)
2166  * New option: `internal_access` to generate internal classes
2167  * Enum values are now PascalCased, and if there's a prefix which matches the
2168    name of the enum, that is removed (so an enum `COLOR` with a value
2169    `COLOR_BLUE` would generate a value of just `Blue`). An option
2170    (`legacy_enum_values`) is temporarily available to disable this, but the
2171    option will be removed for GA.
2172  * `json_name` option is now honored
2173  * If group tags are encountered when parsing, they are validated more
2174    thoroughly (although we don't support actual groups)
2175  * NuGet dependencies are better specified
2176  * Breaking: `Preconditions` is renamed to `ProtoPreconditions`
2177  * Breaking: `GeneratedCodeInfo` is renamed to `GeneratedClrTypeInfo`
2178  * `JsonFormatter` now allows writing to a `TextWriter`
2179  * New interface, `ICustomDiagnosticMessage` to allow more compact
2180    representations from `ToString`
2181  * `CodedInputStream` and `CodedOutputStream` now implement `IDisposable`,
2182    which simply disposes of the streams they were constructed with
2183  * Map fields no longer support null values (in line with other languages)
2184  * Improvements in JSON formatting and parsing
2185
2186  Javascript (Alpha)
2187  * Better support for "bytes" fields: bytes fields can be read as either a
2188    base64 string or UInt8Array (in environments where TypedArray is supported).
2189  * New support for CommonJS imports.  This should make it easier to use the
2190    JavaScript support in Node.js and tools like WebPack.  See js/README.md for
2191    more information.
2192  * Some significant internal refactoring to simplify and modularize the code.
2193
2194  Ruby (Alpha)
2195  * JSON serialization now properly uses camelCased names, with a runtime option
2196    that will preserve original names from .proto files instead.
2197  * Well-known types are now included in the distribution.
2198  * Release now includes binary gems for Windows, Mac, and Linux instead of just
2199    source gems.
2200  * Bugfix for serializing oneofs.
2201
2202  C++/Java Lite (Alpha)
2203    A new "lite" generator parameter was introduced in the protoc for C++ and
2204    Java for Proto3 syntax messages. Example usage:
2205
2206     ./protoc --cpp_out=lite:$OUTPUT_PATH foo.proto
2207
2208    The protoc will treat the current input and all the transitive dependencies
2209    as LITE. The same generator parameter must be used to generate the
2210    dependencies.
2211
2212    In Proto3 syntax files, "optimized_for=LITE_RUNTIME" is no longer supported.
2213
2214
22152015-12-30 version 3.0.0-beta-2 (C++/Java/Python/Ruby/Nano/Objective-C/C#/JavaScript)
2216  General
2217  * Introduced a new language implementation: JavaScript.
2218  * Added a new field option "json_name". By default proto field names are
2219    converted to "lowerCamelCase" in proto3 JSON format. This option can be
2220    used to override this behavior and specify a different JSON name for the
2221    field.
2222  * Added conformance tests to ensure implementations are following proto3 JSON
2223    specification.
2224
2225  C++ (Beta)
2226  * Various bug fixes and improvements to the JSON support utility:
2227      - Duplicate map keys in JSON are now rejected (i.e., translation will
2228        fail).
2229      - Fixed wire-format for google.protobuf.Value/ListValue.
2230      - Fixed precision loss when converting google.protobuf.Timestamp.
2231      - Fixed a bug when parsing invalid UTF-8 code points.
2232      - Fixed a memory leak.
2233      - Reduced call stack usage.
2234
2235  Java (Beta)
2236  * Cleaned up some unused methods on CodedOutputStream.
2237  * Presized lists for packed fields during parsing in the lite runtime to
2238    reduce allocations and improve performance.
2239  * Improved the performance of unknown fields in the lite runtime.
2240  * Introduced UnsafeByteStrings to support zero-copy ByteString creation.
2241  * Various bug fixes and improvements to the JSON support utility:
2242      - Fixed a thread-safety bug.
2243      - Added a new option “preservingProtoFieldNames” to JsonFormat.
2244      - Added a new option “includingDefaultValueFields” to JsonFormat.
2245      - Updated the JSON utility to comply with proto3 JSON specification.
2246
2247  Python (Beta)
2248  * Added proto3 JSON format utility. It includes support for all field types
2249    and a few well-known types except for Any and Struct.
2250  * Added runtime support for Any, Timestamp, Duration and FieldMask.
2251  * [ ] is now accepted for repeated scalar fields in text format parser.
2252  * Map fields now have proper O(1) performance for lookup/insert/delete
2253    when using the Python/C++ implementation. They were previously using O(n)
2254    search-based algorithms because the C++ reflection interface didn't
2255    support true map operations.
2256
2257  Objective-C (Beta)
2258  * Various bug-fixes and code tweaks to pass more strict compiler warnings.
2259  * Now has conformance test coverage and is passing all tests.
2260
2261  C# (Beta)
2262  * Various bug-fixes.
2263  * Code generation: Files generated in directories based on namespace.
2264  * Code generation: Include comments from .proto files in XML doc
2265    comments (naively)
2266  * Code generation: Change organization/naming of "reflection class" (access
2267    to file descriptor)
2268  * Code generation and library: Add Parser property to MessageDescriptor,
2269    and introduce a non-generic parser type.
2270  * Library: Added TypeRegistry to support JSON parsing/formatting of Any.
2271  * Library: Added Any.Pack/Unpack support.
2272  * Library: Implemented JSON parsing.
2273
2274  Javascript (Alpha)
2275  * Added proto3 support for JavaScript. The runtime is written in pure
2276    JavaScript and works in browsers and in Node.js. To generate JavaScript
2277    code for your proto, invoke protoc with "--js_out". See js/README.md
2278    for more build instructions.
2279
22802015-08-26 version 3.0.0-beta-1 (C++/Java/Python/Ruby/Nano/Objective-C/C#)
2281  About Beta
2282  * This is the first beta release of protobuf v3.0.0. Not all languages
2283    have reached beta stage. Languages not marked as beta are still in
2284    alpha (i.e., be prepared for API breaking changes).
2285
2286  General
2287  * Proto3 JSON is supported in several languages (fully supported in C++
2288    and Java, partially supported in Ruby/C#). The JSON spec is defined in
2289    the proto3 language guide:
2290
2291      https://developers.google.com/protocol-buffers/docs/proto3#json
2292
2293    We will publish a more detailed spec to define the exact behavior of
2294    proto3-conformant JSON serializers and parsers. Until then, do not rely
2295    on specific behaviors of the implementation if it’s not documented in
2296    the above spec. More specifically, the behavior is not yet finalized for
2297    the following:
2298      - Parsing invalid JSON input (e.g., input with trailing commas).
2299      - Non-camelCase names in JSON input.
2300      - The same field appears multiple times in JSON input.
2301      - JSON arrays contain “null” values.
2302      - The message has unknown fields.
2303
2304  * Proto3 now enforces strict UTF-8 checking. Parsing will fail if a string
2305    field contains non UTF-8 data.
2306
2307  C++ (Beta)
2308  * Introduced new utility functions/classes in the google/protobuf/util
2309    directory:
2310      - MessageDifferencer: compare two proto messages and report their
2311                            differences.
2312      - JsonUtil: support converting protobuf binary format to/from JSON.
2313      - TimeUtil: utility functions to work with well-known types Timestamp
2314                  and Duration.
2315      - FieldMaskUtil: utility functions to work with FieldMask.
2316
2317  * Performance optimization of arena construction and destruction.
2318  * Bug fixes for arena and maps support.
2319  * Changed to use cmake for Windows Visual Studio builds.
2320  * Added Bazel support.
2321
2322  Java (Beta)
2323  * Introduced a new util package that will be distributed as a separate
2324    artifact in maven. It contains:
2325      - JsonFormat: convert proto messages to/from JSON.
2326      - TimeUtil: utility functions to work with Timestamp and Duration.
2327      - FieldMaskUtil: utility functions to work with FieldMask.
2328
2329  * The static PARSER in each generated message is deprecated, and it will
2330    be removed in a future release. A static parser() getter is generated
2331    for each message type instead.
2332  * Performance optimizations for String fields serialization.
2333  * Performance optimizations for Lite runtime on Android:
2334      - Reduced allocations
2335      - Reduced method overhead after ProGuarding
2336      - Reduced code size after ProGuarding
2337
2338  Python (Alpha)
2339  * Removed legacy Python 2.5 support.
2340  * Moved to a single Python 2.x/3.x-compatible codebase, instead of using 2to3.
2341  * Fixed build/tests on Python 2.6, 2.7, 3.3, and 3.4.
2342      - Pure-Python works on all four.
2343      - Python/C++ implementation works on all but 3.4, due to changes in the
2344        Python/C++ API in 3.4.
2345  * Some preliminary work has been done to allow for multiple DescriptorPools
2346    with Python/C++.
2347
2348  Ruby (Alpha)
2349  * Many bugfixes:
2350      - fixed parsing/serialization of bytes, sint, sfixed types
2351      - other parser bugfixes
2352      - fixed memory leak affecting Ruby 2.2
2353
2354  JavaNano (Alpha)
2355  * JavaNano generated code now will be put in a nano package by default to
2356    avoid conflicts with Java generated code.
2357
2358  Objective-C (Alpha)
2359  * Added non-null markup to ObjC library. Requires SDK 8.4+ to build.
2360  * Many bugfixes:
2361      - Removed the class/enum filter.
2362      - Renamed some internal types to avoid conflicts with the well-known types
2363        protos.
2364      - Added missing support for parsing repeated primitive fields in packed or
2365        unpacked forms.
2366      - Added *Count for repeated and map<> fields to avoid auto-create when
2367        checking for them being set.
2368
2369  C# (Alpha)
2370  * Namespace changed to Google.Protobuf (and NuGet package will be named
2371    correspondingly).
2372  * Target platforms now .NET 4.5 and selected portable subsets only.
2373  * Removed lite runtime.
2374  * Reimplementation to use mutable message types.
2375  * Null references used to represent "no value" for message type fields.
2376  * Proto3 semantics supported; proto2 files are prohibited for C# codegen.
2377    Most proto3 features supported:
2378      - JSON formatting (a.k.a. serialization to JSON), including well-known
2379        types (except for Any).
2380      - Wrapper types mapped to nullable value types (or string/ByteString
2381        allowing nullability). JSON parsing is not supported yet.
2382      - maps
2383      - oneof
2384      - enum unknown value preservation
2385
23862015-05-25 version 3.0.0-alpha-3 (Objective-C/C#):
2387  General
2388  * Introduced two new language implementations (Objective-C, C#) to proto3.
2389  * Explicit "optional" keyword are disallowed in proto3 syntax, as fields are
2390    optional by default.
2391  * Group fields are no longer supported in proto3 syntax.
2392  * Changed repeated primitive fields to use packed serialization by default in
2393    proto3 (implemented for C++, Java, Python in this release).  The user can
2394    still disable packed serialization by setting packed to false for now.
2395  * Added well-known type protos (any.proto, empty.proto, timestamp.proto,
2396    duration.proto, etc.). Users can import and use these protos just like
2397    regular proto files. Additional runtime support will be added for them in
2398    future releases (in the form of utility helper functions, or having them
2399    replaced by language specific types in generated code).
2400  * Added a "reserved" keyword in both proto2 and proto3 syntax. User can use
2401    this keyword to declare reserved field numbers and names to prevent them
2402    from being reused by other fields in the same message.
2403
2404    To reserve field numbers, add a reserved declaration in your message:
2405
2406      message TestMessage {
2407        reserved 2, 15, 9 to 11, 3;
2408      }
2409
2410    This reserves field numbers 2, 3, 9, 10, 11 and 15. If a user uses any of
2411    these as field numbers, the protocol buffer compiler will report an error.
2412
2413    Field names can also be reserved:
2414
2415      message TestMessage {
2416        reserved "foo", "bar";
2417      }
2418
2419  * Various bug fixes since 3.0.0-alpha-2
2420
2421  Objective-C
2422    Objective-C includes a code generator and a native objective-c runtime
2423    library.  By adding “--objc_out” to protoc, the code generator will generate
2424    a header(*.pbobjc.h) and an implementation file(*.pbobjc.m) for each proto
2425    file.
2426
2427    In this first release, the generated interface provides: enums, messages,
2428    field support(single, repeated, map, oneof), proto2 and proto3 syntax
2429    support, parsing and serialization. It’s  compatible with ARC and non-ARC
2430    usage. Besides, user can also access it via the swift bridging header.
2431
2432    See objectivec/README.md for details.
2433
2434  C#
2435    * C# protobufs are based on project
2436      https://github.com/jskeet/protobuf-csharp-port. The original project was
2437      frozen and all the new development will happen here.
2438    * Codegen plugin for C# was completely rewritten to C++ and is now an
2439      integral part of protoc.
2440    * Some refactorings and cleanup has been applied to the C# runtime library.
2441    * Only proto2 is supported in C# at the moment, proto3 support is in
2442      progress and will likely bring significant breaking changes to the API.
2443
2444    See csharp/README.md for details.
2445
2446  C++
2447    * Added runtime support for Any type. To use Any in your proto file, first
2448      import the definition of Any:
2449
2450        // foo.proto
2451        import "google/protobuf/any.proto";
2452        message Foo {
2453          google.protobuf.Any any_field = 1;
2454        }
2455        message Bar {
2456          int32 value = 1;
2457        }
2458
2459      Then in C++ you can access the Any field using PackFrom()/UnpackTo()
2460      methods:
2461
2462        Foo foo;
2463        Bar bar = ...;
2464        foo.mutable_any_field()->PackFrom(bar);
2465        ...
2466        if (foo.any_field().IsType<Bar>()) {
2467          foo.any_field().UnpackTo(&bar);
2468          ...
2469        }
2470    * In text format, entries of a map field will be sorted by key.
2471
2472  Java
2473    * Continued optimizations on the lite runtime to improve performance for
2474      Android.
2475
2476  Python
2477    * Added map support.
2478      - maps now have a dict-like interface (msg.map_field[key] = value)
2479      - existing code that modifies maps via the repeated field interface
2480        will need to be updated.
2481
2482  Ruby
2483    * Improvements to RepeatedField's emulation of the Ruby Array API.
2484    * Various speedups and internal cleanups.
2485
24862015-02-26 version 3.0.0-alpha-2 (Python/Ruby/JavaNano):
2487  General
2488  * Introduced three new language implementations (Ruby, JavaNano, and
2489    Python) to proto3.
2490  * Various bug fixes since 3.0.0-alpha-1
2491
2492  Python:
2493    Python has received several updates, most notably support for proto3
2494    semantics in any .proto file that declares syntax="proto3".
2495    Messages declared in proto3 files no longer represent field presence
2496    for scalar fields (number, enums, booleans, or strings).  You can
2497    no longer call HasField() for such fields, and they are serialized
2498    based on whether they have a non-zero/empty/false value.
2499
2500    One other notable change is in the C++-accelerated implementation.
2501    Descriptor objects (which describe the protobuf schema and allow
2502    reflection over it) are no longer duplicated between the Python
2503    and C++ layers.  The Python descriptors are now simple wrappers
2504    around the C++ descriptors.  This change should significantly
2505    reduce the memory usage of programs that use a lot of message
2506    types.
2507
2508  Ruby:
2509    We have added proto3 support for Ruby via a native C extension.
2510
2511    The Ruby extension itself is included in the ruby/ directory, and details on
2512    building and installing the extension are in ruby/README.md. The extension
2513    will also be published as a Ruby gem. Code generator support is included as
2514    part of `protoc` with the `--ruby_out` flag.
2515
2516    The Ruby extension implements a user-friendly DSL to define message types
2517    (also generated by the code generator from `.proto` files).  Once a message
2518    type is defined, the user may create instances of the message that behave in
2519    ways idiomatic to Ruby. For example:
2520
2521    - Message fields are present as ordinary Ruby properties (getter method
2522      `foo` and setter method `foo=`).
2523    - Repeated field elements are stored in a container that acts like a native
2524      Ruby array, and map elements are stored in a container that acts like a
2525      native Ruby hashmap.
2526    - The usual well-known methods, such as `#to_s`, `#dup`, and the like, are
2527      present.
2528
2529    Unlike several existing third-party Ruby extensions for protobuf, this
2530    extension is built on a "strongly-typed" philosophy: message fields and
2531    array/map containers will throw exceptions eagerly when values of the
2532    incorrect type are inserted.
2533
2534    See ruby/README.md for details.
2535
2536  JavaNano:
2537    JavaNano is a special code generator and runtime library designed especially
2538    for resource-restricted systems, like Android. It is very resource-friendly
2539    in both the amount of code and the runtime overhead. Here is an an overview
2540    of JavaNano features compared with the official Java protobuf:
2541
2542    - No descriptors or message builders.
2543    - All messages are mutable; fields are public Java fields.
2544    - For optional fields only, encapsulation behind setter/getter/hazzer/
2545      clearer functions is opt-in, which provide proper 'has' state support.
2546    - For proto2, if not opted in, has state (field presence) is not available.
2547      Serialization outputs all fields not equal to their defaults.
2548      The behavior is consistent with proto3 semantics.
2549    - Required fields (proto2 only) are always serialized.
2550    - Enum constants are integers; protection against invalid values only
2551      when parsing from the wire.
2552    - Enum constants can be generated into container interfaces bearing
2553      the enum's name (so the referencing code is in Java style).
2554    - CodedInputByteBufferNano can only take byte[] (not InputStream).
2555    - Similarly CodedOutputByteBufferNano can only write to byte[].
2556    - Repeated fields are in arrays, not ArrayList or Vector. Null array
2557      elements are allowed and silently ignored.
2558    - Full support for serializing/deserializing repeated packed fields.
2559    - Support  extensions (in proto2).
2560    - Unset messages/groups are null, not an immutable empty default
2561      instance.
2562    - toByteArray(...) and mergeFrom(...) are now static functions of
2563      MessageNano.
2564    - The 'bytes' type translates to the Java type byte[].
2565
2566    See javanano/README.txt for details.
2567
25682014-12-01 version 3.0.0-alpha-1 (C++/Java):
2569
2570  General
2571  * Introduced Protocol Buffers language version 3 (aka proto3).
2572
2573    When protobuf was initially opensourced it implemented Protocol Buffers
2574    language version 2 (aka proto2), which is why the version number
2575    started from v2.0.0. From v3.0.0, a new language version (proto3) is
2576    introduced while the old version (proto2) will continue to be supported.
2577
2578    The main intent of introducing proto3 is to clean up protobuf before
2579    pushing the language as the foundation of Google's new API platform.
2580    In proto3, the language is simplified, both for ease of use and  to
2581    make it available in a wider range of programming languages. At the
2582    same time a few features are added to better support common idioms
2583    found in APIs.
2584
2585    The following are the main new features in language version 3:
2586
2587      1. Removal of field presence logic for primitive value fields, removal
2588         of required fields, and removal of default values. This makes proto3
2589         significantly easier to implement with open struct representations,
2590         as in languages like Android Java, Objective C, or Go.
2591      2. Removal of unknown fields.
2592      3. Removal of extensions, which are instead replaced by a new standard
2593         type called Any.
2594      4. Fix semantics for unknown enum values.
2595      5. Addition of maps.
2596      6. Addition of a small set of standard types for representation of time,
2597         dynamic data, etc.
2598      7. A well-defined encoding in JSON as an alternative to binary proto
2599         encoding.
2600
2601    This release (v3.0.0-alpha-1) includes partial proto3 support for C++ and
2602    Java. Items 6 (well-known types) and 7 (JSON format) in the above feature
2603    list are not implemented.
2604
2605    A new notion "syntax" is introduced to specify whether a .proto file
2606    uses proto2 or proto3:
2607
2608      // foo.proto
2609      syntax = "proto3";
2610      message Bar {...}
2611
2612    If omitted, the protocol compiler will generate a warning and "proto2" will
2613    be used as the default. This warning will be turned into an error in a
2614    future release.
2615
2616    We recommend that new Protocol Buffers users use proto3. However, we do not
2617    generally recommend that existing users migrate from proto2 from proto3 due
2618    to API incompatibility, and we will continue to support proto2 for a long
2619    time.
2620
2621  * Added support for map fields (implemented in C++/Java for both proto2 and
2622    proto3).
2623
2624    Map fields can be declared using the following syntax:
2625
2626      message Foo {
2627        map<string, string> values = 1;
2628      }
2629
2630    Data of a map field will be stored in memory as an unordered map and it
2631    can be accessed through generated accessors.
2632
2633  C++
2634  * Added arena allocation support (for both proto2 and proto3).
2635
2636    Profiling shows memory allocation and deallocation constitutes a significant
2637    fraction of CPU-time spent in protobuf code and arena allocation is a
2638    technique introduced to reduce this cost. With arena allocation, new
2639    objects will be allocated from a large piece of preallocated memory and
2640    deallocation of these objects is almost free. Early adoption shows 20% to
2641    50% improvement in some Google binaries.
2642
2643    To enable arena support, add the following option to your .proto file:
2644
2645      option cc_enable_arenas = true;
2646
2647    Protocol compiler will generate additional code to make the generated
2648    message classes work with arenas. This does not change the existing API
2649    of protobuf messages and does not affect wire format. Your existing code
2650    should continue to work after adding this option. In the future we will
2651    make this option enabled by default.
2652
2653    To actually take advantage of arena allocation, you need to use the arena
2654    APIs when creating messages. A quick example of using the arena API:
2655
2656      {
2657        google::protobuf::Arena arena;
2658        // Allocate a protobuf message in the arena.
2659        MyMessage* message = Arena::CreateMessage<MyMessage>(&arena);
2660        // All submessages will be allocated in the same arena.
2661        if (!message->ParseFromString(data)) {
2662          // Deal with malformed input data.
2663        }
2664        // Must not delete the message here. It will be deleted automatically
2665        // when the arena is destroyed.
2666      }
2667
2668    Currently arena does not work with map fields. Enabling arena in a .proto
2669    file containing map fields will result in compile errors in the generated
2670    code. This will be addressed in a future release.
2671
26722014-10-20 version 2.6.1:
2673
2674  C++
2675  * Added atomicops support for Solaris.
2676  * Released memory allocated by InitializeDefaultRepeatedFields() and
2677    GetEmptyString(). Some memory sanitizers reported them as memory leaks.
2678
2679  Java
2680  * Updated DynamicMessage.setField() to handle repeated enum values
2681    correctly.
2682  * Fixed a bug that caused NullPointerException to be thrown when
2683    converting manually constructed FileDescriptorProto to
2684    FileDescriptor.
2685
2686  Python
2687  * Fixed WhichOneof() to work with de-serialized protobuf messages.
2688  * Fixed a missing file problem of Python C++ implementation.
2689
26902014-08-15 version 2.6.0:
2691
2692  General
2693  * Added oneofs(unions) feature. Fields in the same oneof will share
2694    memory and at most one field can be set at the same time. Use the
2695    oneof keyword to define a oneof like:
2696      message SampleMessage {
2697        oneof test_oneof {
2698          string name = 4;
2699          YourMessage sub_message = 9;
2700        }
2701      }
2702  * Files, services, enums, messages, methods and enum values can be marked
2703    as deprecated now.
2704  * Added Support for list values, including lists of messages, when
2705    parsing text-formatted protos in C++ and Java.
2706      For example:  foo: [1, 2, 3]
2707
2708  C++
2709  * Enhanced customization on TestFormat printing.
2710  * Added SwapFields() in reflection API to swap a subset of fields.
2711    Added SetAllocatedMessage() in reflection API.
2712  * Repeated primitive extensions are now packable. The
2713    [packed=true] option only affects serializers. Therefore, it is
2714    possible to switch a repeated extension field to packed format
2715    without breaking backwards-compatibility.
2716  * Various speed optimizations.
2717
2718  Java
2719  * writeTo() method in ByteString can now write a substring to an
2720    output stream. Added endWith() method for ByteString.
2721  * ByteString and ByteBuffer are now supported in CodedInputStream
2722    and CodedOutputStream.
2723  * java_generate_equals_and_hash can now be used with the LITE_RUNTIME.
2724
2725  Python
2726  * A new C++-backed extension module (aka "cpp api v2") that replaces the
2727    old ("cpp api v1") one.  Much faster than the pure Python code.  This one
2728    resolves many bugs and is recommended for general use over the
2729    pure Python when possible.
2730  * Descriptors now have enum_types_by_name and extension_types_by_name dict
2731    attributes.
2732  * Support for Python 3.
2733
27342013-02-27 version 2.5.0:
2735
2736  General
2737  * New notion "import public" that allows a proto file to forward the content
2738    it imports to its importers. For example,
2739      // foo.proto
2740      import public "bar.proto";
2741      import "baz.proto";
2742
2743      // qux.proto
2744      import "foo.proto";
2745      // Stuff defined in bar.proto may be used in this file, but stuff from
2746      // baz.proto may NOT be used without importing it explicitly.
2747    This is useful for moving proto files. To move a proto file, just leave
2748    a single "import public" in the old proto file.
2749  * New enum option "allow_alias" that specifies whether different symbols can
2750    be assigned the same numeric value. Default value is "true". Setting it to
2751    false causes the compiler to reject enum definitions where multiple symbols
2752    have the same numeric value.
2753    Note: We plan to flip the default value to "false" in a future release.
2754    Projects using enum aliases should set the option to "true" in their .proto
2755    files.
2756
2757  C++
2758  * New generated method set_allocated_foo(Type* foo) for message and string
2759    fields. This method allows you to set the field to a pre-allocated object
2760    and the containing message takes the ownership of that object.
2761  * Added SetAllocatedExtension() and ReleaseExtension() to extensions API.
2762  * Custom options are now formatted correctly when descriptors are printed in
2763    text format.
2764  * Various speed optimizations.
2765
2766  Java
2767  * Comments in proto files are now collected and put into generated code as
2768    comments for corresponding classes and data members.
2769  * Added Parser to parse directly into messages without a Builder. For
2770    example,
2771      Foo foo = Foo.PARSER.ParseFrom(input);
2772    Using Parser is ~25% faster than using Builder to parse messages.
2773  * Added getters/setters to access the underlying ByteString of a string field
2774    directly.
2775  * ByteString now supports more operations: substring(), prepend(), and
2776    append(). The implementation of ByteString uses a binary tree structure
2777    to support these operations efficiently.
2778  * New method findInitializationErrors() that lists all missing required
2779    fields.
2780  * Various code size and speed optimizations.
2781
2782  Python
2783  * Added support for dynamic message creation. DescriptorDatabase,
2784    DescriptorPool, and MessageFactory work like their C++ counterparts to
2785    simplify Descriptor construction from *DescriptorProtos, and MessageFactory
2786    provides a message instance from a Descriptor.
2787  * Added pickle support for protobuf messages.
2788  * Unknown fields are now preserved after parsing.
2789  * Fixed bug where custom options were not correctly populated. Custom
2790    options can be accessed now.
2791  * Added EnumTypeWrapper that provides better accessibility to enum types.
2792  * Added ParseMessage(descriptor, bytes) to generate a new Message instance
2793    from a descriptor and a byte string.
2794
27952011-05-01 version 2.4.1:
2796
2797  C++
2798  * Fixed the friendship problem for old compilers to make the library now gcc 3
2799    compatible again.
2800  * Fixed vcprojects/extract_includes.bat to extract compiler/plugin.h.
2801
2802  Java
2803  * Removed usages of JDK 1.6 only features to make the library now JDK 1.5
2804    compatible again.
2805  * Fixed a bug about negative enum values.
2806  * serialVersionUID is now defined in generated messages for java serializing.
2807  * Fixed protoc to use java.lang.Object, which makes "Object" now a valid
2808    message name again.
2809
2810  Python
2811  * Experimental C++ implementation now requires C++ protobuf library installed.
2812    See the README.txt in the python directory for details.
2813
28142011-02-02 version 2.4.0:
2815
2816  General
2817  * The RPC (cc|java|py)_generic_services default value is now false instead of
2818    true.
2819  * Custom options can have aggregate types. For example,
2820      message MyOption {
2821        optional string comment = 1;
2822        optional string author = 2;
2823      }
2824      extend google.protobuf.FieldOptions {
2825        optional MyOption myoption = 12345;
2826      }
2827    This option can now be set as follows:
2828      message SomeType {
2829        optional int32 field = 1 [(myoption) = { comment:'x' author:'y' }];
2830      }
2831
2832  C++
2833  * Various speed and code size optimizations.
2834  * Added a release_foo() method on string and message fields.
2835  * Fixed gzip_output_stream sub-stream handling.
2836
2837  Java
2838  * Builders now maintain sub-builders for sub-messages. Use getFooBuilder() to
2839    get the builder for the sub-message "foo". This allows you to repeatedly
2840    modify deeply-nested sub-messages without rebuilding them.
2841  * Builder.build() no longer invalidates the Builder for generated messages
2842    (You may continue to modify it and then build another message).
2843  * Code generator will generate efficient equals() and hashCode()
2844    implementations if new option java_generate_equals_and_hash is enabled.
2845    (Otherwise, reflection-based implementations are used.)
2846  * Generated messages now implement Serializable.
2847  * Fields with [deprecated=true] will be marked with @Deprecated in Java.
2848  * Added lazy conversion of UTF-8 encoded strings to String objects to improve
2849    performance.
2850  * Various optimizations.
2851  * Enum value can be accessed directly, instead of calling getNumber() on the
2852    enum member.
2853  * For each enum value, an integer constant is also generated with the suffix
2854    _VALUE.
2855
2856  Python
2857  * Added an experimental  C++ implementation for Python messages via a Python
2858    extension. Implementation type is controlled by an environment variable
2859    PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION (valid values: "cpp" and "python")
2860    The default value is currently "python" but will be changed to "cpp" in
2861    future release.
2862  * Improved performance on message instantiation significantly.
2863    Most of the work on message instantiation is done just once per message
2864    class, instead of once per message instance.
2865  * Improved performance on text message parsing.
2866  * Allow add() to forward keyword arguments to the concrete class.
2867      E.g. instead of
2868        item = repeated_field.add()
2869        item.foo = bar
2870        item.baz = quux
2871      You can do:
2872        repeated_field.add(foo=bar, baz=quux)
2873  * Added a sort() interface to the BaseContainer.
2874  * Added an extend() method to repeated composite fields.
2875  * Added UTF8 debug string support.
2876
28772010-01-08 version 2.3.0:
2878
2879  General
2880  * Parsers for repeated numeric fields now always accept both packed and
2881    unpacked input.  The [packed=true] option only affects serializers.
2882    Therefore, it is possible to switch a field to packed format without
2883    breaking backwards-compatibility -- as long as all parties are using
2884    protobuf 2.3.0 or above, at least.
2885  * The generic RPC service code generated by the C++, Java, and Python
2886    generators can be disabled via file options:
2887      option cc_generic_services = false;
2888      option java_generic_services = false;
2889      option py_generic_services = false;
2890    This allows plugins to generate alternative code, possibly specific to some
2891    particular RPC implementation.
2892
2893  protoc
2894  * Now supports a plugin system for code generators.  Plugins can generate
2895    code for new languages or inject additional code into the output of other
2896    code generators.  Plugins are just binaries which accept a protocol buffer
2897    on stdin and write a protocol buffer to stdout, so they may be written in
2898    any language.  See src/google/protobuf/compiler/plugin.proto.
2899    **WARNING**:  Plugins are experimental.  The interface may change in a
2900    future version.
2901  * If the output location ends in .zip or .jar, protoc will write its output
2902    to a zip/jar archive instead of a directory.  For example:
2903      protoc --java_out=myproto_srcs.jar --python_out=myproto.zip myproto.proto
2904    Currently the archive contents are not compressed, though this could change
2905    in the future.
2906  * inf, -inf, and nan can now be used as default values for float and double
2907    fields.
2908
2909  C++
2910  * Various speed and code size optimizations.
2911  * DynamicMessageFactory is now fully thread-safe.
2912  * Message::Utf8DebugString() method is like DebugString() but avoids escaping
2913    UTF-8 bytes.
2914  * Compiled-in message types can now contain dynamic extensions, through use
2915    of CodedInputStream::SetExtensionRegistry().
2916  * Now compiles shared libraries (DLLs) by default on Cygwin and MinGW, to
2917    match other platforms.  Use --disable-shared to avoid this.
2918
2919  Java
2920  * parseDelimitedFrom() and mergeDelimitedFrom() now detect EOF and return
2921    false/null instead of throwing an exception.
2922  * Fixed some initialization ordering bugs.
2923  * Fixes for OpenJDK 7.
2924
2925  Python
2926  * 10-25 times faster than 2.2.0, still pure-Python.
2927  * Calling a mutating method on a sub-message always instantiates the message
2928    in its parent even if the mutating method doesn't actually mutate anything
2929    (e.g. parsing from an empty string).
2930  * Expanded descriptors a bit.
2931
29322009-08-11 version 2.2.0:
2933
2934  C++
2935  * Lite mode:  The "optimize_for = LITE_RUNTIME" option causes the compiler
2936    to generate code which only depends libprotobuf-lite, which is much smaller
2937    than libprotobuf but lacks descriptors, reflection, and some other features.
2938  * Fixed bug where Message.Swap(Message) was only implemented for
2939    optimize_for_speed.  Swap now properly implemented in both modes
2940    (Issue 91).
2941  * Added RemoveLast and SwapElements(index1, index2) to Reflection
2942    interface for repeated elements.
2943  * Added Swap(Message) to Reflection interface.
2944  * Floating-point literals in generated code that are intended to be
2945    single-precision now explicitly have 'f' suffix to avoid pedantic warnings
2946    produced by some compilers.
2947  * The [deprecated=true] option now causes the C++ code generator to generate
2948    a GCC-style deprecation annotation (no-op on other compilers).
2949  * google::protobuf::GetEnumDescriptor<SomeGeneratedEnumType>() returns the
2950    EnumDescriptor for that type -- useful for templates which cannot call
2951    SomeGeneratedEnumType_descriptor().
2952  * Various optimizations and obscure bug fixes.
2953
2954  Java
2955  * Lite mode:  The "optimize_for = LITE_RUNTIME" option causes the compiler
2956    to generate code which only depends libprotobuf-lite, which is much smaller
2957    than libprotobuf but lacks descriptors, reflection, and some other features.
2958  * Lots of style cleanups.
2959
2960  Python
2961  * Fixed endianness bug with floats and doubles.
2962  * Text format parsing support.
2963  * Fix bug with parsing packed repeated fields in embedded messages.
2964  * Ability to initialize fields by passing keyword args to constructor.
2965  * Support iterators in extend and __setslice__ for containers.
2966
29672009-05-13 version 2.1.0:
2968
2969  General
2970  * Repeated fields of primitive types (types other that string, group, and
2971    nested messages) may now use the option [packed = true] to get a more
2972    efficient encoding.  In the new encoding, the entire list is written
2973    as a single byte blob using the "length-delimited" wire type.  Within
2974    this blob, the individual values are encoded the same way they would
2975    be normally except without a tag before each value (thus, they are
2976    tightly "packed").
2977  * For each field, the generated code contains an integer constant assigned
2978    to the field number.  For example, the .proto file:
2979      message Foo { optional int bar_baz = 123; }
2980    would generate the following constants, all with the integer value 123:
2981      C++:     Foo::kBarBazFieldNumber
2982      Java:    Foo.BAR_BAZ_FIELD_NUMBER
2983      Python:  Foo.BAR_BAZ_FIELD_NUMBER
2984    Constants are also generated for extensions, with the same naming scheme.
2985    These constants may be used as switch cases.
2986  * Updated bundled Google Test to version 1.3.0.  Google Test is now bundled
2987    in its verbatim form as a nested autoconf package, so you can drop in any
2988    other version of Google Test if needed.
2989  * optimize_for = SPEED is now the default, by popular demand.  Use
2990    optimize_for = CODE_SIZE if code size is more important in your app.
2991  * It is now an error to define a default value for a repeated field.
2992    Previously, this was silently ignored (it had no effect on the generated
2993    code).
2994  * Fields can now be marked deprecated like:
2995      optional int32 foo = 1 [deprecated = true];
2996    Currently this does not have any actual effect, but in the future the code
2997    generators may generate deprecation annotations in each language.
2998  * Cross-compiling should now be possible using the --with-protoc option to
2999    configure.  See README.txt for more info.
3000
3001  protoc
3002  * --error_format=msvs option causes errors to be printed in Visual Studio
3003    format, which should allow them to be clicked on in the build log to go
3004    directly to the error location.
3005  * The type name resolver will no longer resolve type names to fields.  For
3006    example, this now works:
3007      message Foo {}
3008      message Bar {
3009        optional int32 Foo = 1;
3010        optional Foo baz = 2;
3011      }
3012    Previously, the type of "baz" would resolve to "Bar.Foo", and you'd get
3013    an error because Bar.Foo is a field, not a type.  Now the type of "baz"
3014    resolves to the message type Foo.  This change is unlikely to make a
3015    difference to anyone who follows the Protocol Buffers style guide.
3016
3017  C++
3018  * Several optimizations, including but not limited to:
3019    - Serialization, especially to flat arrays, is 10%-50% faster, possibly
3020      more for small objects.
3021    - Several descriptor operations which previously required locking no longer
3022      do.
3023    - Descriptors are now constructed lazily on first use, rather than at
3024      process startup time.  This should save memory in programs which do not
3025      use descriptors or reflection.
3026    - UnknownFieldSet completely redesigned to be more efficient (especially in
3027      terms of memory usage).
3028    - Various optimizations to reduce code size (though the serialization speed
3029      optimizations increased code size).
3030  * Message interface has method ParseFromBoundedZeroCopyStream() which parses
3031    a limited number of bytes from an input stream rather than parsing until
3032    EOF.
3033  * GzipInputStream and GzipOutputStream support reading/writing gzip- or
3034    zlib-compressed streams if zlib is available.
3035    (google/protobuf/io/gzip_stream.h)
3036  * DescriptorPool::FindAllExtensions() and corresponding
3037    DescriptorDatabase::FindAllExtensions() can be used to enumerate all
3038    extensions of a given type.
3039  * For each enum type Foo, protoc will generate functions:
3040      const string& Foo_Name(Foo value);
3041      bool Foo_Parse(const string& name, Foo* result);
3042    The former returns the name of the enum constant corresponding to the given
3043    value while the latter finds the value corresponding to a name.
3044  * RepeatedField and RepeatedPtrField now have back-insertion iterators.
3045  * String fields now have setters that take a char* and a size, in addition
3046    to the existing ones that took char* or const string&.
3047  * DescriptorPool::AllowUnknownDependencies() may be used to tell
3048    DescriptorPool to create placeholder descriptors for unknown entities
3049    referenced in a FileDescriptorProto.  This can allow you to parse a .proto
3050    file without having access to other .proto files that it imports, for
3051    example.
3052  * Updated gtest to latest version.  The gtest package is now included as a
3053    nested autoconf package, so it should be able to drop new versions into the
3054    "gtest" subdirectory without modification.
3055
3056  Java
3057  * Fixed bug where Message.mergeFrom(Message) failed to merge extensions.
3058  * Message interface has new method toBuilder() which is equivalent to
3059    newBuilderForType().mergeFrom(this).
3060  * All enums now implement the ProtocolMessageEnum interface.
3061  * Setting a field to null now throws NullPointerException.
3062  * Fixed tendency for TextFormat's parsing to overflow the stack when
3063    parsing large string values.  The underlying problem is with Java's
3064    regex implementation (which unfortunately uses recursive backtracking
3065    rather than building an NFA).  Worked around by making use of possessive
3066    quantifiers.
3067  * Generated service classes now also generate pure interfaces.  For a service
3068    Foo, Foo.Interface is a pure interface containing all of the service's
3069    defined methods.  Foo.newReflectiveService() can be called to wrap an
3070    instance of this interface in a class that implements the generic
3071    RpcService interface, which provides reflection support that is usually
3072    needed by RPC server implementations.
3073  * RPC interfaces now support blocking operation in addition to non-blocking.
3074    The protocol compiler generates separate blocking and non-blocking stubs
3075    which operate against separate blocking and non-blocking RPC interfaces.
3076    RPC implementations will have to implement the new interfaces in order to
3077    support blocking mode.
3078  * New I/O methods parseDelimitedFrom(), mergeDelimitedFrom(), and
3079    writeDelimitedTo() read and write "delimited" messages from/to a stream,
3080    meaning that the message size precedes the data.  This way, you can write
3081    multiple messages to a stream without having to worry about delimiting
3082    them yourself.
3083  * Throw a more descriptive exception when build() is double-called.
3084  * Add a method to query whether CodedInputStream is at the end of the input
3085    stream.
3086  * Add a method to reset a CodedInputStream's size counter; useful when
3087    reading many messages with the same stream.
3088  * equals() and hashCode() now account for unknown fields.
3089
3090  Python
3091  * Added slicing support for repeated scalar fields. Added slice retrieval and
3092    removal of repeated composite fields.
3093  * Updated RPC interfaces to allow for blocking operation.  A client may
3094    now pass None for a callback when making an RPC, in which case the
3095    call will block until the response is received, and the response
3096    object will be returned directly to the caller.  This interface change
3097    cannot be used in practice until RPC implementations are updated to
3098    implement it.
3099  * Changes to input_stream.py should make protobuf compatible with appengine.
3100
31012008-11-25 version 2.0.3:
3102
3103  protoc
3104  * Enum values may now have custom options, using syntax similar to field
3105    options.
3106  * Fixed bug where .proto files which use custom options but don't actually
3107    define them (i.e. they import another .proto file defining the options)
3108    had to explicitly import descriptor.proto.
3109  * Adjacent string literals in .proto files will now be concatenated, like in
3110    C.
3111  * If an input file is a Windows absolute path (e.g. "C:\foo\bar.proto") and
3112    the import path only contains "." (or contains "." but does not contain
3113    the file), protoc incorrectly thought that the file was under ".", because
3114    it thought that the path was relative (since it didn't start with a slash).
3115    This has been fixed.
3116
3117  C++
3118  * Generated message classes now have a Swap() method which efficiently swaps
3119    the contents of two objects.
3120  * All message classes now have a SpaceUsed() method which returns an estimate
3121    of the number of bytes of allocated memory currently owned by the object.
3122    This is particularly useful when you are reusing a single message object
3123    to improve performance but want to make sure it doesn't bloat up too large.
3124  * New method Message::SerializeAsString() returns a string containing the
3125    serialized data.  May be more convenient than calling
3126    SerializeToString(string*).
3127  * In debug mode, log error messages when string-type fields are found to
3128    contain bytes that are not valid UTF-8.
3129  * Fixed bug where a message with multiple extension ranges couldn't parse
3130    extensions.
3131  * Fixed bug where MergeFrom(const Message&) didn't do anything if invoked on
3132    a message that contained no fields (but possibly contained extensions).
3133  * Fixed ShortDebugString() to not be O(n^2).  Durr.
3134  * Fixed crash in TextFormat parsing if the first token in the input caused a
3135    tokenization error.
3136  * Fixed obscure bugs in zero_copy_stream_impl.cc.
3137  * Added support for HP C++ on Tru64.
3138  * Only build tests on "make check", not "make".
3139  * Fixed alignment issue that caused crashes when using DynamicMessage on
3140    64-bit Sparc machines.
3141  * Simplify template usage to work with MSVC 2003.
3142  * Work around GCC 4.3.x x86_64 compiler bug that caused crashes on startup.
3143    (This affected Fedora 9 in particular.)
3144  * Now works on "Solaris 10 using recent Sun Studio".
3145
3146  Java
3147  * New overload of mergeFrom() which parses a slice of a byte array instead
3148    of the whole thing.
3149  * New method ByteString.asReadOnlyByteBuffer() does what it sounds like.
3150  * Improved performance of isInitialized() when optimizing for code size.
3151
3152  Python
3153  * Corrected ListFields() signature in Message base class to match what
3154    subclasses actually implement.
3155  * Some minor refactoring.
3156  * Don't pass self as first argument to superclass constructor (no longer
3157    allowed in Python 2.6).
3158
31592008-09-29 version 2.0.2:
3160
3161  General
3162  * License changed from Apache 2.0 to 3-Clause BSD.
3163  * It is now possible to define custom "options", which are basically
3164    annotations which may be placed on definitions in a .proto file.
3165    For example, you might define a field option called "foo" like so:
3166      import "google/protobuf/descriptor.proto"
3167      extend google.protobuf.FieldOptions {
3168        optional string foo = 12345;
3169      }
3170    Then you annotate a field using the "foo" option:
3171      message MyMessage {
3172        optional int32 some_field = 1 [(foo) = "bar"]
3173      }
3174    The value of this option is then visible via the message's
3175    Descriptor:
3176      const FieldDescriptor* field =
3177        MyMessage::descriptor()->FindFieldByName("some_field");
3178      assert(field->options().GetExtension(foo) == "bar");
3179    This feature has been implemented and tested in C++ and Java.
3180    Other languages may or may not need to do extra work to support
3181    custom options, depending on how they construct descriptors.
3182
3183  C++
3184  * Fixed some GCC warnings that only occur when using -pedantic.
3185  * Improved static initialization code, making ordering more
3186    predictable among other things.
3187  * TextFormat will no longer accept messages which contain multiple
3188    instances of a singular field.  Previously, the latter instance
3189    would overwrite the former.
3190  * Now works on systems that don't have hash_map.
3191
3192  Java
3193  * Print @Override annotation in generated code where appropriate.
3194
3195  Python
3196  * Strings now use the "unicode" type rather than the "str" type.
3197    String fields may still be assigned ASCII "str" values; they will
3198    automatically be converted.
3199  * Adding a property to an object representing a repeated field now
3200    raises an exception.  For example:
3201      # No longer works (and never should have).
3202      message.some_repeated_field.foo = 1
3203
3204  Windows
3205  * We now build static libraries rather than DLLs by default on MSVC.
3206    See vsprojects/readme.txt for more information.
3207
32082008-08-15 version 2.0.1:
3209
3210  protoc
3211  * New flags --encode and --decode can be used to convert between protobuf text
3212    format and binary format from the command-line.
3213  * New flag --descriptor_set_out can be used to write FileDescriptorProtos for
3214    all parsed files directly into a single output file.  This is particularly
3215    useful if you wish to parse .proto files from programs written in languages
3216    other than C++: just run protoc as a background process and have it output
3217    a FileDescriptorList, then parse that natively.
3218  * Improved error message when an enum value's name conflicts with another
3219    symbol defined in the enum type's scope, e.g. if two enum types declared
3220    in the same scope have values with the same name.  This is disallowed for
3221    compatibility with C++, but this wasn't clear from the error.
3222  * Fixed absolute output paths on Windows.
3223  * Allow trailing slashes in --proto_path mappings.
3224
3225  C++
3226  * Reflection objects are now per-class rather than per-instance.  To make this
3227    possible, the Reflection interface had to be changed such that all methods
3228    take the Message instance as a parameter.  This change improves performance
3229    significantly in memory-bandwidth-limited use cases, since it makes the
3230    message objects smaller.  Note that source-incompatible interface changes
3231    like this will not be made again after the library leaves beta.
3232  * Heuristically detect sub-messages when printing unknown fields.
3233  * Fix static initialization ordering bug that caused crashes at startup when
3234    compiling on Mac with static linking.
3235  * Fixed TokenizerTest when compiling with -DNDEBUG on Linux.
3236  * Fixed incorrect definition of kint32min.
3237  * Fix bytes type setter to work with byte sequences with embedded NULLs.
3238  * Other irrelevant tweaks.
3239
3240  Java
3241  * Fixed UnknownFieldSet's parsing of varints larger than 32 bits.
3242  * Fixed TextFormat's parsing of "inf" and "nan".
3243  * Fixed TextFormat's parsing of comments.
3244  * Added info to Java POM that will be required when we upload the
3245    package to a Maven repo.
3246
3247  Python
3248  * MergeFrom(message) and CopyFrom(message) are now implemented.
3249  * SerializeToString() raises an exception if the message is missing required
3250    fields.
3251  * Code organization improvements.
3252  * Fixed doc comments for RpcController and RpcChannel, which had somehow been
3253    swapped.
3254  * Fixed text_format_test on Windows where floating-point exponents sometimes
3255    contain extra zeros.
3256  * Fix Python service CallMethod() implementation.
3257
3258  Other
3259  * Improved readmes.
3260  * VIM syntax highlighting improvements.
3261
32622008-07-07 version 2.0.0:
3263
3264  * First public release.
3265