Bugs item #891249, was opened at 2004-02-05 19:08
Message generated for change (Comment added) made by gbrandl
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=891249&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: Python 2.3
>Status: Closed
>Resolution: Out of Date
Priority: 5
Submitted By: Brad Clements (bkc)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: pickle dump argument description vague

Initial Comment:
The documentation for pickle.dump()

see http://www.python.org/doc/current/lib/node64.html

dump(   object, file[, protocol[, bin]])

implies that up to four arguments can be specified.
That bin can be specified if protocol has been
specified. The implementation actually accepts only 3
arguments, the last one being either 'protocol' or a
'bin' flag.

The text notation for this function needs to be
clarified, and the visual presentation of the argument
functions changed.

Perhaps to:

dump(   object, file[, protocol | bin])

or

dump(   object, file[, protocol] | [, bin])

or

dump(   object, file[, protocol_or_bin])




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

>Comment By: Georg Brandl (gbrandl)
Date: 2006-03-31 14:13

Message:
Logged In: YES 
user_id=849994

Python 2.5 docs don't include the "bin" parameter any more.

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

Comment By: Žiga Seilnacht (zseil)
Date: 2006-03-31 14:05

Message:
Logged In: YES 
user_id=1326842

The bin parameter has been consistently removed from the
docs as well as from the pickle module in revision 37966.

Resolution should be changed to fixed.

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

Comment By: Irmen de Jong (irmen)
Date: 2004-11-07 19:13

Message:
Logged In: YES 
user_id=129426

There is one other thing.
The cPickle dump/dumps functions don't like the 'bin'
argument at all:
TypeError: 'bin' is an invalid keyword argument for this
function
They only accept the 'protocol' argument.

So that's another thing that should probably be changed in
cPickle (also see bug 888594), or it should probably be
mentioned in the docs, or the 'bin' argument should be
removed totally ;-)

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

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=891249&group_id=5470
_______________________________________________
Python-bugs-list mailing list 
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to