log: deprecate log.* global functions

Add a comment to global functions in log package that
log to the dev channel. In the future these will be
removed and it will be required to specify the log
channel that a log will be written to. This is
intended to reduce the amount of logs that are
sent to DEV by require engineers to be explicit
about where they want to log

Epic: CRDB-53410
Release note: None

Author: kyle-a-wong

pkg/util/log/gen/main.go

@@ -352,6 +352,12 @@ func (logger{{.Name}}) {{with $sev}}{{.Name}}{{end}}fDepth(ctx context.Context,
 {{.Comment -}}
 //
 {{with $sev}}{{.Comment}}{{end -}}
+//
+// TODO: to avoid linting failures, we don't include details about
+// alternative usage. Once all usages have been replaced, update the
+// deprecation comment to describe the replacement functions
+//
+// Deprecated
 func {{with $sev}}{{.Name}}{{end}}f(ctx context.Context, format string, args ...interface{}) {
   logfDepth(ctx, 1, severity.{{with $sev}}{{.NAME}}{{end}}, channel.{{.NAME}}, format, args...)
 }
@@ -363,6 +369,12 @@ func {{with $sev}}{{.Name}}{{end}}f(ctx context.Context, format string, args ...
 {{.Comment -}}
 //
 {{with $sev}}{{.Comment}}{{end -}}
+//
+// TODO: to avoid linting failures, we don't include details about
+// alternative usage. Once all usages have been replaced, update the
+// deprecation comment to describe the replacement functions
+//
+// Deprecated
 func V{{with $sev}}{{.Name}}{{end}}f(ctx context.Context, level Level, format string, args ...interface{}) {
   if VDepth(level, 1) {
     logfDepth(ctx, 1, severity.{{with $sev}}{{.NAME}}{{end}}, channel.{{.NAME}}, format, args...)
@@ -376,6 +388,12 @@ func V{{with $sev}}{{.Name}}{{end}}f(ctx context.Context, level Level, format st
 {{.Comment -}}
 //
 {{with $sev}}{{.Comment}}{{end -}}
+//
+// TODO: to avoid linting failures, we don't include details about
+// alternative usage. Once all usages have been replaced, update the
+// deprecation comment to describe the replacement functions
+//
+// Deprecated
 func {{with $sev}}{{.Name}}{{end}}(ctx context.Context, msg string) {
   logfDepth(ctx, 1, severity.{{with $sev}}{{.NAME}}{{end}}, channel.{{.NAME}}, msg)
 }
@@ -388,6 +406,12 @@ func {{with $sev}}{{.Name}}{{end}}(ctx context.Context, msg string) {
 {{.Comment -}}
 //
 {{with $sev}}{{.Comment}}{{end -}}
+//
+// TODO: to avoid linting failures, we don't include details about
+// alternative usage. Once all usages have been replaced, update the
+// deprecation comment to describe the replacement functions
+//
+// Deprecated
 func {{with $sev}}{{.Name}}{{end}}fDepth(ctx context.Context, depth int, format string, args ...interface{}) {
   logfDepth(ctx, depth+1, severity.{{with $sev}}{{.NAME}}{{end}}, channel.{{.NAME}}, format, args...)
 }
@@ -441,6 +465,12 @@ func (logger{{.Name}}) VEventfDepth(ctx context.Context, depth int, level Level,
 // is currently redirected to a file.
 //
 {{.Comment -}}
+//
+// TODO: to avoid linting failures, we don't include details about
+// alternative usage. Once all usages have been replaced, update the
+// deprecation comment to describe the replacement functions
+//
+// Deprecated
 func Shout(ctx context.Context, sev Severity, msg string) {
   shoutfDepth(ctx, 1, sev, channel.{{.NAME}}, msg)
 }
@@ -450,6 +480,12 @@ func Shout(ctx context.Context, sev Severity, msg string) {
 // the manner of fmt.Printf.
 //
 {{.Comment -}}
+//
+// TODO: to avoid linting failures, we don't include details about
+// alternative usage. Once all usages have been replaced, update the
+// deprecation comment to describe the replacement functions
+//
+// Deprecated
 func Shoutf(ctx context.Context, sev Severity, format string, args ...interface{}) {
   shoutfDepth(ctx, 1, sev, channel.{{.NAME}}, format, args...)
 }