no more generated package doc (#528)

Stop generating package doc comments.

_conformance/conformance.pb.go

@@ -1,18 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: conformance.proto
 
-/*
-Package conformance is a generated protocol buffer package.
-
-It is generated from these files:
-	conformance.proto
-
-It has these top-level messages:
-	ConformanceRequest
-	ConformanceResponse
-	TestAllTypes
-	ForeignMessage
-*/
 package conformance
 
 import proto "github.com/golang/protobuf/proto"

_conformance/conformance_proto/conformance.pb.go

@@ -1,18 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: conformance_proto/conformance.proto
 
-/*
-Package conformance is a generated protocol buffer package.
-
-It is generated from these files:
-	conformance_proto/conformance.proto
-
-It has these top-level messages:
-	ConformanceRequest
-	ConformanceResponse
-	TestAllTypes
-	ForeignMessage
-*/
 package conformance
 
 import proto "github.com/golang/protobuf/proto"

jsonpb/jsonpb_test_proto/more_test_objects.pb.go

@@ -1,33 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: more_test_objects.proto
 
-/*
-Package jsonpb is a generated protocol buffer package.
-
-It is generated from these files:
-	more_test_objects.proto
-	test_objects.proto
-
-It has these top-level messages:
-	Simple3
-	SimpleSlice3
-	SimpleMap3
-	SimpleNull3
-	Mappy
-	Simple
-	NonFinites
-	Repeats
-	Widget
-	Maps
-	MsgWithOneof
-	Real
-	Complex
-	KnownTypes
-	MsgWithRequired
-	MsgWithIndirectRequired
-	MsgWithRequiredBytes
-	MsgWithRequiredWKT
-*/
 package jsonpb
 
 import proto "github.com/golang/protobuf/proto"

proto/test_proto/test.pb.go

@@ -1,45 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: test.proto
 
-/*
-Package test_proto is a generated protocol buffer package.
-
-It is generated from these files:
-	test.proto
-
-It has these top-level messages:
-	GoEnum
-	GoTestField
-	GoTest
-	GoTestRequiredGroupField
-	GoSkipTest
-	NonPackedTest
-	PackedTest
-	MaxTag
-	OldMessage
-	NewMessage
-	InnerMessage
-	OtherMessage
-	RequiredInnerMessage
-	MyMessage
-	Ext
-	ComplexExtension
-	DefaultsMessage
-	MyMessageSet
-	Empty
-	MessageList
-	Strings
-	Defaults
-	SubDefaults
-	RepeatedEnum
-	MoreRepeated
-	GroupOld
-	GroupNew
-	FloatingPoint
-	MessageWithMap
-	Oneof
-	Communique
-*/
 package test_proto
 
 import proto "github.com/golang/protobuf/proto"

proto/test_proto/test.pb.go.golden

@@ -1,45 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: test.proto
 
-/*
-Package test_proto is a generated protocol buffer package.
-
-It is generated from these files:
-	test.proto
-
-It has these top-level messages:
-	GoEnum
-	GoTestField
-	GoTest
-	GoTestRequiredGroupField
-	GoSkipTest
-	NonPackedTest
-	PackedTest
-	MaxTag
-	OldMessage
-	NewMessage
-	InnerMessage
-	OtherMessage
-	RequiredInnerMessage
-	MyMessage
-	Ext
-	ComplexExtension
-	DefaultsMessage
-	MyMessageSet
-	Empty
-	MessageList
-	Strings
-	Defaults
-	SubDefaults
-	RepeatedEnum
-	MoreRepeated
-	GroupOld
-	GroupNew
-	FloatingPoint
-	MessageWithMap
-	Oneof
-	Communique
-*/
 package test_proto
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/generator/generator.go

@@ -1339,43 +1339,22 @@ func (g *Generator) generateHeader() {
 
 	name := g.file.PackageName()
 
-	if g.file.index == 0 {
-		// Generate package docs for the first file in the package.
+	g.P("package ", name)
+	g.P()
+
+	if loc, ok := g.file.comments[strconv.Itoa(packagePath)]; ok {
 		g.P("/*")
-		g.P("Package ", name, " is a generated protocol buffer package.")
-		g.P()
-		if loc, ok := g.file.comments[strconv.Itoa(packagePath)]; ok {
-			// not using g.PrintComments because this is a /* */ comment block.
-			text := strings.TrimSuffix(loc.GetLeadingComments(), "\n")
-			for _, line := range strings.Split(text, "\n") {
-				line = strings.TrimPrefix(line, " ")
-				// ensure we don't escape from the block comment
-				line = strings.Replace(line, "*/", "* /", -1)
-				g.P(line)
-			}
-			g.P()
-		}
-		var topMsgs []string
-		g.P("It is generated from these files:")
-		for _, f := range g.genFiles {
-			g.P("\t", f.Name)
-			for _, msg := range f.desc {
-				if msg.parent != nil {
-					continue
-				}
-				topMsgs = append(topMsgs, CamelCaseSlice(msg.TypeName()))
-			}
-		}
-		g.P()
-		g.P("It has these top-level messages:")
-		for _, msg := range topMsgs {
-			g.P("\t", msg)
+		// not using g.PrintComments because this is a /* */ comment block.
+		text := strings.TrimSuffix(loc.GetLeadingComments(), "\n")
+		for _, line := range strings.Split(text, "\n") {
+			line = strings.TrimPrefix(line, " ")
+			// ensure we don't escape from the block comment
+			line = strings.Replace(line, "*/", "* /", -1)
+			g.P(line)
 		}
 		g.P("*/")
+		g.P()
 	}
-
-	g.P("package ", name)
-	g.P()
 }
 
 // deprecationComment is the standard comment added to deprecated

protoc-gen-go/testdata/deprecated/deprecated.pb.go

@@ -1,19 +1,11 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // deprecated/deprecated.proto is a deprecated file.
 
-/*
-Package deprecated is a generated protocol buffer package.
+package deprecated
 
+/*
 package deprecated contains only deprecated messages and services.
-
-It is generated from these files:
-	deprecated/deprecated.proto
-
-It has these top-level messages:
-	DeprecatedRequest
-	DeprecatedResponse
 */
-package deprecated
 
 import proto "github.com/golang/protobuf/proto"
 import fmt "fmt"

protoc-gen-go/testdata/extension_base/extension_base.pb.go

@@ -1,16 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: extension_base/extension_base.proto
 
-/*
-Package extension_base is a generated protocol buffer package.
-
-It is generated from these files:
-	extension_base/extension_base.proto
-
-It has these top-level messages:
-	BaseMessage
-	OldStyleMessage
-*/
 package extension_base
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/testdata/extension_extra/extension_extra.pb.go

@@ -1,15 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: extension_extra/extension_extra.proto
 
-/*
-Package extension_extra is a generated protocol buffer package.
-
-It is generated from these files:
-	extension_extra/extension_extra.proto
-
-It has these top-level messages:
-	ExtraMessage
-*/
 package extension_extra
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/testdata/extension_user/extension_user.pb.go

@@ -1,20 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: extension_user/extension_user.proto
 
-/*
-Package extension_user is a generated protocol buffer package.
-
-It is generated from these files:
-	extension_user/extension_user.proto
-
-It has these top-level messages:
-	UserMessage
-	LoudMessage
-	LoginMessage
-	Detail
-	Announcement
-	OldStyleParcel
-*/
 package extension_user
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/testdata/grpc/grpc.pb.go

@@ -1,18 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: grpc/grpc.proto
 
-/*
-Package testing is a generated protocol buffer package.
-
-It is generated from these files:
-	grpc/grpc.proto
-
-It has these top-level messages:
-	SimpleRequest
-	SimpleResponse
-	StreamMsg
-	StreamMsg2
-*/
 package testing
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/testdata/imp/imp.pb.go

@@ -1,21 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: imp/imp.proto
 
-/*
-Package imp is a generated protocol buffer package.
-
-It is generated from these files:
-	imp/imp.proto
-	imp/imp2.proto
-	imp/imp3.proto
-
-It has these top-level messages:
-	ImportedMessage
-	ImportedMessage2
-	ImportedExtendable
-	PubliclyImportedMessage
-	ForeignImportedMessage
-*/
 package imp
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/testdata/multi/multi1.pb.go

@@ -1,19 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: multi/multi1.proto
 
-/*
-Package multitest is a generated protocol buffer package.
-
-It is generated from these files:
-	multi/multi1.proto
-	multi/multi2.proto
-	multi/multi3.proto
-
-It has these top-level messages:
-	Multi1
-	Multi2
-	Multi3
-*/
 package multitest
 
 import proto "github.com/golang/protobuf/proto"

protoc-gen-go/testdata/my_test/test.pb.go

@@ -1,24 +1,11 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: my_test/test.proto
 
-/*
-Package test is a generated protocol buffer package.
+package test
 
+/*
 This package holds interesting messages.
-
-It is generated from these files:
-	my_test/test.proto
-
-It has these top-level messages:
-	Request
-	Reply
-	OtherBase
-	ReplyExtensions
-	OtherReplyExtensions
-	OldReply
-	Communique
 */
-package test
 
 import proto "github.com/golang/protobuf/proto"
 import fmt "fmt"

protoc-gen-go/testdata/proto3/proto3.pb.go

@@ -1,16 +1,6 @@
 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: proto3/proto3.proto
 
-/*
-Package proto3 is a generated protocol buffer package.
-
-It is generated from these files:
-	proto3/proto3.proto
-
-It has these top-level messages:
-	Request
-	Book
-*/
 package proto3
 
 import proto "github.com/golang/protobuf/proto"