update annotations

Author: tmillr

lua/plenary/path.lua

@@ -521,7 +521,8 @@ end
 ---current working directory.
 ---@generic T: Path
 ---@param opts { new_name: Path|string }
----@return T
+---@param opts { new_name: Path|string } options table containing the new name
+---@return Path # Path representing the new name
 function Path:rename(opts)
   -- TODO: For reference, Python's `Path.rename()` actually says/does this:
   --