update: source github.com/jsonnet-libs/k8s@68d57927

Author: kinghrothgar

0.7/_gen/generators/main.libsonnet 0.16/_gen/generators/main.libsonnet0.7/_gen/generators/main.libsonnet renamed to 0.16/_gen/generators/main.libsonnet

@@ -1,6 +1,6 @@
 {
   local d = (import 'doc-util/main.libsonnet'),
-  '#':: d.pkg(name='acrAccessToken', url='', help='"ACRAccessToken returns a Azure Container Registry token\\nthat can be used for pushing/pulling images.\\nNote: by default it will return an ACR Refresh Token with full access\\n(depending on the identity).\\nThis can be scoped down to the repository level using .spec.scope.\\nIn case scope is defined it will return an ACR Access Token.\\n\\n\\nSee docs: https://github.com/Azure/acr/blob/main/docs/AAD-OAuth.md"'),
+  '#':: d.pkg(name='acrAccessToken', url='', help='"ACRAccessToken returns an Azure Container Registry token\\nthat can be used for pushing/pulling images.\\nNote: by default it will return an ACR Refresh Token with full access\\n(depending on the identity).\\nThis can be scoped down to the repository level using .spec.scope.\\nIn case scope is defined it will return an ACR Access Token.\\n\\nSee docs: https://github.com/Azure/acr/blob/main/docs/AAD-OAuth.md"'),
   '#metadata':: d.obj(help='"ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create."'),
   metadata: {
     '#withAnnotations':: d.fn(help='"Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations"', args=[d.arg(name='annotations', type=d.T.object)]),
@@ -62,20 +62,20 @@
         secretRef: {
           '#clientId':: d.obj(help='"The Azure clientId of the service principle used for authentication."'),
           clientId: {
-            '#withKey':: d.fn(help="\"The key of the entry in the Secret resource's `data` field to be used. Some instances of this field may be\\ndefaulted, in others it may be required.\"", args=[d.arg(name='key', type=d.T.string)]),
+            '#withKey':: d.fn(help='"A key in the referenced Secret.\\nSome instances of this field may be defaulted, in others it may be required."', args=[d.arg(name='key', type=d.T.string)]),
             withKey(key): { spec+: { auth+: { servicePrincipal+: { secretRef+: { clientId+: { key: key } } } } } },
             '#withName':: d.fn(help='"The name of the Secret resource being referred to."', args=[d.arg(name='name', type=d.T.string)]),
             withName(name): { spec+: { auth+: { servicePrincipal+: { secretRef+: { clientId+: { name: name } } } } } },
-            '#withNamespace':: d.fn(help='"Namespace of the resource being referred to. Ignored if referent is not cluster-scoped. cluster-scoped defaults\\nto the namespace of the referent."', args=[d.arg(name='namespace', type=d.T.string)]),
+            '#withNamespace':: d.fn(help='"The namespace of the Secret resource being referred to.\\nIgnored if referent is not cluster-scoped, otherwise defaults to the namespace of the referent."', args=[d.arg(name='namespace', type=d.T.string)]),
             withNamespace(namespace): { spec+: { auth+: { servicePrincipal+: { secretRef+: { clientId+: { namespace: namespace } } } } } },
           },
           '#clientSecret':: d.obj(help='"The Azure ClientSecret of the service principle used for authentication."'),
           clientSecret: {
-            '#withKey':: d.fn(help="\"The key of the entry in the Secret resource's `data` field to be used. Some instances of this field may be\\ndefaulted, in others it may be required.\"", args=[d.arg(name='key', type=d.T.string)]),
+            '#withKey':: d.fn(help='"A key in the referenced Secret.\\nSome instances of this field may be defaulted, in others it may be required."', args=[d.arg(name='key', type=d.T.string)]),
             withKey(key): { spec+: { auth+: { servicePrincipal+: { secretRef+: { clientSecret+: { key: key } } } } } },
             '#withName':: d.fn(help='"The name of the Secret resource being referred to."', args=[d.arg(name='name', type=d.T.string)]),
             withName(name): { spec+: { auth+: { servicePrincipal+: { secretRef+: { clientSecret+: { name: name } } } } } },
-            '#withNamespace':: d.fn(help='"Namespace of the resource being referred to. Ignored if referent is not cluster-scoped. cluster-scoped defaults\\nto the namespace of the referent."', args=[d.arg(name='namespace', type=d.T.string)]),
+            '#withNamespace':: d.fn(help='"The namespace of the Secret resource being referred to.\\nIgnored if referent is not cluster-scoped, otherwise defaults to the namespace of the referent."', args=[d.arg(name='namespace', type=d.T.string)]),
             withNamespace(namespace): { spec+: { auth+: { servicePrincipal+: { secretRef+: { clientSecret+: { namespace: namespace } } } } } },
           },
         },
@@ -90,7 +90,7 @@
           withAudiencesMixin(audiences): { spec+: { auth+: { workloadIdentity+: { serviceAccountRef+: { audiences+: if std.isArray(v=audiences) then audiences else [audiences] } } } } },
           '#withName':: d.fn(help='"The name of the ServiceAccount resource being referred to."', args=[d.arg(name='name', type=d.T.string)]),
           withName(name): { spec+: { auth+: { workloadIdentity+: { serviceAccountRef+: { name: name } } } } },
-          '#withNamespace':: d.fn(help='"Namespace of the resource being referred to. Ignored if referent is not cluster-scoped. cluster-scoped defaults\\nto the namespace of the referent."', args=[d.arg(name='namespace', type=d.T.string)]),
+          '#withNamespace':: d.fn(help='"Namespace of the resource being referred to.\\nIgnored if referent is not cluster-scoped, otherwise defaults to the namespace of the referent."', args=[d.arg(name='namespace', type=d.T.string)]),
           withNamespace(namespace): { spec+: { auth+: { workloadIdentity+: { serviceAccountRef+: { namespace: namespace } } } } },
         },
       },
@@ -99,7 +99,7 @@
     withEnvironmentType(environmentType): { spec+: { environmentType: environmentType } },
     '#withRegistry':: d.fn(help='"the domain name of the ACR registry\\ne.g. foobarexample.azurecr.io"', args=[d.arg(name='registry', type=d.T.string)]),
     withRegistry(registry): { spec+: { registry: registry } },
-    '#withScope':: d.fn(help='"Define the scope for the access token, e.g. pull/push access for a repository.\\nif not provided it will return a refresh token that has full scope.\\nNote: you need to pin it down to the repository level, there is no wildcard available.\\n\\n\\nexamples:\\nrepository:my-repository:pull,push\\nrepository:my-repository:pull\\n\\n\\nsee docs for details: https://docs.docker.com/registry/spec/auth/scope/"', args=[d.arg(name='scope', type=d.T.string)]),
+    '#withScope':: d.fn(help='"Define the scope for the access token, e.g. pull/push access for a repository.\\nif not provided it will return a refresh token that has full scope.\\nNote: you need to pin it down to the repository level, there is no wildcard available.\\n\\nexamples:\\nrepository:my-repository:pull,push\\nrepository:my-repository:pull\\n\\nsee docs for details: https://docs.docker.com/registry/spec/auth/scope/"', args=[d.arg(name='scope', type=d.T.string)]),
     withScope(scope): { spec+: { scope: scope } },
     '#withTenantId':: d.fn(help='"TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type."', args=[d.arg(name='tenantId', type=d.T.string)]),
     withTenantId(tenantId): { spec+: { tenantId: tenantId } },