From 77fe77d4af87b29ce36fc6d20a097ccb9cd08f76 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Wed, 29 Oct 2014 09:24:54 +0100 Subject: [PATCH] Fixing broken links in doc, part 1: faq/ --- Doc/bugs.rst | 2 +- Doc/distutils/packageindex.rst | 2 +- Doc/faq/design.rst | 6 +++--- Doc/faq/extending.rst | 6 +++--- Doc/faq/general.rst | 12 ++++++------ Doc/faq/gui.rst | 6 +++--- Doc/faq/library.rst | 2 +- Doc/faq/programming.rst | 19 ++++++------------- Doc/faq/windows.rst | 4 ++-- 9 files changed, 26 insertions(+), 33 deletions(-) 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 59d27bca86..daf9345264 100644 --- a/Doc/distutils/packageindex.rst +++ b/Doc/distutils/packageindex.rst @@ -244,4 +244,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 d4dda4b01b..9fdf8cb949 100644 --- a/Doc/faq/design.rst +++ b/Doc/faq/design.rst @@ -368,9 +368,9 @@ Can Python be compiled to machine code, C or some other language? Practical answer: -`Cython `_ and `Pyrex `_ +`Cython `_ and `Pyrex `_ compile a modified version of Python with optional annotations into C -extensions. `Weave `_ makes it easy to +extensions. `Weave `_ makes it easy to intermingle Python and C code in various ways to increase performance. `Nuitka `_ is an up-and-coming compiler of Python into C++ code, aiming to support the full Python language. @@ -392,7 +392,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.) How does Python manage memory? diff --git a/Doc/faq/extending.rst b/Doc/faq/extending.rst index d196e86176..252050eabc 100644 --- a/Doc/faq/extending.rst +++ b/Doc/faq/extending.rst @@ -42,7 +42,7 @@ on what you're trying to do. .. XXX make sure these all work `Cython `_ and its relative `Pyrex -`_ are compilers +`_ are compilers that accept a slightly modified form of Python and generate the corresponding C code. Cython and Pyrex make it possible to write an extension without having to learn Python's C API. @@ -53,8 +53,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 72dfe9eea8..08c5427084 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 7428316df7..6f398fd7a3 100644 --- a/Doc/faq/gui.rst +++ b/Doc/faq/gui.rst @@ -59,13 +59,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+ ---- @@ -103,7 +103,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 95c063b6c3..3c47687fcf 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 659247b8c1..05a43846dd 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? @@ -1125,7 +1118,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 ee627213db..7cac8a9739 100644 --- a/Doc/faq/windows.rst +++ b/Doc/faq/windows.rst @@ -31,7 +31,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" @@ -105,7 +105,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:: -- 2.40.0