[tei-council] $Date: and $Id:

[Martin Holmes]

Hi Kevin,

The Subversion system adds the file date, id, date etc. to every 
checkout if you do this:

1. When you create your new file, copy and paste that header bit from 
any other file into the top of your file. (It doesn't matter if the 
date, filename and other info from the old file is in there. Subversion 
will replace it automatically later.)

2. Run this at the command line in the directory where your file is:

  svn add yourfile.xml

so Subversion knows about your new file.

3. Run this:

svn propset svn:keywords 'LastChangedRevision LastChangedBy Id 
LastChangedDate HeadURL' filename.xml

4. Run svn commit to commit your changes. You'll find that even your 
local copy is automatically updated by SVN to show the right id and 
date, and show your id as the last editor of it.

I think I remember putting this in one of the TCWs, but I don't remember 
where. I'll have a look, and if I can't find it I'll put it somewhere.

Cheers,
Martin

On 12-12-05 07:28 PM, Kevin Hawkins wrote:
> Every file in Guidelines/ and Specs/ contains at the top:
>
> <!--
> Copyright TEI Consortium.
> Dual-licensed under CC-by and BSD2 licences
> See the file COPYING.txt for details.
>
> which is followed by lines beginning:
>
> $Date:
> $Id:
>
> after which there is machine-generated information about the last time
> the file is touched.  I understand that this is automatically by a
> properly configured text editor of some sort.  (I've gone looking for
> information on this in the past out of my own curiosity but have been
> unable to find anything since searching on these terms turns up just
> sourcecode and webpages that were edited using such an editor.  Your
> leads appreciated.)
>
> As far as I can tell,
> http://www.tei-c.org/Activities/Council/Working/tcw20.xml doesn't say
> require that we use a particular editor configuration that will update
> this information when editing an existing file.  I certainly haven't
> ever touched it, so I suppose that when I make an edit, the info listed
> here is inaccurate until someone with such a configuration edits the
> file.  And I suppose that's okay since no one has ever complained or
> suggested we add it to
> http://www.tei-c.org/Activities/Council/Working/tcw20.xml .
>
> However, I am about to create my first element spec (in at last
> implementing http://purl.org/TEI/FR/3555191 ) and am not sure whether to
> put in anything for "$Date:" and "$Id:".  I could create some by hand,
> but I'd like to put in whatever will work best for anyone who further
> edits the file using a properly configured editor.
>
> Please advise.
>
> Kevin
>

-- 
Martin Holmes
mholmes at uvic.ca
UVic Humanities Computing and Media Centre