summaryrefslogtreecommitdiff
path: root/doc/usage.mdwn
diff options
context:
space:
mode:
authorJoey Hess2014-11-23 18:48:52 -0400
committerJoey Hess2014-11-23 18:48:52 -0400
commit9d975e9ee4c44782da0815fb161ea8676dbf559c (patch)
treeb74c1037324cdc4308c98e475202649bf91e27df /doc/usage.mdwn
parentbaba668033f86b7c91f6b15c58002ea4bdbf3da2 (diff)
add --merge
Diffstat (limited to 'doc/usage.mdwn')
-rw-r--r--doc/usage.mdwn16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index 16788320..e83e8def 100644
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -65,6 +65,22 @@ action as needed to satisfy the configured properties of the local host.
Opens $EDITOR on the privdata value.
+* --merge
+
+ Combine multiple --spin commits into a single, more useful commit.
+
+ When using propellor, you may find yourself repeatedly running
+ `propellor --spin` until you get things working the way you like.
+ This results in a lot of git commits being made, with incremental
+ changes.
+
+ To clean that up to a single commit, use `propellor --merge`. A normal
+ interactive git commit will then be made, consisting of all changes
+ that have been previously committed by --spin, since the last time a
+ normal git commit was made.
+
+ (This will result in a trapezoid pattern in gitk.)
+
* hostname
When run with a hostname and no other options, propellor will