From: Georg Brandl Date: Wed, 29 Oct 2014 08:24:54 +0000 (+0100) Subject: Fixing broken links in doc, part 1: faq/ X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fa55a317e4b33e36b19447187e56df924d4e2eeb;p=python Fixing broken links in doc, part 1: faq/ --- diff --git a/Doc/bugs.rst b/Doc/bugs.rst index 11e6101b82..f01ae0e390 100644 --- a/Doc/bugs.rst +++ b/Doc/bugs.rst @@ -68,7 +68,7 @@ taken on the bug. Article which goes into some detail about how to create a useful bug report. This describes what kind of information is useful and why it is useful. - `Bug Writing Guidelines `_ + `Bug Writing Guidelines `_ Information about writing a good bug report. Some of this is specific to the Mozilla project, but describes general good practices. diff --git a/Doc/distutils/packageindex.rst b/Doc/distutils/packageindex.rst index b3dd8a3306..be72bb7787 100644 --- a/Doc/distutils/packageindex.rst +++ b/Doc/distutils/packageindex.rst @@ -246,4 +246,4 @@ without warnings does not guarantee that PyPI will convert the content successfully. -.. _Python Package Index (PyPI): https://pypi.python.org/ +.. _Python Package Index (PyPI): https://pypi.python.org/pypi diff --git a/Doc/faq/design.rst b/Doc/faq/design.rst index 13a79fce1d..eb876345b0 100644 --- a/Doc/faq/design.rst +++ b/Doc/faq/design.rst @@ -404,7 +404,7 @@ approach is feasible, although the speedups reached so far are only modest Hugunin has demonstrated that in combination with whole-program analysis, speedups of 1000x are feasible for small demo programs. See the proceedings from the `1997 Python conference -`_ for more information.) +`_ for more information.) Internally, Python source code is always translated into a bytecode representation, and this bytecode is then executed by the Python virtual @@ -429,12 +429,12 @@ much speed. .. XXX check which of these projects are still alive There are also several programs which make it easier to intermingle Python and C -code in various ways to increase performance. See, for example, `Psyco +code in various ways to increase performance. See, for example, `Cython `_ , `Psyco `_, `Pyrex `_, `PyInline `_, `Py2Cmod -`_, and `Weave -`_. +`_, and +`Weave `_. How does Python manage memory? diff --git a/Doc/faq/extending.rst b/Doc/faq/extending.rst index 4f3cabf01a..2aca607618 100644 --- a/Doc/faq/extending.rst +++ b/Doc/faq/extending.rst @@ -44,8 +44,9 @@ time-critical functions in your code, and gain a significant improvement with very little effort, as long as you're running on a machine with an x86-compatible processor. -`Pyrex `_ is a compiler -that accepts a slightly modified form of Python and generates the corresponding +`Cython `_ and its relative `Pyrex +`_ are compilers +that accept a slightly modified form of Python and generate the corresponding C code. Pyrex makes it possible to write an extension without having to learn Python's C API. @@ -55,8 +56,8 @@ with a tool such as `SWIG `_. `SIP `__, `CXX `_ `Boost `_, or `Weave -`_ are also alternatives for wrapping -C++ libraries. +`_ are also +alternatives for wrapping C++ libraries. How can I execute arbitrary Python statements from C? diff --git a/Doc/faq/general.rst b/Doc/faq/general.rst index 73d31a7718..1359afed42 100644 --- a/Doc/faq/general.rst +++ b/Doc/faq/general.rst @@ -223,8 +223,8 @@ releases are announced on the comp.lang.python and comp.lang.python.announce newsgroups and on the Python home page at https://www.python.org/; an RSS feed of news is available. -You can also access the development version of Python through Subversion. See -https://docs.python.org/devguide/faq for details. +You can also access the development version of Python through Mercurial. See +https://docs.python.org/devguide/faq.html for details. How do I submit bug reports and patches for Python? @@ -284,7 +284,7 @@ Why is it called Python? When he began implementing Python, Guido van Rossum was also reading the published scripts from `"Monty Python's Flying Circus" -`__, a BBC comedy series from the 1970s. Van Rossum +`__, a BBC comedy series from the 1970s. Van Rossum thought he needed a name that was short, unique, and slightly mysterious, so he decided to call the language Python. @@ -313,7 +313,7 @@ guaranteed that interfaces will remain the same throughout a series of bugfix releases. The latest stable releases can always be found on the `Python download page -`_. There are two recommended production-ready +`_. There are two recommended production-ready versions at this point in time, because at the moment there are two branches of stable releases: 2.x and 3.x. Python 3.x may be less useful than 2.x, since currently there is more third party software available for Python 2 than for @@ -337,9 +337,9 @@ the group or even read it. Have any significant projects been done in Python? -------------------------------------------------- -See https://python.org/about/success for a list of projects that use Python. +See https://www.python.org/about/success for a list of projects that use Python. Consulting the proceedings for `past Python conferences -`_ will reveal contributions from many +`_ will reveal contributions from many different companies and organizations. High-profile Python projects include `the Mailman mailing list manager diff --git a/Doc/faq/gui.rst b/Doc/faq/gui.rst index 42d95bdded..5a77016daa 100644 --- a/Doc/faq/gui.rst +++ b/Doc/faq/gui.rst @@ -49,13 +49,13 @@ Qt There are bindings available for the Qt toolkit (using either `PyQt `_ or `PySide -`_) and for KDE (`PyKDE `_). +`_) and for KDE (`PyKDE `__). PyQt is currently more mature than PySide, but you must buy a PyQt license from `Riverbank Computing `_ if you want to write proprietary applications. PySide is free for all applications. Qt 4.5 upwards is licensed under the LGPL license; also, commercial licenses -are available from `Nokia `_. +are available from `The Qt Company `_. Gtk+ ---- @@ -89,7 +89,7 @@ What platform-specific GUI toolkits exist for Python? ======================================================== By installing the `PyObjc Objective-C bridge -`_, Python programs can use Mac OS X's +`_, Python programs can use Mac OS X's Cocoa libraries. :ref:`Pythonwin ` by Mark Hammond includes an interface to the diff --git a/Doc/faq/library.rst b/Doc/faq/library.rst index e63819ccf8..36b3e07522 100644 --- a/Doc/faq/library.rst +++ b/Doc/faq/library.rst @@ -182,7 +182,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 -`_ can also include docstring content. +`_ can also include docstring content. How do I get a single keypress at a time? diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst index b0234fb2fc..54b2369c66 100644 --- a/Doc/faq/programming.rst +++ b/Doc/faq/programming.rst @@ -30,7 +30,7 @@ Pythonwin debugger colors breakpoints and has quite a few cool features such as debugging non-Pythonwin programs. Pythonwin is available as part of the `Python for Windows Extensions `__ project and as a part of the ActivePython distribution (see -http://www.activestate.com/Products/ActivePython/index.html). +http://www.activestate.com/activepython\ ). `Boa Constructor `_ is an IDE and GUI builder that uses wxWidgets. It offers visual frame creation and manipulation, @@ -38,7 +38,7 @@ an object inspector, many views on the source like object browsers, inheritance hierarchies, doc string generated html documentation, an advanced debugger, integrated help, and Zope support. -`Eric `_ is an IDE built on PyQt +`Eric `_ is an IDE built on PyQt and the Scintilla editing component. Pydb is a version of the standard Python debugger pdb, modified for use with DDD @@ -50,7 +50,7 @@ There are a number of commercial Python IDEs that include graphical debuggers. They include: * Wing IDE (http://wingware.com/) -* Komodo IDE (http://www.activestate.com/Products/Komodo) +* Komodo IDE (http://komodoide.com/) * PyCharm (https://www.jetbrains.com/pycharm/) @@ -69,8 +69,7 @@ plug-ins to add a custom feature. In addition to the bug checking that PyChecker performs, Pylint offers some additional features such as checking line length, whether variable names are well-formed according to your coding standard, whether declared interfaces are fully implemented, and more. -http://www.logilab.org/card/pylint_manual provides a full list of Pylint's -features. +http://docs.pylint.org/ provides a full list of Pylint's features. How can I create a stand-alone binary from a Python script? @@ -101,13 +100,7 @@ which don't. One is Thomas Heller's py2exe (Windows only) at http://www.py2exe.org/ -Another is Christian Tismer's `SQFREEZE `_ -which appends the byte code to a specially-prepared Python interpreter that can -find the byte code in the executable. - -Other tools include Fredrik Lundh's `Squeeze -`_ and Anthony Tuininga's -`cx_Freeze `_. +Another tool is Anthony Tuininga's `cx_Freeze `_. Are there coding standards or a style guide for Python programs? @@ -1234,7 +1227,7 @@ How do you remove duplicates from a list? See the Python Cookbook for a long discussion of many ways to do this: - http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/52560 + http://code.activestate.com/recipes/52560/ If you don't mind reordering the list, sort it and then scan from the end of the list, deleting duplicates as you go:: diff --git a/Doc/faq/windows.rst b/Doc/faq/windows.rst index cbc29ee974..19bd12019d 100644 --- a/Doc/faq/windows.rst +++ b/Doc/faq/windows.rst @@ -27,7 +27,7 @@ obvious; otherwise, you might need a little more guidance. .. |Python Development on XP| image:: python-video-icon.png .. _`Python Development on XP`: - http://www.showmedo.com/videos/series?name=pythonOzsvaldPyNewbieSeries + http://showmedo.com/videotutorials/series?name=pythonOzsvaldPyNewbieSeries Unless you use some sort of integrated development environment, you will end up *typing* Windows commands into what is variously referred to as a "DOS window" @@ -101,7 +101,7 @@ gives you a message like:: .. |Adding Python to DOS Path| image:: python-video-icon.png .. _`Adding Python to DOS Path`: - http://showmedo.com/videos/video?name=960000&fromSeriesID=96 + http://showmedo.com/videotutorials/video?name=960000&fromSeriesID=96 or::