Enhance bindings for IDE hints

* Follow https://pkg.go.dev/cmd/go#hdr-Generate_Go_files_by_processing_source
  for leading comment
* Add godoc strings for all exposed methods for IDE support
* Copy field godoc strings into generated code as function godoc string
* Remove unused/unnecessary fields from generator.go structures
* Cleanup code regarding template usage

Signed-off-by: Jhon Honce <jhonce@redhat.com>

14 files changed, 72 insertions, 120 deletions

diff --git a/pkg/bindings/pods/types_create_options.go b/pkg/bindings/pods/types_create_options.go
index 891ef2e84..ce7649e96 100644
--- a/pkg/bindings/pods/types_create_options.go
+++ b/pkg/bindings/pods/types_create_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *CreateOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *CreateOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_exists_options.go b/pkg/bindings/pods/types_exists_options.go
index 02423e7ed..096f5a3f1 100644
--- a/pkg/bindings/pods/types_exists_options.go
+++ b/pkg/bindings/pods/types_exists_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *ExistsOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *ExistsOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_inspect_options.go b/pkg/bindings/pods/types_inspect_options.go
index 20ec3a726..7a2c25058 100644
--- a/pkg/bindings/pods/types_inspect_options.go
+++ b/pkg/bindings/pods/types_inspect_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *InspectOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *InspectOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_kill_options.go b/pkg/bindings/pods/types_kill_options.go
index fabd45c67..ce521d3c0 100644
--- a/pkg/bindings/pods/types_kill_options.go
+++ b/pkg/bindings/pods/types_kill_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,32 +7,27 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *KillOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *KillOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
 
-// WithSignal
+// WithSignal set field Signal to given value
 func (o *KillOptions) WithSignal(value string) *KillOptions {
-	v := &value
-	o.Signal = v
+	o.Signal = &value
 	return o
 }
 
-// GetSignal
+// GetSignal returns value of field Signal
 func (o *KillOptions) GetSignal() string {
-	var signal string
 	if o.Signal == nil {
-		return signal
+		var z string
+		return z
 	}
 	return *o.Signal
 }
diff --git a/pkg/bindings/pods/types_list_options.go b/pkg/bindings/pods/types_list_options.go
index 7221c7ff8..f786aa38c 100644
--- a/pkg/bindings/pods/types_list_options.go
+++ b/pkg/bindings/pods/types_list_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,32 +7,27 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *ListOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *ListOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
 
-// WithFilters
+// WithFilters set field Filters to given value
 func (o *ListOptions) WithFilters(value map[string][]string) *ListOptions {
-	v := value
-	o.Filters = v
+	o.Filters = value
 	return o
 }
 
-// GetFilters
+// GetFilters returns value of field Filters
 func (o *ListOptions) GetFilters() map[string][]string {
-	var filters map[string][]string
 	if o.Filters == nil {
-		return filters
+		var z map[string][]string
+		return z
 	}
 	return o.Filters
 }
diff --git a/pkg/bindings/pods/types_pause_options.go b/pkg/bindings/pods/types_pause_options.go
index 0bbc9c293..34792602c 100644
--- a/pkg/bindings/pods/types_pause_options.go
+++ b/pkg/bindings/pods/types_pause_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *PauseOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *PauseOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_prune_options.go b/pkg/bindings/pods/types_prune_options.go
index 0e788f471..ad2d1b983 100644
--- a/pkg/bindings/pods/types_prune_options.go
+++ b/pkg/bindings/pods/types_prune_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *PruneOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *PruneOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_remove_options.go b/pkg/bindings/pods/types_remove_options.go
index 3d3c7ad2a..ce142ee74 100644
--- a/pkg/bindings/pods/types_remove_options.go
+++ b/pkg/bindings/pods/types_remove_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,32 +7,27 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *RemoveOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *RemoveOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
 
-// WithForce
+// WithForce set field Force to given value
 func (o *RemoveOptions) WithForce(value bool) *RemoveOptions {
-	v := &value
-	o.Force = v
+	o.Force = &value
 	return o
 }
 
-// GetForce
+// GetForce returns value of field Force
 func (o *RemoveOptions) GetForce() bool {
-	var force bool
 	if o.Force == nil {
-		return force
+		var z bool
+		return z
 	}
 	return *o.Force
 }
diff --git a/pkg/bindings/pods/types_restart_options.go b/pkg/bindings/pods/types_restart_options.go
index 9278b7b46..1018ce9ea 100644
--- a/pkg/bindings/pods/types_restart_options.go
+++ b/pkg/bindings/pods/types_restart_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *RestartOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *RestartOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_start_options.go b/pkg/bindings/pods/types_start_options.go
index d0cb50969..0dbe27bc1 100644
--- a/pkg/bindings/pods/types_start_options.go
+++ b/pkg/bindings/pods/types_start_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *StartOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *StartOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
diff --git a/pkg/bindings/pods/types_stats_options.go b/pkg/bindings/pods/types_stats_options.go
index 2fb3529ad..3c9592946 100644
--- a/pkg/bindings/pods/types_stats_options.go
+++ b/pkg/bindings/pods/types_stats_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,32 +7,27 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *StatsOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *StatsOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
 
-// WithAll
+// WithAll set field All to given value
 func (o *StatsOptions) WithAll(value bool) *StatsOptions {
-	v := &value
-	o.All = v
+	o.All = &value
 	return o
 }
 
-// GetAll
+// GetAll returns value of field All
 func (o *StatsOptions) GetAll() bool {
-	var all bool
 	if o.All == nil {
-		return all
+		var z bool
+		return z
 	}
 	return *o.All
 }
diff --git a/pkg/bindings/pods/types_stop_options.go b/pkg/bindings/pods/types_stop_options.go
index 443c9120f..a96f41d1d 100644
--- a/pkg/bindings/pods/types_stop_options.go
+++ b/pkg/bindings/pods/types_stop_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,32 +7,27 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *StopOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *StopOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
 
-// WithTimeout
+// WithTimeout set field Timeout to given value
 func (o *StopOptions) WithTimeout(value int) *StopOptions {
-	v := &value
-	o.Timeout = v
+	o.Timeout = &value
 	return o
 }
 
-// GetTimeout
+// GetTimeout returns value of field Timeout
 func (o *StopOptions) GetTimeout() int {
-	var timeout int
 	if o.Timeout == nil {
-		return timeout
+		var z int
+		return z
 	}
 	return *o.Timeout
 }
diff --git a/pkg/bindings/pods/types_top_options.go b/pkg/bindings/pods/types_top_options.go
index ab6501704..2e319afb2 100644
--- a/pkg/bindings/pods/types_top_options.go
+++ b/pkg/bindings/pods/types_top_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,32 +7,27 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *TopOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *TopOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }
 
-// WithDescriptors
+// WithDescriptors set field Descriptors to given value
 func (o *TopOptions) WithDescriptors(value []string) *TopOptions {
-	v := value
-	o.Descriptors = v
+	o.Descriptors = value
 	return o
 }
 
-// GetDescriptors
+// GetDescriptors returns value of field Descriptors
 func (o *TopOptions) GetDescriptors() []string {
-	var descriptors []string
 	if o.Descriptors == nil {
-		return descriptors
+		var z []string
+		return z
 	}
 	return o.Descriptors
 }
diff --git a/pkg/bindings/pods/types_unpause_options.go b/pkg/bindings/pods/types_unpause_options.go
index f9ea972e6..88e9f60df 100644
--- a/pkg/bindings/pods/types_unpause_options.go
+++ b/pkg/bindings/pods/types_unpause_options.go
@@ -1,3 +1,4 @@
+// Code generated by go generate; DO NOT EDIT.
 package pods
 
 import (
@@ -6,16 +7,12 @@ import (
 	"github.com/containers/podman/v3/pkg/bindings/internal/util"
 )
 
-/*
-This file is generated automatically by go generate.  Do not edit.
-*/
-
-// Changed
+// Changed returns true if named field has been set
 func (o *UnpauseOptions) Changed(fieldName string) bool {
 	return util.Changed(o, fieldName)
 }
 
-// ToParams
+// ToParams formats struct fields to be passed to API service
 func (o *UnpauseOptions) ToParams() (url.Values, error) {
 	return util.ToParams(o)
 }