doc: new field extern_name in cargo-metadata

Author: weihanglo

src/doc/man/cargo-metadata.md

@@ -242,13 +242,20 @@ The output has the following format:
                         /* The name of the dependency's library target.
                            If this is a renamed dependency, this is the new
                            name.
+                           NOTE: Deprecated. Please use `dep_kinds.extern_name` instead.
                         */
                         "name": "bitflags",
                         /* The Package ID of the dependency. */
                         "pkg": "bitflags 1.0.4 (registry+https://github.com/rust-lang/crates.io-index)",
                         /* Array of dependency kinds. Added in Cargo 1.40. */
                         "dep_kinds": [
                             {
+                                /* The name of the dependency's library target.
+                                   If this is a renamed dependency, this is the new
+                                   name.
+                                   Added in Cargo 1.68.
+                                */
+                                "extern_name": "bitflags",
                                 /* The dependency kind.
                                    "dev", "build", or null for a normal dependency.
                                 */

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

@@ -237,13 +237,20 @@ OUTPUT FORMAT
                                    /* The name of the dependency's library target.
                                       If this is a renamed dependency, this is the new
                                       name.
+                                      NOTE: Deprecated. Please use `dep_kinds.extern_name` instead.
                                    */
                                    "name": "bitflags",
                                    /* The Package ID of the dependency. */
                                    "pkg": "bitflags 1.0.4 (registry+https://github.com/rust-lang/crates.io-index)",
                                    /* Array of dependency kinds. Added in Cargo 1.40. */
                                    "dep_kinds": [
                                        {
+                                           /* The name of the dependency's library target.
+                                              If this is a renamed dependency, this is the new
+                                              name.
+                                              Added in Cargo 1.68.
+                                           */
+                                           "extern_name": "bitflags",
                                            /* The dependency kind.
                                               "dev", "build", or null for a normal dependency.
                                            */

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

@@ -242,13 +242,20 @@ The output has the following format:
                         /* The name of the dependency's library target.
                            If this is a renamed dependency, this is the new
                            name.
+                           NOTE: Deprecated. Please use `dep_kinds.extern_name` instead.
                         */
                         "name": "bitflags",
                         /* The Package ID of the dependency. */
                         "pkg": "bitflags 1.0.4 (registry+https://github.com/rust-lang/crates.io-index)",
                         /* Array of dependency kinds. Added in Cargo 1.40. */
                         "dep_kinds": [
                             {
+                                /* The name of the dependency's library target.
+                                   If this is a renamed dependency, this is the new
+                                   name.
+                                   Added in Cargo 1.68.
+                                */
+                                "extern_name": "bitflags",
                                 /* The dependency kind.
                                    "dev", "build", or null for a normal dependency.
                                 */

src/etc/man/cargo-metadata.1

@@ -239,13 +239,20 @@ The output has the following format:
                         /* The name of the dependency's library target.
                            If this is a renamed dependency, this is the new
                            name.
+                           NOTE: Deprecated. Please use `dep_kinds.extern_name` instead.
                         */
                         "name": "bitflags",
                         /* The Package ID of the dependency. */
                         "pkg": "bitflags 1.0.4 (registry+https://github.com/rust\-lang/crates.io\-index)",
                         /* Array of dependency kinds. Added in Cargo 1.40. */
                         "dep_kinds": [
                             {
+                                /* The name of the dependency's library target.
+                                   If this is a renamed dependency, this is the new
+                                   name.
+                                   Added in Cargo 1.68.
+                                */
+                                "extern_name": "bitflags",
                                 /* The dependency kind.
                                    "dev", "build", or null for a normal dependency.
                                 */