Commit generated doc changes.

cmd/config/internal/generateddocs/api/docs.go

@@ -1,9 +1,7 @@
-
-
 // Code generated by "mdtogo"; DO NOT EDIT.
 package api
 
-var ConfigIoLong=`# Configuration IO API Semantics
+var ConfigIoLong = `# Configuration IO API Semantics
 
 Resource Configuration may be read / written from / to sources such as directories,
 stdin|out or network. Tools may be composed using pipes such that the tools writing
@@ -63,8 +61,8 @@ Example:
 	  annotations:
 	    config.kubernetes.io/local-config: "true"`
 
-var FunctionsImplShort=`Following is an example for implementing an nginx abstraction using a configuration`
+var FunctionsImplShort = `Following is an example for implementing an nginx abstraction using a configuration`
-var FunctionsImplLong=`# Running Configuration Functions using kustomize CLI
+var FunctionsImplLong = `# Running Configuration Functions using kustomize CLI
 
 Configuration functions can be implemented using any toolchain and invoked using any
 container workflow orchestrator including Tekton, Cloud Build, or run directly using ` + "`" + `docker run` + "`" + `.
@@ -233,8 +231,8 @@ The function is invoked using byrunning ` + "`" + `kustomize config run dir/` +
 	    app: nginx
 	    instance: my-instance`
 
-var FunctionsSpecShort=`_Configuration functions_ enable shift-left practices (client-side) through:`
+var FunctionsSpecShort = `_Configuration functions_ enable shift-left practices (client-side) through:`
-var FunctionsSpecLong=`# Configuration Functions Specification
+var FunctionsSpecLong = `# Configuration Functions Specification
 
 This document specifies a standard for client-side functions that operate on
 Kubernetes declarative configurations. This standard enables creating
@@ -411,7 +409,7 @@ A non-zero exit code indicates a failure.
 [2]: https://tools.ietf.org/html/rfc2119
 [3]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#types-kinds`
 
-var Merge2Long=`# Merge (2-way)
+var Merge2Long = `# Merge (2-way)
 
   2-way merges fields from a source to a destination, overriding the destination fields
   where they differ.
@@ -503,7 +501,7 @@ var Merge2Long=`# Merge (2-way)
 	      - name: sidecar2
 	        image: sidecar2:v1`
 
-var Merge3Long=`# Merge (3-way)
+var Merge3Long = `# Merge (3-way)
 
   3-way merge identifies changes between an original source + updated source and merges the result
   into a destination, overriding the destination fields where they have changed between

cmd/config/internal/generateddocs/commands/docs.go

@@ -1,30 +1,28 @@
-
-
 // Code generated by "mdtogo"; DO NOT EDIT.
 package commands
 
-var AnnotateShort=`[Alpha] Set an annotation on Resources.`
+var AnnotateShort = `[Alpha] Set an annotation on Resources.`
-var AnnotateLong=`
+var AnnotateLong = `
 [Alpha]  Set an annotation on Resources.
 
   DIR:
     Path to local directory.
 `
-var AnnotateExamples=`
+var AnnotateExamples = `
     kustomize cfg annotate my-dir/ --kv foo=bar
 
     kustomize cfg annotate my-dir/ --kv foo=bar --kv a=b
 
     kustomize cfg annotate my-dir/ --kv foo=bar --kind Deployment --name foo`
 
-var CatShort=`[Alpha] Print Resource Config from a local directory.`
+var CatShort = `[Alpha] Print Resource Config from a local directory.`
-var CatLong=`
+var CatLong = `
 [Alpha]  Print Resource Config from a local directory.
 
   DIR:
     Path to local directory.
 `
-var CatExamples=`
+var CatExamples = `
     # print Resource config from a directory
     kustomize cfg cat my-dir/
 
@@ -34,11 +32,11 @@ var CatExamples=`
     # unwrap Resource config from a directory in an ResourceList
     ... | kustomize cfg cat`
 
-var CompletionShort=`Generate shell completion.`
+var CompletionShort = `Generate shell completion.`
-var CompletionLong=`
+var CompletionLong = `
 Generate shell completion for ` + "`" + `kustomize` + "`" + ` -- supports bash, zsh, fish and powershell.
 `
-var CompletionExamples=`
+var CompletionExamples = `
     # load completion for Bash
     source <(kustomize completion bash)
 
@@ -55,19 +53,19 @@ var CompletionExamples=`
     kustomize completion zsh > /usr/share/zsh/site-functions/_kustomize
 `
 
-var CountShort=`[Alpha] Count Resources Config from a local directory.`
+var CountShort = `[Alpha] Count Resources Config from a local directory.`
-var CountLong=`
+var CountLong = `
 [Alpha] Count Resources Config from a local directory.
 
   DIR:
     Path to local directory.
 `
-var CountExamples=`
+var CountExamples = `
     # print Resource counts from a directory
     kustomize cfg count my-dir/`
 
-var CreateSetterShort=`[Alpha] Create a custom setter for a Resource field`
+var CreateSetterShort = `[Alpha] Create a custom setter for a Resource field`
-var CreateSetterLong=`
+var CreateSetterLong = `
 Create a custom setter for a Resource field by inlining OpenAPI as comments.
 
   DIR
@@ -82,7 +80,7 @@ Create a custom setter for a Resource field by inlining OpenAPI as comments.
 
     The current value of the field, or a substring within the field.
 `
-var CreateSetterExamples=`
+var CreateSetterExamples = `
     # create a setter for port fields matching "8080"
     kustomize cfg create-setter DIR/ port 8080 --type "integer" --field port \
          --description "default port used by the app"
@@ -92,8 +90,8 @@ var CreateSetterExamples=`
     kustomize cfg create-setter DIR/ image-tag v1.0.1 --type "string" \
         --field image --description "current stable release"`
 
-var DeleteSetterShort=`[Alpha] Delete a custom setter for a Resource field`
+var DeleteSetterShort = `[Alpha] Delete a custom setter for a Resource field`
-var DeleteSetterLong=`
+var DeleteSetterLong = `
 Delete a custom setter for a Resource field.
 
   DIR
@@ -104,12 +102,12 @@ Delete a custom setter for a Resource field.
 
     The name of the setter to create.
 `
-var DeleteSetterExamples=`
+var DeleteSetterExamples = `
     # delete a setter for port
     kustomize cfg create-setter DIR/ port`
 
-var FmtShort=`[Alpha] Format yaml configuration files.`
+var FmtShort = `[Alpha] Format yaml configuration files.`
-var FmtLong=`
+var FmtLong = `
 [Alpha] Format yaml configuration files.
 
 Fmt will format input by ordering fields and unordered list items in Kubernetes
@@ -135,7 +133,7 @@ field paths.
 - .spec.template.spec.containers (by element name)
 - .webhooks.rules.operations (by element value)
 `
-var FmtExamples=`
+var FmtExamples = `
 	# format file1.yaml and file2.yml
 	kustomize cfg fmt file1.yaml file2.yml
 
@@ -148,8 +146,8 @@ var FmtExamples=`
 	# format kustomize output
 	kustomize build | kustomize cfg fmt`
 
-var GrepShort=`[Alpha] Search for matching Resources in a directory or from stdin`
+var GrepShort = `[Alpha] Search for matching Resources in a directory or from stdin`
-var GrepLong=`
+var GrepLong = `
 [Alpha] Search for matching Resources in a directory or from stdin.
 
   QUERY:
@@ -162,7 +160,7 @@ var GrepLong=`
   DIR:
     Path to local directory.
 `
-var GrepExamples=`
+var GrepExamples = `
     # find Deployment Resources
     kustomize cfg grep "kind=Deployment" my-dir/
 
@@ -175,22 +173,22 @@ var GrepExamples=`
     # look for Resources matching a specific container image
     kustomize cfg grep "spec.template.spec.containers[name=nginx].image=nginx:1\.7\.9" my-dir/ | kustomize cfg tree`
 
-var InitShort=`[Alpha] Initialize a directory with a Krmfile.`
+var InitShort = `[Alpha] Initialize a directory with a Krmfile.`
-var InitLong=`
+var InitLong = `
 [Alpha]  Initialize a directory with a Krmfile.
 
   DIR:
     Path to local directory.
 `
-var InitExamples=`
+var InitExamples = `
     # create a Krmfile in the local directory
     kustomize cfg init
 
     # create a Krmfile in my-dir/
     kustomize cfg init my-dir/`
 
-var ListSettersShort=`[Alpha] List setters for Resources.`
+var ListSettersShort = `[Alpha] List setters for Resources.`
-var ListSettersLong=`
+var ListSettersLong = `
 List setters for Resources.
 
   DIR
@@ -201,15 +199,15 @@ List setters for Resources.
 
     Optional.  The name of the setter to display.
 `
-var ListSettersExamples=`
+var ListSettersExamples = `
   Show setters:
 
     $ kustomize cfg list-setters DIR/
         NAME      DESCRIPTION   VALUE     TYPE     COUNT   SETBY  
     name-prefix   ''            PREFIX    string   2`
 
-var MergeShort=`[Alpha] Merge Resource configuration files`
+var MergeShort = `[Alpha] Merge Resource configuration files`
-var MergeLong=`
+var MergeLong = `
 [Alpha] Merge Resource configuration files
 
 Merge reads Kubernetes Resource yaml configuration files from stdin or sources packages and write
@@ -225,11 +223,11 @@ For information on merge rules, run:
 
 	kustomize cfg docs merge
 `
-var MergeExamples=`
+var MergeExamples = `
     cat resources_and_patches.yaml | kustomize cfg merge > merged_resources.yaml`
 
-var Merge3Short=`[Alpha] Merge diff of Resource configuration files into a destination (3-way)`
+var Merge3Short = `[Alpha] Merge diff of Resource configuration files into a destination (3-way)`
-var Merge3Long=`
+var Merge3Long = `
 [Alpha] Merge diff of Resource configuration files into a destination (3-way)
 
 Merge3 performs a 3-way merge by applying the diff between 2 sets of Resources to a 3rd set.
@@ -244,11 +242,11 @@ For information on merge rules, run:
 
 	kustomize cfg docs-merge3
 `
-var Merge3Examples=`
+var Merge3Examples = `
     kustomize cfg merge3 --ancestor a/ --from b/ --to c/`
 
-var RunFnsShort=`[Alpha] Reoncile config functions to Resources.`
+var RunFnsShort = `[Alpha] Reoncile config functions to Resources.`
-var RunFnsLong=`
+var RunFnsLong = `
 [Alpha] Reconcile config functions to Resources.
 
 run sequentially invokes all config functions in the directory, providing Resources
@@ -293,11 +291,11 @@ order they appear in the file).
 
   See ` + "`" + `kustomize help cfg docs-fn` + "`" + ` for more details on writing functions.
 `
-var RunFnsExamples=`
+var RunFnsExamples = `
 kustomize fn run example/`
 
-var SetShort=`[Alpha] Set values on Resources fields values.`
+var SetShort = `[Alpha] Set values on Resources fields values.`
-var SetLong=`
+var SetLong = `
 Set values on Resources fields.  May set either the complete or partial field value.
 
 ` + "`" + `set` + "`" + ` identifies setters using field metadata published as OpenAPI extensions.
@@ -335,7 +333,7 @@ The description and setBy fields are left unmodified unless specified with flags
 
 To create a custom setter for a field see: ` + "`" + `kustomize help cfg create-setter` + "`" + `
 `
-var SetExamples=`
+var SetExamples = `
   Resource YAML: Name Prefix Setter
 
     # DIR/resources.yaml
@@ -379,8 +377,8 @@ var SetExamples=`
         name: test-app2 # {"description":"test environment","type":"string","x-kustomize":{"setBy":"dev","setter":[{"name":"name-prefix","value":"test"}]}}
     ...`
 
-var SinkShort=`[Alpha] Implement a Sink by writing input to a local directory.`
+var SinkShort = `[Alpha] Implement a Sink by writing input to a local directory.`
-var SinkLong=`
+var SinkLong = `
 [Alpha] Implement a Sink by writing input to a local directory.
 
     kustomize fn sink [DIR]
@@ -390,11 +388,11 @@ var SinkLong=`
 
 ` + "`" + `sink` + "`" + ` writes its input to a directory
 `
-var SinkExamples=`
+var SinkExamples = `
     kustomize fn source DIR/ | your-function | kustomize fn sink DIR/`
 
-var SourceShort=`[Alpha] Implement a Source by reading a local directory.`
+var SourceShort = `[Alpha] Implement a Source by reading a local directory.`
-var SourceLong=`
+var SourceLong = `
 [Alpha] Implement a Source by reading a local directory.
 
     kustomize fn source DIR...
@@ -405,14 +403,14 @@ var SourceLong=`
 
 ` + "`" + `source` + "`" + ` emits configuration to act as input to a function
 `
-var SourceExamples=`
+var SourceExamples = `
     # emity configuration directory as input source to a function
     kustomize fn source DIR/
 
     kustomize fn source DIR/ | your-function | kustomize fn sink DIR/`
 
-var TreeShort=`[Alpha] Display Resource structure from a directory or stdin.`
+var TreeShort = `[Alpha] Display Resource structure from a directory or stdin.`
-var TreeLong=`
+var TreeLong = `
 [Alpha] Display Resource structure from a directory or stdin.
 
 kustomize cfg tree may be used to print Resources in a directory or cluster, preserving structure
@@ -433,7 +431,7 @@ By default, kustomize cfg tree uses Resource graph structure if any relationship
 are detected, as is typically the case when printing from a cluster. Otherwise, directory graph structure is used. The
 graph structure can also be selected explicitly using the '--graph-structure' flag.
 `
-var TreeExamples=`
+var TreeExamples = `
     # print Resources using directory structure
     kustomize cfg tree my-dir/
 

cmd/config/internal/generateddocs/tutorials/docs.go

@@ -1,10 +1,8 @@
-
-
 // Code generated by "mdtogo"; DO NOT EDIT.
 package tutorials
 
-var ConfigurationBasicsShort=`### Synopsis`
+var ConfigurationBasicsShort = `### Synopsis`
-var ConfigurationBasicsLong=`
+var ConfigurationBasicsLong = `
 ` + "`" + `kustomize cfg` + "`" + ` provides tools for working with local configuration directories.
 
   First fetch a bundle of configuration to your local file system from the
@@ -276,8 +274,8 @@ var ConfigurationBasicsLong=`
     │               └── image: <YOUR-CONTAINER>
     ...`
 
-var FunctionBasicsShort=`### Synopsis`
+var FunctionBasicsShort = `### Synopsis`
-var FunctionBasicsLong=`
+var FunctionBasicsLong = `
   ` + "`" + `kustomize config` + "`" + ` enables encapsulating function for manipulating Resource
   configuration inside containers, which are run using ` + "`" + `run` + "`" + `.