[Pkg-bazaar-commits] ./bzr/unstable r106: design notes for ignore patterns

[mbp at sourcefrog.net]

------------------------------------------------------------
revno: 106
committer: mbp at sourcefrog.net
timestamp: Mon 2005-03-28 10:14:04 +1000
message:
  design notes for ignore patterns
added:
  doc/ignore.txt
modified:
  doc/index.txt
-------------- next part --------------
=== added file 'doc/ignore.txt'
--- a/doc/ignore.txt	1970-01-01 00:00:00 +0000
+++ b/doc/ignore.txt	2005-03-28 00:14:04 +0000
@@ -0,0 +1,22 @@
+Ignore patterns
+***************
+
+Ignore patterns need to be flexible but simple.
+
+Based on the system from rsync, which is in turn based on that of
+CVS.  
+
+First build a list by concatenating:
+
+* per-user configuration
+* per-tree configuration
+* command line options
+
+Just one ``.bzrignore`` at tree root?
+
+File can contain '+ ' and '- ' prefixes to include and exclude things,
+also '#' for comments.
+ 
+Should have a ``--ignore`` command line option that specifies ignore
+patterns; by putting a ! in this you can turn off any other includes.
+(Similar to CVS.)

=== modified file 'doc/index.txt'
--- a/doc/index.txt	2005-03-14 02:57:37 +0000
+++ b/doc/index.txt	2005-03-28 00:14:04 +0000
@@ -73,7 +73,10 @@
 
 * `Config specs <config-specs.html>`__ assemble a tree from several places.
 
-* `Conflicts <conflicts.html>`_ that can occur during merge-like operations.
+* `Conflicts <conflicts.html>`_ that can occur during merge-like
+  operations.
+
+* `Ignored files <ignore.html>`__
 
 * `Recovering from interrupted operations <interrupted.html>`__