doc: update links and docs on checking links

Add timeout for link checking so make linkcheck completes.

Document grep command to use to filter broken links to external links.

Fix PostgreSQL links to point to current pages.
Fix pyreadline3 link.
Fix vim po file plugin link
Use wayback machine for zpi internationalization link.

Author: rouilj

RELEASE.txt

@@ -56,6 +56,14 @@ Roundup release checklist:
        fix broken references in docs
        verify redirects are correct
 
+    Use::
+
+        grep '\[broken\]\s*htt'  _tmp/linkcheck/output.txt
+
+    to find external refs only. Internal refs will probably fail
+    because they don't use :ref: or :doc: roles to reference them.
+    They are referenced using html link syntax.
+
 5.  Update setup.py info if needed (contacts, classifiers, etc.). When
     releasing check that Development Status matches release: stable,
     beta alpha etc.

doc/admin_guide.txt

@@ -583,7 +583,7 @@ languages are supported.
    to_tsquery. It is enabled by starting the search phrase with ``ts:``.
 
 .. _Parsing Queries: \
-   https://www.postgresql.org/docs/14/textsearch-controls.html#TEXTSEARCH-PARSING-QUERIES
+   https://www.postgresql.org/docs/current/textsearch-controls.html#TEXTSEARCH-PARSING-QUERIES
 
 Websearch provides a more natural style of search and supports:
 
@@ -641,7 +641,7 @@ You will see an error about ``text search configuration ... does not
 exist``.
 
 .. _own textsearch configuration: \
-  https://www.postgresql.org/docs/14/textsearch-configuration.html
+  https://www.postgresql.org/docs/current/textsearch-configuration.html
 
 It may be possible to append to this list using the tracker's
 interfaces.py. For details, see ``test/test_indexer.py`` in the
@@ -1457,8 +1457,8 @@ If you are using GNU readline, ``set history-size 10``. If your
 installation uses libedit (macs), it should be possible to
 persistently set the history size using ``history size
 10``. Pyreadline3 can set history length using
-``history_length(10)``. See the older documentation for example syntax:
-https://pythonhosted.org/pyreadline/usage.html.persistently.
+``history_length(10)``. See the documentation for example syntax:
+https://pythonhosted.org/pyreadline/usage.html#configuration-file.
 
 History is saved to the file ``.roundup_admin_history`` in your home
 directory (for windows usually ``\Users\<username>``.

doc/developers.txt

@@ -664,7 +664,7 @@ At run time, Roundup automatically compiles message catalogs whenever
 .. _Plural Forms:
    https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/gettext.html
 .. _po filetype plugin:
-    https://vim.sourceforge.io/scripts/script.php?script_id=695
+    https://www.vim.org/scripts/script.php?script_id=64
 .. _PO utilities: https://github.com/pinard/po-utils
 .. _poEdit: https://poedit.net/
 .. _pology: http://pology.nedohodnik.net/doc/user/en_US/ch-poformat.html
@@ -685,4 +685,4 @@ At run time, Roundup automatically compiles message catalogs whenever
    https://pagetemplates.readthedocs.io/en/latest/history/TALESSpecification13.html
 .. _TravisCI: https://app.travis-ci.com/github/roundup-tracker/roundup
 .. _vim: https://www.vim.org/
-.. _ZPTInternationalization: http://grok.zope.org/doc/community/view_generation/i18n_of_your_app.html
+.. _ZPTInternationalization: https://web.archive.org/web/20120804003011/http://grok.zope.org/doc/community/view_generation/i18n_of_your_app.html

website/www/conf.py

@@ -246,3 +246,5 @@
     r'https://.../rest/.*',              # dummy example url
     r'http://dev.zope.org/Wikis/DevSite/Projects/ComponentArchitecture/ZPTInternationalizationSupport',                 # dead link, there for historic
 ]
+
+linkcheck_timeout = 10  # seconds