info-cvs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Standard Styntax for TAG


From: Muhammad Shakeel
Subject: Re: Standard Styntax for TAG
Date: Tue, 21 May 2002 11:21:53 +0500
User-agent: Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010726 Netscape6/6.1


Thanks for the information, but there should be a version number of the module in case of release level tag. I designed the following syntax. Any comments/suggestions ?

Release Tag Syntax:   

Rel_ProjectName_x_y_State

e.g.

Rel_Mpeg4_1_0_Final

Branch TAG Syntax:

B_ BranchName_ProjectName_ TAGName_State

e.g.

B_ Group2_ H263_TestOK

Devoper TAG Syntaz:
ProjectName_TAGName_State

e.g.

Mpeg4_Test1OK_Alpha



Regards,
shakeel


Glew, Andy wrote:
Is there is any standard syntax or pattern for Tags , for 
following type of tags or some other importnat one:

Developement level Tags
Release levelTags
Branch level Tags

I don't know of any universal standards, but I try to enforce
the following on projects I am involved with.
Also, I have several scripts, like cvs-make-branch,
that automatically mandate some of these
"standards".

All branches should have "branch" in them,
e.g. the branch tag should be suffixed
*--branch

All branches should have a tag "branch-base"
associated with the contour they branched from
e.g. the branch tag, suffixed
*--branch-base

Less often, but more and more recently,
I use the words "contour" to distinguish
tags that identify a self consistent set of versions
e.g. some meaningful name suffixed
*--contour

I nearly always want to have the date and time
in my tags. I indicate this as
*--YYYY-MM-DD-HHhMM--*
I only use local time at the moment, although
have been forced to use GMT in the past.

I only do not put the year and date
a) for floating tags
e.g. regression-test-latest
although for such floating tags I usually have
a timestamped version
e.g. regression-test-2002-05-17-16h10
or b) for long-lived tags, typically branches,
e.g.
windows-branch
vs
linux-branch
However, overall I find long-lived branches a bad idea,
and prefer to unify them via the build system.
I more often regret not having the timestamp in a branch tag
than I regret having it in a tag.

At the front of a tag, of course, I try to put something meaningful.
I have learned that it is best to put the most distinguishing part
of the tag first rather than last, so that name completion tools
work well --- e.g. meaningful-text--2002-05-17-16h20--branch
rather than tag-2002-05-17-16h20--branch--meaningful-text.


I have tried to enforce naming conventions wrt merge points,
where other branches are merged in, but have never found a good
one.



    

reply via email to

[Prev in Thread] Current Thread [Next in Thread]