Deprecating --api-version flag

Author: nikhiljindal

docs/man/man1/kubectl-annotate.1

@@ -49,7 +49,7 @@ horizontalpodautoscalers (hpa), resourcequotas (quota) or secrets.
 
 .PP
 \fB\-\-output\-version\fP=""
-    Output the formatted object with the given version (default api\-version).
+    Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
 
 .PP
 \fB\-\-overwrite\fP=false
@@ -92,7 +92,7 @@ horizontalpodautoscalers (hpa), resourcequotas (quota) or secrets.
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-api-versions.1

@@ -23,7 +23,7 @@ Print the supported API versions on the server, in the form of "group/version".
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-apply.1

@@ -49,7 +49,7 @@ JSON and YAML formats are accepted.
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-attach.1

@@ -37,7 +37,7 @@ Attach to a process that is already running inside an existing container.
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-autoscale.1

@@ -61,7 +61,7 @@ An autoscaler can automatically increase or decrease number of pods deployed wit
 
 .PP
 \fB\-\-output\-version\fP=""
-    Output the formatted object with the given version (default api\-version).
+    Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
 
 .PP
 \fB\-\-record\fP=false
@@ -96,7 +96,7 @@ An autoscaler can automatically increase or decrease number of pods deployed wit
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-cluster-info.1

@@ -23,7 +23,7 @@ Display addresses of the master and services with label kubernetes.io/cluster\-s
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-config-current-context.1

@@ -23,7 +23,7 @@ Displays the current\-context
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-config-set-context.1

@@ -38,7 +38,7 @@ Specifying a name that already exists will merge new fields on top of existing v
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-config-set-credentials.1

@@ -65,7 +65,7 @@ Bearer token and basic auth are mutually exclusive.
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""

docs/man/man1/kubectl-config-set.1

@@ -25,7 +25,7 @@ PROPERTY\_VALUE is the new value you wish to set.
 
 .PP
 \fB\-\-api\-version\fP=""
-    The API version to use when talking to the server
+    DEPRECATED: The API version to use when talking to the server
 
 .PP
 \fB\-\-certificate\-authority\fP=""