From: CandyAngel <CandyAngel@web>
Date: Wed, 2 Nov 2016 09:58:25 +0000 (+0000)
Subject: (no commit message)
X-Git-Tag: archive/raspbian/10.20250416-2+rpi1~1^2~287^2~61^2~2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=116e0189ed53e0c29f37e913edc421f0d8bb7824;p=git-annex.git

---

diff --git a/doc/bugs/addurl_pathdepth_description_misleading.mdwn b/doc/bugs/addurl_pathdepth_description_misleading.mdwn
new file mode 100644
index 0000000000..531e43cbf0
--- /dev/null
+++ b/doc/bugs/addurl_pathdepth_description_misleading.mdwn
@@ -0,0 +1,13 @@
+The description for the *pathdepth* option for *addurl* doesn't match its behaviour (emphasis mine).
+
+> Rather than basing the **filename** on the whole url, this causes a **path** to be constructed, starting at the specified depth within the path of the url.
+> 
+> For example, adding the url http://www.example.com/dir/subdir/bigfile with --pathdepth=1 will use "**dir/subdir/bigfile**", while --pathdepth=3 will use "bigfile".
+
+This isn't how it behaves. It would be more accurate as (emphasis on changes):
+
+> Rather than basing the filename on the whole url, this causes a **filename** to be constructed, starting at the specified depth within the path of the url.
+> 
+> For example, adding the url http://www.example.com/dir/subdir/bigfile with --pathdepth=1 will use "**dir_subdir_bigfile**", while --pathdepth=3 will use "bigfile".
+
+For what I am doing (adding a directory tree with addurl and file:// URLs), I'd actually like the behaviour described (to recreate the tree), but I'm not sure which one was the *intended* behaviour..