diff --git a/src/google/protobuf/compiler/php/php_generator.cc b/src/google/protobuf/compiler/php/php_generator.cc
index 7c1daec42f..41da10c80f 100644
--- a/src/google/protobuf/compiler/php/php_generator.cc
+++ b/src/google/protobuf/compiler/php/php_generator.cc
@@ -1799,6 +1799,10 @@ void GenerateMessageDocComment(io::Printer* printer, const Descriptor* message,
const Options& options) {
printer->Print("/**\n");
GenerateDocCommentBody(printer, message);
+ if (message->options().deprecated()) {
+ printer->Print(" * @deprecated\n");
+ }
+
printer->Print(
" * Generated from protobuf message ^messagename^
\n"
" */\n",
@@ -1840,6 +1844,9 @@ void GenerateMessageConstructorDocComment(io::Printer* printer,
void GenerateServiceDocComment(io::Printer* printer,
const ServiceDescriptor* service) {
printer->Print("/**\n");
+ if (service->options().deprecated()) {
+ printer->Print(" * @deprecated\n");
+ }
GenerateDocCommentBody(printer, service);
printer->Print(
" * Protobuf type ^fullname^
\n"
@@ -1917,6 +1924,9 @@ void GenerateWrapperFieldSetterDocComment(io::Printer* printer, const FieldDescr
void GenerateEnumDocComment(io::Printer* printer, const EnumDescriptor* enum_,
const Options& options) {
printer->Print("/**\n");
+ if (enum_->options().deprecated()) {
+ printer->Print(" * @deprecated\n");
+ }
GenerateDocCommentBody(printer, enum_);
printer->Print(
" * Protobuf type ^fullname^
\n"
@@ -1938,6 +1948,9 @@ void GenerateServiceMethodDocComment(io::Printer* printer,
const MethodDescriptor* method) {
printer->Print("/**\n");
GenerateDocCommentBody(printer, method);
+ if (method->options().deprecated()) {
+ printer->Print(" * @deprecated\n");
+ }
printer->Print(
" * Method ^method_name^
\n"
" *\n",