cue: some deprecation notices suggest other APIs which are also deprecated

[errordeveloper]

cue/cue/build.go

Lines 60 to 61 in 87408d7

	// Deprecated: use Parse or ParseBytes. The use of Instance is being phased out.
	func (r *hiddenRuntime) Compile(filename string, source interface{}) (*Instance, error) {

cue/cue/build.go

Lines 104 to 106 in 87408d7

	// Deprecated: use CompileString or CompileBytes. The use of Instance is being
	// phased out.
	func (r *hiddenRuntime) Parse(name string, source interface{}) (*Instance, error) {

[myitcv]

I'm not quite sure what the issue/question is here?

cue.Runtime is deprecated, and cue.Instance is being phased, and replaced entirely by cue.Value.

The doc comments you have quoted are not, to my knowledge, visible by virtue of being defined against hiddenRuntime.

So it this perhaps just a code-level clean up you're proposing?

[errordeveloper]

The doc comments you have quoted are not, to my knowledge, visible by virtue of being defined against hiddenRuntime.

Each of the functions are still exported. I was able to see these in vscode via code completion. I found it hard to follow the recursive deprecation.
Are you saying that these functions are not visible at pkg.go.dev or in certiain IDEs?

[mvdan]

Are you saying that these functions are not visible at pkg.go.dev or in certiain IDEs?

They are indeed hidden from the docs, e.g. see https://pkg.go.dev/cuelang.org/go/cue@master#Runtime.

That said, we can fix up the deprecation notices to directly point to non-deprecated APIs. I'll send a patch.