Deprecate some cfg commands

[natasha41575]

This PR marks some cfg commands as deprecated as described in #3953, and would be a first step toward #4045.

Some questions:

1. Can we do this now? There is some discussion in the Deprecation of kustomize cfg and kustomize fn alpha commands #3953 about having setters as a transformer - do we need to wait for that to be done before deprecating the setters commands? Or is a release note pointing to the KRM functions enough?
2. I haven't seen any discussion about the command create-subst - this PR marks it as deprecated, but is that what we want to do?
3. Some of the wording for the deprecation messages can probably be improved, I would appreciate some feedback for that.

Sample output:

$ kustomize cfg annotate
Command "annotate" is deprecated, use `commonAnnotations` field in kustomization instead.

[KnVerey]

Can we do this now? There is some discussion in the [Question] Future of kustomize cfg alpha commands #3953 about having setters as a transformer - do we need to wait for that to be done before deprecating the setters commands? Or is a release note pointing to the KRM functions enough?

IMO yes we can do it now. In fact, it might get us some engagement around whether it is worth providing as an "official" transformer.

I haven't seen any discussion about the command create-subst - this PR marks it as deprecated, but is that what we want to do?

Looks like it's related to setters and requires a KRM file, so yes, I think it should go.

Some of the wording for the deprecation messages can probably be improved, I would appreciate some feedback for that.

WDYT about linking to the deprecation issue?

[natasha41575]

WDYT about linking to the deprecation issue?

@KnVerey done, e.g.

$ kustomize cfg create-setter <args>
Command "create-setter" is deprecated, setter commands will no longer be available in kustomize v5.
See discussion in https://github.com/kubernetes-sigs/kustomize/issues/3953.

[KnVerey]

/lgtm

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: KnVerey, natasha41575

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [KnVerey,natasha41575]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment