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

[Martin Holmes]

Hi Kevin,

No, you only need to go through this procedure when you create a new 
file and add it to svn. Once the properties are set for a specific file, 
svn will take care of updating the info every time the file is committed 
or checked out.

Cheers,
Martin

On 12-12-06 06:09 PM, Kevin Hawkins wrote:
> Martin, your instructions below and in tcw22 are clear, so please do
> update tcw20 if we should be doing this with every commit.  Do I really
> understand correctly that you all run this svn propset command every
> time before committing?  It seems tedious.
>
> On 12/6/12 11:07 AM, Martin Holmes wrote:
>> 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
mholmes at uvic.ca
UVic Humanities Computing and Media Centre