jenkins-bot submitted this change.

View Change

[doc] Update ROADMAP.rst, update doc strings

Change-Id: I7dea0f031379ac563fe1f19a6946a177edce461f
---
M ROADMAP.rst
M pywikibot/pagegenerators.py
M pywikibot/site/_generators.py
3 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/ROADMAP.rst b/ROADMAP.rst
index a688629..1f6e461 100644
--- a/ROADMAP.rst
+++ b/ROADMAP.rst
@@ -1,9 +1,15 @@
 Current release changes
 ^^^^^^^^^^^^^^^^^^^^^^^
 
+* APISite method pagelanglinks() may skip links with empty titles (T223157)
+* User.name() method was removed in favour of User.username property
+* BasePage.getLatestEditors() method was removed in favour of contributors() or revisions()
+* pagenenerators.handleArg() method was renamed to handle_arg() (T271437)
+* CategoryGenerator, FileGenerator, ImageGenerator and ReferringPageGenerator pagegenerator functions were removed
+* Family.ignore_certificate_error() method was removed in favour of verify_SSL_certificate (T265205)
 * tools.is_IP was renamed to is_ip_address due to PEP8
 * Fix Page.getDeletedRevision() method which always returned an empty list
-* Async chunked uploads are supported (T129216, 133443)
+* Async chunked uploads are supported (T129216, T133443)
 * A new InvalidPageError will be raised if a Page has no version history (T280043)
 * config2.py was renamed to config.py
 * L10N updates
@@ -26,9 +32,5 @@
 * 6.0.1: Site.undeletepage() and Site.undelete_file_versions() will be removed in favour of Site.undelete() method
 * 6.0.1: Site.deletepage() and Site.deleteoldimage() will be removed in favour of Site.delete() method
 * 6.0.1: DataSite.createNewItemFromPage() method will be removed in favour of ImagePage.fromPage() (T98663)
-* 6.0.0: User.name() method will be removed in favour of User.username property
-* 5.6.0: pagenenerators.handleArg() method will be removed in favour of handle_arg() (T271437)
-* 5.6.0: Family.ignore_certificate_error() method will be removed in favour of verify_SSL_certificate() (T265205)
 * 5.0.0: OptionHandler.options dict will be removed in favour of OptionHandler.opt
 * 5.0.0: Methods deprecated for 5 years or longer will be removed
-* 5.0.0: pagegenerators.ReferringPageGenerator is desupported and will be removed
diff --git a/pywikibot/pagegenerators.py b/pywikibot/pagegenerators.py
index a8c635a..a992b3c 100644
--- a/pywikibot/pagegenerators.py
+++ b/pywikibot/pagegenerators.py
@@ -1215,7 +1215,10 @@
         return self._parse_log_events(*params)
 
     def handle_args(self, args: Iterable[str]) -> List[str]:
-        """Handle command line arguments and return the rest as a list."""
+        """Handle command line arguments and return the rest as a list.
+
+        *New in version 6.0.*
+        """
         return [arg for arg in args if not self.handle_arg(arg)]
 
     def handle_arg(self, arg: str) -> bool:
@@ -1227,6 +1230,8 @@
         can try parsing the argument. Call getCombinedGenerator() after all
         arguments have been parsed to get the final output generator.
 
+        *Renamed in version 6.0.*
+
         @param arg: Pywikibot argument consisting of -name:value
         @return: True if the argument supplied was recognised by the factory
         """
diff --git a/pywikibot/site/_generators.py b/pywikibot/site/_generators.py
index 475d71b..cfa7bf8 100644
--- a/pywikibot/site/_generators.py
+++ b/pywikibot/site/_generators.py
@@ -736,6 +736,8 @@
                       include_empty_titles: bool = False):
         """Iterate all interlanguage links on page, yielding Link objects.
 
+        *New in 6.2:* *include_empty_titles* parameter was added.
+
         @see: U{https://www.mediawiki.org/wiki/API:Langlinks}
 
         @param include_obsolete: if true, yield even Link objects whose

To view, visit change 691263. To unsubscribe, or for help writing mail filters, visit settings.