fixed documentation and regenaration of the pages

Fix all the broken intra-doc links

docs(build-rs): Fix broken intra-doc links

These were caught with the latest nightly

This was pulled from rust-lang#15800

chore(deps): update rust crate cargo_metadata to 0.21.0

docs: `-Zpackage-workspace` has been stabilized

chore: bump to 0.92.0

docs: update changelog for 1.90.0

Add test for multiple build scripts in different order

Preserve order of build scripts

Update semver tests for 1.89

This updates the tests where messages have changed in 1.89.

chore(deps): update msrv (1 version) to v1.89

chore: Bump versions

test(build-std): relax the thread name assertion

rust-lang/rust#115746 changed to print thread ID,
so we update accordingly.

chore(deps): update cargo-semver-checks to v0.43.0

docs(unstable): Link out to the Plumbing commands effort

This is intended to help people discover where to go to discuss plumbing
command efforts.

chore(deps): update compatible

add is_inherited method to InheritableDependency

add is_inherited method to InheritableField

Add unstable `-Zsection-timings` flag

Pass `--json=timings` to rustc when `--timings` and `-Zsection-timings` is enabled

Parse and store section timing events

Add section timing data to JSON `--timings` output

Make headers of the HTML `--timings` unit table dynamic

Add compilation sections to the HTML unit table

Duplicates of unknown_feature test

More helpful error for invalid cargo-features = []

test(package): Add test to verify package build cache behavior

fix(package): Fixed inconsistent build cache behavior during package verify

When running `cargo package` the verify the build cache
(target-dir/build-dir) will not be used and all dependencies will be
recompiled.

This is inconsistent as setting target dir (via `CARGO_TARGET_DIR` for
example) will cause `cargo package` to reuse the build cache.

This commit changes the default behavior to always use the build cache,
matching the behavior of having target-dir set.

chore(deps): update msrv (3 versions) to v1.87

chore: remove x86_64-apple-darwin from CI and tests

RFC 3841 has merged, and x86_64-apple-darwin will be demoted to tier-2
in 1.90.0. In Cargo we usually run test against tier-1 platforms, so
x86_64-apple-darwin should be removed.
Also, that target platform is often the slowest one in CI,
we are happy to remove it to save us a couple of minutes.

https://rust-lang.github.io/rfcs/3841-demote-x86_64-apple-darwin.html

chore(deps): bump slab from 0.4.10 to 0.4.11

Bumps [slab](https://github.com/tokio-rs/slab) from 0.4.10 to 0.4.11.
- [Release notes](https://github.com/tokio-rs/slab/releases)
- [Changelog](https://github.com/tokio-rs/slab/blob/master/CHANGELOG.md)
- [Commits](tokio-rs/slab@v0.4.10...v0.4.11)

---
updated-dependencies:
- dependency-name: slab
  dependency-version: 0.4.11
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <[email protected]>

refactor: make resolve features public

feat(build-dir): Stabilize build-dir

docs: Formatting and cross-linking to build-dir/target-dir docs

Update src/doc/man/cargo-doc.md as per the feedback recieved

regenerated pages using cargo build-man and ran ./ci/validate-man.sh and sync branch with master branch

Author: ojuschugh1

src/doc/man/cargo-doc.md

@@ -16,6 +16,8 @@ cargo-doc --- Build a package's documentation
 Build the documentation for the local package and all dependencies. The output
 is placed in `target/doc` in rustdoc's usual format.
 
+**Note:** Documentation generation is cumulative: existing doc files in the target directory are preserved across different `cargo doc` invocations. To remove existing generated docs, pass `--doc` to {{man "cargo-clean" 1}}.
+
 ## OPTIONS
 
 ### Documentation Options

src/doc/man/generated_txt/cargo-doc.txt

@@ -10,6 +10,10 @@ DESCRIPTION
        Build the documentation for the local package and all dependencies. The
        output is placed in target/doc in rustdoc’s usual format.
 
+       Note: Documentation generation is cumulative: existing doc files in the
+       target directory are preserved across different cargo doc invocations.
+       To remove existing generated docs, pass --doc to cargo-clean(1).
+
 OPTIONS
    Documentation Options
        --open

src/doc/src/commands/cargo-doc.md

@@ -12,6 +12,8 @@ cargo-doc --- Build a package's documentation
 Build the documentation for the local package and all dependencies. The output
 is placed in `target/doc` in rustdoc's usual format.
 
+**Note:** Documentation generation is cumulative: existing doc files in the target directory are preserved across different `cargo doc` invocations. To remove existing generated docs, pass `--doc` to [cargo-clean(1)](cargo-clean.html).
+
 ## OPTIONS
 
 ### Documentation Options

src/etc/man/cargo-doc.1

@@ -10,6 +10,8 @@ cargo\-doc \[em] Build a package\[cq]s documentation
 .SH "DESCRIPTION"
 Build the documentation for the local package and all dependencies. The output
 is placed in \fBtarget/doc\fR in rustdoc\[cq]s usual format.
+.sp
+\fBNote:\fR Documentation generation is cumulative: existing doc files in the target directory are preserved across different \fBcargo doc\fR invocations. To remove existing generated docs, pass \fB\-\-doc\fR to \fBcargo\-clean\fR(1).
 .SH "OPTIONS"
 .SS "Documentation Options"
 .sp