Here's a patch that changes the reference to :class:`file` in the iterable entry in Doc/glossary.rst to :term:`file objects <file object>`, along with minor grammatical fixes to make it fit, and reflowing of the text.

If you are changing just a few minor things, can you resubmit the patch without reflowing?  It will be easier to see what minor things have changed.  (It is okay to have the occasional short line to avoid having long lines.  Reflowing can be done as part of a separate commit if it is severe.)

Hello Zachary, What'wrong with referencing :class:`file` for iterable? I find it as OK. Also if it needs to be corrected, the reference could be made for :ref:`bltin-file-objects`

Re grammatical fixes, you could point out which were made as with the reflow of the text, it is difficult to spot the fix.

senthil: the file type doesn't exist any more in python3.

Oh Okay, Thanks! I was checking it against 2.7!

On Tue, Jan 1, 2013 at 11:48 AM, R. David Murray <report@bugs.python.org>wrote:

>
> R. David Murray added the comment:
>
> senthil: the file type doesn't exist any more in python3.
>
> ----------
> nosy: +r.david.murray
>
> _______________________________________
> Python tracker <report@bugs.python.org>
> <http://bugs.python.org/issue16747>
> _______________________________________
>

Hi folks,

Sorry it's taken me so long to get back to this, it's been a busy month :)

Here's the non-reflowed diff.  In retrospect, I should have just specifically mentioned the grammatical changes I made in the first place; they were merely to change 'and' between 'dict' and 'file object' to a comma, and add a comma after 'file object'.

Yes, that would have been better.
I actually prefer reflowing text, but pointing out the changes makes reviewing the patch easier.

Changed lines should still be reflowed to respect the column limit.  I was just referring to the unchanged lines before and afterwards that shouldn't be reflowed.

Not reflowing makes it easier for people viewing diffs on python-checkins and hg.python.org, using hg annotate, etc. to see what has changed.

I reviewed the patch. Changes LGTM.

New changeset 2afc0997e440 by Ezio Melotti in branch '3.2':
#16747: fix link to file objects in the glossary.
http://hg.python.org/cpython/rev/2afc0997e440

New changeset 6e4fc5e2acf8 by Ezio Melotti in branch '3.3':
#16747: merge with 3.2.
http://hg.python.org/cpython/rev/6e4fc5e2acf8

New changeset e19ed347523e by Ezio Melotti in branch 'default':
#16747: merge with 3.3.
http://hg.python.org/cpython/rev/e19ed347523e

Fixed, thanks for the report and the patch!

New changeset dea89ee34402 by Chris Jerdonek in branch '2.7':
Issue #16747: Reflow iterable glossary entry to match 3.x change e19ed347523e.
http://hg.python.org/cpython/rev/dea89ee34402