add a note for Ipv4Addr::to_ipv6_compatible

nanpuyue · nanpuyue · commit 3b2991329501 · 2020-09-02T21:08:09.000+08:00
diff --git 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
