git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Jakub Narebski <jnareb@gmail.com>
To: Andreas Ericsson <ae@op5.se>
Cc: takeshin <admirau@gmail.com>, git@vger.kernel.org
Subject: Re: update @version in file
Date: Wed, 13 May 2009 02:42:06 -0700 (PDT)	[thread overview]
Message-ID: <m3iqk5l4ps.fsf@localhost.localdomain> (raw)
In-Reply-To: <4A0A8ED8.8000905@op5.se>

Andreas Ericsson <ae@op5.se> writes:
> takeshin wrote:

> > Hi,
> > I have following PHPDoc code in files of my repository:
> > /**
> >  * Class description
> >  * @version 1.2
> >  */
> >  class Name…
> > Is there a chance that git could increment this @version
> > automatically
> > on each commit
> 
> No, but see GIT-VERSION-GEN and "git help describe" for info on how to
> replace such version tags using a script when you cut a release of your
> project.
> 
> > or stamp the file somehow?
> >
> 
> Yes. It can only do so using the blob id though. 

See documentation of `ident` attribute in gitattributes(5) manpage.

Well, you can always use `export-subst` gitattribute to make
git-archive do keyword expansion, and there you can use things like
date or decoration (tag / version).

> Things like this can be done in CVS and Subversion because
> a) CVS and SVN are file-based. The version they write are not the
>    version of the *project*, but the version of the file (not even
>    remotely the same thing).
> b) they do not really support proper branching.
> 
> In git (which is snapshot based and supports branching very well indeed),
> it *could* be done, but it would incur such an enormous performance
> penalty when switching branches, creating a new commit or re-writing
> history (since every file would have to be altered) that it's never
> been considered worth adding.

You can cobble something together using "smudge" (to do keyword
expansion) and "clean" (to store files with keywords not expanded in
git repository) filters, see `filter` attribute in gitattributes(5).
But I am not sure it is worth it.

HTH
-- 
Jakub Narebski
Poland
ShadeHawk on #git

  parent reply	other threads:[~2009-05-13  9:42 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-05-13  8:59 update @version in file takeshin
2009-05-13  9:11 ` Andreas Ericsson
2009-05-13  9:22   ` takeshin
2009-05-13  9:42   ` Jakub Narebski [this message]
2009-05-13 16:04     ` Dan Loewenherz
2009-05-13 16:56       ` Jakub Narebski
2009-05-13 17:05         ` Matthieu Moy
2009-05-13 17:38           ` Andreas Ericsson
2009-05-13 23:02           ` Jakub Narebski
2009-05-14  7:08             ` Matthieu Moy

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m3iqk5l4ps.fsf@localhost.localdomain \
    --to=jnareb@gmail.com \
    --cc=admirau@gmail.com \
    --cc=ae@op5.se \
    --cc=git@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).