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

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

python documentation

2021-03-26 Thread python
Howdy Folks, 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/ Blythooon can be found here: https://pypi.org/project/blythooon/ and the belonging installation step-by-step-guid

Official Python documentation lookup while programming (was: Is the content available in the html doc available in help()?)

2016-09-17 Thread Ben Finney
ess it, nor how to present it. So no, a Python interactive prompt does not natively have a way to do what you're asking. What you may like is to get your programming environment to present the official Python documentation as part of that environment. For example, the documentation is rendered

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

Python Documentation Improvement

2014-11-25 Thread Archana Pandey
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 ‘+’ ‘=’ operators separately. For example

Re: Where to suggest improvements in the official Python documentation?

2013-08-20 Thread Joel Goldstick
On Tue, Aug 20, 2013 at 10:22 AM, Aseem Bansal wrote: > @Joel Goldstick >> Joel Goldstick >> >> http://joelgoldstick.com > > My specific question was that the Python documentation's tutorial isn't clear > when it comes to lambda forms. I just wanted something to be done so it > becomes clear for

Re: Where to suggest improvements in the official Python documentation?

2013-08-20 Thread Aseem Bansal
@Joel Goldstick > Joel Goldstick > > http://joelgoldstick.com My specific question was that the Python documentation's tutorial isn't clear when it comes to lambda forms. I just wanted something to be done so it becomes clear for future readers who are not familiar with functional paradigm. I

Re: Where to suggest improvements in the official Python documentation?

2013-08-04 Thread Joel Goldstick
On Sun, Aug 4, 2013 at 12:30 PM, Aseem Bansal wrote: > @ Terry Jan Reedy > > If there is an issue in place for improving the lambda forms then that's > good. I wanted a link about functional programming because it is mentioned as > if it were a household word. It depends on your household I sup

Re: Where to suggest improvements in the official Python documentation?

2013-08-04 Thread Aseem Bansal
@ Terry Jan Reedy If there is an issue in place for improving the lambda forms then that's good. I wanted a link about functional programming because it is mentioned as if it were a household word. -- http://mail.python.org/mailman/listinfo/python-list

Re: Where to suggest improvements in the official Python documentation?

2013-08-03 Thread Terry Reedy
nk of "functional Programming HOWTO" of Python documentation can take out much confusion for Python newbies. That document is not about lambda. The word 'lambda' does not appear until near the end, and some of the current examples violate PEP 8. I would like to suggest t

Re: Where to suggest improvements in the official Python documentation?

2013-08-03 Thread Joel Goldstick
e tutorial what lambda forms are for someone who > doesn't know functional programming. I think placing a link of "functional > Programming HOWTO" of Python documentation can take out much confusion for > Python newbies. > > I would like to suggest this because as I newbiw

Where to suggest improvements in the official Python documentation?

2013-08-03 Thread Aseem Bansal
ional programming. I think placing a link of "functional Programming HOWTO" of Python documentation can take out much confusion for Python newbies. I would like to suggest this because as I newbiw I had much confusion 2 months back before I could figure out its proper use. Where do I suggest th

Re: Problems with Python documentation [Re: Don't feed the troll...]

2013-06-17 Thread Joel Goldstick
On Mon, Jun 17, 2013 at 6:50 PM, Steven D'Aprano < steve+comp.lang.pyt...@pearwood.info> wrote: > On Mon, 17 Jun 2013 07:41:54 -0700, rurpy wrote: > > > On 06/17/2013 01:23 AM, Chris Angelico wrote: > >> On Mon, Jun 17, 2013 at 3:04 PM, Ferrous Cranus > >> wrote: > >>> The only thing i'm feeling

Problems with Python documentation [Re: Don't feed the troll...]

2013-06-17 Thread Steven D'Aprano
On Mon, 17 Jun 2013 07:41:54 -0700, rurpy wrote: > On 06/17/2013 01:23 AM, Chris Angelico wrote: >> On Mon, Jun 17, 2013 at 3:04 PM, Ferrous Cranus >> wrote: >>> The only thing i'm feeling guilty is that instead of reading help >>> files and PEP's which seem too technical for me, i prefer the liv

Re: PyDoc - Python Documentation Plugin for Eclipse

2012-06-15 Thread Alexey Gaidamaka
On Sun, 10 Jun 2012 15:37:50 +, Alexey Gaidamaka wrote: > On Sun, 10 Jun 2012 05:02:35 -0500, Andrew Berg wrote: > >> On 6/10/2012 4:22 AM, Alexey Gaidamaka wrote: >>> Practically the plugin is a simple html archive from python >>> documentation website running

Re: PyDoc - Python Documentation Plugin for Eclipse

2012-06-15 Thread Alexey Gaidamaka
On Sun, 10 Jun 2012 12:14:15 +0300, Alexey Gaidamaka wrote: > Greets! > > Since i'm new to Python, i've decided to create a handy plugin for > Elipse SDK which is my primary dev environment. Practically the plugin > is a simple html archive from python documentation

Re: PyDoc - Python Documentation Plugin for Eclipse

2012-06-10 Thread Alexey Gaidamaka
On Sun, 10 Jun 2012 05:02:35 -0500, Andrew Berg wrote: > On 6/10/2012 4:22 AM, Alexey Gaidamaka wrote: >> Practically the plugin is a simple html archive from python >> documentation website running >> inside Eclipse so you can call it using Eclipse help system. As for now

Re: PyDoc - Python Documentation Plugin for Eclipse

2012-06-10 Thread Andrew Berg
On 6/10/2012 4:22 AM, Alexey Gaidamaka wrote: > Practically the plugin is a simple html archive from python > documentation website running > inside Eclipse so you can call it using Eclipse help system. > As for now it is pretty large (~7 mb), but i'm planning to optimize it

PyDoc - Python Documentation Plugin for Eclipse

2012-06-10 Thread Alexey Gaidamaka
Greets! Since i'm new to Python, i've decided to create a handy plugin for Elipse SDK which is my primary dev environment. Practically the plugin is a simple html archive from python documentation website running inside Eclipse so you can call it using Eclipse help system. As for

PyDoc - Python Documentation Plugin for Eclipse

2012-06-10 Thread Alexey Gaidamaka
Greets! Since i'm new to Python, i've decided to create a handy plugin for Elipse SDK which is my primary dev environment. Practically the plugin is a simple html archive from python documentation website running inside Eclipse so you can call it using Eclipse help system. As for

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
nformation), perhaps it would be useful to put a link to a page that explains how to improve the docs, on each doc page? I have to agree with others. My preferred Python documentation is either the books I have, or a search on Google. A google search typically has several postings from people 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: Man pages and info pages (was: Python documentation too difficult for beginners)

2010-11-02 Thread Tim Harig
On 2010-11-02, Tim Harig wrote: > On 2010-11-02, Teemu Likonen wrote: >> With the text terminal info browser called "info" as well as Emacs' info >> browser you can use command "s" (stands for "search"). It prompts for a >> regexp pattern to search in the whole document, including subsections >>

Re: Man pages and info pages (was: Python documentation too difficult for beginners)

2010-11-02 Thread Tim Harig
On 2010-11-02, Teemu Likonen wrote: > * 2010-11-02 18:43 (UTC), Tim Harig wrote: > >> The manual format contains all of the information on one page that can >> be easily searched whereas the info pages are split into sections that >> must be viewed individually. With the man pages, you can almost

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"

Man pages and info pages (was: Python documentation too difficult for beginners)

2010-11-02 Thread Teemu Likonen
* 2010-11-02 18:43 (UTC), Tim Harig wrote: > The manual format contains all of the information on one page that can > be easily searched whereas the info pages are split into sections that > must be viewed individually. With the man pages, you can almost always > find what you want with a quick se

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 w

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
nd the epydoc format useful. And I'm glad that various people have taken the trouble to produce documentation for Python in various formats that suit them. 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: 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

Python documentation too difficult for beginners

2010-11-02 Thread jk
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://www.russellbeat

Re: bug in python documentation?

2010-09-11 Thread Vito 'ZeD' De Tullio
Benjamin Kaplan wrote: > You're looking at the 2.7 documentation. Are you using 2.7? whoops, no: 2.6.5 :\ (but the "new in python X.Y.Z" disclaimer does not apply to the example snippets?) -- By ZeD -- http://mail.python.org/mailman/listinfo/python-list

Re: bug in python documentation?

2010-09-11 Thread Thomas Jollans
On Saturday 11 September 2010, it occurred to Vito 'ZeD' De Tullio to exclaim: > from http://docs.python.org/library/unittest.html > > $ python test_unittest.py > .E. > == > ERROR: test_sample (__main__.TestSequenceFunctions) > --

Re: bug in python documentation?

2010-09-11 Thread Benjamin Kaplan
On Sat, Sep 11, 2010 at 11:34 AM, Vito 'ZeD' De Tullio wrote: > from http://docs.python.org/library/unittest.html > > -->8>8>8>8>8>8>8>8>8>8>8>8-- > > Here is a short script to test three functions from the random module: > > import random > import unitt

bug in python documentation?

2010-09-11 Thread Vito 'ZeD' De Tullio
from http://docs.python.org/library/unittest.html -->8>8>8>8>8>8>8>8>8>8>8>8-- Here is a short script to test three functions from the random module: import random import unittest class TestSequenceFunctions(unittest.TestCase): def setUp(self):

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

Python Documentation website layout changed?

2010-03-17 Thread Andrej Mitrovic
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 parts of the documentation as well. -- http://mail.python.or

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/052368a71f

Python documentation servers

2009-08-10 Thread Roy Hyunjin Han
Are there issues with the python documentation servers? http://docs.python.org/ The site has been really slow to respond all weekend. -- http://mail.python.org/mailman/listinfo/python-list

Re: is anyone using text to speech to read python documentation

2009-06-05 Thread edexter
On Jun 3, 12:28 pm, Stef Mientki wrote: > eric_dex...@msn.com wrote: > >      I wrote a small pre-processor for python documentation and I am > > looking for advice on how to get the most natural sounding reading.  I > > uploaded an example of a reading of lxml docume

  1   2   3   4   >