1// Code generated by protoc-gen-go. DO NOT EDIT. 2// source: google/api/documentation.proto 3 4package serviceconfig 5 6import ( 7 fmt "fmt" 8 math "math" 9 10 proto "github.com/golang/protobuf/proto" 11) 12 13// Reference imports to suppress errors if they are not otherwise used. 14var _ = proto.Marshal 15var _ = fmt.Errorf 16var _ = math.Inf 17 18// This is a compile-time assertion to ensure that this generated file 19// is compatible with the proto package it is being compiled against. 20// A compilation error at this line likely means your copy of the 21// proto package needs to be updated. 22const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package 23 24// `Documentation` provides the information for describing a service. 25// 26// Example: 27// <pre><code>documentation: 28// summary: > 29// The Google Calendar API gives access 30// to most calendar features. 31// pages: 32// - name: Overview 33// content: (== include google/foo/overview.md ==) 34// - name: Tutorial 35// content: (== include google/foo/tutorial.md ==) 36// subpages; 37// - name: Java 38// content: (== include google/foo/tutorial_java.md ==) 39// rules: 40// - selector: google.calendar.Calendar.Get 41// description: > 42// ... 43// - selector: google.calendar.Calendar.Put 44// description: > 45// ... 46// </code></pre> 47// Documentation is provided in markdown syntax. In addition to 48// standard markdown features, definition lists, tables and fenced 49// code blocks are supported. Section headers can be provided and are 50// interpreted relative to the section nesting of the context where 51// a documentation fragment is embedded. 52// 53// Documentation from the IDL is merged with documentation defined 54// via the config at normalization time, where documentation provided 55// by config rules overrides IDL provided. 56// 57// A number of constructs specific to the API platform are supported 58// in documentation text. 59// 60// In order to reference a proto element, the following 61// notation can be used: 62// <pre><code>[fully.qualified.proto.name][]</code></pre> 63// To override the display text used for the link, this can be used: 64// <pre><code>[display text][fully.qualified.proto.name]</code></pre> 65// Text can be excluded from doc using the following notation: 66// <pre><code>(-- internal comment --)</code></pre> 67// 68// A few directives are available in documentation. Note that 69// directives must appear on a single line to be properly 70// identified. The `include` directive includes a markdown file from 71// an external source: 72// <pre><code>(== include path/to/file ==)</code></pre> 73// The `resource_for` directive marks a message to be the resource of 74// a collection in REST view. If it is not specified, tools attempt 75// to infer the resource from the operations in a collection: 76// <pre><code>(== resource_for v1.shelves.books ==)</code></pre> 77// The directive `suppress_warning` does not directly affect documentation 78// and is documented together with service config validation. 79type Documentation struct { 80 // A short summary of what the service does. Can only be provided by 81 // plain text. 82 Summary string `protobuf:"bytes,1,opt,name=summary,proto3" json:"summary,omitempty"` 83 // The top level pages for the documentation set. 84 Pages []*Page `protobuf:"bytes,5,rep,name=pages,proto3" json:"pages,omitempty"` 85 // A list of documentation rules that apply to individual API elements. 86 // 87 // **NOTE:** All service configuration rules follow "last one wins" order. 88 Rules []*DocumentationRule `protobuf:"bytes,3,rep,name=rules,proto3" json:"rules,omitempty"` 89 // The URL to the root of documentation. 90 DocumentationRootUrl string `protobuf:"bytes,4,opt,name=documentation_root_url,json=documentationRootUrl,proto3" json:"documentation_root_url,omitempty"` 91 // Declares a single overview page. For example: 92 // <pre><code>documentation: 93 // summary: ... 94 // overview: (== include overview.md ==) 95 // </code></pre> 96 // This is a shortcut for the following declaration (using pages style): 97 // <pre><code>documentation: 98 // summary: ... 99 // pages: 100 // - name: Overview 101 // content: (== include overview.md ==) 102 // </code></pre> 103 // Note: you cannot specify both `overview` field and `pages` field. 104 Overview string `protobuf:"bytes,2,opt,name=overview,proto3" json:"overview,omitempty"` 105 XXX_NoUnkeyedLiteral struct{} `json:"-"` 106 XXX_unrecognized []byte `json:"-"` 107 XXX_sizecache int32 `json:"-"` 108} 109 110func (m *Documentation) Reset() { *m = Documentation{} } 111func (m *Documentation) String() string { return proto.CompactTextString(m) } 112func (*Documentation) ProtoMessage() {} 113func (*Documentation) Descriptor() ([]byte, []int) { 114 return fileDescriptor_dead24b587ac0742, []int{0} 115} 116 117func (m *Documentation) XXX_Unmarshal(b []byte) error { 118 return xxx_messageInfo_Documentation.Unmarshal(m, b) 119} 120func (m *Documentation) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { 121 return xxx_messageInfo_Documentation.Marshal(b, m, deterministic) 122} 123func (m *Documentation) XXX_Merge(src proto.Message) { 124 xxx_messageInfo_Documentation.Merge(m, src) 125} 126func (m *Documentation) XXX_Size() int { 127 return xxx_messageInfo_Documentation.Size(m) 128} 129func (m *Documentation) XXX_DiscardUnknown() { 130 xxx_messageInfo_Documentation.DiscardUnknown(m) 131} 132 133var xxx_messageInfo_Documentation proto.InternalMessageInfo 134 135func (m *Documentation) GetSummary() string { 136 if m != nil { 137 return m.Summary 138 } 139 return "" 140} 141 142func (m *Documentation) GetPages() []*Page { 143 if m != nil { 144 return m.Pages 145 } 146 return nil 147} 148 149func (m *Documentation) GetRules() []*DocumentationRule { 150 if m != nil { 151 return m.Rules 152 } 153 return nil 154} 155 156func (m *Documentation) GetDocumentationRootUrl() string { 157 if m != nil { 158 return m.DocumentationRootUrl 159 } 160 return "" 161} 162 163func (m *Documentation) GetOverview() string { 164 if m != nil { 165 return m.Overview 166 } 167 return "" 168} 169 170// A documentation rule provides information about individual API elements. 171type DocumentationRule struct { 172 // The selector is a comma-separated list of patterns. Each pattern is a 173 // qualified name of the element which may end in "*", indicating a wildcard. 174 // Wildcards are only allowed at the end and for a whole component of the 175 // qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A 176 // wildcard will match one or more components. To specify a default for all 177 // applicable elements, the whole pattern "*" is used. 178 Selector string `protobuf:"bytes,1,opt,name=selector,proto3" json:"selector,omitempty"` 179 // Description of the selected API(s). 180 Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"` 181 // Deprecation description of the selected element(s). It can be provided if 182 // an element is marked as `deprecated`. 183 DeprecationDescription string `protobuf:"bytes,3,opt,name=deprecation_description,json=deprecationDescription,proto3" json:"deprecation_description,omitempty"` 184 XXX_NoUnkeyedLiteral struct{} `json:"-"` 185 XXX_unrecognized []byte `json:"-"` 186 XXX_sizecache int32 `json:"-"` 187} 188 189func (m *DocumentationRule) Reset() { *m = DocumentationRule{} } 190func (m *DocumentationRule) String() string { return proto.CompactTextString(m) } 191func (*DocumentationRule) ProtoMessage() {} 192func (*DocumentationRule) Descriptor() ([]byte, []int) { 193 return fileDescriptor_dead24b587ac0742, []int{1} 194} 195 196func (m *DocumentationRule) XXX_Unmarshal(b []byte) error { 197 return xxx_messageInfo_DocumentationRule.Unmarshal(m, b) 198} 199func (m *DocumentationRule) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { 200 return xxx_messageInfo_DocumentationRule.Marshal(b, m, deterministic) 201} 202func (m *DocumentationRule) XXX_Merge(src proto.Message) { 203 xxx_messageInfo_DocumentationRule.Merge(m, src) 204} 205func (m *DocumentationRule) XXX_Size() int { 206 return xxx_messageInfo_DocumentationRule.Size(m) 207} 208func (m *DocumentationRule) XXX_DiscardUnknown() { 209 xxx_messageInfo_DocumentationRule.DiscardUnknown(m) 210} 211 212var xxx_messageInfo_DocumentationRule proto.InternalMessageInfo 213 214func (m *DocumentationRule) GetSelector() string { 215 if m != nil { 216 return m.Selector 217 } 218 return "" 219} 220 221func (m *DocumentationRule) GetDescription() string { 222 if m != nil { 223 return m.Description 224 } 225 return "" 226} 227 228func (m *DocumentationRule) GetDeprecationDescription() string { 229 if m != nil { 230 return m.DeprecationDescription 231 } 232 return "" 233} 234 235// Represents a documentation page. A page can contain subpages to represent 236// nested documentation set structure. 237type Page struct { 238 // The name of the page. It will be used as an identity of the page to 239 // generate URI of the page, text of the link to this page in navigation, 240 // etc. The full page name (start from the root page name to this page 241 // concatenated with `.`) can be used as reference to the page in your 242 // documentation. For example: 243 // <pre><code>pages: 244 // - name: Tutorial 245 // content: (== include tutorial.md ==) 246 // subpages: 247 // - name: Java 248 // content: (== include tutorial_java.md ==) 249 // </code></pre> 250 // You can reference `Java` page using Markdown reference link syntax: 251 // `[Java][Tutorial.Java]`. 252 Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` 253 // The Markdown content of the page. You can use <code>(== include {path} 254 // ==)</code> to include content from a Markdown file. 255 Content string `protobuf:"bytes,2,opt,name=content,proto3" json:"content,omitempty"` 256 // Subpages of this page. The order of subpages specified here will be 257 // honored in the generated docset. 258 Subpages []*Page `protobuf:"bytes,3,rep,name=subpages,proto3" json:"subpages,omitempty"` 259 XXX_NoUnkeyedLiteral struct{} `json:"-"` 260 XXX_unrecognized []byte `json:"-"` 261 XXX_sizecache int32 `json:"-"` 262} 263 264func (m *Page) Reset() { *m = Page{} } 265func (m *Page) String() string { return proto.CompactTextString(m) } 266func (*Page) ProtoMessage() {} 267func (*Page) Descriptor() ([]byte, []int) { 268 return fileDescriptor_dead24b587ac0742, []int{2} 269} 270 271func (m *Page) XXX_Unmarshal(b []byte) error { 272 return xxx_messageInfo_Page.Unmarshal(m, b) 273} 274func (m *Page) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { 275 return xxx_messageInfo_Page.Marshal(b, m, deterministic) 276} 277func (m *Page) XXX_Merge(src proto.Message) { 278 xxx_messageInfo_Page.Merge(m, src) 279} 280func (m *Page) XXX_Size() int { 281 return xxx_messageInfo_Page.Size(m) 282} 283func (m *Page) XXX_DiscardUnknown() { 284 xxx_messageInfo_Page.DiscardUnknown(m) 285} 286 287var xxx_messageInfo_Page proto.InternalMessageInfo 288 289func (m *Page) GetName() string { 290 if m != nil { 291 return m.Name 292 } 293 return "" 294} 295 296func (m *Page) GetContent() string { 297 if m != nil { 298 return m.Content 299 } 300 return "" 301} 302 303func (m *Page) GetSubpages() []*Page { 304 if m != nil { 305 return m.Subpages 306 } 307 return nil 308} 309 310func init() { 311 proto.RegisterType((*Documentation)(nil), "google.api.Documentation") 312 proto.RegisterType((*DocumentationRule)(nil), "google.api.DocumentationRule") 313 proto.RegisterType((*Page)(nil), "google.api.Page") 314} 315 316func init() { proto.RegisterFile("google/api/documentation.proto", fileDescriptor_dead24b587ac0742) } 317 318var fileDescriptor_dead24b587ac0742 = []byte{ 319 // 356 bytes of a gzipped FileDescriptorProto 320 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x74, 0x92, 0xc1, 0x6a, 0xe3, 0x30, 321 0x14, 0x45, 0x71, 0xec, 0xcc, 0x64, 0x5e, 0x98, 0x61, 0x46, 0x0c, 0x19, 0x33, 0xd0, 0x12, 0xb2, 322 0x28, 0x59, 0x14, 0x1b, 0x9a, 0x42, 0x17, 0x5d, 0x35, 0xa4, 0x94, 0xee, 0x8c, 0xa1, 0x9b, 0x6e, 323 0x82, 0xa2, 0xbc, 0x0a, 0x83, 0xad, 0x67, 0x24, 0x39, 0xa5, 0xbf, 0xd0, 0xcf, 0xe8, 0x57, 0xf5, 324 0x73, 0x8a, 0x65, 0x27, 0xb1, 0x29, 0xdd, 0xf9, 0xfa, 0x1e, 0xe9, 0x3e, 0x5d, 0x09, 0x4e, 0x25, 325 0x91, 0xcc, 0x31, 0xe6, 0x65, 0x16, 0x6f, 0x49, 0x54, 0x05, 0x2a, 0xcb, 0x6d, 0x46, 0x2a, 0x2a, 326 0x35, 0x59, 0x62, 0xd0, 0xf8, 0x11, 0x2f, 0xb3, 0xd9, 0xbb, 0x07, 0x3f, 0x57, 0x5d, 0x86, 0x85, 327 0xf0, 0xdd, 0x54, 0x45, 0xc1, 0xf5, 0x4b, 0xe8, 0x4d, 0xbd, 0xf9, 0x8f, 0x74, 0x2f, 0xd9, 0x19, 328 0x0c, 0x4b, 0x2e, 0xd1, 0x84, 0xc3, 0xa9, 0x3f, 0x1f, 0x5f, 0xfc, 0x8e, 0x8e, 0xfb, 0x44, 0x09, 329 0x97, 0x98, 0x36, 0x36, 0x5b, 0xc0, 0x50, 0x57, 0x39, 0x9a, 0xd0, 0x77, 0xdc, 0x49, 0x97, 0xeb, 330 0x65, 0xa5, 0x55, 0x8e, 0x69, 0xc3, 0xb2, 0x4b, 0x98, 0xf4, 0x66, 0x5d, 0x6b, 0x22, 0xbb, 0xae, 331 0x74, 0x1e, 0x06, 0x6e, 0x8a, 0xbf, 0x3d, 0x37, 0x25, 0xb2, 0x0f, 0x3a, 0x67, 0xff, 0x61, 0x44, 332 0x3b, 0xd4, 0xbb, 0x0c, 0x9f, 0xc3, 0x81, 0xe3, 0x0e, 0x7a, 0xf6, 0xea, 0xc1, 0x9f, 0x4f, 0x71, 333 0xf5, 0x0a, 0x83, 0x39, 0x0a, 0x4b, 0xba, 0x3d, 0xdf, 0x41, 0xb3, 0x29, 0x8c, 0xb7, 0x68, 0x84, 334 0xce, 0xca, 0x1a, 0x6f, 0x37, 0xec, 0xfe, 0x62, 0x57, 0xf0, 0x6f, 0x8b, 0xa5, 0x46, 0xd1, 0xcc, 335 0xd8, 0xa5, 0x7d, 0x47, 0x4f, 0x3a, 0xf6, 0xea, 0xe8, 0xce, 0x36, 0x10, 0xd4, 0x15, 0x31, 0x06, 336 0x81, 0xe2, 0x05, 0xb6, 0xd1, 0xee, 0xbb, 0x6e, 0x5c, 0x90, 0xb2, 0xa8, 0x6c, 0x1b, 0xb9, 0x97, 337 0xec, 0x1c, 0x46, 0xa6, 0xda, 0x34, 0xa5, 0xfb, 0x5f, 0x94, 0x7e, 0x20, 0x96, 0x16, 0x7e, 0x09, 338 0x2a, 0x3a, 0xc0, 0x92, 0xf5, 0xce, 0x9f, 0xd4, 0xb7, 0x9f, 0x78, 0x8f, 0xb7, 0x2d, 0x21, 0x29, 339 0xe7, 0x4a, 0x46, 0xa4, 0x65, 0x2c, 0x51, 0xb9, 0xb7, 0x11, 0x37, 0x16, 0x2f, 0x33, 0xe3, 0x9e, 340 0x8f, 0xa9, 0xbb, 0x14, 0x28, 0x48, 0x3d, 0x65, 0xf2, 0xba, 0xa7, 0xde, 0x06, 0xc1, 0xdd, 0x4d, 341 0x72, 0xbf, 0xf9, 0xe6, 0x16, 0x2e, 0x3e, 0x02, 0x00, 0x00, 0xff, 0xff, 0x3e, 0x04, 0x32, 0xbf, 342 0x76, 0x02, 0x00, 0x00, 343} 344