From rrr at ronadam.com Tue Mar 2 05:45:22 2010 From: rrr at ronadam.com (Ron Adam) Date: Mon, 01 Mar 2010 22:45:22 -0600 Subject: [Doc-SIG] pydoc gui enhancement Message-ID: Hi, just updated this patch so it works with Python version 3.2. http://bugs.python.org/issue2001 What it does is add a navigation bar at the top of the web pages so you can do the following. + Shows what version of python you are browsing/using. + Get an item - It takes the same input as the help() function does in the console. + Search - Returns the same result as the tkinter search box. + Module index - The normal default top level. + Topics - lists all the topics. They can be clicked on and the results are displayed with xrefs that can be clicked on. + Keywords - Lists all the keywords. Works the same as Topics. Also the file links are read in as text and served as a pydoc page instead of relying on the browsers file reading capability. That is much safer and gives a better file listing. This patch removes the tkinter search bar sense it's no longer needed. tkinter is no longer needed for pydoc to run in gui mode. It really makes browsing pythons library a breeze. If someone can try it out and give me some additional feedback as to possibly any problems or any changes I need to make it would be nice. Thanks, Ron Adam From ianb at colorstudy.com Tue Mar 2 17:28:50 2010 From: ianb at colorstudy.com (Ian Bicking) Date: Tue, 2 Mar 2010 10:28:50 -0600 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: <26748865.post@talk.nabble.com> References: <26748865.post@talk.nabble.com> Message-ID: There's an effort to create a new set of documentation for packaging: http://guide.python-distribute.org/ Ideally this work will end up on docs.python.org at some point. On Fri, Dec 11, 2009 at 12:05 PM, Dr. Phillip M. Feldman < pfeldman at verizon.net> wrote: > > The procedure for uploading to PyPI is not well documented. I had to read > several different docs and do some experimentation before coming up with > the > following: > > Procedure for uploading to the Python Package Index (PyPI): > > 1. Create setup.py file. > 2. Create ".pypirc" file if it does not already exist. > 3. Launch IPython. > 4. Issue the command "run setup register" > 5. Issue the command "run setup sdist upload". > 6. Log into PyPI and adjust visibility of old versions as necessary. > > I'd like to see this list of steps (or something similar) in the docs. > -- > View this message in context: > http://old.nabble.com/better-documentation-on-how-to-upload-to-PyPI-tp26748865p26748865.html > Sent from the Python - doc-sig mailing list archive at Nabble.com. > > _______________________________________________ > Doc-SIG maillist - Doc-SIG at python.org > http://mail.python.org/mailman/listinfo/doc-sig > -- Ian Bicking | http://blog.ianbicking.org | http://twitter.com/ianbicking -------------- next part -------------- An HTML attachment was scrubbed... URL: From ncoghlan at gmail.com Tue Mar 2 21:49:45 2010 From: ncoghlan at gmail.com (Nick Coghlan) Date: Wed, 03 Mar 2010 06:49:45 +1000 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: References: <26748865.post@talk.nabble.com> Message-ID: <4B8D79E9.9060603@gmail.com> Ian Bicking wrote: > There's an effort to create a new set of documentation for > packaging: http://guide.python-distribute.org/ > > Ideally this work will end up on docs.python.org > at some point. Would it be worth including a "See Also" or some other link in the main docs in the meantime? (the quick start there does appear to be the brief list of the basic steps that the main docs are missing) Cheers, Nick. -- Nick Coghlan | ncoghlan at gmail.com | Brisbane, Australia --------------------------------------------------------------- From ianb at colorstudy.com Tue Mar 2 21:54:31 2010 From: ianb at colorstudy.com (Ian Bicking) Date: Tue, 2 Mar 2010 14:54:31 -0600 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: <4B8D79E9.9060603@gmail.com> References: <26748865.post@talk.nabble.com> <4B8D79E9.9060603@gmail.com> Message-ID: On Tue, Mar 2, 2010 at 2:49 PM, Nick Coghlan wrote: > Ian Bicking wrote: > > There's an effort to create a new set of documentation for > > packaging: http://guide.python-distribute.org/ > > > > Ideally this work will end up on docs.python.org > > at some point. > > Would it be worth including a "See Also" or some other link in the main > docs in the meantime? (the quick start there does appear to be the brief > list of the basic steps that the main docs are missing) > Yes, I'm sure that would be quite helpful for readers. -- Ian Bicking | http://blog.ianbicking.org | http://twitter.com/ianbicking -------------- next part -------------- An HTML attachment was scrubbed... URL: From fuzzyman at voidspace.org.uk Wed Mar 3 00:53:32 2010 From: fuzzyman at voidspace.org.uk (Michael Foord) Date: Tue, 02 Mar 2010 23:53:32 +0000 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: References: <26748865.post@talk.nabble.com> <4B8D79E9.9060603@gmail.com> Message-ID: <4B8DA4FC.6010709@voidspace.org.uk> On 02/03/2010 20:54, Ian Bicking wrote: > On Tue, Mar 2, 2010 at 2:49 PM, Nick Coghlan > wrote: > > Ian Bicking wrote: > > There's an effort to create a new set of documentation for > > packaging: http://guide.python-distribute.org/ > > > > Ideally this work will end up on docs.python.org > > > at some point. > > Would it be worth including a "See Also" or some other link in the > main > docs in the meantime? (the quick start there does appear to be the > brief > list of the basic steps that the main docs are missing) > > > Yes, I'm sure that would be quite helpful for readers. If we make the change in 2.6-maint then it will be on the main docs when 2.6 is released. What documentation page should it go on? I've added a link to the following page, but don't think that will be particularly effective: http://python.org/doc/ Michael > > -- > Ian Bicking | http://blog.ianbicking.org | http://twitter.com/ianbicking > > > _______________________________________________ > Doc-SIG maillist - Doc-SIG at python.org > http://mail.python.org/mailman/listinfo/doc-sig > -- http://www.ironpythoninaction.com/ http://www.voidspace.org.uk/blog READ CAREFULLY. By accepting and reading this email you agree, on behalf of your employer, to release me from all obligations and waivers arising from any and all NON-NEGOTIATED agreements, licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap, confidentiality, non-disclosure, non-compete and acceptable use policies (?BOGUS AGREEMENTS?) that I have entered into with your employer, its partners, licensors, agents and assigns, in perpetuity, without prejudice to my ongoing rights and privileges. You further represent that you have the authority to release me from any BOGUS AGREEMENTS on behalf of your employer. -------------- next part -------------- An HTML attachment was scrubbed... URL: From g.brandl at gmx.net Wed Mar 3 08:36:07 2010 From: g.brandl at gmx.net (Georg Brandl) Date: Wed, 03 Mar 2010 08:36:07 +0100 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: <4B8DA4FC.6010709@voidspace.org.uk> References: <26748865.post@talk.nabble.com> <4B8D79E9.9060603@gmail.com> <4B8DA4FC.6010709@voidspace.org.uk> Message-ID: <4B8E1167.1020602@gmx.net> Am 03.03.2010 00:53, schrieb Michael Foord: > On 02/03/2010 20:54, Ian Bicking wrote: >> On Tue, Mar 2, 2010 at 2:49 PM, Nick Coghlan > > wrote: >> >> Ian Bicking wrote: >> > There's an effort to create a new set of documentation for >> > packaging: http://guide.python-distribute.org/ >> > >> > Ideally this work will end up on docs.python.org >> >> > at some point. >> >> Would it be worth including a "See Also" or some other link in the >> main >> docs in the meantime? (the quick start there does appear to be the >> brief >> list of the basic steps that the main docs are missing) >> >> >> Yes, I'm sure that would be quite helpful for readers. > > If we make the change in 2.6-maint then it will be on the main docs when > 2.6 is released. What documentation page should it go on? > > I've added a link to the following page, but don't think that will be > particularly effective: > > http://python.org/doc/ http://docs.python.org/distutils/ comes to mind -- a seealso right before the big table of contents? Georg From ziade.tarek at gmail.com Wed Mar 3 10:10:11 2010 From: ziade.tarek at gmail.com (=?ISO-8859-1?Q?Tarek_Ziad=E9?=) Date: Wed, 3 Mar 2010 10:10:11 +0100 Subject: [Doc-SIG] better documentation on how to upload to PyPI Message-ID: <94bdd2611003030110ua6dae6ahedcc97a5e5c3d10a@mail.gmail.com> > From: Michael Foord > Date: Tue, Mar 2, 2010 at 5:53 PM > Subject: Re: [Doc-SIG] better documentation on how to upload to PyPI > To: Ian Bicking > Cc: Nick Coghlan , doc-sig at python.org > > > On 02/03/2010 20:54, Ian Bicking wrote: > > On Tue, Mar 2, 2010 at 2:49 PM, Nick Coghlan wrote: >> >> Ian Bicking wrote: >> > There's an effort to create a new set of documentation for >> > packaging: http://guide.python-distribute.org/ >> > >> > Ideally this work will end up on docs.python.org >> > at some point. >> >> Would it be worth including a "See Also" or some other link in the main >> docs in the meantime? (the quick start there does appear to be the brief >> list of the basic steps that the main docs are missing) > > Yes, I'm sure that would be quite helpful for readers. > > If we make the change in 2.6-maint then it will be on the main docs when 2.6 > is released. What documentation page should it go on? > > I've added a link to the following page, but don't think that will be > particularly effective: > > http://python.org/doc/ > > Michael Hello, I've asked Georg about the best location for the guide in the doc a few days ago since we planned to include it in docs.python.org during the summit. If the HH guide is included before it is finished as we have planned, maybe it could be included right now as part of the 2.6 maintenance as well. So the "See also link" would be an internal link in docs.python.org. I am proposing this to avoid maintaining guide.python-distribute.org *and* a section in docs.python.org once 2.7 is out. This will also avoid confusion for the community imho. Cheers Tarek -- Tarek Ziad? | http://ziade.org From fuzzyman at voidspace.org.uk Wed Mar 3 11:34:11 2010 From: fuzzyman at voidspace.org.uk (Michael Foord) Date: Wed, 03 Mar 2010 10:34:11 +0000 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: <94bdd2611003030110ua6dae6ahedcc97a5e5c3d10a@mail.gmail.com> References: <94bdd2611003030110ua6dae6ahedcc97a5e5c3d10a@mail.gmail.com> Message-ID: <4B8E3B23.40400@voidspace.org.uk> On 03/03/2010 09:10, Tarek Ziad? wrote: >> From: Michael Foord >> Date: Tue, Mar 2, 2010 at 5:53 PM >> Subject: Re: [Doc-SIG] better documentation on how to upload to PyPI >> To: Ian Bicking >> Cc: Nick Coghlan, doc-sig at python.org >> >> >> On 02/03/2010 20:54, Ian Bicking wrote: >> >> On Tue, Mar 2, 2010 at 2:49 PM, Nick Coghlan wrote: >> >>> Ian Bicking wrote: >>> >>>> There's an effort to create a new set of documentation for >>>> packaging: http://guide.python-distribute.org/ >>>> >>>> Ideally this work will end up on docs.python.org >>>> at some point. >>>> >>> Would it be worth including a "See Also" or some other link in the main >>> docs in the meantime? (the quick start there does appear to be the brief >>> list of the basic steps that the main docs are missing) >>> >> Yes, I'm sure that would be quite helpful for readers. >> >> If we make the change in 2.6-maint then it will be on the main docs when 2.6 >> is released. What documentation page should it go on? >> >> I've added a link to the following page, but don't think that will be >> particularly effective: >> >> http://python.org/doc/ >> >> Michael >> > > Hello, > > I've asked Georg about the best location for the guide in the doc a > few days ago > since we planned to include it in docs.python.org during the summit. > > If the HH guide is included before it is finished as we have planned, > maybe it could be included right now > as part of the 2.6 maintenance as well. > > So the "See also link" would be an internal link in docs.python.org. I > am proposing this to avoid > maintaining guide.python-distribute.org *and* a section in > docs.python.org once 2.7 is out. This will > also avoid confusion for the community imho. > See if Georg approves that. If he does I will leave it to you to check it into the documentation. All the best, Michael > Cheers > Tarek > > > -- http://www.ironpythoninaction.com/ http://www.voidspace.org.uk/blog READ CAREFULLY. By accepting and reading this email you agree, on behalf of your employer, to release me from all obligations and waivers arising from any and all NON-NEGOTIATED agreements, licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap, confidentiality, non-disclosure, non-compete and acceptable use policies (?BOGUS AGREEMENTS?) that I have entered into with your employer, its partners, licensors, agents and assigns, in perpetuity, without prejudice to my ongoing rights and privileges. You further represent that you have the authority to release me from any BOGUS AGREEMENTS on behalf of your employer. From g.brandl at gmx.net Wed Mar 3 08:36:07 2010 From: g.brandl at gmx.net (Georg Brandl) Date: Wed, 03 Mar 2010 08:36:07 +0100 Subject: [Doc-SIG] better documentation on how to upload to PyPI In-Reply-To: <4B8DA4FC.6010709@voidspace.org.uk> References: <26748865.post@talk.nabble.com> <4B8D79E9.9060603@gmail.com> <4B8DA4FC.6010709@voidspace.org.uk> Message-ID: <4B8E1167.1020602@gmx.net> Am 03.03.2010 00:53, schrieb Michael Foord: > On 02/03/2010 20:54, Ian Bicking wrote: >> On Tue, Mar 2, 2010 at 2:49 PM, Nick Coghlan > > wrote: >> >> Ian Bicking wrote: >> > There's an effort to create a new set of documentation for >> > packaging: http://guide.python-distribute.org/ >> > >> > Ideally this work will end up on docs.python.org >> >> > at some point. >> >> Would it be worth including a "See Also" or some other link in the >> main >> docs in the meantime? (the quick start there does appear to be the >> brief >> list of the basic steps that the main docs are missing) >> >> >> Yes, I'm sure that would be quite helpful for readers. > > If we make the change in 2.6-maint then it will be on the main docs when > 2.6 is released. What documentation page should it go on? > > I've added a link to the following page, but don't think that will be > particularly effective: > > http://python.org/doc/ http://docs.python.org/distutils/ comes to mind -- a seealso right before the big table of contents? Georg