Re: Python documentation moronicities (continued)

2005-04-26 Thread Steve Holden
Peter Hansen wrote: Steve Holden wrote: I still await the specified five emails preferring your version to the current documentation. So, for the record Steve, how many of those emails have you received to date? (And how many from *anyone*, not just regulars, proclaiming Xah's version better?) -

Re: Python documentation moronicities (continued)

2005-04-26 Thread Ivan Van Laningham
Hi All-- Richie Hindle wrote: > > Xah is right - I have a copy here of his message of 18th April, saying "i > have rewrote the Python's re module documentation.". > Which announcement alone I take as evidence sufficient unto itself. I shall not be reading the "rewrote" documentation. Metta, I

Re: Python documentation moronicities (continued)

2005-04-26 Thread Peter Hansen
Steve Holden wrote: I still await the specified five emails preferring your version to the current documentation. So, for the record Steve, how many of those emails have you received to date? (And how many from *anyone*, not just regulars, proclaiming Xah's version better?) -Peter -- http://mail.

Re: Python documentation moronicities (continued)

2005-04-26 Thread Brian Quinlan
I think that there are some nice ideas in the new version e.g. "Regex functions" is a nicer title than "Module contents", examples, caveats. But there are some organizational problems and the actual writting is a bit weak. Cheers, Brian -- http://mail.python.org/mailman/listinfo/python-list

Re: Python documentation moronicities (continued)

2005-04-26 Thread Mike Meyer
"Claudio Grondi" <[EMAIL PROTECTED]> writes: > From my point of view both, the existing and > the proposed documentation assume some > knowledge about regular expressions as > such, so doesn't really explain, beeing > limited to showing the syntax of usage. It's not clear that this belongs in the

Re: Python documentation moronicities (continued)

2005-04-26 Thread Richie Hindle
[Xah] > I have produced my doc. > ( http://xahlee.org/perl-python/python_re-write/lib/module-re.html ) > > isn't there a hundred dollars due to me? I don't have the time to write a full review of your version, but for the record I've compared it with the original and I don't think it's a signifi

Re: Python documentation moronicities (continued)

2005-04-26 Thread Claudio Grondi
Conclusion: --- I agree with Bill Mill saying "I'd suggest that he [Xah Lee] actually make an effort at improving the docs before submitting them." so I am still waiting for the final version before deciding which docu is better, believing, that if Xah Lee puts more work and serious eff

Re: Python documentation moronicities (continued)

2005-04-25 Thread Steve Holden
Xah Lee wrote: Dear Steve Holden, the rewrite of the regex doc is instigated by your offer. it is published and announced here on April 18th. I'll have to take your word for that. If you deem it proper, paypal me. It will be to your credit and easier to incorporate into the main doc. I still await

Re: Python documentation moronicities (continued)

2005-04-25 Thread Xah Lee
Dear Steve Holden, the rewrite of the regex doc is instigated by your offer. it is published and announced here on April 18th. If you deem it proper, paypal me. It will be to your credit and easier to incorporate into the main doc. Xah [EMAIL PROTECTED] â http://xahlee.org/ -- http://mail.pyt

Re: Python documentation moronicities (continued)

2005-04-25 Thread Steve Holden
Robert Kern wrote: Xah Lee wrote: I have produced my doc. ( http://xahlee.org/perl-python/python_re-write/lib/module-re.html ) isn't there a hundred dollars due to me? No. [Steve Holden] The condition for winning the prize is that at least five regular posters to c.l.py have to mail me and saythey

Re: Python documentation moronicities (continued)

2005-04-25 Thread Robert Kern
Xah Lee wrote: I have produced my doc. ( http://xahlee.org/perl-python/python_re-write/lib/module-re.html ) isn't there a hundred dollars due to me? No. [Steve Holden] The condition for winning the prize is that at least five regular posters to c.l.py have to mail me and saythey think your version

Re: Python documentation moronicities (continued)

2005-04-25 Thread James Stroud
On Monday 25 April 2005 11:48 am, so sayeth Xah Lee: > I have produced my doc. > ( http://xahlee.org/perl-python/python_re-write/lib/module-re.html ) > > isn't there a hundred dollars due to me? > Yes, we have put it in an envelop that is sitting between the dumpster and the Dairy Queen in Dalhart

Re: Python documentation moronicities (continued)

2005-04-25 Thread Xah Lee
I have produced my doc. ( http://xahlee.org/perl-python/python_re-write/lib/module-re.html ) isn't there a hundred dollars due to me? Xah [EMAIL PROTECTED] â http://xahlee.org/PageTwo_dir/more.html Steve Holden wrote: > Xah Lee wrote: > [mountains of irrelevant drivel which normal people woul

Re: Python documentation moronicities (continued)

2005-04-13 Thread Steve Holden
runes wrote: Steve, thank you for givig me those links. I'll go there if I manage to structure an improvement suggestion. RTFM :-) [The links came from the documentation] And about the link to the Howto: I suppose many people don't read the manual from a to z but with a particular problem in mind.

Re: Python documentation moronicities (continued)

2005-04-13 Thread runes
Steve, thank you for givig me those links. I'll go there if I manage to structure an improvement suggestion. And about the link to the Howto: I suppose many people don't read the manual from a to z but with a particular problem in mind. Hence the link could ble locateded several places, perhaps re

Re: Python documentation moronicities (continued)

2005-04-13 Thread rbt
runes wrote: Generally: I have got my experiences with the Python Manual over the the last 30 months Python beeing my preferred language. One of them is that I have to look elsewhere. I've gotten great help from this newsgroup. By following these steps: 1. Read the docs at http://docs.python.org/mo

Re: Python documentation moronicities (continued)

2005-04-13 Thread Steve Holden
runes wrote: Seems like criticising the manual is som kind of heresy. So be it. Don't think so, but this being open source I suspect that Fredrik was trying to get them improved. You know, the Re documentation contains many pages. Ufortunately I didn't dwell with the first introductory paragraph

Re: Python documentation moronicities (continued)

2005-04-13 Thread runes
Seems like criticising the manual is som kind of heresy. So be it. You know, the Re documentation contains many pages. Ufortunately I didn't dwell with the first introductory paragraph, I was trying to solve a particular problem. I'm not that used to looking for links to external sources in the m

Re: Python documentation moronicities (continued)

2005-04-13 Thread Fredrik Lundh
"runes" <[EMAIL PROTECTED]> wrote: > I found the Howto through Google. Somehow I didn't see that link in the > documentation. > > And please do not make any assumptions about my reading of manuals. if you were unable to find a link in the documentation you were reading, can you perhaps suggest a

Re: Python documentation moronicities (continued)

2005-04-12 Thread peufeu
I sympathize with you and also think there should be an "add comment" in the Python documentation website, so that users could post their code snippets in the relevant places. I found the Howto through Google. Somehow I didn't see that link in the documentation. And please do not make any as

Re: Python documentation moronicities (continued)

2005-04-12 Thread runes
Thank you for being so friendly! I found the Howto through Google. Somehow I didn't see that link in the documentation. And please do not make any assumptions about my reading of manuals. -- http://mail.python.org/mailman/listinfo/python-list

Re: Python documentation moronicities (continued)

2005-04-12 Thread John Machin
On 12 Apr 2005 15:06:30 -0700, "runes" <[EMAIL PROTECTED]> wrote: >Luckily I found this regex howto: >http://www.amk.ca/python/howto/regex/ and that helped a lot. Luckily??? AMK's howto is pointed to by the 3rd paragraph of Section 4.2.1 of the documentation that you are dissing: """ A brief ex

Re: Python documentation moronicities (continued)

2005-04-12 Thread runes
> why cannot this piece of shit writing give a single example of usage? Actually, I can understand your frustration even if you should enhance your vocabulary slightly. I often struggle with the Python documnetation myself and I can't understand why a couple of examples are so hard to give. When