Documentation for cmd and entrypoint are imprecise/inconsistent with implementation

[reddaly]

Documentation for oci_image_rule:

cmd: A file containing a newline separated list to be used as the command & args of the container. These values act as defaults and may be replaced by any specified when creating a container.

entrypoint: A file containing a newline separated list to be used as the entrypoint to execute when the container starts. These values act as defaults and may be replaced by an entrypoint specified when creating a container. NOTE: Setting this attribute will reset the cmd attribute

Documentation for oci_image:

cmd: Command & argument configured by default in the running container. See documentation above.

entrypoint: Entrypoint configured by default in the running container. See documentation above.

Usage in e2e tests is inconsitent with these definitions:

rules_oci/e2e/smoke/BUILD.bazel

Lines 8 to 19 in 5ff4c79

	oci_image(
	name = "image",
	base = "@distroless_base",
	cmd = [
	"--arg1",
	"--arg2",
	],
	entrypoint = ["/custom_bin"],
	env = {
	"ENV": "/test",
	},
	)

---

Issues with the above:

1. "Command & argument configured by default in the running container" seems incorrect. The above example shows only the arguments are specified.

2. "A file containing a newline separated list to be used as the entrypoint to execute when the container starts. These values..." The type accepted here seems to be a list of strings, not a file.