On Apr 1, 10:42 am, Terry Brown <[EMAIL PROTECTED]> wrote:

> I don't see how anything can let you code against an API as fast as up
> to date, complete, and accurate documentation does.

I agree.  But we don't have that with distutils.

The transformation in my attitude is that I can do something besides
bemoan my fate.

It's now fairly clear why python setup.py install is not working at
all: the 'install' code is ignoring the manifest, at least when I
specify a package explicitly, which I assumed I had to do...

Now, after stepping through the code a few times, I have a much better
feel for what the code is intending to do.  I can return to the
sources to look for clues.  My first guess is that the atrociously-
documented options are the place to start looking for relief.  Rather
than read the worse-than-useless docs, I plan to read the actual code.

In other words, there is now a three-way interaction between debugger
info, source info, and docs.  In this case, the docs appear to be
actively misleading, but that still leaves two fruitful avenues for
action.

In short, a horrid chore has been transformed to a fun game.

Edward

P.S. The docs say it is possible to set os.environ['DISTUTILS_DEBUG']
= 'any-non-empty-string' in order to enable debugging.  In fact,
setting os.environ is non-trivial.  See: 
http://docs.python.org/lib/os-procinfo.html

So I just set DEBUG = True in debug.py. Once again, we avoid actively
bad code/docs.  This is the only change I'm like to make to the
code :-)

P.P.S: I just stumbled across http://docs.python.org/dist/setup-config.html

About as clear as mud, but it does indicate the kinds of args that
might have to be set.  So there will be an interplay between this
page, the code, and the debugger.

P.P.S: In short, with a debugger-based attitude, even wretched docs
become clues :-)  Do you see why I am excited?

EKR
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/leo-editor?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to