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

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

>> Completed revising configobj.txt, committed it in two steps: in the first
>> one there's only trailing spaces removal, the real changes are in the

> 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. :-)


>> second one. This way it may be easier reviewing the changes. Now I'm
>> looking at validate.txt .

> Great - are you making big changes ?

Many small changes, mostly.


> I made a few changes myself - but they should be easy enough to merge.
> 
> Nice one - thanks.
> 
> As I mention in my other email - I've been working on the other
> pythonutils modules and their docs.

Not enough time to work on those too, at the moment. :-(


>> What do you think?

> Ok - fine with me. Just do appropriate changes in docstrings/docs. I'm
> sure you would have anyway.

Of course. Made the changes to code, docstrings and docs, and committed:
"length" is no more. :-) I also removed a leftover caseless import in
__init__.py . (Those "from ... import *" are ugly!)

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.

BTW, validate.py in the branch is long more than double the one in the
trunk, because of all those doctests. Instead, configobj.py in the branch
is *shorter* than the one in the trunk (v.3), *despite* all the added
doctests, which is remarkable. :-)

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