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

[Martin Holmes]

There's an abbreviated form of these instructions in the release 
technician's guide:

<http://www.tei-c.org/Activities/Council/Working/tcw22.xml#releaseSteps>

but I think it should also go in TCW20 (How to edit the Guidelines), in 
here:

<http://www.tei-c.org/Activities/Council/Working/tcw20.xml#body.1_div.4>

Before I add it, does anyone have any suggestions for improvements to 
the text below?

Cheers,
Martin

On 12-12-05 08:41 PM, Martin Holmes wrote:
> 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
University of Victoria Humanities Computing and Media Centre
(mholmes at uvic.ca)