<div dir="ltr">On Thu, Nov 9, 2017 at 2:49 PM, Allan Haldane <<a href="mailto:allanhaldane@gmail.com">allanhaldane@gmail.com</a>> wrote:<br>><br>> On 11/09/2017 05:39 PM, Robert Kern wrote:<br>> > On Thu, Nov 9, 2017 at 1:58 PM, Mark Bakker <<a href="mailto:markbak@gmail.com">markbak@gmail.com</a>> wrote:<br>> ><br>> >> Can anybody explain why vstack is going the way of the dodo?<br>> >> Why are stack / concatenate better? What is 'bad' about vstack?<br>> ><br>> > As far as I can tell, the discussion happened all on Github, not the<br>> > mailing list. See here for references:<br>> ><br>> > <a href="https://github.com/numpy/numpy/pull/7253">https://github.com/numpy/numpy/pull/7253</a><br>> ><br>> > --<br>> > Robert Kern<br>><br>> yes, and in particular this linked comment/PR:<br>><br>> <a href="https://github.com/numpy/numpy/pull/5605#issuecomment-85180204">https://github.com/numpy/numpy/pull/5605#issuecomment-85180204</a><br>><br>> Maybe we should reword the vstack docstring so that it doesn't imply<br>> that vstack is going away. It should say something weaker<br>> like "the functions np.stack, np.concatenate, and np.block are often<br>> more general/useful/less confusing alternatives".. or better explain<br>> what the problem is.<br>><br>> If we limit ourselves to 1d,2d and maybe 3d arrays the vstack behavior<br>> doesn't seem all that confusing to me.<br><br>I concur. Highlighting that the functions are only being retained "for backward compatibility" does seem to imply to people that they are deprecated and cannot be relied upon to remain. We *do* break backwards compatibility from time to time.<br><br>--<br>Robert Kern</div>