Include genyaml in update/verify generated docs scripts

.generated_docs

@@ -106,3 +106,36 @@ docs/user-guide/kubectl/kubectl_run.md
 docs/user-guide/kubectl/kubectl_scale.md
 docs/user-guide/kubectl/kubectl_uncordon.md
 docs/user-guide/kubectl/kubectl_version.md
+docs/yaml/kubectl/kubectl.yaml
+docs/yaml/kubectl/kubectl_annotate.yaml
+docs/yaml/kubectl/kubectl_api-versions.yaml
+docs/yaml/kubectl/kubectl_apply.yaml
+docs/yaml/kubectl/kubectl_attach.yaml
+docs/yaml/kubectl/kubectl_autoscale.yaml
+docs/yaml/kubectl/kubectl_cluster-info.yaml
+docs/yaml/kubectl/kubectl_config.yaml
+docs/yaml/kubectl/kubectl_convert.yaml
+docs/yaml/kubectl/kubectl_cordon.yaml
+docs/yaml/kubectl/kubectl_create.yaml
+docs/yaml/kubectl/kubectl_delete.yaml
+docs/yaml/kubectl/kubectl_describe.yaml
+docs/yaml/kubectl/kubectl_drain.yaml
+docs/yaml/kubectl/kubectl_edit.yaml
+docs/yaml/kubectl/kubectl_exec.yaml
+docs/yaml/kubectl/kubectl_explain.yaml
+docs/yaml/kubectl/kubectl_expose.yaml
+docs/yaml/kubectl/kubectl_get.yaml
+docs/yaml/kubectl/kubectl_label.yaml
+docs/yaml/kubectl/kubectl_logs.yaml
+docs/yaml/kubectl/kubectl_namespace.yaml
+docs/yaml/kubectl/kubectl_patch.yaml
+docs/yaml/kubectl/kubectl_port-forward.yaml
+docs/yaml/kubectl/kubectl_proxy.yaml
+docs/yaml/kubectl/kubectl_replace.yaml
+docs/yaml/kubectl/kubectl_rolling-update.yaml
+docs/yaml/kubectl/kubectl_rollout.yaml
+docs/yaml/kubectl/kubectl_run.yaml
+docs/yaml/kubectl/kubectl_scale.yaml
+docs/yaml/kubectl/kubectl_stop.yaml
+docs/yaml/kubectl/kubectl_uncordon.yaml
+docs/yaml/kubectl/kubectl_version.yaml

docs/yaml/kubectl/kubectl_annotate.yaml

@@ -22,6 +22,10 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to a file identifying the resource to update the annotation
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: no-headers
   default_value: "false"
   usage: When using the default output, don't print headers.
@@ -39,6 +43,10 @@ options:
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: resource-version
   usage: |
     If non-empty, the annotation update will only succeed if this is the current resource-version for the object. Only valid when specifying a single resource.

docs/yaml/kubectl/kubectl_apply.yaml

@@ -8,13 +8,21 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to file that contains the configuration to apply
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: output
   shorthand: o
   usage: |
     Output mode. Use "-o name" for shorter output (resource/name).
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: schema-cache-dir
   default_value: ~/.kube/schema
   usage: |

docs/yaml/kubectl/kubectl_autoscale.yaml

@@ -24,6 +24,10 @@ options:
   default_value: horizontalpodautoscaler/v1beta1
   usage: |
     The name of the API generator to use. Currently there is only 1 generator.
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: max
   default_value: "-1"
   usage: |
@@ -48,6 +52,10 @@ options:
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: save-config
   default_value: "false"
   usage: |

docs/yaml/kubectl/kubectl_cluster-info.yaml

@@ -2,6 +2,11 @@ name: cluster-info
 synopsis: Display cluster info
 description: |
   Display addresses of the master and services with label kubernetes.io/cluster-service=true
+options:
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 inherited_options:
 - name: alsologtostderr
   default_value: "false"

docs/yaml/kubectl/kubectl_convert.yaml

@@ -16,6 +16,10 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to file to need to get converted.
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: local
   default_value: "true"
   usage: |
@@ -30,6 +34,10 @@ options:
 - name: output-version
   usage: |
     Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: schema-cache-dir
   default_value: ~/.kube/schema
   usage: |

docs/yaml/kubectl/kubectl_create.yaml

@@ -10,13 +10,21 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to file to use to create the resource
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: output
   shorthand: o
   usage: |
     Output mode. Use "-o name" for shorter output (resource/name).
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: save-config
   default_value: "false"
   usage: |

docs/yaml/kubectl/kubectl_delete.yaml

@@ -32,10 +32,18 @@ options:
   default_value: "false"
   usage: |
     Treat "resource not found" as a successful delete. Defaults to "true" when --all is specified.
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: output
   shorthand: o
   usage: |
     Output mode. Use "-o name" for shorter output (resource/name).
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: selector
   shorthand: l
   usage: Selector (label query) to filter on.

docs/yaml/kubectl/kubectl_describe.yaml

@@ -14,14 +14,22 @@ description: |-
   Possible resource types include (case insensitive): pods (po), services (svc), deployments,
   replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
   persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-  serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
+  serviceaccounts (sa), ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
   componentstatuses (cs), endpoints (ep), and secrets.
 options:
 - name: filename
   shorthand: f
   default_value: '[]'
   usage: |
     Filename, directory, or URL to a file containing the resource to describe
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: selector
   shorthand: l
   usage: Selector (label query) to filter on

docs/yaml/kubectl/kubectl_edit.yaml

@@ -26,6 +26,10 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to file to use to edit the resource
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: output
   shorthand: o
   default_value: yaml
@@ -36,6 +40,10 @@ options:
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: save-config
   default_value: "false"
   usage: |

docs/yaml/kubectl/kubectl_explain.yaml

@@ -6,9 +6,13 @@ description: |-
   Possible resource types include (case insensitive): pods (po), services (svc), deployments,
   replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
   persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-  serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
+  serviceaccounts (sa), ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
   componentstatuses (cs), endpoints (ep), and secrets.
 options:
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: recursive
   default_value: "false"
   usage: Print the fields of fields (Currently only 1 level deep)

docs/yaml/kubectl/kubectl_expose.yaml

@@ -1,6 +1,6 @@
 name: expose
 synopsis: |
-  Take a replication controller, service, or pod and expose it as a new Kubernetes Service
+  Take a replication controller, service, deployment or pod and expose it as a new Kubernetes Service
 description: "Take a deployment, service, replica set, replication controller, or
   pod and expose it as a new Kubernetes service.\n\nLooks up a deployment, service,
   replica set, replication controller or pod by name and uses the selector\nfor that
@@ -64,6 +64,10 @@ options:
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: save-config
   default_value: "false"
   usage: |

docs/yaml/kubectl/kubectl_get.yaml

@@ -6,7 +6,7 @@ description: |-
   Possible resource types include (case insensitive): pods (po), services (svc), deployments,
   replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
   persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-  serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
+  serviceaccounts (sa), ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
   componentstatuses (cs), endpoints (ep), and secrets.
 
   By specifying the output as 'template' and providing a Go template as the value
@@ -25,6 +25,10 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to a file identifying the resource to get from a server.
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: label-columns
   shorthand: L
   default_value: '[]'
@@ -40,6 +44,10 @@ options:
 - name: output-version
   usage: |
     Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: selector
   shorthand: l
   usage: Selector (label query) to filter on

docs/yaml/kubectl/kubectl_label.yaml

@@ -20,6 +20,10 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to a file identifying the resource to update the labels
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: no-headers
   default_value: "false"
   usage: When using the default output, don't print headers.
@@ -37,6 +41,10 @@ options:
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: resource-version
   usage: |
     If non-empty, the labels update will only succeed if this is the current resource-version for the object. Only valid when specifying a single resource.

docs/yaml/kubectl/kubectl_logs.yaml

@@ -10,6 +10,10 @@ options:
   shorthand: f
   default_value: "false"
   usage: Specify if the logs should be streamed.
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: interactive
   default_value: "false"
   usage: If true, prompt the user for input when required.

docs/yaml/kubectl/kubectl_patch.yaml

@@ -12,6 +12,10 @@ options:
   default_value: '[]'
   usage: |
     Filename, directory, or URL to a file identifying the resource to update
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: output
   shorthand: o
   usage: |
@@ -22,6 +26,10 @@ options:
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: type
   default_value: strategic
   usage: |

docs/yaml/kubectl/kubectl_replace.yaml

@@ -25,13 +25,21 @@ options:
   default_value: "-1"
   usage: |
     Only relevant during a force replace. Period of time in seconds given to the old resource to terminate gracefully. Ignored if negative.
+- name: include-extended-apis
+  default_value: "true"
+  usage: |
+    If true, include definitions of new APIs via calls to the API server. [default true]
 - name: output
   shorthand: o
   usage: |
     Output mode. Use "-o name" for shorter output (resource/name).
 - name: record
   default_value: "false"
   usage: Record current kubectl command in the resource annotation.
+- name: recursive
+  shorthand: R
+  default_value: "false"
+  usage: If true, process directory recursively.
 - name: save-config
   default_value: "false"
   usage: |