[Patches] [ python-Patches-1303595 ] Update documentation for __builtins__

[SourceForge.net]

Patches item #1303595, was opened at 2005-09-24 19:06
Message generated for change (Comment added) made by fdrake
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1303595&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: None
>Status: Closed
>Resolution: Accepted
Priority: 5
Submitted By: Collin Winter (collinwinter)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: Update documentation for __builtins__

Initial Comment:
If applied, this patch would explicitly tell users that
they should be using __builtin__ to override built-in
functions, rather than __builtins__. The patch would
also add documentation clairifying that __builtins__ is
a module when in __main__ and a dictionary anywhere else.

This diff was made against dist/src/Doc/ref/ref4.tex,
version 1.38 from CVS.

----------------------------------------------------------------------

>Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2006-06-10 16:04

Message:
Logged In: YES 
user_id=3066

Interestingly, your patch gets the sense which object is
bound to __builtins__ in what context reversed.

I've modified the patch a bit to correct that and make the
warning about direct use of __builtins__ visually stronger
(at  least in the HTML format).

Committed to the trunk as revision 46826, and to the Python
2.4.x maintenance branch as revision 46828.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1303595&group_id=5470