'bzr ignore' undocumented behaviour and misleading tutorial

[David Roberts]

From observation of behaviour, not by reading code, it is apparent that 'ignore' creates a .bzrignore file if none exists, or appends to it if it exists already. That might be expected. 'ignore' ALSO does an implicit and silent ADD of .bzrignore to the versioned file set. That was not entirely expected, and the tutorial is misleading in this respect.

The section headed 'Ignoring files' does not mention 'bzr ignore', but explicitly gives an examples of 'bzr add .bzrignore' . This user spent [wasted?] sometime trying to work out why the ADD operation never reported that the file was added. It's because it had already been versioned automagically, so the command was redundant!

Suggest clarifying/updating tutorial, and consider adding reporting code to 'bzr ignore' to say 'Created .bzrignore and made it versioned.'

[John A Meinel (jameinel)]

Agreed, the tutorial should be updated for stuff like this.

[Ian Clatworthy (ian-clatworthy)]

This can actually be marked as "Fix Released". See http://doc.bazaar-vcs.org/developers/bug-handling.html for details but, basically, landed in trunk == Fix Released by our conventions.