Re: [Xen-devel] [PATCH] README.dev: Document the usage of stop files

[Ian Campbell <Ian.Campbell@xxxxxxxxxx>]

On Fri, 2015-01-23 at 15:20 +0000, Ian Jackson wrote:
> Ian Campbell writes ("[PATCH] README.dev: Document the usage of stop files"):
> ...
> >  NOTE: $revision must be a revision *not* a tag.
> > +
> > +Temporarily stopping a branch or the entire system
> > +==================================================
> > +
> > +osstest can be paused by dropping a stop file into either the central
> > +$HOME/testing.git or ~/branches/for-$branch.git etc.
> > +
> > +stop                       -- stops everything
> > +daily.stop         -- stops all regular daily tests
> > +bisects.stop               -- stops all bisections
> > +$branch.stop               -- stops $branch
> > +$xenbranch.stop            -- stops everything using $xenbranch
> > +daily.stop         -- stops all regular daily tests
> 
> `daily.stop' is mentioned twice here.
> 
> You should probably mention that dropping `stop' into for-$branch.git
> doesn't stop "everything" but only that branch.

I've redone it as below which I think is probably (?) clearer. There are
some less useful things you can do like
$HOME/branches/for-$branch.git/$branch.stop, but that's a bit redundant
so I didn't document it. Likewise I think
$HOME/branches/for-$branch.git/$xenbranch.stop (i.e. stop this branch
iff it is using $xenbranch) isn't terribly helpful.

I think I'm correct that $HOME/testing.git/$branch.stop stops both
regular flights and bisects?

Please could you also take a look at "README.dev: Document how to do a
force push." from
<1420552277-4358-1-git-send-email-ian.campbell@xxxxxxxxxx>.

8<------

From 5f4cf7b340828b42f0828a141ad8275eea7b6d22 Mon Sep 17 00:00:00 2001
From: Ian Campbell <ian.campbell@xxxxxxxxxx>
Date: Fri, 23 Jan 2015 15:13:20 +0000
Subject: [PATCH] README.dev: Document the usage of stop files

Signed-off-by: Ian Campbell <ian.campbell@xxxxxxxxxx>
---
v2: Improve (?)
---
 README.dev | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/README.dev b/README.dev
index 1257649..5e69cb8 100644
--- a/README.dev
+++ b/README.dev
@@ -132,3 +132,37 @@ $ cd ~/branches/for-$branch.git
 $ OSSTEST_CONFIG=production-config ./ap-push $branch $revision
 
 NOTE: $revision must be a revision *not* a tag.
+
+Temporarily stopping a branch or the entire system
+==================================================
+
+osstest can be paused by dropping a stop file into either the central
+$HOME/testing.git or $HOME/branches/for-$branch.git etc.
+
+$HOME/testing.git/stop
+
+  stop everything
+
+$HOME/testing.git/daily.stop
+
+  stops all regular tests
+
+$HOME/testing.git/bisect.stop
+
+  stops all bisections
+
+$HOME/testing.git/$branch.stop
+
+  stop regular tests and bisections of $branch
+
+$HOME/branches/for-$branch.git/stop
+
+  stops regular tests $branch
+
+$HOME/bisects/for-$branch.git/stop
+
+  stops bisections of $branch
+
+$HOME/testing.git/$xenbranch.stop
+
+  stops everything using $xenbranch
-- 
2.1.4




_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel