Re: python documentation

2021-03-28 Thread Michael Torrie
On 3/28/21 12:28 PM, Michael Torrie wrote: > You want to use an obsolete version of Python and an obsolete version of > Qt. That's totally fine! But why are you angry when people, who are > strictly volunteers, are unable to help much here other than to strongly > recommend you reconsider? Oops.

Re: python documentation

2021-03-28 Thread Michael Torrie
On 3/27/21 1:02 PM, pyt...@blackward.eu wrote: > You say: "The point is that there are those who use Python 2 and > don't want to move to Python 3, claiming that it's easier to switch > from Python 2 to some other language than from Python 2 to Python 3. > That's what seems questionable." And I say

Re: python documentation

2021-03-27 Thread Thomas Jollans
On 27/03/2021 06:20, pyt...@blackward.eu wrote: Chris, you seem to imply, that I have compiled said versions without reason and that the same would be possible on basis of Python 3 - which is simply not true. Maybe you are not enough acquainted with Qt and belonging libraries alike PyQtGraph.

Re: python documentation

2021-03-27 Thread Terry Reedy
On 3/27/2021 1:20 AM, pyt...@blackward.eu wrote: By the way, some months ago I started trying to migrate to Python 3 and gave up in favor of creating said compilation. Why? What was biggest roadblock? Compatibility of Python and its Packages decreased with V3 significantly. I don't believ

Re: python documentation

2021-03-27 Thread Grant Edwards
On 2021-03-27, MRAB wrote: > On 2021-03-27 17:03, pyt...@blackward.eu wrote: >> You write, that "Everyone claims that it's easier to move to some other >> language rather than to migrate to Python 3". >> >> Thank you for sharing this remarkable information! > > You've quoted him partially and inc

Re: python documentation

2021-03-27 Thread Terry Reedy
I would like to suggest adding "Blythooon" to the list under "Other parties have re-packaged CPython" listed here: https://www.python.org/download/alternatives/ Your title is misleading because you are proposing a change to a python.org website page, not the 'Python documentation'. That te

Re: python documentation

2021-03-27 Thread Terry Reedy
I answered your actual question, in your original post, separately. But by posting here, and continuing to respond, you implicitly invited extended discussion with questions and opinions. On 3/26/2021 11:15 PM, pyt...@blackward.eu wrote: in response to Chris Angelico, a long-time python-list

Re: python documentation

2021-03-27 Thread Chris Angelico
On Sun, Mar 28, 2021 at 7:46 AM Avi Gross via Python-list wrote: > > What are the odds, Chris, that rewriting an existing project written in an > older version of a language like python FROM SCRATCH into any other existing > language, would be easier than updating it to the same language which mad

RE: python documentation

2021-03-27 Thread Avi Gross via Python-list
wishes but not free to force others to help him when it is not in their interest. -Original Message- From: Python-list On Behalf Of Chris Angelico Sent: Saturday, March 27, 2021 1:37 AM To: Python Subject: Re: python documentation On Sat, Mar 27, 2021 at 4:20 PM wrote: > > Chris, &

Re: python documentation

2021-03-27 Thread MRAB
On 2021-03-27 19:02, pyt...@blackward.eu wrote: You say: "The point is that there are those who use Python 2 and don't want to move to Python 3, claiming that it's easier to switch from Python 2 to some other language than from Python 2 to Python 3. That's what seems questionable." And I say, fo

Re: python documentation

2021-03-27 Thread python
You say: "The point is that there are those who use Python 2 and don't want to move to Python 3, claiming that it's easier to switch from Python 2 to some other language than from Python 2 to Python 3. That's what seems questionable." And I say, forcing people to do things they do not want to

Re: python documentation

2021-03-27 Thread MRAB
On 2021-03-27 17:03, pyt...@blackward.eu wrote: You write, that "Everyone claims that it's easier to move to some other language rather than to migrate to Python 3". Thank you for sharing this remarkable information! You've quoted him partially and incorrectly. He said "Everyone claims that it

Re: python documentation

2021-03-27 Thread Chris Angelico
On Sun, Mar 28, 2021 at 4:03 AM wrote: > > You write, that "Everyone claims that it's easier to move to some other > language rather than to migrate to Python 3". > > Thank you for sharing this remarkable information! > Yep. Plenty of people have claimed that. And guess what? They mostly end up d

Re: python documentation

2021-03-27 Thread Dan Stromberg
On Sat, Mar 27, 2021 at 9:56 AM wrote: > May I ask, do you have any knowledge or even experience about if resp. > how good Tauthon and Pypy2 works together with Qt 4.8? > I've never used Qt. I do my GUI's with PyGOBject. I've moved all of my personal code that I care about from Python 2.x to 3

Re: python documentation

2021-03-27 Thread python
You write, that "Everyone claims that it's easier to move to some other language rather than to migrate to Python 3". Thank you for sharing this remarkable information! On 2021-03-27 06:36, Chris Angelico wrote: On Sat, Mar 27, 2021 at 4:20 PM wrote: Chris, you seem to imply, that I ha

Re: python documentation

2021-03-27 Thread python
Hi Dan, thank you very much for your kind hints - quite interesting idea to have a more detailed look into this direction! By the way, your response was the very first here, which I consider to have a constructive notion; at least I did not felt very welcome here by Chris until yet... In

Re: python documentation

2021-03-27 Thread Chris Angelico
On Sat, Mar 27, 2021 at 5:01 PM Dan Stromberg wrote: > > On Fri, Mar 26, 2021 at 10:37 PM Chris Angelico wrote: >> >> On Sat, Mar 27, 2021 at 4:20 PM wrote: >> > By the way, some months ago I started trying to migrate to Python 3 and >> > gave up in favor of creating said compilation. Compatibil

Re: python documentation

2021-03-26 Thread Dan Stromberg
On Fri, Mar 26, 2021 at 10:37 PM Chris Angelico wrote: > On Sat, Mar 27, 2021 at 4:20 PM wrote: > > By the way, some months ago I started trying to migrate to Python 3 and > > gave up in favor of creating said compilation. Compatibility of Python > > and its Packages decreased with V3 significan

Re: python documentation

2021-03-26 Thread Chris Angelico
On Sat, Mar 27, 2021 at 4:20 PM wrote: > > Chris, > > you seem to imply, that I have compiled said versions without reason and > that the same would be possible on basis of Python 3 - which is simply > not true. Maybe you are not enough acquainted with Qt and belonging > libraries alike PyQtGraph.

Re: python documentation

2021-03-26 Thread python
Chris, you seem to imply, that I have compiled said versions without reason and that the same would be possible on basis of Python 3 - which is simply not true. Maybe you are not enough acquainted with Qt and belonging libraries alike PyQtGraph. Maybe you are just not willing to see / accept

Re: python documentation

2021-03-26 Thread MRAB
On 2021-03-27 03:44, Chris Angelico wrote: On Sat, Mar 27, 2021 at 2:15 PM wrote: [snip] By the way, there is more, Blythooon offers beyond what I already have written in the last email. Otherwise please name me another comparable MINIMAL 'distribution', which is compiled specifically for sc

Re: python documentation

2021-03-26 Thread Chris Angelico
On Sat, Mar 27, 2021 at 2:15 PM wrote: > > No, I am not encouraging, I am just offering the possibility. > > Python and its community once was not dogmatic. At least this was my > impression when I started - after all Python originally had been > designed to be multi paradigmatic. This spirit of f

Re: python documentation

2021-03-26 Thread python
No, I am not encouraging, I am just offering the possibility. Python and its community once was not dogmatic. At least this was my impression when I started - after all Python originally had been designed to be multi paradigmatic. This spirit of freedom was one mayor reason for Python to grow

Re: python documentation

2021-03-26 Thread Chris Angelico
On Sat, Mar 27, 2021 at 7:49 AM wrote: > > Hi Chris, > > > thank you for your interest and thanks for asking. > > > Blythooon is notable due to several reasons; let's compare it with some > of the already listed (and thus obviously notable) 'distributions': > > 2) winpython seems not to support Py

Re: python documentation - addendum

2021-03-26 Thread python
Sorry, copy & paste obviously failed, here is the link I wanted to include: https://www.anaconda.com/terms-of-service On 2021-03-26 17:33, Chris Angelico wrote: On Sat, Mar 27, 2021 at 3:31 AM wrote: Howdy Folks, I would like to suggest adding "Blythooon" to the list under "Other partie

Re: python documentation

2021-03-26 Thread python
Hi Chris, thank you for your interest and thanks for asking. Blythooon is notable due to several reasons; let's compare it with some of the already listed (and thus obviously notable) 'distributions': 1) pythonxy seems not to be maintained anymore - the last version I found is from 2015.

Re: python documentation

2021-03-26 Thread Chris Angelico
On Sat, Mar 27, 2021 at 3:31 AM wrote: > > Howdy Folks, > > > I would like to suggest adding "Blythooon" to the list under "Other > parties have re-packaged CPython" listed here: > What makes it notable? ChrisA -- https://mail.python.org/mailman/listinfo/python-list

Re: Python Documentation Improvement

2014-11-25 Thread Steven D'Aprano
Archana Pandey wrote: [...] > A = a + 1 and a += 1 both behave in same way for all data types except > python Lists I cannot think of any other mutable data type that supports + but there are mutable data types that support other augmented assignment operators: py> a = set("abcd") py> b = a #

Re: Python Documentation Improvement

2014-11-25 Thread Mark Lawrence
On 25/11/2014 11:44, Archana Pandey wrote: Hello I hereby would like to share the problem I have faced regarding python list implementation :- As per python documentation python list is mutable data object. The problem I found with the list is that is behaves differently when we use ‘+=’ and ‘

Re: Python documentation too difficult for beginners

2010-11-04 Thread News123
On 11/02/2010 02:42 PM, Steven D'Aprano wrote: > However, there is a Python wiki. It doesn't get anywhere near as much > love as it deserves, and (I think) the consensus was that the official > Python docs should stay official, but link to the wiki for user- > contributed content. This hasn't ha

Re: Python documentation too difficult for beginners

2010-11-04 Thread Lawrence D'Oliveiro
In message , Cameron Simpson wrote: > But its weakness is stuff like this: > > http://epydoc.sourceforge.net/stdlib/Canvas.Polygon-class.html > > Automatic docness, no useful information. But it Conforms to Documentation-Production Metrics as decreed by the Corporate Task Force on Policy. S

Re: Python documentation too difficult for beginners

2010-11-03 Thread Martin Gregorie
On Thu, 04 Nov 2010 08:03:37 +1100, Cameron Simpson wrote: > On 02Nov2010 04:23, jk wrote: | This > (http://epydoc.sourceforge.net/stdlib/) is what I'm talking | about. > | > | Why aren't the official docs like this, and why has it taken me 2 days > | of searching? All this needs is a search engi

Re: Python documentation too difficult for beginners

2010-11-03 Thread Cameron Simpson
On 02Nov2010 04:23, jk wrote: | This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking | about. | | Why aren't the official docs like this, and why has it taken me 2 days | of searching? All this needs is a search engine behind it and it'd be | perfect. It looks a lot like javadoc. But

Re: Python documentation too difficult for beginners

2010-11-03 Thread Cameron Simpson
On 02Nov2010 03:42, jk wrote: | I've been coding in PHP and Java for years, and their documentation is | concise, well structured and easy to scan. While I agree about Java, at least the core Java docs, and javadoc output in general (_great_ cross referencing!) I have mixed feelings about the PHP

Re: Python documentation too difficult for beginners

2010-11-03 Thread Hallvard B Furuseth
Steven D'Aprano writes: > On Tue, 02 Nov 2010 03:42:22 -0700, jk wrote: >> The former is difficult to find (try searching for 'open' in the search >> box and see what you get). > > A fair point -- the built-in open comes up as hit #30, whereas searching > for open in the PHP page brings up fopen a

Re: Python documentation too difficult for beginners

2010-11-03 Thread jk
On Nov 2, 11:06 pm, Lawrence D'Oliveiro wrote: > In message > , jk > wrote: > > > This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking > > about. > > Framesets? Is that really your idea of well-laid-out documentation? Using a > feature which has been derided (and dropped in HTML5) beca

Re: Python documentation too difficult for beginners

2010-11-03 Thread Lawrence D'Oliveiro
In message , Dennis Lee Bieber wrote: > Whereas I have a whole shelf of Java documentation and it still > takes me an hour to write "Hello World"... Java's one class per file > results in a plethora of bloody names one has to remember just to find > out where to start looking for a standard libra

Re: Python documentation too difficult for beginners

2010-11-02 Thread rantingrick
AD i agree with you! The official python tutorial and the official docs are pretty much a twisted mass of confusion to the initiated programmer. Even today when i try yo search the docs i find the result quite frankly useless. And the search reminds me of the old XP "puppy dog" search. The doc AR

Re: Python documentation too difficult for beginners

2010-11-02 Thread John Bond
My 2c: I use the ActiveState distro, and it's winhelp doco. It's generally ok and some things, like Dive Into Python, I've found excellent. But I do quite regularly find myself cursing at the vagueness of the index, and some of the content seems to require that you know it before you read i

Re: Python documentation too difficult for beginners

2010-11-02 Thread Lawrence D'Oliveiro
In message <2010110223050345181-nizum...@mcnuggetscom>, Nizumzen wrote: > On 2010-11-02 10:42:22 +, jk said: > >> I've been coding in PHP and Java for years, and their documentation is >> concise, well structured and easy to scan. > > Are you mad? Javadoc is one of the worst examples of sour

Re: Python documentation too difficult for beginners

2010-11-02 Thread Kee Nethery
> >> >> Therefore, if you truly want changes in the documentation, I suggest that, >> rather then whining to the group, you make some of the changes yourself. > > I agree up to here, with a different interpretation of the last clause. > Work within the existing system. There are currently 250 o

Re: Python documentation too difficult for beginners

2010-11-02 Thread James Mills
On Wed, Nov 3, 2010 at 9:05 AM, Nizumzen wrote: > Are you mad? Javadoc is one of the worst examples of source code > documentation I can possibly imagine. I would go as far to say that the > Python guys should do exactly the opposite of Javadoc. For what it's worth, I concur. cheers James --

Re: Python documentation too difficult for beginners

2010-11-02 Thread AD.
On Nov 3, 7:43 am, Tim Harig wrote: > On 2010-11-02, jk wrote: > > > As for the 9 paragraphs statement, there's a usability book that > > applies here - it's called "Don't make me think". I shouldn't have to > > Anything that promotes a lack of thinking sends up red flags in my head. > We want to

Re: Python documentation too difficult for beginners

2010-11-02 Thread Lawrence D'Oliveiro
In message , jk wrote: > This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking > about. Framesets? Is that really your idea of well-laid-out documentation? Using a feature which has been derided (and dropped in HTML5) because of its effect on usability and accessibility? -- http:/

Re: Python documentation too difficult for beginners

2010-11-02 Thread Nizumzen
On 2010-11-02 10:42:22 +, jk said: Hi, I've been coding in PHP and Java for years, and their documentation is concise, well structured and easy to scan. Are you mad? Javadoc is one of the worst examples of source code documentation I can possibly imagine. I would go as far to say that th

Re: Python documentation too difficult for beginners

2010-11-02 Thread Terry Reedy
On 11/2/2010 2:43 PM, Tim Harig wrote: The real question is what do you want to gain by your posts here. You should already know that most groups are, by their very nature, slow to make changes to the status quo. The problem tends to be exasperated in open source projects where any changes mea

Re: Python documentation too difficult for beginners

2010-11-02 Thread John McMonagle
On 03/11/10 05:04, John Nagle wrote: >Right. Google does a far better job of organizing Python's > documentation than the Python community does. I don't even try > looking up anything starting at Python.org; I always start > with a Google search. Even though Python.org's search is > powered

Re: Python documentation too difficult for beginners

2010-11-02 Thread Kee Nethery
On Nov 2, 2010, at 11:07 AM, Ian wrote: > On 02/11/2010 14:47, jk wrote: >> I think the key difference is that I don't want to have to *read* >> the >> python docs - I want to be able to scan for what I'm looking for and >> find it easily. That makes me productive. >> > Hi jk, > > I totally a

Re: Python documentation too difficult for beginners

2010-11-02 Thread John Nagle
On 11/2/2010 7:53 AM, Paul Rudin wrote: Steven D'Aprano writes: A fair point -- the built-in open comes up as hit #30, whereas searching for open in the PHP page brings up fopen as hit #1. But the PHP search also brings up many, many hits -- ten pages worth. OTOH googling for "python open"

Re: Python documentation too difficult for beginners

2010-11-02 Thread Ian
On Nov 2, 8:47 am, jk wrote: > You're right in that the python docs in this case are less lines, but > that's one of the problems. It doesn't mention anywhere the extra > detail you've added regarding exceptions thrown. That's the kind of > thing that probably comes through experience or some kind

Re: Python documentation too difficult for beginners

2010-11-02 Thread Tim Harig
On 2010-11-02, jk wrote: > As for the 9 paragraphs statement, there's a usability book that > applies here - it's called "Don't make me think". I shouldn't have to Anything that promotes a lack of thinking sends up red flags in my head. We want to recruit smart people who think, not idiots. > go

Re: Python documentation too difficult for beginners

2010-11-02 Thread Ian
On 02/11/2010 14:47, jk wrote: I think the key difference is that I don't want to have to*read* the python docs - I want to be able to scan for what I'm looking for and find it easily. That makes me productive. Hi jk, I totally agree. But you will get nowhere. A few weeks back I complained th

Re: Python documentation too difficult for beginners

2010-11-02 Thread Terry Reedy
On 11/2/2010 6:42 AM, jk wrote: Compare for instance the differences in ease of use, and speed of use, of these: http://docs.python.org/library/functions.html#open http://uk.php.net/manual/en/function.fopen.php The former is difficult to find (try searching for 'open' in the search box and see

Re: Python documentation too difficult for beginners

2010-11-02 Thread Bruno Desthuilliers
jk a écrit : Hi, I've been coding in PHP and Java for years, and their documentation is concise, well structured and easy to scan. Others have mentioned this apparently for years (see: http://stackoverflow.com/questions/4046166/easy-to-navigate-online-python-reference-manual/4070851 and http://

Re: Python documentation too difficult for beginners

2010-11-02 Thread Paul Rudin
Steven D'Aprano writes: > A fair point -- the built-in open comes up as hit #30, whereas searching > for open in the PHP page brings up fopen as hit #1. But the PHP search > also brings up many, many hits -- ten pages worth. > OTOH googling for "python open" gives you the correct (for 2.7) pag

Re: Python documentation too difficult for beginners

2010-11-02 Thread jk
On Nov 2, 1:42 pm, Steven D'Aprano wrote: > It's always difficult to know how much information is too much. The PHP > docs seem to take an "everything including the kitchen sink" approach. > Given that approach, it makes sense to divide everything into > subsections, one page per function. But wit

Re: Python documentation too difficult for beginners

2010-11-02 Thread Grant Edwards
On 2010-11-02, brf...@gmail.com wrote: > A tutorial type book can also be great for reference and > documentation (as long as its current). I would recommend a > non-programmers tutorial to python even if you have started > programming in other languages before. Also its a wiki book and is > free

Re: Python documentation too difficult for beginners

2010-11-02 Thread Steven D'Aprano
On Tue, 02 Nov 2010 03:42:22 -0700, jk wrote: > Hi, > > I've been coding in PHP and Java for years, and their documentation is > concise, well structured and easy to scan. Well, that's one opinion. > Others have mentioned this apparently for years (see: > http://stackoverflow.com/questions/40

Re: Python documentation too difficult for beginners

2010-11-02 Thread jk
On Nov 2, 11:49 am, Tim Golden wrote: > But why do you imagine that the core > Python documentation -- developed and maintained by a group of people > who clearly have some idea what they're doing -- should change to a > format which happens to suit you? It's not just me who's found the current d

Re: Python documentation too difficult for beginners

2010-11-02 Thread Antoine Pitrou
On Tue, 2 Nov 2010 04:23:49 -0700 (PDT) jk wrote: > This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking > about. > > Why aren't the official docs like this, and why has it taken me 2 days > of searching? What's wrong with this: http://docs.python.org/library/ ? If you have specific

Re: Python documentation too difficult for beginners

2010-11-02 Thread Tim Wintle
On Tue, 2010-11-02 at 04:23 -0700, jk wrote: > This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking > about. Aaaarrr > Why aren't the official docs like this, Because not everyone likes documentation like that. Personally I far prefer the existing documentation to the JavaDoc-s

Re: Python documentation too difficult for beginners

2010-11-02 Thread brf256
A tutorial type book can also be great for reference and documentation (as long as its current). I would recommend a non-programmers tutorial to python even if you have started programming in other languages before. Also its a wiki book and is free. -Braden Faulkner Sent wirelessly from my Bla

Re: Python documentation too difficult for beginners

2010-11-02 Thread Martin P. Hellwig
On 11/02/10 10:42, jk wrote: Is there much chance that the Python maintainers will change their documentation system to make it more like Java or PHP? How would I go about trying to make that happen? I am by no means an authority however since you ask it here I feel compelled to give you my opi

Re: Python documentation too difficult for beginners

2010-11-02 Thread Tim Golden
On 02/11/2010 11:23, jk wrote: This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking about. Why aren't the official docs like this, and why has it taken me 2 days of searching? All this needs is a search engine behind it and it'd be perfect. I'm glad you find the epydoc format usefu

Re: Python documentation too difficult for beginners

2010-11-02 Thread jk
This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking about. Why aren't the official docs like this, and why has it taken me 2 days of searching? All this needs is a search engine behind it and it'd be perfect. -- http://mail.python.org/mailman/listinfo/python-list

Re: Python documentation too difficult for beginners

2010-11-02 Thread srinivas hn
If you are really beginner in python you can look into the dive into python,search as in google as the same its quite helpful for beginners.Also you can go for the byte of python. CHEERS CNA 9986229891 On Tue, Nov 2, 2010 at 4:42 PM, jk wrote: > Hi, > > I've been coding in PHP and Java for yea

Re: Python Documentation website layout changed?

2010-03-21 Thread Andrej Mitrovic
On Mar 20, 12:32 am, Steve Holden wrote: > Steve Holden wrote: > > Andrej Mitrovic wrote: > >> On Mar 17, 6:41 pm, Andrej Mitrovic > >> wrote: > >>> Hi, > > >>> What happened to the sidebar on the left of the documentation website? > >>> It seems to be gone: > > >>>http://docs.python.org/py3k/ind

Re: Python Documentation website layout changed?

2010-03-19 Thread Steve Holden
Steve Holden wrote: > Andrej Mitrovic wrote: >> On Mar 17, 6:41 pm, Andrej Mitrovic >> wrote: >>> Hi, >>> >>> What happened to the sidebar on the left of the documentation website? >>> It seems to be gone: >>> >>> http://docs.python.org/py3k/index.html >>> >>> I found it quite useful since I can q

Re: Python Documentation website layout changed?

2010-03-17 Thread Steve Holden
Andrej Mitrovic wrote: > On Mar 17, 6:41 pm, Andrej Mitrovic > wrote: >> Hi, >> >> What happened to the sidebar on the left of the documentation website? >> It seems to be gone: >> >> http://docs.python.org/py3k/index.html >> >> I found it quite useful since I can quickly swap between Python2/3 >>

Re: Python Documentation website layout changed?

2010-03-17 Thread Andrej Mitrovic
On Mar 17, 6:41 pm, Andrej Mitrovic wrote: > Hi, > > What happened to the sidebar on the left of the documentation website? > It seems to be gone: > > http://docs.python.org/py3k/index.html > > I found it quite useful since I can quickly swap between Python2/3 > documentation, and between other pa

Re: Python documentation servers

2009-08-10 Thread r
On Aug 10, 12:53 pm, Roy Hyunjin Han wrote: > Are there issues with the python documentation servers?http://docs.python.org/ > The site has been really slow to respond all weekend. try this thread http://groups.google.com/group/comp.lang.python/browse_thread/thread/052368a71f2a8ad2/929bd74bd203c6

Re: Python documentation

2008-05-03 Thread Scott David Daniels
[EMAIL PROTECTED] wrote: I have been learning python for some time using the dive into python book. I am interested to know if anyone can recommend a book which covers more advanced topics like threading and potentially GUI style coding If you don't at least browse "The Python Cookbook," you

Re: Python documentation

2008-05-02 Thread Mike Driscoll
On May 2, 4:34 am, [EMAIL PROTECTED] wrote: > Hello, > > I have been learning python for some time using the dive into python > book. I am interested to know if anyone can recommend a book which > covers more advanced topics like threading and potentially GUI style > coding. > > Regards, > > Ronald

Re: Python Documentation Standards

2006-03-17 Thread Colin J. Williams
Steven Bethard wrote: > Colin J. Williams wrote: > >> Doc strings provide us with a great opportunity to illuminate our code. >> >> In the example below, __init__ refers us to the class's documentation, >> but the class doc doesn't help much. > > > It doesn't? > > >>> print list.__doc__ > list

Re: Python Documentation Standards

2006-03-16 Thread Duncan Booth
Steven Bethard wrote: > Colin J. Williams wrote: >> Doc strings provide us with a great opportunity to illuminate our code. >> >> In the example below, __init__ refers us to the class's documentation, >> but the class doc doesn't help much. > > It doesn't? > > >>> print list.__doc__ > list() ->

Re: Python Documentation Standards

2006-03-16 Thread Steven Bethard
Colin J. Williams wrote: > Doc strings provide us with a great opportunity to illuminate our code. > > In the example below, __init__ refers us to the class's documentation, > but the class doc doesn't help much. It doesn't? >>> print list.__doc__ list() -> new list list(sequence) -> new list i

Re: Python documentation problem

2005-06-18 Thread axel
In comp.lang.perl.misc Xah Lee <[EMAIL PROTECTED]> wrote: > i wanted to find out if Python supports eval. e.g. > somecode='3+4' > print eval(somecode) # prints 7 > in the 14 hundred pages of python doc, where am i supposed to find this > info? By using the index - it's an alphabetical list of

Re: Python documentation problem

2005-06-18 Thread Jürgen Exner
Xah Lee wrote: > i wanted to find out if Python supports eval. e.g. > > somecode='3+4' > print eval(somecode) # prints 7 > > in the 14 hundred pages of python doc, where am i supposed to find > this info? Why are you asking in a Perl NG for information about Python? Or are you also asking your bac

Re: Python documentation problem

2005-06-18 Thread Jürgen Exner
Xah Lee wrote: > Python documentation, > [...] Python Reference Manual for more information. > [...] python doc wasted my time. [...] python coders. > [...] use python doc > python community [...] coding in python. [Sexual explicatives deleted] And this outburst has exactly _what_ to do with Perl

Re: Python documentation problem

2005-06-18 Thread Grant Edwards
On 2005-06-18, Xah Lee <[EMAIL PROTECTED]> wrote: [...] > Fuck the python doc wasted my time. Fuck python coders. Each > time i tried to use python doc and got frustrated because it > being grossly incompetent, i'll post a message like this, no > more frequent than once a week. This will go on as

Re: Python documentation problem

2005-06-18 Thread Steven D'Aprano
On Sat, 18 Jun 2005 12:02:07 +0200, Kalle Anke wrote: > On Sat, 18 Jun 2005 11:49:38 +0200, Xah Lee wrote > (in article <[EMAIL PROTECTED]>): > >> the problem is that the page essentially says nothing. Nothing that is >> relevant to programing, and such nothingness occupies a significant >> porti

Re: Python documentation problem

2005-06-18 Thread Kalle Anke
On Sat, 18 Jun 2005 11:49:38 +0200, Xah Lee wrote (in article <[EMAIL PROTECTED]>): > the problem is that the page essentially says nothing. Nothing that is > relevant to programing, and such nothingness occupies a significant > portion of the python doc. (at least a quarter) It is like reading a

Re: Python documentation problem

2005-06-18 Thread Xah Lee
> what is wrong with python doc > http://python.org/doc/2.4.1/lib/typesfunctions.html the problem is that the page essentially says nothing. Nothing that is relevant to programing, and such nothingness occupies a significant portion of the python doc. (at least a quarter) It is like reading a manu

Re: Python documentation problem

2005-06-18 Thread Tassilo v. Parseval
Also sprach Xah Lee: > i wanted to find out if Python supports eval. e.g. > > somecode='3+4' > print eval(somecode) # prints 7 > > in the 14 hundred pages of python doc, where am i supposed to find this > info? You are not going to find it in comp.lang.perl.misc. Tassilo -- use bigint; $n=71423

Re: Python documentation problem

2005-06-18 Thread Xah Lee
Apparently i tried it before posting eval '3' and got misleading errors because i forgot the parenthesis... This is a easy one to find in the doc... The unhelpful doc organization and past experiences confounded this case. Thanks. Xah [EMAIL PROTECTED] ∑ http://xahlee.org/ -- http://mail.pyt

Re: Python documentation problem

2005-06-18 Thread John Machin
Xah Lee wrote: > i wanted to find out if Python supports eval. e.g. > > somecode='3+4' > print eval(somecode) # prints 7 > > in the 14 hundred pages of python doc, where am i supposed to find this > info? > Option 1: As they say in the classics, "Suck it and see". If you want to find out if som

Re: Python documentation problem

2005-06-18 Thread Brian van den Broek
Xah Lee said unto the world upon 18/06/2005 04:11: > i wanted to find out if Python supports eval. e.g. > > somecode='3+4' > print eval(somecode) # prints 7 > > in the 14 hundred pages of python doc, where am i supposed to find this > info? > > Xah > [EMAIL PROTECTED] > ∑ http://xahlee.org/ >

Re: Python documentation problem

2005-06-18 Thread Brian van den Broek
Xah Lee said unto the world upon 18/06/2005 03:49: > Python documentation, > http://python.org/doc/2.4.1/lib/typesfunctions.html > > - > 2.3.10.3 Functions > > Function objects are created by function definitions. The only > operation on a function object is to call it: func(argu

Re: Python documentation problem

2005-06-18 Thread Xah Lee
i wanted to find out if Python supports eval. e.g. somecode='3+4' print eval(somecode) # prints 7 in the 14 hundred pages of python doc, where am i supposed to find this info? Xah [EMAIL PROTECTED] ∑ http://xahlee.org/ -- http://mail.python.org/mailman/listinfo/python-list

Re: Python documentation problem

2005-06-18 Thread Erik Max Francis
Xah Lee wrote: > Fuck the python doc wasted my time. Fuck python coders. Use your words! -- Erik Max Francis && [EMAIL PROTECTED] && http://www.alcyone.com/max/ San Jose, CA, USA && 37 20 N 121 53 W && AIM erikmaxfrancis The mind is not a vessel to be filled but a fire to be kindled. -- P

Re: Python Documentation (should be better?)

2005-05-17 Thread Davo
Overall organization is definitely an issue, at least for newer users. As an occasional python user I remain constantly in a mode of having to look up basic terminology for examples and exact spelling of terms in order to knock out a quick script. I feel very much like Mr. Bottaro that the docs, w

Re: Python Documentation (should be better?)

2005-05-14 Thread kaerbuhez
bruno modulix a écrit : > > I fail to see why would it would be better to have to open a browser, go > to python.org, go to the doc, find the right link etc instead of just > typing dir(xxx) and/or help(xxx). > I fully agree with you. I just suspect that you are not more than me a web develo

Re: Python Documentation (should be better?)

2005-05-13 Thread OKB (not okblacke)
Greg Ewing wrote: > Curiously I had the same problem just the other day, > except with list instead of string. I think the problem > is that the sections on the actual built-in types > (list, str, dict, etc.) are one level too far down > to appear in the table of contents of the Library > Referenc

Re: Python Documentation (should be better?)

2005-05-13 Thread Aahz
In article <[EMAIL PROTECTED]>, Greg Ewing <[EMAIL PROTECTED]> wrote: > >Curiously I had the same problem just the other day, except with list >instead of string. I think the problem is that the sections on the >actual built-in types (list, str, dict, etc.) are one level too far >down to appear in

Re: Python Documentation (should be better?)

2005-05-13 Thread John J. Lee
"Christopher J. Bottaro" <[EMAIL PROTECTED]> writes: [...] By the way, did you try the .chm? John -- http://mail.python.org/mailman/listinfo/python-list

Re: Python Documentation (should be better?)

2005-05-13 Thread John J. Lee
"Christopher J. Bottaro" <[EMAIL PROTECTED]> writes: [...] > At my work, we are developing a product from scratch. It is completely > modular and the modules communicate via SOAP. Because of that, we can > implement individual modules in any language of our choosing (so long as > they have good S

Re: Python Documentation (should be better?)

2005-05-13 Thread John J. Lee
Greg Ewing <[EMAIL PROTECTED]> writes: > Ivan Van Laningham wrote: > > Hi All-- > > The Python docs are not ideal. I can never remember, for instance, > > where to find string methods (not methods in the string module, but > > methods with '') > > Curiously I had the same problem just the other

Re: Python Documentation (should be better?)

2005-05-13 Thread John J. Lee
Ivan Van Laningham <[EMAIL PROTECTED]> writes: > Hi All-- > The Python docs are not ideal. I can never remember, for instance, > where to find string methods (not methods in the string module, but > methods with ''), but I can remember a tortured path to get me there [...] The answer to 80% of "

Re: Python Documentation (should be better?)

2005-05-13 Thread Skip Montanaro
bruno> I fail to see why would it would be better to have to open a bruno> browser, go to python.org, go to the doc, find the right link etc bruno> instead of just typing dir(xxx) and/or help(xxx). Actually, you frequently don't even have to enter the Python interpreter. Executing "py

Re: Python Documentation (should be better?)

2005-05-13 Thread Bruno Desthuilliers
Ivan Van Laningham a écrit : (snip) > BTW, my "tortured method" is quicker than Bruno's, because to use his > method I'd have to start the interactive interpreter. > "start the interactive interpreter" ??? What do you mean, "start the interactive interpreter" ??? It's *always* started as a part

  1   2   >