Auto merge of #13298 - weihanglo:pkgid, r=epage

docs: add more links to pkgid spec chapter

src/doc/man/cargo-metadata.md

@@ -393,4 +393,6 @@ reproduction of the information within `Cargo.toml`.
        cargo metadata --format-version=1
 
 ## SEE ALSO
-{{man "cargo" 1}}
+{{man "cargo" 1}}, {{man "cargo-pkgid" 1}}, [Package ID Specifications]
+
+[Package ID Specifications]: ../reference/pkgid-spec.html

src/doc/man/cargo-pkgid.md

@@ -33,6 +33,8 @@ _url_`#`_version_          | `https://github.com/rust-lang/cargo#0.33.0`
 _url_`#`_name_             | `https://github.com/rust-lang/crates.io-index#bitflags`
 _url_`#`_name_`@`_version_ | `https://github.com/rust-lang/cargo#[email protected]`
 
+The specification grammar can be found in chapter [Package ID Specifications].
+
 ## OPTIONS
 
 ### Package Selection
@@ -86,4 +88,6 @@ Get the package ID for the given package instead of the current package.
        cargo pkgid file:///path/to/local/package#foo
 
 ## SEE ALSO
-{{man "cargo" 1}}, {{man "cargo-generate-lockfile" 1}}, {{man "cargo-metadata" 1}}
+{{man "cargo" 1}}, {{man "cargo-generate-lockfile" 1}}, {{man "cargo-metadata" 1}}, [Package ID Specifications]
+
+[Package ID Specifications]: ../reference/pkgid-spec.html

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

@@ -482,5 +482,6 @@ EXAMPLES
               cargo metadata --format-version=1
 
 SEE ALSO
-       cargo(1)
+       cargo(1), cargo-pkgid(1), Package ID Specifications
+       <https://doc.rust-lang.org/cargo/reference/pkgid-spec.html>
 

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

@@ -39,6 +39,10 @@ DESCRIPTION
        | url#name@version | https://github.com/rust-lang/cargo#[email protected] |
        +-----------------+--------------------------------------------------+
 
+       The specification grammar can be found in chapter Package ID
+       Specifications
+       <https://doc.rust-lang.org/cargo/reference/pkgid-spec.html>.
+
 OPTIONS
    Package Selection
        -p spec, --package spec
@@ -166,5 +170,7 @@ EXAMPLES
               cargo pkgid file:///path/to/local/package#foo
 
 SEE ALSO
-       cargo(1), cargo-generate-lockfile(1), cargo-metadata(1)
+       cargo(1), cargo-generate-lockfile(1), cargo-metadata(1), Package ID
+       Specifications
+       <https://doc.rust-lang.org/cargo/reference/pkgid-spec.html>
 

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

@@ -512,4 +512,6 @@ details on environment variables that Cargo reads.
        cargo metadata --format-version=1
 
 ## SEE ALSO
-[cargo(1)](cargo.html)
+[cargo(1)](cargo.html), [cargo-pkgid(1)](cargo-pkgid.html), [Package ID Specifications]
+
+[Package ID Specifications]: ../reference/pkgid-spec.html

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

@@ -33,6 +33,8 @@ _url_`#`_version_          | `https://github.com/rust-lang/cargo#0.33.0`
 _url_`#`_name_             | `https://github.com/rust-lang/crates.io-index#bitflags`
 _url_`#`_name_`@`_version_ | `https://github.com/rust-lang/cargo#[email protected]`
 
+The specification grammar can be found in chapter [Package ID Specifications].
+
 ## OPTIONS
 
 ### Package Selection
@@ -181,4 +183,6 @@ details on environment variables that Cargo reads.
        cargo pkgid file:///path/to/local/package#foo
 
 ## SEE ALSO
-[cargo(1)](cargo.html), [cargo-generate-lockfile(1)](cargo-generate-lockfile.html), [cargo-metadata(1)](cargo-metadata.html)
+[cargo(1)](cargo.html), [cargo-generate-lockfile(1)](cargo-generate-lockfile.html), [cargo-metadata(1)](cargo-metadata.html), [Package ID Specifications]
+
+[Package ID Specifications]: ../reference/pkgid-spec.html

src/etc/man/cargo-metadata.1

@@ -529,4 +529,4 @@ cargo metadata \-\-format\-version=1
 .RE
 .RE
 .SH "SEE ALSO"
-\fBcargo\fR(1)
+\fBcargo\fR(1), \fBcargo\-pkgid\fR(1), \fIPackage ID Specifications\fR <https://doc.rust\-lang.org/cargo/reference/pkgid\-spec.html>

src/etc/man/cargo-pkgid.1

@@ -62,6 +62,8 @@ T}:T{
 T}
 .TE
 .sp
+.sp
+The specification grammar can be found in chapter \fIPackage ID Specifications\fR <https://doc.rust\-lang.org/cargo/reference/pkgid\-spec.html>\&.
 .SH "OPTIONS"
 .SS "Package Selection"
 .sp
@@ -240,4 +242,4 @@ cargo pkgid file:///path/to/local/package#foo
 .RE
 .RE
 .SH "SEE ALSO"
-\fBcargo\fR(1), \fBcargo\-generate\-lockfile\fR(1), \fBcargo\-metadata\fR(1)
+\fBcargo\fR(1), \fBcargo\-generate\-lockfile\fR(1), \fBcargo\-metadata\fR(1), \fIPackage ID Specifications\fR <https://doc.rust\-lang.org/cargo/reference/pkgid\-spec.html>