[Boost-users] boost::filesystem::rename() documentation incorrect

Subject: [Boost-users] boost::filesystem::rename() documentation incorrect
From: Paul (elegant_dice_at_[hidden])
Date: 2009-09-25 03:59:01

Hi all,

this documentation is incorrect:
Otherwise, if to_p resolves to an existing file, it is removed.

This is from Boost 1.40.0, and yet the code for rename() calls
rename_api() which then does the following:
        if ( fs::exists( status_api( to, dummy ) ) )
          return error_code( EEXIST, system_category );

ie, if to_p resolves to an existing file, it will always return/throw
an error... NOT remove the existing file, as was documented.

Or am I reading things wrong?

cheers
Paul