Rev 4816: (igc) Explain that .bzrignore is implicitly added (Patrick Regan, in file:///home/pqm/archives/thelove/bzr/%2Btrunk/

[Canonical.com Patch Queue Manager]

At file:///home/pqm/archives/thelove/bzr/%2Btrunk/

------------------------------------------------------------
revno: 4816 [merge]
revision-id: pqm at pqm.ubuntu.com-20091120050017-v09m0msompvbol5b
parent: pqm at pqm.ubuntu.com-20091119174527-7449pcexzj7mav1p
parent: ian.clatworthy at canonical.com-20091120041518-vfhcyhdzqqjzk82o
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Fri 2009-11-20 05:00:17 +0000
message:
  (igc) Explain that .bzrignore is implicitly added (Patrick Regan,
  	#59608)
modified:
  bzrlib/builtins.py             builtins.py-20050830033751-fc01482b9ca23183
  doc/en/tutorials/tutorial.txt  tutorial.txt-20050804190939-9dcbba2ef053bc84
=== modified file 'bzrlib/builtins.py'
--- a/bzrlib/builtins.py	2009-11-19 06:28:13 +0000
+++ b/bzrlib/builtins.py	2009-11-20 04:15:18 +0000
@@ -2577,6 +2577,12 @@
 
     See ``bzr help patterns`` for details on the syntax of patterns.
 
+    If a .bzrignore file does not exist, the ignore command
+    will create one and add the specified files or patterns to the newly
+    created file. The ignore command will also automatically add the 
+    .bzrignore file to be versioned. Creating a .bzrignore file without
+    the use of the ignore command will require an explicit add command.
+
     To remove patterns from the ignore list, edit the .bzrignore file.
     After adding, editing or deleting that file either indirectly by
     using this command or directly by using an editor, be sure to commit

=== modified file 'doc/en/tutorials/tutorial.txt'
--- a/doc/en/tutorials/tutorial.txt	2009-09-02 16:03:51 +0000
+++ b/doc/en/tutorials/tutorial.txt	2009-11-19 23:30:19 +0000
@@ -403,6 +403,26 @@
     % bzr commit -m "Add ignore patterns"
 
 
+bzr ignore
+----------
+
+As an alternative to editing the ``.bzrignore`` file, you can use the 
+``bzr ignore`` command. The ``bzr ignore`` command takes filenames and/or
+patterns as arguments and then adds them to the ``.bzrignore`` file. If a
+``.bzrignore`` file does not exist the ``bzr ignore`` command will 
+automatically create one for you, and implicitly add it to be versioned::
+
+    % bzr ignore tags
+    % bzr status
+    added:
+      .bzrignore
+
+Just like when editing the ``.bzrignore`` file on your own, you should
+commit the automatically created ``.bzrignore`` file::
+
+    % bzr commit -m "Added tags to ignore file"
+
+
 Global ignores
 --------------