From 97950ced81edfbef3f8501d3b887bf909668271c Mon Sep 17 00:00:00 2001
From: Carmi Grushko
Date: Thu, 9 Mar 2017 17:25:38 +0000
Subject: Document the descriptor set output of proto_library.
--
PiperOrigin-RevId: 149659956
MOS_MIGRATED_REVID=149659956
---
.../devtools/build/lib/rules/proto/BazelProtoLibraryRule.java | 10 ++++++++++
1 file changed, 10 insertions(+)
(limited to 'src')
diff --git a/src/main/java/com/google/devtools/build/lib/rules/proto/BazelProtoLibraryRule.java b/src/main/java/com/google/devtools/build/lib/rules/proto/BazelProtoLibraryRule.java
index cbb09fd149..c0a6eb00aa 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/proto/BazelProtoLibraryRule.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/proto/BazelProtoLibraryRule.java
@@ -94,4 +94,14 @@ public final class BazelProtoLibraryRule implements RuleDefinition {
in the deps
clause of supported rules, such as java_proto_library
.
+When compiled on the command-line, a proto_library
creates a file named
+foo-descriptor-set.proto.bin
, which is the descriptor set for the
+messages the rule srcs. The file is a serialized FileDescriptorSet
, which is described
+in https://developers.google.com/protocol-buffers/docs/techniques#self-description.
+
+It only contains information about the .proto
files directly mentioned by a
+proto_library
rule; the collection of transitive descriptor sets is available through
+the proto.transitivedescriptorsets
Skylark provider.
+See documentation in ProtoSourcesProvider.java
.
+
*/
--
cgit v1.2.3