Re: [gentoo-dev] [RFC] Some sync control

[Robin H. Johnson]

On Thu, Jan 11, 2007 at 10:29:58PM +0100, Piotr Jaroszy??ski wrote:
> After yesterday epkgmove fun I thought that it would be nice to have some
> control on when our cvstree is synced with mirrors. My first very basic idea
> is just to put a block_sync file in the tree when smth big is going on, like
> new kde version stabilization or big pkg move. Inside the file we could have
> smth like "user - why - until time&date".
If you'd asked the infra folks, in the past we have just blocked it when
people asked us to.

However I do really like the idea of moving the control towards
developers, and I'll take the first step of strongly defining the format
of the file.

0. File location is located at profiles/block_sync
1. Lines starting with a # are comments.
2. Each entry must be separated by one or more lines of whitespace.
3. Each entry based on RFC[2]822 format, with continuation lines if
   needed. This makes parsing very easy. (See people complaining about
   trying to parse comments in package.mask lately).
4. The following headers must be included: Entry-Date, Start-Date,
   Signed-Off-By, Reason.
5. All dates must be in UTC and conform to RFC2822. 
   (Use 'date -R -u' output)
6. Start-Date specifies when the block starts. Entry-Date is when the
   entry was created in the file.
7. Signed-Off-By must be the contact person for the block. More than one
   Signed-Off-By line may be present.
8. The following headers are optional: Completion-Date, References
9. References should include links or message-ID numbers to publicly
   visible reasons as to why the block is in place.
10. A Completion-Date may be present, but is a guideline only. No
    automatic action shall be taken based on this line.
11. Other headers may exist, and should not interfere with the file.

Example entry:
==============
Entry-Date: Thu, 11 Jan 2007 21:45:23 +0000
Start-Date: Thu, 11 Jan 2007 22:00:00 +0000
Completion-Date: Thu, 11 Jan 2007 23:00:00 +0000
Signed-off-By: Robin H. Johnson <robbat2@g.o>
References: http://article.gmane.org/gmane.linux.gentoo.devel/45310
Reason: The following is an example of a block for the block_sync file.
 This is a continuation line. Notice the leading space. It is still part
 of the Reason header.
# The above is the example block
==============

-- 
Robin Hugh Johnson
Gentoo Linux Developer
E-Mail     : robbat2@g.o
GnuPG FP   : 11AC BA4F 4778 E3F6 E4ED  F38E B27B 944E 3488 4E85