summaryrefslogtreecommitdiff
path: root/doc/preferred_content.mdwn
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2015-02-06 15:12:42 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2015-02-06 15:12:42 -0400
commitfaa6b2cdd7e62e221ccda3890fd1da32713cec8f (patch)
tree0587650ccdb863797e0d32aba93b19249109fbf0 /doc/preferred_content.mdwn
parenta33ccc14c09d51a1604b34a175e7938d37f29abf (diff)
groupwanted: New command to set the groupwanted preferred content expression.
Diffstat (limited to 'doc/preferred_content.mdwn')
-rw-r--r--doc/preferred_content.mdwn18
1 files changed, 15 insertions, 3 deletions
diff --git a/doc/preferred_content.mdwn b/doc/preferred_content.mdwn
index f6071ea35..31e614919 100644
--- a/doc/preferred_content.mdwn
+++ b/doc/preferred_content.mdwn
@@ -125,8 +125,8 @@ But, you can do more complicated things, for example:
The "groupwanted" keyword can be used to refer to a preferred content
expression that is associated with a group. This is like the "standard"
-keyword, but you can set up groupwanted preferred content expressions
-using `git annex vicfg`.
+keyword, but you can configure the preferred content expressions
+using `git annex groupwanted`.
Note that when writing a groupwanted preferred content expression,
you can use all of the keywords listed above, including "standard".
@@ -134,7 +134,8 @@ you can use all of the keywords listed above, including "standard".
For example, to make a variant of the standard client preferred content
expression that does not want files in the "out" directory, you
-could set `groupwanted client = standard and exclude=out/*`.
+could run: `git annex groupwanted client "standard and exclude=out/*"`
+
Then repositories that are in the client group and have their preferred
content expression set to "groupwanted" will use that, while
other client repositories that have their preferred content expression
@@ -144,6 +145,17 @@ Or, you could make a new group, with your own custom preferred content
expression tuned for your needs, and every repository you put in this
group and make its preferred content be "groupwanted" will use it.
+For example, the archive group only wants to archive 1 copy of each file,
+spread amoung every repository in the group.
+Here's how to configure a group named redundantarchive, that instead
+wants to contain 3 copies of each file:
+
+ git annex groupwanted redundantarchive "not (copies=redundantarchive:3)"
+ for repo in foo bar baz; do
+ git annex group $repo redundantarchive
+ git annex wanted $repo groupwanted
+ done
+
### difference: metadata matching
This: