From 3b29913295010e538df9a692f4e59ece9ed362d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=97=E6=B5=A6=E6=9C=88?= <nanpuyue@gmail.com>
Date: Wed, 2 Sep 2020 21:08:09 +0800
Subject: [PATCH] add a note for Ipv4Addr::to_ipv6_compatible

---
 library/std/src/net/ip.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/library/std/src/net/ip.rs b/library/std/src/net/ip.rs
index 341a112df71b3..5aff2b5bb7896 100644
--- a/library/std/src/net/ip.rs
+++ b/library/std/src/net/ip.rs
@@ -745,6 +745,9 @@ impl Ipv4Addr {
     ///
     /// a.b.c.d becomes ::a.b.c.d
     ///
+    /// This isn't typically the method you want; these addresses don't typically
+    /// function on modern systems. Use `to_ipv6_mapped` instead.
+    ///
     /// [`IPv6` address]: Ipv6Addr
     ///
     /// # Examples