doc/bugs/git-annex_6.20161031_fails_with_filenames_containing_newlines.mdwn

@@ -0,0 +1,43 @@
+### Please describe the problem.
+
+I tried to add a bunch of files and one of the files contained a newline in its name.
+When doing 'git annex add .' it failed with an error that contained only the part of the filename before the newline.
+
+### What steps will reproduce the problem?
+
+Create a file with a newline in its name:
+
+~/tmp $ touch 'file with newline'$'\n''line 2'^C
+~/tmp $ mkdir annex
+~/tmp $ cd annex/
+~/tmp/annex $ git init
+~/tmp/annex $ git annex init
+init  ok
+(recording state in git...)
+~/tmp/annex $ cp ../file* .
+~/tmp/annex $ git annex add .
+add file with newline
+line 2 git-annex: unknown response from git cat-file ("HEAD:./file with newline missing",Ref "HEAD:./file with newline\nline 2")
+~/tmp/annex $
+
+### What version of git-annex are you using? On what operating system?
+
+6.20161031 on Gentoo Linux
+
+
+### Please provide any additional information below.
+
+[[!format sh """
+# If you can, paste a complete transcript of the problem occurring here.
+
+please see above
+
+# If the problem is with the git-annex assistant, paste in .git/annex/daemon.log
+
+
+# End of transcript or log.
+"""]]
+
+### Have you had any luck using git-annex before? (Sometimes we get tired of reading bug reports all day and a lil' positive end note does wonders)
+
+I hope to have very soon ;-)