<span style='font-family:Verdana'><span style='font-size:12px'>What about something like this?<br /> 
<br /> 
Keyword substitution is generally only suitable for plain text files. Plain text files are typically used for program source code, and for simple documents such as README files that accompany program source code or executables. A plain text file can be displayed in a terminal window using the cat command on a Unix-like operating system, and read by a human.  Microsoft Office documents are generally not stored in plain text, and novice users should not attempt keyword substitution on those files.<br /> 
<br /> 
Richard<br /> 
<p style="margin:0px; padding:0px;" > 
         </p> 
<blockquote style="border-left: 1px solid #CCC; padding-left: 5px; margin-left: 5px; margin-bottom: 0px; margin-top: 0px; margin-right: 0px;" type="cite"> 
        <p style="margin:0px; padding:0px;" > 
                <span style="font-family:Verdana"><span style="font-size:12px">----- Original Message -----</span></span></p> 
        <p style="margin:0px; padding:0px;" > 
                <span style="font-family:Verdana"><span style="font-size:12px">From: Walter Klust</span></span></p> 
        <p style="margin:0px; padding:0px;" > 
                <span style="font-family:Verdana"><span style="font-size:12px">Sent: 09/07/12 01:28 AM</span></span></p> 
        <p style="margin:0px; padding:0px;" > 
                <span style="font-family:Verdana"><span style="font-size:12px">To: svnbook-dev@red-bean.com</span></span></p> 
        <p style="margin:0px; padding:0px;" > 
                <span style="font-family:Verdana"><span style="font-size:12px">Subject: Re: [PATCH]: ch03: A note to MS office users regarding keyword substitutions</span></span></p> 
        <br /> 
        <div> 
                <div> 
                        <pre style="white-space: pre-wrap; word-wrap: break-word; font-size:11;pre"> 
Mike, 

My hope was to have an explicit message to the users who manage office documents with svn. They often are not aware of 
the binary nature of their documents and are suprised about the results of the keyword substitution or not aware about 
the dangers. I fear that these users wont probably not recognize that the warning of this added paragraph applies to them. 

regards 

Walter 


On 06.09.2012 16:52, C. Michael Pilato wrote: 
> I'm with Richard on this one.  I've added (in r4299) the following to the end of the summary paragraph about 
> fixed-length keyword substitution: 

>     Of course, where binary file formats are concerned, you must always take great care that any keyword substitution 
>     you introduce--fixed-length or otherwise--does not violate the integrity of that format.  While it might sound easy 
>     enough, this can be an astonishingly difficult task for most of the popular binary file formats in use today, and 
>     /not/ something to be undertaken by the faint of heart! 


> On 09/05/2012 07:58 PM, Richard Cavell wrote: 
>> I like the idea of it but it doesn't need to be so long.  The basic idea is that MS Office documents, and many other 
>> file formats, are complicated and must be parsed properly.  Keyword substitution on something other than a plain-text 
>> file is risky business. 
>> 
>> Richard 
>> 
>>> ----- Original Message ----- 
>>> 
>>> From: Walter Klust 
>>> 
>>> Sent: 09/06/12 12:08 AM 
>>> 
>>> To: svnbook-dev@red-bean.com <mailto:svnbook-dev@red-bean.com> 
>>> 
>>> Subject: [PATCH]: ch03: A note to MS office users regarding keyword substitutions 
>>> 
>>> 
>>> 
>>> Hello, 
>>> 
>>> Please find attached a patch für the chapter about keyword substitutions. It is a specific note for users of MS Office 
>>> who are thinking of using the substitution on their office files. 
>>> 
>>> We had support cases regarding this topic; so I felt it couldnt hurt to add this note to the official documentation. 
>>> 
>>> regards 
>>> 
>>> Walter 
>>> 
>>> -- 
>>> Walter Klust, Director Support 
>>> 
>>> fon +49 30 2345 8696, fax +49 30 2345 8695 
>>> support +49 30 322 971 300 
>>> 
>>> elego Software Solutions GmbH,http://www.elegosoft.com 
>>> Building 12 (BIG), Gustav-Meyer-Allee 25, 13355 Berlin, Germany 
>>> 
>>> Registered Office: Berlin, VAT Reg No: DE 163214194 
>>> Trade Register: District Court Charlottenburg HRB 77719 
>>> Managing Directors: Olaf Wagner, Michael Diers 
>> 
>> 
>> 
>> _______________________________________________ 
>> svnbook-dev mailing list 
>> svnbook-dev@red-bean.com  <mailto:svnbook-dev@red-bean.com> 
>> http://www.red-bean.com/mailman/listinfo/svnbook-dev 



> _______________________________________________ 
> svnbook-dev mailing list 
> svnbook-dev@red-bean.com 
> http://www.red-bean.com/mailman/listinfo/svnbook-dev 


_______________________________________________ 
svnbook-dev mailing list 
svnbook-dev@red-bean.com 
http://www.red-bean.com/mailman/listinfo/svnbook-dev</pre> 
                </div> 
        </div> 
</blockquote> 
<p style="margin:0px; padding:0px;" > 
         </p> 
</span></span>