From: Georg Brandl Date: Wed, 29 Oct 2014 09:57:37 +0000 (+0100) Subject: Fixing broken links in doc, part 4: some more breaks and redirects X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0f5d6c00b48fb5e10e19909f5a8ca48bd2b9b0f5;p=python Fixing broken links in doc, part 4: some more breaks and redirects --- diff --git a/Doc/about.rst b/Doc/about.rst index 678168b2df..3ea311fa62 100644 --- a/Doc/about.rst +++ b/Doc/about.rst @@ -6,7 +6,7 @@ About these documents These documents are generated from `reStructuredText`_ sources by `Sphinx`_, a document processor specifically written for the Python documentation. -.. _reStructuredText: http://docutils.sf.net/rst.html +.. _reStructuredText: http://docutils.sourceforge.net/rst.html .. _Sphinx: http://sphinx-doc.org/ .. In the online version of these documents, you can submit comments and suggest @@ -21,7 +21,7 @@ Many thanks go to: * Fred L. Drake, Jr., the creator of the original Python documentation toolset and writer of much of the content; -* the `Docutils `_ project for creating +* the `Docutils `_ project for creating reStructuredText and the Docutils suite; * Fredrik Lundh for his `Alternative Python Reference `_ project from which Sphinx got many good diff --git a/Doc/distutils/setupscript.rst b/Doc/distutils/setupscript.rst index 67327bd1a6..d2be0400a9 100644 --- a/Doc/distutils/setupscript.rst +++ b/Doc/distutils/setupscript.rst @@ -625,7 +625,7 @@ Notes: 'long string' Multiple lines of plain text in reStructuredText format (see - http://docutils.sf.net/). + http://docutils.sourceforge.net/). 'list of strings' See below. diff --git a/Doc/faq/extending.rst b/Doc/faq/extending.rst index 2aca607618..ccd8b285b2 100644 --- a/Doc/faq/extending.rst +++ b/Doc/faq/extending.rst @@ -53,7 +53,7 @@ Python's C API. If you need to interface to some C or C++ library for which no Python extension currently exists, you can try wrapping the library's data types and functions with a tool such as `SWIG `_. `SIP -`__, `CXX +`__, `CXX `_ `Boost `_, or `Weave `_ are also diff --git a/Doc/faq/general.rst b/Doc/faq/general.rst index 1359afed42..8dc8a1931e 100644 --- a/Doc/faq/general.rst +++ b/Doc/faq/general.rst @@ -53,7 +53,7 @@ commercial use, to sell copies of Python in source or binary form (modified or unmodified), or to sell products that incorporate Python in some form. We would still like to know about all commercial use of Python, of course. -See `the PSF license page `_ to find further +See `the PSF license page `_ to find further explanations and a link to the full text of the license. The Python logo is trademarked, and in certain cases permission is required to @@ -178,8 +178,8 @@ How do I get documentation on Python? .. XXX mention py3k The standard documentation for the current stable version of Python is available -at https://docs.python.org/. PDF, plain text, and downloadable HTML versions are -also available at https://docs.python.org/download.html. +at https://docs.python.org/3/. PDF, plain text, and downloadable HTML versions are +also available at https://docs.python.org/3/download.html. The documentation is written in reStructuredText and processed by `the Sphinx documentation tool `__. The reStructuredText source for diff --git a/Doc/faq/gui.rst b/Doc/faq/gui.rst index 5a77016daa..5e1d8beafd 100644 --- a/Doc/faq/gui.rst +++ b/Doc/faq/gui.rst @@ -48,7 +48,7 @@ Qt --- There are bindings available for the Qt toolkit (using either `PyQt -`_ or `PySide +`_ or `PySide `_) and for KDE (`PyKDE `__). PyQt is currently more mature than PySide, but you must buy a PyQt license from `Riverbank Computing `_ diff --git a/Doc/faq/library.rst b/Doc/faq/library.rst index 36b3e07522..979df9e8ef 100644 --- a/Doc/faq/library.rst +++ b/Doc/faq/library.rst @@ -181,7 +181,7 @@ How do I create documentation from doc strings? The :mod:`pydoc` module can create HTML from the doc strings in your Python source code. An alternative for creating API documentation purely from -docstrings is `epydoc `_. `Sphinx +docstrings is `epydoc `_. `Sphinx `_ can also include docstring content. diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst index 54b2369c66..588066dbc5 100644 --- a/Doc/faq/programming.rst +++ b/Doc/faq/programming.rst @@ -61,7 +61,7 @@ Yes. PyChecker is a static analysis tool that finds bugs in Python source code and warns about code complexity and style. You can get PyChecker from -http://pychecker.sf.net. +http://pychecker.sourceforge.net/. `Pylint `_ is another tool that checks if a module satisfies a coding standard, and also makes it possible to write diff --git a/Doc/howto/cporting.rst b/Doc/howto/cporting.rst index 6ebcc4164d..d7a7086302 100644 --- a/Doc/howto/cporting.rst +++ b/Doc/howto/cporting.rst @@ -252,6 +252,6 @@ Other options ============= If you are writing a new extension module, you might consider `Cython -`_. It translates a Python-like language to C. The +`_. It translates a Python-like language to C. The extension modules it creates are compatible with Python 3 and Python 2. diff --git a/Doc/howto/pyporting.rst b/Doc/howto/pyporting.rst index 109a37bd4d..e1a460991a 100644 --- a/Doc/howto/pyporting.rst +++ b/Doc/howto/pyporting.rst @@ -609,11 +609,10 @@ please email the python-porting_ mailing list. .. _future: http://python-future.org/ .. _modernize: https://github.com/mitsuhiko/python-modernize .. _Porting to Python 3: http://python3porting.com/ -.. _PyPI: https://pypi.python.org/ +.. _PyPI: https://pypi.python.org/pypi .. _Python 3 Packages: https://pypi.python.org/pypi?:action=browse&c=533&show=all .. _Python 3 Q & A: http://ncoghlan-devs-python-notes.readthedocs.org/en/latest/python3/questions_and_answers.html .. _python-porting: https://mail.python.org/mailman/listinfo/python-porting .. _six: https://pypi.python.org/pypi/six .. _tox: https://pypi.python.org/pypi/tox .. _trove classifiers: https://pypi.python.org/pypi?%3Aaction=list_classifiers - diff --git a/Doc/howto/webservers.rst b/Doc/howto/webservers.rst index 94a376231d..6534753945 100644 --- a/Doc/howto/webservers.rst +++ b/Doc/howto/webservers.rst @@ -519,7 +519,7 @@ Popular template engines include: * `Mako `_ * `Genshi `_ - * `Jinja `_ + * `Jinja `_ .. seealso:: diff --git a/Doc/library/crypto.rst b/Doc/library/crypto.rst index 21cc251e07..670cbf1f24 100644 --- a/Doc/library/crypto.rst +++ b/Doc/library/crypto.rst @@ -26,6 +26,5 @@ Here's an overview: Hardcore cypherpunks will probably find the cryptographic modules written by A.M. Kuchling of further interest; the package contains modules for various encryption algorithms, most notably AES. These modules are not distributed with -Python but available separately. See the URL -http://www.pycrypto.org for more information. - +Python but available separately. See the URL http://www.pycrypto.org/ for more +information. diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index 15a4fe4386..4276e9154f 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -514,7 +514,7 @@ Instance methods: Return a 3-tuple, (ISO year, ISO week number, ISO weekday). The ISO calendar is a widely used variant of the Gregorian calendar. See - http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm for a good + http://www.staff.science.uu.nl/~gent0113/calendar/isocalendar.htm for a good explanation. The ISO year consists of 52 or 53 full weeks, and where a week starts on a diff --git a/Doc/library/email.rst b/Doc/library/email.rst index 4e90ce474f..879c38f9aa 100644 --- a/Doc/library/email.rst +++ b/Doc/library/email.rst @@ -222,7 +222,7 @@ Differences from :mod:`mimelib` ------------------------------- The :mod:`email` package was originally prototyped as a separate library called -`mimelib `_. Changes have been made so that method names +`mimelib `_. Changes have been made so that method names are more consistent, and some methods or modules have either been added or removed. The semantics of some of the methods have also changed. For the most part, any functionality available in :mod:`mimelib` is still available in the diff --git a/Doc/library/mimetypes.rst b/Doc/library/mimetypes.rst index 8891e7a76a..740c2f6be3 100644 --- a/Doc/library/mimetypes.rst +++ b/Doc/library/mimetypes.rst @@ -44,7 +44,7 @@ the information :func:`init` sets up. The optional *strict* argument is a flag specifying whether the list of known MIME types is limited to only the official types `registered with IANA - `_. + `_. When *strict* is ``True`` (the default), only the IANA types are supported; when *strict* is ``False``, some additional non-standard but commonly used MIME types are also recognized. diff --git a/Doc/library/othergui.rst b/Doc/library/othergui.rst index ba26e74157..d75ca186e6 100644 --- a/Doc/library/othergui.rst +++ b/Doc/library/othergui.rst @@ -16,7 +16,7 @@ available for Python: `GNOME `_. An online `tutorial `_ is available. - `PyQt `_ + `PyQt `_ PyQt is a :program:`sip`\ -wrapped binding to the Qt toolkit. Qt is an extensive C++ GUI application development framework that is available for Unix, Windows and Mac OS X. :program:`sip` is a tool diff --git a/Doc/library/pyexpat.rst b/Doc/library/pyexpat.rst index 20ca3bc274..5876d1dbef 100644 --- a/Doc/library/pyexpat.rst +++ b/Doc/library/pyexpat.rst @@ -912,5 +912,5 @@ The ``errors`` object has the following attributes: .. [#] The encoding string included in XML output should conform to the appropriate standards. For example, "UTF-8" is valid, but "UTF8" is not. See http://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl - and http://www.iana.org/assignments/character-sets\ . + and http://www.iana.org/assignments/character-sets/character-sets.xhtml. diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index 730e1fd094..c52b073ff7 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -1674,10 +1674,10 @@ successful call of :func:`~ssl.RAND_add`, :func:`~ssl.RAND_bytes` or `RFC 4366: Transport Layer Security (TLS) Extensions `_ Blake-Wilson et. al. - `RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 `_ + `RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 `_ T. Dierks et. al. - `RFC 6066: Transport Layer Security (TLS) Extensions `_ + `RFC 6066: Transport Layer Security (TLS) Extensions `_ D. Eastlake `IANA TLS: Transport Layer Security (TLS) Parameters `_ diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index ddaeec73ad..29f6959bcf 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -26,7 +26,7 @@ is maintained at ActiveState.) `TKDocs `_ Extensive tutorial plus friendlier widget pages for some of the widgets. - `Tkinter reference: a GUI for Python `_ + `Tkinter reference: a GUI for Python `_ On-line reference material. `Tkinter docs from effbot `_ diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst index 1ff70249bb..5cde5e2d52 100644 --- a/Doc/library/xml.dom.minidom.rst +++ b/Doc/library/xml.dom.minidom.rst @@ -276,4 +276,4 @@ utility to most DOM users. .. [#] The encoding string included in XML output should conform to the appropriate standards. For example, "UTF-8" is valid, but "UTF8" is not. See http://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl - and http://www.iana.org/assignments/character-sets\ . + and http://www.iana.org/assignments/character-sets/character-sets.xhtml. diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst index f14742e02d..3afabb43c2 100644 --- a/Doc/library/xml.etree.elementtree.rst +++ b/Doc/library/xml.etree.elementtree.rst @@ -954,4 +954,4 @@ This is an example of counting the maximum depth of an XML file:: .. [#] The encoding string included in XML output should conform to the appropriate standards. For example, "UTF-8" is valid, but "UTF8" is not. See http://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl - and http://www.iana.org/assignments/character-sets. + and http://www.iana.org/assignments/character-sets/character-sets.xhtml. diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 03750f5372..d100303f65 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -293,7 +293,7 @@ Compiling Python on Windows If you want to compile CPython yourself, first thing you should do is get the `source `_. You can download either the latest release's source or just grab a fresh `checkout -`_. +`_. For Microsoft Visual C++, which is the compiler with which official Python releases are built, the source tree contains solutions/project files. View the @@ -336,7 +336,7 @@ Other resources .. seealso:: - `Python Programming On Win32 `_ + `Python Programming On Win32 `_ "Help for Windows Programmers" by Mark Hammond and Andy Robinson, O'Reilly Media, 2000, ISBN 1-56592-621-8 diff --git a/Doc/whatsnew/2.0.rst b/Doc/whatsnew/2.0.rst index f7998e6978..b6c4fb960d 100644 --- a/Doc/whatsnew/2.0.rst +++ b/Doc/whatsnew/2.0.rst @@ -1003,7 +1003,7 @@ Relationship to PyXML The XML Special Interest Group has been working on XML-related Python code for a while. Its code distribution, called PyXML, is available from the SIG's Web -pages at https://www.python.org/sigs/xml-sig/. The PyXML distribution also used +pages at https://www.python.org/community/sigs/current/xml-sig. The PyXML distribution also used the package name ``xml``. If you've written programs that used PyXML, you're probably wondering about its compatibility with the 2.0 :mod:`xml` package. diff --git a/Doc/whatsnew/2.3.rst b/Doc/whatsnew/2.3.rst index d017c64d68..d9f1b7e9ce 100644 --- a/Doc/whatsnew/2.3.rst +++ b/Doc/whatsnew/2.3.rst @@ -1330,7 +1330,7 @@ complete list of changes, or look through the CVS logs for all the details. (Contributed by Kevin O'Connor.) * The IDLE integrated development environment has been updated using the code - from the IDLEfork project (http://idlefork.sf.net). The most notable feature is + from the IDLEfork project (http://idlefork.sourceforge.net). The most notable feature is that the code being developed is now executed in a subprocess, meaning that there's no longer any need for manual ``reload()`` operations. IDLE's core code has been incorporated into the standard library as the :mod:`idlelib` package. diff --git a/Doc/whatsnew/2.6.rst b/Doc/whatsnew/2.6.rst index 54ded7ad4b..edba4e1c95 100644 --- a/Doc/whatsnew/2.6.rst +++ b/Doc/whatsnew/2.6.rst @@ -236,7 +236,7 @@ have adopted Sphinx as their documentation tool. `Sphinx `__ Documentation and code for the Sphinx toolchain. - `Docutils `__ + `Docutils `__ The underlying reStructuredText parser and toolset. @@ -2359,7 +2359,7 @@ changes, or look through the Subversion logs for all the details. negotiation itself. (Patch contributed by Bill Fenner; :issue:`829951`.) -* The :mod:`socket` module now supports TIPC (http://tipc.sf.net), +* The :mod:`socket` module now supports TIPC (http://tipc.sourceforge.net/), a high-performance non-IP-based protocol designed for use in clustered environments. TIPC addresses are 4- or 5-tuples. (Contributed by Alberto Bertogli; :issue:`1646`.) diff --git a/Doc/whatsnew/2.7.rst b/Doc/whatsnew/2.7.rst index 6aeea32342..9d26893072 100644 --- a/Doc/whatsnew/2.7.rst +++ b/Doc/whatsnew/2.7.rst @@ -708,7 +708,7 @@ Some smaller changes made to the core Python language are: The :func:`contextlib.nested` function provides a very similar function, so it's no longer necessary and has been deprecated. - (Proposed in http://codereview.appspot.com/53094; implemented by + (Proposed in https://codereview.appspot.com/53094; implemented by Georg Brandl.) * Conversions between floating-point numbers and strings are