From 525d355984e1afa342aa72fc7867a56eea937a61 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Wed, 29 Oct 2014 10:26:56 +0100 Subject: [PATCH] Fixing broken links in doc, part 3: the rest --- Doc/install/index.rst | 6 +-- Doc/installing/index.rst | 10 ++-- Doc/library/collections.rst | 2 +- Doc/library/difflib.rst | 4 +- Doc/library/distribution.rst | 2 +- Doc/library/functools.rst | 2 +- Doc/library/gettext.rst | 2 +- Doc/library/http.cookiejar.rst | 2 +- Doc/library/mailbox.rst | 2 +- Doc/library/msilib.rst | 64 +++++++++++++------------- Doc/library/othergui.rst | 2 +- Doc/library/plistlib.rst | 2 +- Doc/library/pprint.rst | 2 +- Doc/library/select.rst | 5 +- Doc/library/statistics.rst | 2 +- Doc/library/unittest.mock-examples.rst | 4 +- Doc/library/unittest.rst | 2 +- Doc/license.rst | 2 +- Doc/reference/import.rst | 2 +- Doc/reference/introduction.rst | 2 +- Doc/tutorial/whatnow.rst | 4 +- Doc/using/cmdline.rst | 2 +- Doc/using/mac.rst | 8 ++-- Doc/using/unix.rst | 5 +- Doc/using/venv-create.inc | 2 +- Doc/using/windows.rst | 13 +++--- 26 files changed, 75 insertions(+), 80 deletions(-) diff --git a/Doc/install/index.rst b/Doc/install/index.rst index d0fea3d4f1e..8f3ad7241af 100644 --- a/Doc/install/index.rst +++ b/Doc/install/index.rst @@ -1012,7 +1012,7 @@ section :ref:`inst-config-files`.) .. seealso:: - `C++Builder Compiler `_ + `C++Builder Compiler `_ Information about the free C++ compiler from Borland, including links to the download pages. @@ -1084,7 +1084,7 @@ normal libraries do. .. seealso:: - `Building Python modules on MS Windows platform with MinGW `_ + `Building Python modules on MS Windows platform with MinGW `_ Information about building the required libraries for the MinGW environment. @@ -1093,7 +1093,7 @@ normal libraries do. .. [#] This also means you could replace all existing COFF-libraries with OMF-libraries of the same name. -.. [#] Check http://sources.redhat.com/cygwin/ and http://www.mingw.org/ for more +.. [#] Check http://www.sourceware.org/cygwin/ and http://www.mingw.org/ for more information .. [#] Then you have no POSIX emulation available, but you also don't need diff --git a/Doc/installing/index.rst b/Doc/installing/index.rst index 5db9bbb76ef..973c689861f 100644 --- a/Doc/installing/index.rst +++ b/Doc/installing/index.rst @@ -104,7 +104,7 @@ into an active virtual environment uses the commands shown above. .. seealso:: `Python Packaging User Guide: Installing Python Distribution Packages - `__ + `__ How do I ...? @@ -122,7 +122,7 @@ User Guide. .. seealso:: `Python Packaging User Guide: Setup for Installing Distribution Packages - `__ + `__ .. installing-per-user-installation: @@ -141,13 +141,13 @@ A number of scientific Python packages have complex binary dependencies, and aren't currently easy to install using ``pip`` directly. At this point in time, it will often be easier for users to install these packages by `other means -`__ +`__ rather than attempting to install them with ``pip``. .. seealso:: `Python Packaging User Guide: Installing Scientific Packages - `__ + `__ ... work with multiple versions of Python installed in parallel? @@ -210,7 +210,7 @@ as users are more regularly able to install pre-built extensions rather than needing to build them themselves. Some of the solutions for installing `scientific software -`__ +`__ that is not yet available as pre-built ``wheel`` files may also help with obtaining other binary extensions without needing to build them locally. diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index 1651ef53f9f..d8339b5ba34 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -109,7 +109,7 @@ The class can be used to simulate nested scopes and is useful in templating. writing to any mapping in the chain. * Django's `Context class - `_ + `_ for templating is a read-only chain of mappings. It also features pushing and popping of contexts similar to the :meth:`~collections.ChainMap.new_child` method and the diff --git a/Doc/library/difflib.rst b/Doc/library/difflib.rst index 2a75d2cb159..5f72ea6233f 100644 --- a/Doc/library/difflib.rst +++ b/Doc/library/difflib.rst @@ -323,9 +323,9 @@ diffs. For comparing directories and files, see also, the :mod:`filecmp` module. .. seealso:: - `Pattern Matching: The Gestalt Approach `_ + `Pattern Matching: The Gestalt Approach `_ Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. This - was published in `Dr. Dobb's Journal `_ in July, 1988. + was published in `Dr. Dobb's Journal `_ in July, 1988. .. _sequence-matcher: diff --git a/Doc/library/distribution.rst b/Doc/library/distribution.rst index fb3f5df5998..c4954d1b4ad 100644 --- a/Doc/library/distribution.rst +++ b/Doc/library/distribution.rst @@ -4,7 +4,7 @@ Software Packaging and Distribution These libraries help you with publishing and installing Python software. While these modules are designed to work in conjunction with the -`Python Package Index `__, they can also be used +`Python Package Index `__, they can also be used with a local index server, or without any index server at all. .. toctree:: diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst index 96645c361c4..7fd7d5826b6 100644 --- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -72,7 +72,7 @@ The :mod:`functools` module defines the following functions: bypassing the cache, or for rewrapping the function with a different cache. An `LRU (least recently used) cache - `_ works + `_ works best when the most recent calls are the best predictors of upcoming calls (for example, the most popular articles on a news server tend to change each day). The cache's size limit assures that the cache does not grow without bound on diff --git a/Doc/library/gettext.rst b/Doc/library/gettext.rst index 982780fec15..ff23b59156d 100644 --- a/Doc/library/gettext.rst +++ b/Doc/library/gettext.rst @@ -460,7 +460,7 @@ translatable. `Babel `__ is a Python internationalization library that includes a :file:`pybabel` script to extract and compile message catalogs. François Pinard's program called :program:`xpot` does a similar job and is available as part of -his `po-utils package `__. +his `po-utils package `__. (Python also includes pure-Python versions of these programs, called :program:`pygettext.py` and :program:`msgfmt.py`; some Python distributions diff --git a/Doc/library/http.cookiejar.rst b/Doc/library/http.cookiejar.rst index 2fae47c6267..1f6b1badf4b 100644 --- a/Doc/library/http.cookiejar.rst +++ b/Doc/library/http.cookiejar.rst @@ -115,7 +115,7 @@ The following classes are provided: :mod:`http.cookiejar` and :mod:`http.cookies` modules do not depend on each other. - http://wp.netscape.com/newsref/std/cookie_spec.html + http://curl.haxx.se/rfc/cookie_spec.html The specification of the original Netscape cookie protocol. Though this is still the dominant protocol, the 'Netscape cookie protocol' implemented by all the major browsers (and :mod:`http.cookiejar`) only bears a passing resemblance to diff --git a/Doc/library/mailbox.rst b/Doc/library/mailbox.rst index a03fd1cd40c..6334bd6e988 100644 --- a/Doc/library/mailbox.rst +++ b/Doc/library/mailbox.rst @@ -487,7 +487,7 @@ Supported mailbox formats are Maildir, mbox, MH, Babyl, and MMDF. `Configuring Netscape Mail on Unix: Why The Content-Length Format is Bad `_ An argument for using the original mbox format rather than a variation. - `"mbox" is a family of several mutually incompatible mailbox formats `_ + `"mbox" is a family of several mutually incompatible mailbox formats `_ A history of mbox variations. diff --git a/Doc/library/msilib.rst b/Doc/library/msilib.rst index d3451c844bc..4145c8e7cc0 100644 --- a/Doc/library/msilib.rst +++ b/Doc/library/msilib.rst @@ -120,9 +120,9 @@ structures. .. seealso:: - `FCICreateFile `_ - `UuidCreate `_ - `UuidToString `_ + `FCICreateFile `_ + `UuidCreate `_ + `UuidToString `_ .. _database-objects: @@ -151,9 +151,9 @@ Database Objects .. seealso:: - `MSIDatabaseOpenView `_ - `MSIDatabaseCommit `_ - `MSIGetSummaryInformation `_ + `MSIDatabaseOpenView `_ + `MSIDatabaseCommit `_ + `MSIGetSummaryInformation `_ .. _view-objects: @@ -199,11 +199,11 @@ View Objects .. seealso:: - `MsiViewExecute `_ - `MSIViewGetColumnInfo `_ - `MsiViewFetch `_ - `MsiViewModify `_ - `MsiViewClose `_ + `MsiViewExecute `_ + `MSIViewGetColumnInfo `_ + `MsiViewFetch `_ + `MsiViewModify `_ + `MsiViewClose `_ .. _summary-objects: @@ -243,10 +243,10 @@ Summary Information Objects .. seealso:: - `MsiSummaryInfoGetProperty `_ - `MsiSummaryInfoGetPropertyCount `_ - `MsiSummaryInfoSetProperty `_ - `MsiSummaryInfoPersist `_ + `MsiSummaryInfoGetProperty `_ + `MsiSummaryInfoGetPropertyCount `_ + `MsiSummaryInfoSetProperty `_ + `MsiSummaryInfoPersist `_ .. _record-objects: @@ -297,11 +297,11 @@ Record Objects .. seealso:: - `MsiRecordGetFieldCount `_ - `MsiRecordSetString `_ - `MsiRecordSetStream `_ - `MsiRecordSetInteger `_ - `MsiRecordClear `_ + `MsiRecordGetFieldCount `_ + `MsiRecordSetString `_ + `MsiRecordSetStream `_ + `MsiRecordSetInteger `_ + `MsiRecordClear `_ .. _msi-errors: @@ -393,10 +393,10 @@ Directory Objects .. seealso:: - `Directory Table `_ - `File Table `_ - `Component Table `_ - `FeatureComponents Table `_ + `Directory Table `_ + `File Table `_ + `Component Table `_ + `FeatureComponents Table `_ .. _features: @@ -421,7 +421,7 @@ Features .. seealso:: - `Feature Table `_ + `Feature Table `_ .. _msi-gui: @@ -516,13 +516,13 @@ for installing Python packages. .. seealso:: - `Dialog Table `_ - `Control Table `_ - `Control Types `_ - `ControlCondition Table `_ - `ControlEvent Table `_ - `EventMapping Table `_ - `RadioButton Table `_ + `Dialog Table `_ + `Control Table `_ + `Control Types `_ + `ControlCondition Table `_ + `ControlEvent Table `_ + `EventMapping Table `_ + `RadioButton Table `_ .. _msi-tables: diff --git a/Doc/library/othergui.rst b/Doc/library/othergui.rst index 2d514914f0f..73f868a71b4 100644 --- a/Doc/library/othergui.rst +++ b/Doc/library/othergui.rst @@ -10,7 +10,7 @@ available for Python: `PyGObject `_ provides introspection bindings for C libraries using - `GObject `_. One of + `GObject `_. One of these libraries is the `GTK+ 3 `_ widget set. GTK+ comes with many more widgets than Tkinter provides. An online `Python GTK+ 3 Tutorial `_ diff --git a/Doc/library/plistlib.rst b/Doc/library/plistlib.rst index 6a2d6b4971c..2bef120f1dd 100644 --- a/Doc/library/plistlib.rst +++ b/Doc/library/plistlib.rst @@ -37,7 +37,7 @@ or :class:`datetime.datetime` objects. .. seealso:: - `PList manual page `_ + `PList manual page `_ Apple's documentation of the file format. diff --git a/Doc/library/pprint.rst b/Doc/library/pprint.rst index 447f8f70606..c0589a31a90 100644 --- a/Doc/library/pprint.rst +++ b/Doc/library/pprint.rst @@ -211,7 +211,7 @@ Example ------- To demonstrate several uses of the :func:`pprint` function and its parameters, -let's fetch information about a project from `PyPI `_:: +let's fetch information about a project from `PyPI `_:: >>> import json >>> import pprint diff --git a/Doc/library/select.rst b/Doc/library/select.rst index 973a0cc7d6f..734e426acde 100644 --- a/Doc/library/select.rst +++ b/Doc/library/select.rst @@ -160,10 +160,7 @@ The module defines the following: .. _devpoll-objects: ``/dev/poll`` Polling Objects ----------------------------------------------- - - http://developers.sun.com/solaris/articles/using_devpoll.html - http://developers.sun.com/solaris/articles/polling_efficient.html +----------------------------- Solaris and derivatives have ``/dev/poll``. While :c:func:`select` is O(highest file descriptor) and :c:func:`poll` is O(number of file diff --git a/Doc/library/statistics.rst b/Doc/library/statistics.rst index 4e7783872a4..0c9d88c8de3 100644 --- a/Doc/library/statistics.rst +++ b/Doc/library/statistics.rst @@ -226,7 +226,7 @@ However, for reading convenience, most of the examples show sorted sequences. * Calculating the `median `_. * The `SSMEDIAN - `_ + `_ function in the Gnome Gnumeric spreadsheet, including `this discussion `_. diff --git a/Doc/library/unittest.mock-examples.rst b/Doc/library/unittest.mock-examples.rst index 796323739e2..0a3cfb6496f 100644 --- a/Doc/library/unittest.mock-examples.rst +++ b/Doc/library/unittest.mock-examples.rst @@ -549,7 +549,7 @@ Calls to the date constructor are recorded in the `mock_date` attributes An alternative way of dealing with mocking dates, or other builtin classes, is discussed in `this blog entry -`_. +`_. Mocking a Generator Method @@ -1254,4 +1254,4 @@ As of version 1.5, the Python testing library `PyHamcrest `_ provides similar functionality, that may be useful here, in the form of its equality matcher (`hamcrest.library.integration.match_equality -`_). +`_). diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst index a4bed7afe96..c3ff494e5f7 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -67,7 +67,7 @@ test runner a GUI tool for test discovery and execution. This is intended largely for ease of use for those new to unit testing. For production environments it is recommended that tests be driven by a continuous integration system such as - `Buildbot `_, `Jenkins `_ + `Buildbot `_, `Jenkins `_ or `Hudson `_. diff --git a/Doc/license.rst b/Doc/license.rst index c8d3b77241c..bbeacfcdbd1 100644 --- a/Doc/license.rst +++ b/Doc/license.rst @@ -27,7 +27,7 @@ https://www.python.org/psf/) was formed, a non-profit organization created specifically to own Python-related Intellectual Property. Zope Corporation is a sponsoring member of the PSF. -All Python releases are Open Source (see http://www.opensource.org/ for the Open +All Python releases are Open Source (see http://opensource.org/ for the Open Source Definition). Historically, most, but not all, Python releases have also been GPL-compatible; the table below summarizes the various releases. diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 146f29e1259..e9b7e53247d 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -901,7 +901,7 @@ References The import machinery has evolved considerably since Python's early days. The original `specification for packages -`_ is still available to read, +`_ is still available to read, although some details have changed since the writing of that document. The original specification for :data:`sys.meta_path` was :pep:`302`, with diff --git a/Doc/reference/introduction.rst b/Doc/reference/introduction.rst index 0ac57945db1..5633ae3eb1c 100644 --- a/Doc/reference/introduction.rst +++ b/Doc/reference/introduction.rst @@ -66,7 +66,7 @@ IronPython An alternate Python for .NET. Unlike Python.NET, this is a complete Python implementation that generates IL, and compiles Python code directly to .NET assemblies. It was created by Jim Hugunin, the original creator of Jython. For - more information, see `the IronPython website `_. + more information, see `the IronPython website `_. PyPy An implementation of Python written completely in Python. It supports several diff --git a/Doc/tutorial/whatnow.rst b/Doc/tutorial/whatnow.rst index a9ff6f46b72..6b03cb5b207 100644 --- a/Doc/tutorial/whatnow.rst +++ b/Doc/tutorial/whatnow.rst @@ -38,12 +38,12 @@ More Python resources: * https://docs.python.org: Fast access to Python's documentation. -* https://pypi.python.org: The Python Package Index, previously also nicknamed +* https://pypi.python.org/pypi: The Python Package Index, previously also nicknamed the Cheese Shop, is an index of user-created Python modules that are available for download. Once you begin releasing code, you can register it here so that others can find it. -* http://aspn.activestate.com/ASPN/Python/Cookbook/: The Python Cookbook is a +* http://code.activestate.com/recipes/langs/python/: The Python Cookbook is a sizable collection of code examples, larger modules, and useful scripts. Particularly notable contributions are collected in a book also titled Python Cookbook (O'Reilly & Associates, ISBN 0-596-00797-3.) diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index bf4c1abc040..3749e743ad4 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -411,7 +411,7 @@ Options you shouldn't use Reserved for use by Jython_. -.. _Jython: http://jython.org +.. _Jython: http://www.jython.org/ .. _using-on-envvars: diff --git a/Doc/using/mac.rst b/Doc/using/mac.rst index 9034b636ecc..ede864d7ade 100644 --- a/Doc/using/mac.rst +++ b/Doc/using/mac.rst @@ -64,7 +64,7 @@ the Finder you first need an editor to create your script. Mac OS X comes with a number of standard Unix command line editors, :program:`vim` and :program:`emacs` among them. If you want a more Mac-like editor, :program:`BBEdit` or :program:`TextWrangler` from Bare Bones Software (see -http://www.barebones.com/products/bbedit/index.shtml) are good choices, as is +http://www.barebones.com/products/bbedit/index.html) are good choices, as is :program:`TextMate` (see http://macromates.com/). Other editors include :program:`Gvim` (http://macvim.org) and :program:`Aquamacs` (http://aquamacs.org/). @@ -116,7 +116,7 @@ The IDE MacPython ships with the standard IDLE development environment. A good introduction to using IDLE can be found at -http://hkn.eecs.berkeley.edu/~dyoo/python/idle_intro/index.html. +https://hkn.eecs.berkeley.edu/~dyoo/python/idle_intro/index.html. .. _mac-package-manager: @@ -130,7 +130,7 @@ There are several methods to install additional Python packages: setup.py install``). * Many packages can also be installed via the :program:`setuptools` extension - or :program:`pip` wrapper, see http://www.pip-installer.org/. + or :program:`pip` wrapper, see https://pip.pypa.io/. GUI Programming on the Mac @@ -140,7 +140,7 @@ There are several options for building GUI applications on the Mac with Python. *PyObjC* is a Python binding to Apple's Objective-C/Cocoa framework, which is the foundation of most modern Mac development. Information on PyObjC is -available from http://pyobjc.sourceforge.net. +available from https://pythonhosted.org/pyobjc/. The standard Python GUI toolkit is :mod:`tkinter`, based on the cross-platform Tk toolkit (http://www.tcl.tk). An Aqua-native version of Tk is bundled with OS diff --git a/Doc/using/unix.rst b/Doc/using/unix.rst index 067f80af033..5da1f233466 100644 --- a/Doc/using/unix.rst +++ b/Doc/using/unix.rst @@ -67,7 +67,7 @@ Building Python 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 `clone -`_. (If you want +`_. (If you want to contribute patches, you will need a clone.) The build process consists in the usual :: @@ -145,5 +145,4 @@ Geany is an excellent IDE with support for a lot of languages. For more information, read: http://www.geany.org/ Komodo edit is another extremely good IDE. It also has support for a lot of -languages. For more information, read: -http://www.activestate.com/store/productdetail.aspx?prdGuid=20f4ed15-6684-4118-a78b-d37ff4058c5f +languages. For more information, read http://komodoide.com/. diff --git a/Doc/using/venv-create.inc b/Doc/using/venv-create.inc index 26acf0bfc16..ba1cdcc50b5 100644 --- a/Doc/using/venv-create.inc +++ b/Doc/using/venv-create.inc @@ -14,7 +14,7 @@ subdirectory (on Windows, this is ``Lib\site-packages``). .. seealso:: `Python Packaging User Guide: Creating and using virtual environments - `__ + `__ .. highlight:: none diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 10d4df32965..93c67a79705 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -29,9 +29,8 @@ earlier are no longer supported (due to the lack of users or developers). Check :pep:`11` for details on all unsupported platforms. * `Windows CE `_ is still supported. -* The `Cygwin `_ installer offers to install the `Python - interpreter `_ as well; it is located under - "Interpreters." (cf. `Cygwin package source +* The `Cygwin `_ installer offers to install the Python + interpreter as well (cf. `Cygwin package source `_, `Maintainer releases `_) @@ -45,9 +44,9 @@ for detailed information about platforms with pre-compiled installers. "7 Minutes to "Hello World!"" by Richard Dooling, 2006 - `Installing on Windows `_ + `Installing on Windows `_ in "`Dive into Python: Python from novice to pro - `_" + `_" by Mark Pilgrim, 2004, ISBN 1-59059-356-1 @@ -67,7 +66,7 @@ key features: `ActivePython `_ Installer with multi-platform compatibility, documentation, PyWin32 -`Enthought Python Distribution `_ +`Enthought Python Distribution `_ Popular modules (such as PyWin32) with their respective documentation, tool suite for building extensible Python applications @@ -555,7 +554,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 -`_. +`_. The source tree contains a build solution and project files for Microsoft Visual C++, which is the compiler used to build the official Python releases.