'bzr ignore' undocumented behaviour and misleading tutorial
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Bazaar |
Fix Released
|
Medium
|
Patrick Regan |
Bug Description
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.'
Related branches
- Ian Clatworthy: Approve
- Patrick Regan (community): Needs Resubmitting
- John A Meinel: Needs Fixing
-
Diff: 46 lines (+26/-0)2 files modifiedbzrlib/builtins.py (+6/-0)
doc/en/tutorials/tutorial.txt (+20/-0)
Changed in bzr: | |
status: | Confirmed → In Progress |
assignee: | nobody → Patrick Regan (patrick-regan) |
Changed in bzr: | |
status: | In Progress → Fix Committed |
Agreed, the tutorial should be updated for stuff like this.