docs(build-rs): inline -C link-arg and remove broken intra-doc refs

Author: ojuschugh1

crates/build-rs/src/output.rs

@@ -66,13 +66,11 @@ pub fn rerun_if_env_changed(key: impl AsRef<OsStr>) {
 }
 
 /// The `rustc-link-arg` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// supported targets (benchmarks, binaries, cdylib crates, examples, and tests).
 ///
 /// Its usage is highly platform specific. It is useful to set the shared library
 /// version or linker script.
-///
-/// [link-arg]: https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg
 #[track_caller]
 pub fn rustc_link_arg(flag: &str) {
     if flag.contains([' ', '\n']) {
@@ -82,13 +80,11 @@ pub fn rustc_link_arg(flag: &str) {
 }
 
 /// The `rustc-link-arg-bin` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// the binary target with name `BIN`. Its usage is highly platform specific.
 ///
 /// It
 /// is useful to set a linker script or other linker options.
-///
-/// [link-arg]: https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg
 #[track_caller]
 pub fn rustc_link_arg_bin(bin: &str, flag: &str) {
     if !is_ident(bin) {
@@ -101,13 +97,11 @@ pub fn rustc_link_arg_bin(bin: &str, flag: &str) {
 }
 
 /// The `rustc-link-arg-bins` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// the binary target.
 ///
 /// Its usage is highly platform specific. It is useful to set
 /// a linker script or other linker options.
-///
-/// [link-arg]: https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg
 #[track_caller]
 pub fn rustc_link_arg_bins(flag: &str) {
     if flag.contains([' ', '\n']) {
@@ -117,7 +111,7 @@ pub fn rustc_link_arg_bins(flag: &str) {
 }
 
 /// The `rustc-link-arg-tests` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// a tests target.
 #[track_caller]
 pub fn rustc_link_arg_tests(flag: &str) {
@@ -128,7 +122,7 @@ pub fn rustc_link_arg_tests(flag: &str) {
 }
 
 /// The `rustc-link-arg-examples` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// an examples target.
 #[track_caller]
 pub fn rustc_link_arg_examples(flag: &str) {
@@ -139,7 +133,7 @@ pub fn rustc_link_arg_examples(flag: &str) {
 }
 
 /// The `rustc-link-arg-benches` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// a benchmark target.
 #[track_caller]
 pub fn rustc_link_arg_benches(flag: &str) {
@@ -371,13 +365,11 @@ pub fn rustc_env(key: &str, value: &str) {
 }
 
 /// The `rustc-cdylib-link-arg` instruction tells Cargo to pass the
-/// [`-C link-arg=FLAG` option][link-arg] to the compiler, but only when building
+/// [`-C link-arg=FLAG` option](https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg) to the compiler, but only when building
 /// a `cdylib` library target.
 ///
 /// Its usage is highly platform specific. It is useful
 /// to set the shared library version or the runtime-path.
-///
-/// [link-arg]: https://doc.rust-lang.org/rustc/codegen-options/index.html#link-arg
 #[track_caller]
 pub fn rustc_cdylib_link_arg(flag: &str) {
     if flag.contains('\n') {