rest2web-develop — A discussion list for rest2web development.

Re: [Rest2web-develop] Mixing other files in with the HTML generated by rest2web

[Eur I. C. G. <cl...@is...>]

On Wed, Mar 07, 2007 at 09:32:08PM +0000, Michael Foord wrote:
> Eur Ing Chris Green wrote:
> > I'm considering using rest2web for maintaining my personal web of
> > documents and other stuff that I keep on my home linux box.
> >
> > I have been writing some notes in reST already and have been using
> > rst2html.py to convert them to HTML.  Since rest2web can automate this
> > process and add menus etc. it seems like it may help me.
> >
> > However I'm not quite sure how to manage other information and
> > documents like PDF files, I really want to keep this in the same
> > directory hierarchy as the information.  E.g. I have a workshop manual
> > for my motorbike in PDF format and would like to keep this in the
> > motorbike directory along with a couple of HTML files created by
> > res2web.
> >
> > I don't see any clean/easy way to do this, it might be possible by
> > adding lines to the individual restindex sections if the index.txt
> > files but this seems a bit clumsy.  What I really want is for rest2web
> > only to build the files it needs to and to leave the existing
> > directory hierarchy of the output in place.  Or am I confused and it
> > does that already?
> >
> > E.g. if I have a directory somewhere down the output hierarchy called
> > motorbikes and it has a file zzr1200.pdf in it will rest2web delete
> > that file when I run r2w.py or will it only delete/overwrite the HTML
> > files it creates from .txt files?
> >
> >   
> rest2web *never* deletes files from the output directory (except when it 
> has to overwrite them with a newer version).
> 
OK, thanks, excellent!


> Additionally you can use the 'file' keyword in the restindex to copy 
> files from the source directory into the output directory.
> 
Ah, I had seen that but hadn't really understood what it did.


Actually, for my requirements I think it could make sense to have the
start_directory and target_directory set to the same directory. The
idea is to have documentation and notes that I can read as text files
(i.e. the reST format files) and as HTML web pages using the apache
server running on the computer.  The HTML doesn't have to be exported
anywhere.  Will this cause any issues?

-- 
Chris Green

Re: [Rest2web-develop] Any templates/stylesheets 'library' for rest2web?

[Eur I. C. G. <cl...@is...>]

On Wed, Mar 07, 2007 at 09:28:49PM +0000, Michael Foord wrote:
> > Or, alternatively, are there any other web applications whose
> > templates and stylesheets work OK with rest2web?  I'm quite happy to
> > modify/change them a bit but I'd prefer not to have to create the
> > whole thing from scratch.
> >
> >   
> The *best* source I've ever found of free web templates is :
> 
> http://www.oswd.org/designs/browse/
> 
Er, thanks, but how is one meant to find anything useful among over
2000 designs with no sort of classification at all?  :-)


> They should be very easy to modify.
> 
OK, maybe I'll try one or two, I'm a C/C++/Java programmer and find
HTML and CSS a little 'foreign'.  :-)

-- 
Chris Green

Re: [Rest2web-develop] Mixing other files in with the HTML generated by rest2web

[Michael F. <ar...@vo...>]

Eur Ing Chris Green wrote:
> I'm considering using rest2web for maintaining my personal web of
> documents and other stuff that I keep on my home linux box.
>
> I have been writing some notes in reST already and have been using
> rst2html.py to convert them to HTML.  Since rest2web can automate this
> process and add menus etc. it seems like it may help me.
>
> However I'm not quite sure how to manage other information and
> documents like PDF files, I really want to keep this in the same
> directory hierarchy as the information.  E.g. I have a workshop manual
> for my motorbike in PDF format and would like to keep this in the
> motorbike directory along with a couple of HTML files created by
> res2web.
>
> I don't see any clean/easy way to do this, it might be possible by
> adding lines to the individual restindex sections if the index.txt
> files but this seems a bit clumsy.  What I really want is for rest2web
> only to build the files it needs to and to leave the existing
> directory hierarchy of the output in place.  Or am I confused and it
> does that already?
>
> E.g. if I have a directory somewhere down the output hierarchy called
> motorbikes and it has a file zzr1200.pdf in it will rest2web delete
> that file when I run r2w.py or will it only delete/overwrite the HTML
> files it creates from .txt files?
>
>   
rest2web *never* deletes files from the output directory (except when it 
has to overwrite them with a newer version).

Additionally you can use the 'file' keyword in the restindex to copy 
files from the source directory into the output directory.

Fuzzyman
http://www.voidspace.org.uk/python/articles.shtml

Re: [Rest2web-develop] Any templates/stylesheets 'library' for rest2web?

[Michael F. <ar...@vo...>]

Eur Ing Chris Green wrote:
> Well I have arrived here via firedrop2 (well I had considered rest2web
> before due to it's using reST).  For what it's worth I found rest2web
> easier to install on a Linux box than firedrop2 was.
>
> Is there a respository of useful templates and/or stylesheets for
> rest2web anywhere?  In particular I would like a 'fluid' stylesheet
> because I don't really like the default one's "column down the middle"
> appearance.
>
> Or, alternatively, are there any other web applications whose
> templates and stylesheets work OK with rest2web?  I'm quite happy to
> modify/change them a bit but I'd prefer not to have to create the
> whole thing from scratch.
>
>   
The *best* source I've ever found of free web templates is :

http://www.oswd.org/designs/browse/

They should be very easy to modify.

Few users have made rest2web templates public - although I believe I 
have one sitting around somewhere (donated by a user) that when I have 
time will become part of the rest2web distribution.

All the best,


Fuzzyman
http://www.voidspace.org.uk/python/articles.shtml

[Rest2web-develop] Bug#386949: marked as done (rest2web-doc: please include html docs or provide configuration that can build them)

[<ow...@bu...>]

Your message dated Wed, 7 Mar 2007 14:15:25 +0000
with message-id <200...@la...>
and subject line Bug#386949: rest2web-doc: please include html docs or prov=
ide configuration that can build them
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

[Rest2web-develop] Mixing other files in with the HTML generated by rest2web

[Eur I. C. G. <cl...@is...>]

I'm considering using rest2web for maintaining my personal web of
documents and other stuff that I keep on my home linux box.

I have been writing some notes in reST already and have been using
rst2html.py to convert them to HTML.  Since rest2web can automate this
process and add menus etc. it seems like it may help me.

However I'm not quite sure how to manage other information and
documents like PDF files, I really want to keep this in the same
directory hierarchy as the information.  E.g. I have a workshop manual
for my motorbike in PDF format and would like to keep this in the
motorbike directory along with a couple of HTML files created by
res2web.

I don't see any clean/easy way to do this, it might be possible by
adding lines to the individual restindex sections if the index.txt
files but this seems a bit clumsy.  What I really want is for rest2web
only to build the files it needs to and to leave the existing
directory hierarchy of the output in place.  Or am I confused and it
does that already?

E.g. if I have a directory somewhere down the output hierarchy called
motorbikes and it has a file zzr1200.pdf in it will rest2web delete
that file when I run r2w.py or will it only delete/overwrite the HTML
files it creates from .txt files?

-- 
Chris Green

[Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[martin f k. <ma...@de...>]

Version: 0.5.0.svn-r227-1

This bug has been fixed in the current version.

--=20
 .''`.   martin f. krafft <ma...@de...>
: :'  :  proud Debian developer, author, administrator, and user
`. `'`   http://people.debian.org/~madduck - http://debiansystem.info
  `-  Debian - when you have better things to do than fixing systems

[Rest2web-develop] Any templates/stylesheets 'library' for rest2web?

[Eur I. C. G. <cl...@is...>]

Well I have arrived here via firedrop2 (well I had considered rest2web
before due to it's using reST).  For what it's worth I found rest2web
easier to install on a Linux box than firedrop2 was.

Is there a respository of useful templates and/or stylesheets for
rest2web anywhere?  In particular I would like a 'fluid' stylesheet
because I don't really like the default one's "column down the middle"
appearance.

Or, alternatively, are there any other web applications whose
templates and stylesheets work OK with rest2web?  I'm quite happy to
modify/change them a bit but I'd prefer not to have to create the
whole thing from scratch.

-- 
Chris Green

Re: [Rest2web-develop] Common links

[Michael F. <fuz...@vo...>]

martin f krafft wrote:
> also sprach Max Belugin <mbe...@gm...> [2007.01.31.1426 +0000]:
>   
>> .. _Python: http://www.python.org/
>>
>> on every page but keep them in centralized place instead?
>>     
>
> Use includes:
>
> .. include:: common.inc
>
> This can go at the bottom of each file.
>
>   
Cool- thanks.

Fuzzyman
http://www.voidspace.org.uk/python/articles.shtml

> ------------------------------------------------------------------------
>
> -------------------------------------------------------------------------
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to share your
> opinions on IT & business topics through brief surveys - and earn cash
> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
> ------------------------------------------------------------------------
>
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   

Re: [Rest2web-develop] Common links

[martin f k. <ma...@ma...>]

also sprach Max Belugin <mbe...@gm...> [2007.01.31.1426 +0000]:
> .. _Python: http://www.python.org/
>=20
> on every page but keep them in centralized place instead?

Use includes:

=2E. include:: common.inc

This can go at the bottom of each file.

--=20
martin;              (greetings from the heart of the sun.)
  \____ echo mailto: !#^."<*>"|tr "<*> mailto:" net@madduck
=20
spamtraps: mad...@ma...
=20
"it is easier to be a lover than a husband for the simple reason
 that it is more difficult to be witty every day
 than to say pretty things from time to time."
                                                   -- honor=E9 de balzac

Re: [Rest2web-develop] Common links

[Michael F. <fuz...@vo...>]

Max Belugin wrote:
> Is it possible not to repeat link definitions like
>
> .. _Python: http://www.python.org/
>
> on every page but keep them in centralized place instead?
>
>   
Yep, I'd like to add that.

I came to implement it once and realised it wasn't trivially easy 
(although probably not very difficult).

I haven't revisited the problem since.

:-)

Fuzzyman
http://www.voidspace.org.uk/python/articles.shtml

[Rest2web-develop] Common links

[Max B. <mbe...@gm...>]

Is it possible not to repeat link definitions like

.. _Python: http://www.python.org/

on every page but keep them in centralized place instead?


-- 
Max Belugin, http://belugin.info , ICQ:9406811

Re: [Rest2web-develop] How to use custom macro in template files ?

[David C. <da...@ar...>]

David Cournapeau wrote:
> Michael Foord wrote:
>> David Cournapeau wrote:
>>> Hi there,
>>>
>>>     I am using rest2web for my own website, and it is working great, but 
>>> I have one problem. I would like to use my own python functions in the 
>>> templates, and I don't know how to do that. I manage to use my macro in 
>>> a index file doing {print_hello}, but I cannot make it work in a 
>>> template.txt (using <# print_hello() #>). 
>> This should work. You should either import or define the function in the 
>> template. 
> What do you mean by import ? The problem really seems to be related to 
> being able to add my function in the "template's namespace".
Ok, the solution is so obvious I feel a bit embarassed... I just have to 
import the module where the macro are defined; it is just standard python.

David

Re: [Rest2web-develop] How to use custom macro in template files ?

[David C. <da...@ar...>]

Michael Foord wrote:
> David Cournapeau wrote:
>> Hi there,
>>
>>     I am using rest2web for my own website, and it is working great, but 
>> I have one problem. I would like to use my own python functions in the 
>> templates, and I don't know how to do that. I manage to use my macro in 
>> a index file doing {print_hello}, but I cannot make it work in a 
>> template.txt (using <# print_hello() #>). 
> This should work. You should either import or define the function in the 
> template. 
What do you mean by import ? The problem really seems to be related to 
being able to add my function in the "template's namespace".
> <#
>   def print_hello():
>        print 'hello'
>   print_hello()
> #>
This works without any problem. What I don't manage to get working is to 
define the print_hello in my macro file, and use it in the template: I 
have the print_hello in a macro file, the macro is set in my .ini file, 
I can use the function in index.txt, but in template.txt, I got a 
NameError: name 'print_hello' is not defined.


cheers,

David

Re: [Rest2web-develop] How to use custom macro in template files ?

[Michael F. <fuz...@vo...>]

David Cournapeau wrote:
> Hi there,
>
>     I am using rest2web for my own website, and it is working great, but 
> I have one problem. I would like to use my own python functions in the 
> templates, and I don't know how to do that. I manage to use my macro in 
> a index file doing {print_hello}, but I cannot make it work in a 
> template.txt (using <# print_hello() #>). 
This should work. You should either import or define the function in the 
template. The function needs to print its output rather than simply 
return it (unless you use <% print_hello() %>).

Try something like:

<#
  def print_hello():
       print 'hello'
  print_hello()
#>

Fuzzyman
http://www.voidspace.org.uk/python/articles.shtml

> I thought about adding it in 
> the namespace using uservalues:
>
>     [uservalues]
>     foo = print_hello
>
> But print_hello is transformer into a string before the template is 
> processed. So how can I use my own python function in a template file ?
>
>     Thanks,
>
>     David
>
> -------------------------------------------------------------------------
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to share your
> opinions on IT & business topics through brief surveys - and earn cash
> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>
>   

[Rest2web-develop] How to use custom macro in template files ?

[David C. <da...@ar...>]

Hi there,

    I am using rest2web for my own website, and it is working great, but 
I have one problem. I would like to use my own python functions in the 
templates, and I don't know how to do that. I manage to use my macro in 
a index file doing {print_hello}, but I cannot make it work in a 
template.txt (using <# print_hello() #>). I thought about adding it in 
the namespace using uservalues:

    [uservalues]
    foo = print_hello

But print_hello is transformer into a string before the template is 
processed. So how can I use my own python function in a template file ?

    Thanks,

    David

Re: [Rest2web-develop] Sort in indextree

[Gael V. <gae...@no...>]

On Mon, Jan 01, 2007 at 11:47:28PM +0000, Michael Foord wrote:
> So your patch just allows the passing in of a comparison function to th=
e=20
> sidebar function.

> If a comparison function is passed in, it is used to sort the pages.

Yes, simple, but useful.

> It sounds fine. Can you give me an example function I can put in the do=
cs ?

Well, how about this (adapted from the sidebar example): sorting by crumb
value, inverse order.

    .. raw:: html
   =20
        {+coloring}
       =20
	cmp_page =3D lambda page1, page2 : 2*(page1['crumb'] < page2['crumb'] ) =
- 1

        for page in sidebar(indextree, cmp=3Dcmp_page):
            val =3D page['crumb']
            link =3D page['target']
            if page['title']:
                print '<br /><strong><a href=3D"%s">%s</a></strong>' \
                % (link, val)=20
            else:
                print '<br /><a href=3D"%s">%s</a>' % (link, val)
       =20
        {-coloring}

But this allows for much more powerful uses (like having a "date"
uservalue, and sorting by date).

Cheers,

Ga=EBl

Re: [Rest2web-develop] Sort in indextree

[Michael F. <fuz...@vo...>]

Gael Varoquaux wrote:
> Hi all,
> 
> and happy new year !
> 
> I have made a small modification to "indextree" to allow for sorting the
> nodes of the same depth. This simply add a "cmp" keyword argument that
> acts exactly as in list sorting (well, actually it is implemented using
> list sorting). The patch is trivial and I find this very useful. I am
> sending it along and proposing it for inclusion.
> 

So your patch just allows the passing in of a comparison function to the 
sidebar function.

If a comparison function is passed in, it is used to sort the pages.

It sounds fine. Can you give me an example function I can put in the docs ?

Thanks (and happy new year).

Michael
http://www.voidspace.org.uk/python/articles.shtml


> Cheers,
> 
> Gaël
> 
> 

[Rest2web-develop] Sort in indextree

[Gael V. <gae...@no...>]

Hi all,

and happy new year !

I have made a small modification to "indextree" to allow for sorting the
nodes of the same depth. This simply add a "cmp" keyword argument that
acts exactly as in list sorting (well, actually it is implemented using
list sorting). The patch is trivial and I find this very useful. I am
sending it along and proposing it for inclusion.

Cheers,

Ga=EBl

[Rest2web-develop] rest2web 0.5.1

[<fuz...@vo...>]

No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.409 / Virus Database: 268.15.24/592 - Release Date: 18/12/2006
=

Re: [Rest2web-develop] disabling promotion of top-level section to title

[Michael F. <ar...@vo...>]

Steven Bethard wrote:
> On 12/10/06, Michael Foord <mi...@vo...> wrote:
>> Steven Bethard wrote:
>> > How can I disable the promotion of the top-level section to a title?
> [snip]
>> However... how about this :
>>
>> If you set an explicit page title, then rest2web will switch off
>> promotion to title ?
>
> That would be great.  That's pretty much what I was hoping for.
I've just checked this change into subversion.

It is not enabled by default because with rest2web you should always 
pass in an explicit 'page-title' for index pages. Having this enabled by 
default would change the behaviour unexpectedly.

There is a new config file option 'promote_headers' which defaults to 
True. Set this to False in your config file to prevent the automatic 
promotion of section headers to a title.

I'm preparing a new release which will be out soon...

Fuzzyman
http://www.voidspace.org.uk/index2.shtml
>
> Steve



-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.409 / Virus Database: 268.15.21/589 - Release Date: 15/12/2006

Re: [Rest2web-develop] disabling promotion of top-level section to title

[Michael F. <fuz...@vo...>]

Steven Bethard wrote:
> How can I disable the promotion of the top-level section to a title?
> That is, I'm giving rest2html a file like::
>
>   
Currently there is no way to pass options to docutils from individual pages.

At some point I would like to add this.

However... how about this :

If you set an explicit page title, then rest2web will switch off 
promotion to title ?

This sounds fairly logical and should be easy for me to implement.

Fuzzyman


>     restindex
>         crumb: Crumb
>         page-title: My Page Title
>     /restindex
>
>     Header
>     ======
>
>     Sub-section
>     -----------
>
> and rest2html is outputting a document structure like::
>
>     <h1 class="title">Header</h1>
>     <div class="section">
>         <h1>
>             <a id="sub-section" name="sub-section">Sub-section</a>
>         </h1>
>     </div>
>
> Note that the "Header" got interpreted as a "title" and therefore the
> "Sub-section" is still given "h1" instead of "h2".
>
> I gather this is because of docutils, but I couldn't figure out how to
> make rest2html use the appropriate "doctitle_xform" from the Docutils
> Configuration:
>
>     http://docutils.sourceforge.net/docs/user/config.html#configuration-files
>
> I tried putting the following docutils.conf in the directory from
> which I'm running r2w.py and setting the DOCUTILSCONFIG environment
> variable to the same directory, but with no luck::
>
>     [standalone reader]
>     doctitle_xform = 0
>
> Steve
>   

[Rest2web-develop] disabling promotion of top-level section to title

[Steven B. <ste...@gm...>]

How can I disable the promotion of the top-level section to a title?
That is, I'm giving rest2html a file like::

    restindex
        crumb: Crumb
        page-title: My Page Title
    /restindex

    Header
    ======

    Sub-section
    -----------

and rest2html is outputting a document structure like::

    <h1 class="title">Header</h1>
    <div class="section">
        <h1>
            <a id="sub-section" name="sub-section">Sub-section</a>
        </h1>
    </div>

Note that the "Header" got interpreted as a "title" and therefore the
"Sub-section" is still given "h1" instead of "h2".

I gather this is because of docutils, but I couldn't figure out how to
make rest2html use the appropriate "doctitle_xform" from the Docutils
Configuration:

    http://docutils.sourceforge.net/docs/user/config.html#configuration-files

I tried putting the following docutils.conf in the directory from
which I'm running r2w.py and setting the DOCUTILSCONFIG environment
variable to the same directory, but with no luck::

    [standalone reader]
    doctitle_xform = 0

Steve
-- 
I'm not *in*-sane. Indeed, I am so far *out* of sane that you appear a
tiny blip on the distant coast of sanity.
        --- Bucky Katt, Get Fuzzy

Re: [Rest2web-develop] Problem with keywords in python source

[Michael F. <fuz...@vo...>]

Grzegorz Adam Hankiewicz wrote:
> On 2006-12-06, Michael Foord <fuz...@vo...> wrote:
>> Grzegorz Adam Hankiewicz wrote:
>>> Looking at the culprit, it is the expanded svn keyword
>>> LastChangedDate which expands on my sistem to "2006-10-11 00:50:49
>>> +0200 (mié, 11 oct 2006)".
>> Aargh... :-)
>>
>> Hmmm... I find these useful. It is useful to be able to look at
>> a file and see when it was last changed and by whom. Can I change
>> this to a different date format that doesn't screw you up ?
> 
> AFAICS you can't fix the problem because it is a client side problem.
> The same would happen with the Id keyword, since that puts the name of
> the file. On my system this disallows me to use the
> keyword in an ascii python script if I decided to rename the file to
> something using 8-bit characters, or just utf-8, that would again creep
> into the source, making it invalid.
> 
> And while you may not find it necessary for rest2web, I can tell you
> keywords are a pain in the ass just for making patches between development
> branches. Also at some point a coworker wanted to write a verification tool to
> make sure that the svn import from cvs was good, and he couldn't because
> keywords screwed up the md5sum: they even get expanded in different ways
> depending on your locale, cvs version and conversion switches.
> 
> I suggested on the mailing lists for keywords to always expand to english
> words, which is also fair since the keywords themselves are only available
> in English, but svn developers are just too overwhelmed with work to
> care about little details.
> 
>   http://svn.haxx.se/users/archive-2005-06/1306.shtml
> 
> I myself see the easy solution: keywords should just burn in hell. Any
> feature of a source control system that modifies the source in a
> non-deterministic way is just wrong, because you stop controlling
> the source.
> 
> Anyway it doesn't bother me, I can always add the encoding myself or
> remove the line, svn won't put it back for me in future updates.
> 

Ok - understood, and thanks.

If it becomes a problem for anyone else I will remove the date keywords.

Fuzzyman
http://www.voidspace.org.uk/python/weblog/index.shtml

> -------------------------------------------------------------------------
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to share your
> opinions on IT & business topics through brief surveys - and earn cash
> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
> 
> 



-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.409 / Virus Database: 268.15.14/578 - Release Date: 07/12/2006

Re: [Rest2web-develop] Problem with keywords in python source

[Grzegorz A. H. <gr...@ti...>]

On 2006-12-06, Michael Foord <fuz...@vo...> wrote:
> Grzegorz Adam Hankiewicz wrote:
> > Looking at the culprit, it is the expanded svn keyword
> > LastChangedDate which expands on my sistem to "2006-10-11 00:50:49
> > +0200 (mi=C3=A9, 11 oct 2006)".
>
> Aargh... :-)
>
> Hmmm... I find these useful. It is useful to be able to look at
> a file and see when it was last changed and by whom. Can I change
> this to a different date format that doesn't screw you up ?

AFAICS you can't fix the problem because it is a client side problem.
The same would happen with the Id keyword, since that puts the name of
the file. On my system this disallows me to use the
keyword in an ascii python script if I decided to rename the file to
something using 8-bit characters, or just utf-8, that would again creep
into the source, making it invalid.

And while you may not find it necessary for rest2web, I can tell you
keywords are a pain in the ass just for making patches between developmen=
t
branches. Also at some point a coworker wanted to write a verification to=
ol to
make sure that the svn import from cvs was good, and he couldn't because
keywords screwed up the md5sum: they even get expanded in different ways
depending on your locale, cvs version and conversion switches.

I suggested on the mailing lists for keywords to always expand to english
words, which is also fair since the keywords themselves are only availabl=
e
in English, but svn developers are just too overwhelmed with work to
care about little details.

  http://svn.haxx.se/users/archive-2005-06/1306.shtml

I myself see the easy solution: keywords should just burn in hell. Any
feature of a source control system that modifies the source in a
non-deterministic way is just wrong, because you stop controlling
the source.

Anyway it doesn't bother me, I can always add the encoding myself or
remove the line, svn won't put it back for me in future updates.