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

[Kevin Hawkins]

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
>>>
>>
>