From 75f1107b7c34952e3aef1dfd0acb2282296040dd Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Sun, 5 Apr 2009 10:32:26 +0000 Subject: Avoid sure signs of a diseased mind. --- Doc/distutils/apiref.rst | 4 ++-- Doc/library/_winreg.rst | 5 +++-- Doc/library/shelve.rst | 2 +- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst index a3b464a..4ee9fcc 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 e9c0fa7..7876f85 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 b5e7eae..1afa19b 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 -- cgit v0.12