rustc book: Outdated parameters for `--print`

[xizheyin]

Location

https://doc.rust-lang.org/rustc/command-line-arguments.html#--print-print-compiler-information

Summary

When I use rustc ---print, it reports

       Usage:
           --print [all-target-specs-json|calling-conventions|cfg|check-cfg|code-models|crate-name|deployment-target|file-names|host-tuple|link-args|native-static-libs|relocation-models|split-debuginfo|stack-protector-strategies|sysroot|target-cpus|target-features|target-libdir|target-list|target-spec-json|tls-models]

But some of them can not be found in the corresponding chapter in rustc book. And the order in which the parameters are arranged needs to be adjusted.

[Urgau]

But some of them can not be found in the corresponding chapter in rustc book

That's because some of them are unstable.

And the order in which the parameters are arranged needs to be adjusted.

What do you mean by "adjusted"?

[ChrisDenton]

We should probably try to hide the unstable options on stable? Although that might be more difficult to do since I don't think stable/unstable is easy to query.

[xizheyin]

What do you mean by "adjusted"?

Alphabetical order may be more beautiful.

We should probably try to hide the unstable options on stable?

I think so, too, otherwise it may cause confusion.Is it possible to mark as unstable?

[jieyouxu]

It should be possible to hide the unstable options on stable due to how print requests are handed: see

rust/compiler/rustc_session/src/config.rs

Lines 2035 to 2042 in a7fc463

	let kind = if let Some((print_name, print_kind)) =
	PRINT_KINDS.iter().find(|&&(name, _)| name == req)
	{
	check_print_request_stability(early_dcx, unstable_opts, (print_name, *print_kind));
	*print_kind
	} else {
	emit_unknown_print_request_help(early_dcx, req)
	};

Probably just pull out the "what is considered unstable print request" logic

rust/compiler/rustc_session/src/config.rs

Lines 2060 to 2076 in a7fc463

	fn check_print_request_stability(
	early_dcx: &EarlyDiagCtxt,
	unstable_opts: &UnstableOptions,
	(print_name, print_kind): (&str, PrintKind),
	) {
	match print_kind {
	PrintKind::AllTargetSpecsJson | PrintKind::CheckCfg | PrintKind::TargetSpecJson
	if !unstable_opts.unstable_options =>
	{
	early_dcx.early_fatal(format!(
	"the `-Z unstable-options` flag must also be passed to enable the `{print_name}` \
	print option"
	));
	}
	_ => {}
	}
	}

(There might be a bit more nuance to this, I haven't tried implementing it)

[xizheyin]

jieyou, are you going to do this? If not, I can give it a try. @jieyouxu

[jieyouxu]

I am not working on this, no.