Merged revisions 81168 via svnmerge from

Merged revisions 81168 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r81168 | victor.stinner | 2010-05-14 17:58:55 +0200 (ven., 14 mai 2010) | 10 lines

  Issue #8711: Document PyUnicode_DecodeFSDefault*() functions

   * Add paragraph titles to c-api/unicode.rst.
   * Fix PyUnicode_DecodeFSDefault*() comment: it now uses the "surrogateescape"
     error handler (and not "replace")
   * Remove "The function is intended to be used for paths and file names only
     during bootstrapping process where the codecs are not set up." from
     PyUnicode_FSConverter() comment: it is used after the bootstrapping and for
     other purposes than file names
........