Re: python doc available in emacs info format?

2009-08-19 Thread Nathan Keel
A.Politz wrote: > On Aug 17, 6:43 am, Xah Lee wrote: >> btw, is there still [no] info format for python doc? >> >> i feel kinda sad [...] >> Part of this is due to [other peoples fault] > > Someone started a rst2info project (google it), maybe you want to help > this guy out. > > Though, he mig

Re: python doc available in emacs info format?

2009-08-19 Thread A.Politz
On Aug 17, 6:43 am, Xah Lee wrote: > btw, is there still [no] info format for python doc? > > i feel kinda sad [...] > Part of this is due to [other peoples fault] Someone started a rst2info project (google it), maybe you want to help this guy out. Though, he might be a techgeeker, so watch out

Re: python doc available in emacs info format?

2009-08-17 Thread Xah Lee
> Please do not slag off a project if you want people to help; > it tends to put the goat up. a healthy community needs both positive comment as well as negative to grow. emacs's user base has been rotting off from i estimate more than 50% of programers to less that 1% today. the particular obse

Re: python doc available in emacs info format?

2009-08-17 Thread Bruce Stephens
"Colin S. Miller" writes: [...] > Ubuntu maintains a package search site, it is on > http://packages.ubuntu.com/ > > However, there seems to be no files named > python.*info (regexp) And yet there are info files in python2.5-doc: .

Re: python doc available in emacs info format?

2009-08-17 Thread Colin S. Miller
Xah Lee wrote: btw, is there still info format for python doc? i feel kinda sad that emacs info format has pretty much been deprecated over the past decade. About a decade ago, you still will see now and then people asking for emacs info format of docs (was the days of perl). Today, one don't he

Re: python doc available in emacs info format?

2009-08-17 Thread Xah Lee
info format for Xah Lee writes: > in programing elisp in emacs, i can press “Ctrl+h f” to lookup > the doc for the function under cursor. is there such facility > when coding in perl, python, php? On Dec 11 2008, 6:56 am, Matthias wrote: > Yes, try C-h S (or similarly S): > (info-looku

Re: Python Doc 2.6 vs 2.5--A Matter of Format?

2009-01-31 Thread Martin v. Löwis
> I see for 2.5 and > for 2.6. I'm guessing these two pages differ > somewhat in formats simply because someone decided to do so, and not > that I'm in the wrong place for each of the two versions, correct? Correct. The documentation forma

Re: Python Doc 2.6 vs 2.5--A Matter of Format?

2009-01-31 Thread Stephen Hansen
On Sat, Jan 31, 2009 at 9:14 AM, W. eWatson wrote:I see for 2.5 and for 2.6. I'm guessing these two pages differ somewhat in formats simply because someone decided to do so, and not that I'm in the wrong place for each of the two versions,

Re: python doc in command line

2008-07-16 Thread Ben Finney
Peng Yu <[EMAIL PROTECTED]> writes: > Perl has a command line help perldoc. I'm wondering if python has a > similar help command. The interactive interpreter has a "help" command, and a corresponding "help" function which can be passed an object to display its docstrings recursively and nicely-fo

Re: python doc in command line

2008-07-16 Thread Fredrik Lundh
Peng Yu wrote: Perl has a command line help perldoc. I'm wondering if python has a similar help command. it's built into the interpreter, and Python tells you how to use it when you start Python in interactive mode. $ python Python 2.5.1 Type "help", "copyright", "credits" or "license" for

Re: python-doc

2008-04-23 Thread Gabriel Genellina
En Wed, 23 Apr 2008 11:02:46 -0300, korean_dave <[EMAIL PROTECTED]> escribió: Hi all. I am using this to try to document my python-coded apps. http://effbot [DOT] org/zone/pythondoc [DOT] htm i am using windows XP professional. I have put the install directory of pythondoc.py in my path file.

Re: Python doc problem example: gzip module (reprise)

2005-11-09 Thread Jeffrey Schwab
Mike Meyer wrote: > "Xah Lee" <[EMAIL PROTECTED]> writes: > > >>Newsgroups: comp.lang.perl.misc >>PS: I won't cross-post as I'm not subscribed to the Python group. > > > Very wisely done. Then from Xah Lee, we get; > > >>I have cross posted it for you. > > > Proving once again that he's stu

Re: Python doc problem example: gzip module (reprise)

2005-11-08 Thread Mike Meyer
"Xah Lee" <[EMAIL PROTECTED]> writes: > Newsgroups: comp.lang.perl.misc > PS: I won't cross-post as I'm not subscribed to the Python group. Very wisely done. Then from Xah Lee, we get; > I have cross posted it for you. Proving once again that he's stupider than spam. Please help google find him

Re: Python doc problem example: gzip module (reprise)

2005-11-08 Thread Xah Lee
Newsgroups: comp.lang.perl.misc From: "Veli-Pekka Tätilä" Date: Sat, 5 Nov 2005 17:25:35 +0200 Subject: Re: Python doc problem example: gzip module (reprise) Xah Lee wrote: > Today i need to use Python to compress/decompress gzip files. > However, scanning the doc after 20 se

Re: Python doc problem example: gzip module (reprise)

2005-11-07 Thread jmdeschamps
(gulp! red-in-the-face) yes Steve, I meant "gist", sorry if I offended anyone, specially Fredrik since I was referring to the 'substance' of his post...certainly not as if it were a 'joke' . Jean-Marc -- http://mail.python.org/mailman/listinfo/python-list

Re: Python doc problem example: gzip module (reprise)

2005-11-06 Thread Keith Thompson
Rick Wotnaz <[EMAIL PROTECTED]> writes: [snip] > I've managed to avoid reading Xah Lee's diatribes for the most > part. Since you included the *WHOLE THING* in your post, I had an > "opportunity" to see what he had to say, and for once I agree with > some of it. That's fine, but if you're going

Re: Python doc problem example: gzip module (reprise)

2005-11-06 Thread Steven D'Aprano
On Sun, 06 Nov 2005 04:28:35 -0800, jmdeschamps wrote: > This actually brings us back to the jest of F. previous post, I didn't think it was very funny... Unless you meant the *gist* of Fredrik's post. -- Steven. -- http://mail.python.org/mailman/listinfo/python-list

Re: Python doc problem example: gzip module (reprise)

2005-11-06 Thread jmdeschamps
Sorry but I take exception on this subject. I still think Fredrik's Intro to Tkinter is still more usable ... Grayson's book uses PMW extensively, and a lot is about specific widgets of that library. This actually brings us back to the jest of F. previous post, that documentation is question of mu

Re: Python doc problem example: gzip module (reprise)

2005-11-06 Thread Bengt Richter
On 05 Nov 2005 19:19:29 -0800, Paul Rubin wrote: >Mike Meyer <[EMAIL PROTECTED]> writes: >> > It's only -because- of those licenses that there's any reason not to >> > bundle. >> >> Actually, there are other reasons, just as there are reasons besides >> licensing for no

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Mike Meyer
Paul Rubin writes: > Mike Meyer <[EMAIL PROTECTED]> writes: >> > It's only -because- of those licenses that there's any reason not to >> > bundle. >> Actually, there are other reasons, just as there are reasons besides >> licensing for not simply including third party lib

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Paul Rubin
Mike Meyer <[EMAIL PROTECTED]> writes: > > It's only -because- of those licenses that there's any reason not to > > bundle. > > Actually, there are other reasons, just as there are reasons besides > licensing for not simply including third party libraries into the > standard library. I'm not talk

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Mike Meyer
Paul Rubin writes: >> To my knowledge the PSF isn't doing anything about including the >> documentation with their distribution, so they shouldn't care about >> the licenses. Wanting to bundle a good tutorial for everything in >> the library might be on the list, but the

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Paul Rubin
Mike Meyer <[EMAIL PROTECTED]> writes: > To my knowledge the PSF isn't doing anything about including the > documentation with their distribution, so they shouldn't care about > the licenses. Wanting to bundle a good tutorial for everything in > the library might be on the list, but the licenses on

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Mike Meyer
Paul Rubin writes: > Mike Meyer <[EMAIL PROTECTED]> writes: >> The thing is, the library documentation that Xah Lee is complaining >> about is a *reference document*. It says so right in the title: >> "Python Library Reference". As such, it makes lousy tutorial >> documen

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Paul Rubin
Mike Meyer <[EMAIL PROTECTED]> writes: > The thing is, the library documentation that Xah Lee is complaining > about is a *reference document*. It says so right in the title: > "Python Library Reference". As such, it makes lousy tutorial > documentation. I'm not sure which particular library Xah L

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Mike Meyer
"Andrea Gavana" <[EMAIL PROTECTED]> writes: > I tend to agree with you, Rick. I usually don't like Xah's "posting > behavior", but this time he has done, in my opinion, a "constructive" > criticism (and he didn't even say *fuck* once in the whole post!!!). I am > quite a newbie in Python, I usuall

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Andrea Gavana
Hello NG, > I've managed to avoid reading Xah Lee's diatribes for the most > part. Since you included the *WHOLE THING* in your post, I had an > "opportunity" to see what he had to say, and for once I agree with > some of it. > I would love to see examples for essentially every function and > m

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Charlton Wilbur
> "RW" == Rick Wotnaz <[EMAIL PROTECTED]> writes: RW> Someone is sure to jump in now and point to sample code, which RW> nearly all reasonably major packages include. That's good RW> stuff. With (for example) wxPython, it's the only useful RW> documentation, or rather, it's th

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Peter Hansen
Jeffrey Schwab wrote: > Xah Lee wrote: > >> i've read the official Python tutorial 8 months ago, have spent 30 >> minutes with Python 3 times a week since, have 14 years of computing >> experience, 8 years in mathematical computing and 4 years in unix admin >> and perl > > I can wiggle my ears.

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Rick Wotnaz
"Gerard Flanagan" <[EMAIL PROTECTED]> wrote in news:[EMAIL PROTECTED]: > Xah Lee wrote: >> Python Doc Problem Example: gzip >> [...] >> A quality documentation should be clear, succinct, precise. >> And, the least it assumes reader's expertise to obtain these >> qualities, the better it is. >> >>

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Jeffrey Schwab
Xah Lee wrote: > i've read the official Python tutorial 8 months ago, have spent 30 > minutes with Python 3 times a week since, have 14 years of computing > experience, 8 years in mathematical computing and 4 years in unix admin > and perl I can wiggle my ears. -- http://mail.python.org/mailman/

Re: Python doc problem example: gzip module (reprise)

2005-11-05 Thread Gerard Flanagan
Xah Lee wrote: > Python Doc Problem Example: gzip > > Xah Lee, 20050831 > > Today i need to use Python to compress/decompress gzip files. Since > i've read the official Python tutorial 8 months ago, have spent 30 > minutes with Python 3 times a week since, have 14 years of computing > experience, 8

os.makedirs should not succeed when the directory already exists (was Re: Python Doc Error: os.makedirs)

2005-10-20 Thread jepler
On Wed, Oct 19, 2005 at 09:26:16AM -0700, Dr. Who wrote: > The fact that the directory already exists is irrelevant to the function...it > still failed to create the directory. That's not true. Imagine that os.makedirs() is used inside tempfile.mkdtemp() (I looked, and it isn't) and the proposed

Re: Python Doc Error: os.makedirs

2005-10-20 Thread Xah Lee
Thomas Bellman wrote: >try: > os.makedirs("/tmp/trh/spam/norwegian/blue/parrot/cheese") >except os.error, e: > if e.errno != errno.EEXIST: > raise This is what i want. Thanks. (the doc needs quite some improvement...) Xah [EMAIL PROTECTED] ∑ http://xahlee.org/ -

Re: Python Doc Error: os.makedirs

2005-10-19 Thread Thomas Bellman
I wrote: >try: > os.makedirs("/tmp/trh/spam/norwegian/blue/parrot/cheese") >except os.error, e: > if e.errno != errno.EEXIST: > raise Actually, when I think more about it, one would probably rather want something like: try: os.makedirs("/tmp/trh/spam/nor

Re: Python Doc Error: os.makedirs

2005-10-19 Thread Thomas Bellman
"Xah Lee" <[EMAIL PROTECTED]> wrote: > The "Throws an error exception" should be "Throws an OSError > exception". Both are correct: >>> os.error is OSError True That is even documented in http://python.org/doc/lib/module-os.html: error This exception is raised when a functi

Re: Python Doc Error: os.makedirs

2005-10-19 Thread the_crazy88
if not os.path.isdir("your_dir_name"): makedirs("your_dir_name") -- http://mail.python.org/mailman/listinfo/python-list

Re: Python Doc Error: os.makedirs

2005-10-19 Thread Dr. Who
Xah Lee wrote: > i think the function shouldn't complain if dir already exists. How is a > programer to distinguish if the dir already exists, or if there's a > problem creating the dir? Of course it should thrown an exception because it was unable to do what it was asked: create a directory. Th

Re: Python Doc Error: os.makedirs

2005-10-19 Thread pclinch
if os.access( path, os.F_OK): print 'path exists' See also os.stat(path) for further info. about a file or dir. regards, Paul Clinch -- http://mail.python.org/mailman/listinfo/python-list

Re: bizarro world (was Re: Python Doc Problem Example: sort() (reprise))

2005-10-17 Thread Terry Hancock
print """\ On Monday 17 October 2005 02:59 am, Xah Lee wrote: > > Bryan wrote: > > mr. xah... would you be willing to give a lecture at pycon 2006? i'm sure > > you > > would draw a huge crowd and a lot of people would like to meet you in > > person... > > > > thanks. > > I'd be delight to. >

Re: bizarro world (was Re: Python Doc Problem Example: sort() (reprise))

2005-10-17 Thread Xah Lee
Bryan wrote: > mr. xah... would you be willing to give a lecture at pycon 2006? i'm sure you > would draw a huge crowd and a lot of people would like to meet you in > person... > > thanks. I'd be delight to. My requirements are: 1 cup of fat-free milk, free, and free pizza. Xah [EMAIL PROTE

Re: bizarro world (was Re: Python Doc Problem Example: sort() (reprise))

2005-10-11 Thread Lasse Vågsæther Karlsen
Bryan wrote: > mr. xah... would you be willing to give a lecture at pycon 2006? i'm > sure you would draw a huge crowd and a lot of people would like to meet > you in person... > > thanks. > I think that would be a highly un-pythonesque crowd. Python isn't much in the sense of limitations, b

Re: bizarro world (was Re: Python Doc Problem Example: sort() (reprise))

2005-10-11 Thread Bryan
mr. xah... would you be willing to give a lecture at pycon 2006? i'm sure you would draw a huge crowd and a lot of people would like to meet you in person... thanks. -- http://mail.python.org/mailman/listinfo/python-list

bizarro world (was Re: Python Doc Problem Example: sort() (reprise))

2005-10-11 Thread Bryan
Xah Lee wrote: > Addendum, 200510 > > Here's further example of Python's extreme low quality of > documentation. In particular, what follows focuses on the bad writing > skill aspect, and comments on some language design and quality issues > of Python. > >>From the Official Python documentation o

Re: Python Doc Problem Example: sort() (reprise)

2005-10-11 Thread Xah Lee
Addendum, 200510 Here's further example of Python's extreme low quality of documentation. In particular, what follows focuses on the bad writing skill aspect, and comments on some language design and quality issues of Python. >From the Official Python documentation of the sort() method, at: http:

Re: Python Doc Problem Example: os.path.split

2005-09-20 Thread Steve Holden
Peter Hansen wrote: > Diez B. Roggisch wrote: [...] >>But I stand by the nano-tube-narrow mind-set of Xah Lee. Besides his >>tourette syndrome he also is simply unwilling to read documentation if >>it is not what _he_ expects it to be. > > > It's interesting to note that c.l.p still manages to gi

Re: Python Doc Problem Example: os.path.split

2005-09-20 Thread Peter Hansen
Diez B. Roggisch wrote: >>I think this is unfair. The use of "slash" is a failing of the current >>documentation. If his use is an indication of a nano-tube-narrow >>mindset then so would be the use by the actual documentation writers. > > You're right - I missed that somehow, as the original docs

Re: Python Doc Problem Example: os.path.split

2005-09-20 Thread Diez B. Roggisch
> I think this is unfair. The use of "slash" is a failing of the current > documentation. If his use is an indication of a nano-tube-narrow > mindset then so would be the use by the actual documentation writers. You're right - I missed that somehow, as the original docs talk about components - w

Re: Python Doc Problem Example: os.path.split

2005-09-20 Thread Antoon Pardon
Op 2005-09-19, Diez B. Roggisch schreef <[EMAIL PROTECTED]>: >> >> split(path) >> returns a pair (dirname,filename), where dirname is the part of path >> up to the last slash, and filename is the rest of the string after the >> last slash. > > Bullshit. Slash isn't always the path component d

Re: Python Doc Problem Example: os.path.split

2005-09-19 Thread Diez B. Roggisch
> > split(path) > returns a pair (dirname,filename), where dirname is the part of path > up to the last slash, and filename is the rest of the string after the > last slash. Bullshit. Slash isn't always the path component delimiter. Get a clue on what you're talking about before suggesting

Re: Python Doc Problem Example: os.path.split

2005-09-19 Thread Xah Lee
Addendum: I was working on a program where i needed to split a path into dirname, corename, and suffix. I came to this page and took me a while to understand what split() is about. There are other path related functions splitext(), splitdrive(), basename(), dirname(). User has to scan the whole p

Re: Python Doc Problem Example: os.path.split

2005-09-18 Thread George Sakkis
Another epileptic seizure on the keyboard. Apart from clue deficit disorder, this guy seems to suffer from some serious anger management problems...*plonk* "Xah Lee" <[EMAIL PROTECTED]> wrote: > Python Doc Problem Example > > Quote from: > http://docs.python.org/lib/module-os.path.html >

Re: Python Doc Problem Example: os.path.split

2005-09-18 Thread Julian Fondren
> Please don't feed the trolls. > In other words, if everybody ignores this loser, he might crawl back under > the rock he came from. Well, comp.lang.python people would do better to accept the suggested rewrite and ignore at the rest at their discretion. -- http://mail.python.org/mailman/listi

Re: Python Doc Problem Example: os.path.split

2005-09-18 Thread Bruno Desthuilliers
Laszlo Zsolt Nagy a écrit : > >> is the doc writer, trying to write the doc with some austereness, but >> is confused about the behavior of split, or confused about expressing >> it? Did his pretension fucked him up? >> >> > Dear Xah Lee, > > The Python community is very sorry because we have a

Re: Python Doc Problem Example: os.path.split

2005-09-18 Thread Matija Papec
X-Ftn-To: Xah Lee "Xah Lee" <[EMAIL PROTECTED]> wrote: >Python Doc Problem Example what makes you sure that this problem would be interesting for groups beside c.l.python? are you begging to be converted to a true religion? :-) -- Matija -- http://mail.python.org/mailman/listinfo/python-list

Re: Python Doc Problem Example: os.path.split

2005-09-18 Thread Laszlo Zsolt Nagy
>is the doc writer, trying to write the doc with some austereness, but >is confused about the behavior of split, or confused about expressing >it? Did his pretension fucked him up? > > Dear Xah Lee, The Python community is very sorry because we have a very bad documentation. You are right. Th

Re: Python Doc Problem Example: os.path.split

2005-09-18 Thread Steven D'Aprano
On Sun, 18 Sep 2005 03:46:03 -0700, Xah Lee wibbled: > Can anyone tell me what this verbiage is trying to fucking say? Please don't feed the trolls. In other words, if everybody ignores this loser, he might crawl back under the rock he came from. -- Steven. -- http://mail.python.org/mailman/

Re: Python Doc Problem Example: os.system

2005-09-05 Thread Robert Wierschke
Xah Lee schrieb: > Python Doc Problem Example: os.system > > Xah Lee, 2005-09 > > today i'm trying to use Python to call shell commands. e.g. in Perl > something like > > output=qx(ls) > > in Python i quickly located the the function due to its > well-named-ness: > > import os > os.system("ls"

Re: Python Doc Problem Example: os.system

2005-09-04 Thread Jeremy Jones
Xah Lee wrote: >Python Doc Problem Example: os.system > >Xah Lee, 2005-09 > >today i'm trying to use Python to call shell commands. e.g. in Perl >something like > >output=qx(ls) > >in Python i quickly located the the function due to its >well-named-ness: > >import os >os.system("ls") > > >however,

Re: Python doc problems example: gzip module

2005-09-01 Thread EP
"Xah Lee" <[EMAIL PROTECTED]> wrote: > today i need to decompress > since i'm familiar with what the fuck > Fuck the > I just need to decompress that fucking doc whatever fuck Is it just me or, do you suppose, with so much unnecessary "f" word, this is not a post at all, but a

Re: Python doc problems example: gzip module

2005-09-01 Thread pspierce
Peter Maas wrote: > Xah Lee schrieb: > > today i need to use Python to decompress gzip files. > > > > since i'm familiar with Python doc and have 10 years of computing > > experience with 4 years in unix admin and perl, i have quickly located > > the official doc: > > > > http://python.org/doc/2

Re: Python doc problems example: gzip module

2005-09-01 Thread plainsane
Peter Maas wrote: > Xah Lee schrieb: > > today i need to use Python to decompress gzip files. > > > > since i'm familiar with Python doc and have 10 years of computing > > experience with 4 years in unix admin and perl, i have quickly located > > the official doc: > > > > http://python.org/doc/2

Re: Python doc problems example: gzip module

2005-09-01 Thread en.karpachov
On 1 Sep 2005 07:24:26 -0700 Peter Wang wrote: > >> Constructor for the GzipFile class, which simulates most of the methods > >> of a file object, with the exception of the readinto() and truncate() > > > > yeah, blab blab blab. what the fuck are you talking about? So, how to > > use it? > >> a

Re: Python doc problems example: gzip module

2005-09-01 Thread Peter Wang
>> Constructor for the GzipFile class, which simulates most of the methods >> of a file object, with the exception of the readinto() and truncate() > > yeah, blab blab blab. what the fuck are you talking about? So, how to > use it? um... presumably you type "zippedfile = GzipFile(...)" and dependi

Re: Python doc problems example: gzip module

2005-09-01 Thread Xah Lee
nothing personal my friend. But just in case you are interested about getting it: the question here is about quality of documentation, not about whether you got it. http://xahlee.org/UnixResource_dir/writ/python_doc.html Xah [EMAIL PROTECTED] ∑ http://xahlee.org/ Sybren Stuvel wrote: > Xah Le

Re: Python doc problems example: gzip module

2005-08-31 Thread Sybren Stuvel
Xah Lee enlightened us with: > but after a minute of scanning, please someone tell me what the fuck > is it talking about? How difficult is it? The first line of the Gzip class explains it all to me: "Constructor for the GzipFile class, which simulates most of the methods of a file object" Sybren

Re: Python doc problems example: gzip module

2005-08-31 Thread Fredrik Lundh
Peter Maas wrote: > Please feel free to insert this fucking example into the fucking docs. or use the fucking search engine. searching for "python example" and clicking the "I feel lucky" button tends to work quite well. e.g. http://www.google.com/search?q=python+gzip+example&btnI=

Re: Python doc problems example: gzip module

2005-08-31 Thread Peter Maas
Xah Lee schrieb: > today i need to use Python to decompress gzip files. > > since i'm familiar with Python doc and have 10 years of computing > experience with 4 years in unix admin and perl, i have quickly located > the official doc: > > http://python.org/doc/2.4.1/lib/module-gzip.html > > but

Re: Python doc problems example: gzip module

2005-08-31 Thread Xah Lee
Today i need to use Python to compress/decompress gzip files. I quickly found the official doc: http://python.org/doc/2.4.1/lib/module-gzip.html I'd imagine it being a function something like GzipFile(filePath, comprress/decompress, outputPath) however, scanning the doc after 20 seconds there's