Re: [Rest2web-develop] Docs revision, "length" removal

[Nicola L. <ni...@te...>]

>>> The docutils spec. seemed to indicate that a trailing (or leading) space
>>> was needed where you break a line. I freely admit to not having tested
>>> this of course !

>> Mmh... I don't remember reading anything of the sort. Docutils seems to
>> like these files just fine. The trailing spaces removal is done
>> automatically by the Kate editor, and is rather handy, since I don't
>> maintain on docs the same, rather nutty, level of white space control I do
>> on code. :-)

> There has been a very recent debate on the 'docutils-users' list about
> this. Where long lines (paragraphs) are broken by newlines - adding an
> implicit space is wrong for character sets (like the Chinese ones) that
> *don't* use spaces to separate words.

Oh, that one, didn't think it was relevant (still don't :-) ).


> David Goodger (docutils lead) thought that docutils didn't and shouldn't
> add an implicit space.

It's well and good.


> I believed him without testing - hence the multitude of single trailing
> spaces.

This is quite a wide jump to conclusions. The spaces docutils does not add
are not needed: HTML converts newlines to spaces anyway.

Didn't you wonder how it could have worked all this time without trailing
spaces? :-)


> (Oh, by the way - apparently O'Reilly are bringing out a book on Twisted.
> I saw via a Daily-Python post).

Yeah, there was an announcement on the Twisted mailing list a few weeks ago.


>> (Those "from ... import *" are ugly!)

> I'm implementing __all__ in all the sub-modules. They're there so you can
> import directly from the ``pythonutils`` namespace.

Oh yes, one of the few legitimate uses of it Silly me. :-)


>> ConfigObj and validate are now ready to be moved back into the trunk, docs
>> included, and to be released, as soon as you're satisfied with the rest of
>> pythonutils, if you prefer releasing them together. I'd separate them,
>> though, I think ConfigObj deserves autonomous distribution.

> Yes - I'll package ConfigObj and validate for release ASAP. 

That's great!


> I'm working towards a Pythonutils release as soon after that as possible.

Will it still include ConfigObj? I suppose not.


> I'd rather be able to move the pythonutils stuff in one go. Really it
> ought to be in it's own repository.

It[no_quote]s ;-) own top directory would be enough.


> Maybe I ought to look at setting up subversion and trac :-)

That's quite a good idea. :-)

-- 
Nicola Larosa - ni...@te...

PHP is such a load of crap, right down to the standard library, that it
creates a culture where it's acceptable to write horrible code. [...]
Maybe with PHP 5 they are trying to clean up the neighborhood, but that
doesn't change the fact when you program in PHP you are programming in
a dump. -- Ian Bicking, July 2005