From d92a06adec90ec3f1d92dfc071280d84008dce78 Mon Sep 17 00:00:00 2001
From: Marli Frost <marli@frost.red>
Date: Wed, 19 Aug 2020 13:53:21 +0100
Subject: [PATCH] docs: deprecate poor Path sanitization

---
 src/read.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/read.rs b/src/read.rs
index 9a977359..2368ab64 100644
--- a/src/read.rs
+++ b/src/read.rs
@@ -607,6 +607,11 @@ impl<'a> ZipFile<'a> {
 
     /// Get the name of the file in a sanitized form. It truncates the name to the first NULL byte,
     /// removes a leading '/' and removes '..' parts.
+    #[deprecated(
+        since = "0.5.7",
+        note = "by stripping `..`s from the path, the meaning of paths can change.
+                You must use a sanitization strategy that's appropriate for your input"
+    )]
     pub fn sanitized_name(&self) -> ::std::path::PathBuf {
         self.data.file_name_sanitized()
     }