From: Georg Brandl Date: Sun, 5 Apr 2009 10:32:26 +0000 (+0000) Subject: Avoid sure signs of a diseased mind. X-Git-Tag: v2.7a1~1568 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=75f1107b7c34952e3aef1dfd0acb2282296040dd;p=python Avoid sure signs of a diseased mind. --- diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst index a3b464afec..4ee9fcc81c 100644 --- a/Doc/distutils/apiref.rst +++ b/Doc/distutils/apiref.rst @@ -1050,8 +1050,8 @@ This module contains some utility functions for operating on individual files. .. warning:: - Handles cross-device moves on Unix using :func:`copy_file`. What about other - systems??? + Handles cross-device moves on Unix using :func:`copy_file`. What about + other systems? .. function:: write_file(filename, contents) diff --git a/Doc/library/_winreg.rst b/Doc/library/_winreg.rst index e9c0fa7795..7876f8573b 100644 --- a/Doc/library/_winreg.rst +++ b/Doc/library/_winreg.rst @@ -252,9 +252,10 @@ This module offers the following functions: associated. If this parameter is ``None`` or empty, the function retrieves the value set by the :func:`SetValue` method for the key identified by *key*. - Values in the registry have name, type, and data components. This method + Values in the registry have name, type, and data components. This method retrieves the data for a key's first value that has a NULL name. But the - underlying API call doesn't return the type, Lame Lame Lame, DO NOT USE THIS!!! + underlying API call doesn't return the type, so always use + :func:`QueryValueEx` if possible. .. function:: QueryValueEx(key, value_name) diff --git a/Doc/library/shelve.rst b/Doc/library/shelve.rst index b5e7eae815..1afa19ba3e 100644 --- a/Doc/library/shelve.rst +++ b/Doc/library/shelve.rst @@ -148,7 +148,7 @@ object):: # as d was opened WITHOUT writeback=True, beware: d['xx'] = range(4) # this works as expected, but... - d['xx'].append(5) # *this doesn't!* -- d['xx'] is STILL range(4)!!! + d['xx'].append(5) # *this doesn't!* -- d['xx'] is STILL range(4)! # having opened d without writeback=True, you need to code carefully: temp = d['xx'] # extracts the copy