Roundup Robot added the comment:
New changeset d1ef91025d70 by Andrew Svetlov in branch 'default':
Issue #5066: Update IDLE docs
http://hg.python.org/cpython/rev/d1ef91025d70
--
nosy: +python-dev
___
Python tracker rep...@bugs.python.org
Andrew Svetlov added the comment:
Pushed. Thanks.
--
resolution: - fixed
stage: patch review - committed/rejected
status: open - closed
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
Zachary Ware added the comment:
Version 4 looks good to me!
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
___
Python-bugs-list mailing
Éric Araujo added the comment:
Idle needs to find its text help files at runtime, so they are installed as
data alongside with the code. The rst doc files however can be installed
anywhere or not installed at all, so we can’t change Idle to look for them.
An alternate idea to avoid
Senthil Kumaran added the comment:
Regardless of the topic of merge, the suggested improvements for both idle.rst
and help.txt are great! Thanks for working the patch, Todd.
I am +1 with the changes. If no else has any comments, I can go ahead with
committing this.
--
nosy: +orsenthil
Zachary Ware added the comment:
I'd like to see Éric, Ezio, and my comments on v3 in Rietveld addressed, but
after that I'm good with it :)
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
Zachary Ware added the comment:
Issue 16893 has been filed to deal with the idea of merging the files.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
Todd Rovito added the comment:
Thanks Senthil but I don't deserve all the credit this issue is a team effort
with lots of help from Zach, Éric, and Ezio. All of which have improved the
patch's quality a great deal. Hopefully we can address the issues then let you
make the commit soon.
Todd Rovito added the comment:
I took all the comments and created a new patch version 4 which should address
all the issues. Thanks for the excellent review and support from everybody. I
think this patch is a much higher quality now.
--
Added file:
Zachary Ware added the comment:
I wonder, is there any really good reason to keep a separate
Lib/idlelib/help.txt, or can Doc/library/idle.rst be used for its purpose (with
or without a small amount of processing to, for instance, remove comments and
extra backslashes)? Both have most of the
Todd Rovito added the comment:
Zachary,
I like your idea about joining idle.rst with help.txt but I think that
should be covered under a separate bug issue. The way I see it this bug is
about fixing the current documentation. So I suggest you open up a new issue
and get people's take on
Zachary Ware added the comment:
Right you are, Todd; I'll get another issue opened for that soon.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
Todd Rovito added the comment:
Zachary,
Thanks for your excellent review Your feedback was very helpful for
making the patch even better.
--
Added file:
http://bugs.python.org/file28626/5066IDLEocumentationforUnixObsoleteIncorrectVersion3.patch
Todd Rovito added the comment:
Based on Zachary's comments I have uploaded a new version of the patch which is
version 3.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
Todd Rovito added the comment:
A ping on this bug since it has not had any forward movement. Can somebody
please review and or commit? Thanks.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
Zachary Ware added the comment:
Hi Todd, I can't commit, but I have a review in the works for you.
--
nosy: +zach.ware
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
Todd Rovito added the comment:
Thanks much appreciated!
Sent from my iPhone
On Jan 4, 2013, at 1:07 PM, Zachary Ware rep...@bugs.python.org wrote:
Zachary Ware added the comment:
Hi Todd, I can't commit, but I have a review in the works for you.
--
nosy: +zach.ware
Todd Rovito added the comment:
Version 2 of the patch change include:
-help.txt removed all tabs and replaced with spaces, as suggested by Roger
-help.txt re-inserted the section on running IDLE without a subprocess as
suggested by Roger
-Added a note on line 162 (idle.rst) about how the Python
Todd Rovito added the comment:
For version 2 of the patch
-Line 340 (idle.rst) where the Emacs bindings are rendered seemed to work fine
on my computer without the spaces but I think ezio is correct spaces should be
present so I added them
**SHOULD BE**
-Line 340 (idle.rst) where the
Todd Rovito added the comment:
This patch is an extensive refactoring of help.txt and idle.rst. The first
thing I did was merge issue5066.patch from jesstess into the current idle.rst
file, because the original patch from jesstess was so old it had to be merged
by hand into the 3.4 source
Roger Serwy added the comment:
The original help.txt and the patched version still mixes tabs and spaces. This
is a minor point, but perhaps all the tabs should be expanded.
Also, the section on running IDLE without a subprocess should not be removed
until version 3.5. See #16123.
--
Changes by Todd Rovito rovit...@gmail.com:
--
nosy: +Todd.Rovito
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
___
Python-bugs-list
Todd Rovito added the comment:
This is a good patch but it is rather out of date and won't apply. I will
patch the patch and maybe somebody can apply it this time. Expect a new patch
by 11/26/2012.
--
___
Python tracker rep...@bugs.python.org
Changes by Andrew Svetlov andrew.svet...@gmail.com:
--
nosy: +asvetlov
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
___
Python-bugs-list
Changes by Ezio Melotti ezio.melo...@gmail.com:
--
nosy: +ezio.melotti
stage: needs patch - patch review
versions: +Python 3.3 -Python 3.1
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
Ramiro Batista da Luz ramiro...@gmail.com added the comment:
I reviewed the texts, applied the patches, ran idle, edited
Demo/classes/Dates.py run module inside Idle. Generated the docs inside Doc,
with make html and reviewed the IDLE doc in
Jessica McKellar jesst...@mit.edu added the comment:
Attached is a patch updating the IDLE web documentation as well as the help
file displayed when you click the Help - Idle Help menu item in IDLE. It looks
like the IDLE web documentation was lifted directly from the help file at some
point
Daniel Diniz aja...@gmail.com added the comment:
This looks like a perfect match for GHOP.
--
keywords: +easy
nosy: +ajaksu2, gpolo
priority: - normal
stage: - needs patch
type: - behavior
versions: +Python 2.6, Python 3.0, Python 3.1
___
Python
Georg Brandl ge...@python.org added the comment:
I don't know any. But since rst is so lightweight, it is usually not too
much of a pain to just copy the text from the browser and reintroduce
formatting because you're likely to have to go over and edit the whole
content anyway.
Georg Brandl ge...@python.org added the comment:
Well, having nice full docs for IDLE would be nice, but I won't do
anything on this matter except committing a full patch :)
--
assignee: georg.brandl -
___
Python tracker rep...@bugs.python.org
Terry J. Reedy tjre...@udel.edu added the comment:
Is there an HTML to acceptable RST converter?
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5066
___
___
Terry J. Reedy tjre...@udel.edu added the comment:
LOL. That doc was apparently last revised in 2000 for the IDLE released
with 1.5.2 (see screenshot). Other needed updates I see are: 'Shell'
and 'Options' have been added to the menu line; we now have unicode
text; screenshots look different
32 matches
Mail list logo
