docs: make pebble.Client.remove_path and Container.remove_path docs consistent

ops/model.py

@@ -2516,7 +2516,15 @@ def remove_path(self, path: Union[str, PurePath], *, recursive: bool = False):
 
         Args:
             path: Path of the file or directory to delete from the remote system.
-            recursive: If True, recursively delete path and everything under it.
+            recursive: If True, and path is a directory, recursively delete it and
+                       everything under it. If path is a file, delete the file. In
+                       either case, do nothing if the file or directory does not
+                       exist. Behaviourally similar to ``rm -rf <file|dir>``.
+
+        Raises:
+            pebble.PathError: If a relative path is provided, or if `recursive` is False
+                and the file or directory cannot be removed (it does not exist or is not empty).
+
         """
         self._pebble.remove_path(str(path), recursive=recursive)
 

ops/pebble.py

@@ -2153,11 +2153,15 @@ def remove_path(self, path: str, *, recursive: bool = False):
 
         Args:
             path: Path of the file or directory to delete from the remote system.
-            recursive: If True, and path is a directory recursively deletes it and
+            recursive: If True, and path is a directory, recursively deletes it and
                        everything under it. If the path is a file, delete the file and
                        do nothing if the file is non-existent. Behaviourally similar
                        to ``rm -rf <file|dir>``.
 
+        Raises:
+            PathError: If the file cannot be removed (perhaps it does not
+                exist) and `recursive` is false, or if a relative path is provided.
+
         """
         info: Dict[str, Any] = {'path': path}
         if recursive: