From a6ec184d43f2629dd151d26c3f0b8518b7b9299f Mon Sep 17 00:00:00 2001
From: Xymph <Xymph@users.noreply.github.com>
Date: Sun, 23 Jul 2023 13:46:10 +0200
Subject: [PATCH] Describe usage of Wikimate::undelete()

---
 CHANGELOG.md |  4 +++-
 USAGE.md     | 13 ++++++++++++-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b49602..e26d4bd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,7 +11,7 @@ and [Keep a Changelog](http://keepachangelog.com/).
 
 - Added internal mechanism to handle version-dependent parameters of API modules ([#151])
 - Support version-dependent `deletetalk` parameter in `WikiPage::delete()` and `WikiFile::delete()` ([#152])
-- New method `Wikimate::undelete()` ([#153])
+- New method `Wikimate::undelete()` ([#153], [#155])
 
 ### Changed
 
@@ -251,3 +251,5 @@ and may require changes in applications that invoke these methods:_
 [#150]: https://github.com/hamstar/Wikimate/pull/150
 [#151]: https://github.com/hamstar/Wikimate/pull/151
 [#152]: https://github.com/hamstar/Wikimate/pull/152
+[#153]: https://github.com/hamstar/Wikimate/pull/153
+[#155]: https://github.com/hamstar/Wikimate/pull/155
diff --git a/USAGE.md b/USAGE.md
index 67e5ba0..077d725 100644
--- a/USAGE.md
+++ b/USAGE.md
@@ -12,6 +12,7 @@
   - [Deleting...](#deleting-1)
 - [Other stuff](#other-stuff)
   - [Running custom queries](#running-custom-queries)
+  - [Restoring a deleted page or file](#restoring-a-deleted-page-or-file)
   - [Customizing the user agent](#customizing-the-user-agent)
   - [Maximum lag and retries](#maximum-lag-and-retries)
   - [Handling errors and exceptions](#handling-errors-and-exceptions)
@@ -347,6 +348,16 @@ $array_result = $wiki->edit($data);
 
 Both methods return an array of the MediaWiki API result.
 
+### Restoring a deleted page or file
+
+A previously deleted page or file can be undeleted via its original path,
+including namespace if applicable:
+
+```php
+$wiki->undelete('Sausages');
+$wiki->undelete('File:Old-button.png');
+```
+
 ### Customizing the user agent
 
 API requests are made over HTTP with a user agent string to identify
@@ -358,8 +369,8 @@ The string can be retrieved and customized via:
 
 ```php
 $useragent = $wiki->getUserAgent();
-$wiki->setUserAgent('Custom User Agent');
 $wiki->setUserAgent('Custom Prefix - ' . $useragent);
+$wiki->setUserAgent('Custom User Agent');
 ```
 
 In order to use a custom user agent for all requests in the session,