diff --git a/src/Composer/Package/Package.php b/src/Composer/Package/Package.php
index f7ee0b1b7..ba3f611c1 100644
--- a/src/Composer/Package/Package.php
+++ b/src/Composer/Package/Package.php
@@ -498,9 +498,8 @@ class Package extends BasePackage
      * Replaces current version and pretty version with passed values.
      * It also sets stability.
      *
-     * @param string $version
-     *
-     * @param string $prettyVersion
+     * @param string $version       The package's normalized version
+     * @param string $prettyVersion The package's non-normalized version
      */
     public function replaceVersion($version, $prettyVersion)
     {