From d8ea6831f9042502dbb4f24e51fe521349bd97ad Mon Sep 17 00:00:00 2001 From: Gary Wilson Jr Date: Sat, 26 Dec 2009 06:44:02 +0000 Subject: [PATCH] [1.1.X] Fixed several broken and redirecting URLs in the documentation (fixes #12219, refs #12427). Backport of r11994 from trunk. git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@11995 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/faq/install.txt | 2 +- docs/howto/auth-remote-user.txt | 2 +- docs/howto/deployment/modpython.txt | 4 ++-- docs/howto/outputting-pdf.txt | 10 ++++------ docs/internals/contributing.txt | 15 ++++++++------- docs/internals/documentation.txt | 2 +- docs/intro/tutorial01.txt | 4 ++-- docs/ref/contrib/flatpages.txt | 1 - docs/ref/contrib/index.txt | 2 +- docs/ref/contrib/localflavor.txt | 6 +++--- docs/ref/contrib/syndication.txt | 2 +- docs/ref/models/fields.txt | 2 +- docs/ref/models/querysets.txt | 2 +- docs/ref/settings.txt | 2 +- docs/ref/unicode.txt | 6 +++--- docs/releases/0.96.txt | 4 ++-- docs/topics/db/queries.txt | 2 +- docs/topics/db/sql.txt | 3 +-- docs/topics/files.txt | 2 +- docs/topics/http/file-uploads.txt | 20 ++++++++++---------- docs/topics/install.txt | 4 ++-- docs/topics/testing.txt | 14 +++++++------- 22 files changed, 54 insertions(+), 57 deletions(-) diff --git a/docs/faq/install.txt b/docs/faq/install.txt index fb8005c7e7..21dcaa9753 100644 --- a/docs/faq/install.txt +++ b/docs/faq/install.txt @@ -35,7 +35,7 @@ also need a database engine. PostgreSQL_ is recommended, because we're PostgreSQL fans, and MySQL_, `SQLite 3`_, and Oracle_ are also supported. .. _Python: http://www.python.org/ -.. _WSGI: http://www.python.org/peps/pep-0333.html +.. _WSGI: http://www.python.org/dev/peps/pep-0333/ .. _server arrangements wiki page: http://code.djangoproject.com/wiki/ServerArrangements .. _PostgreSQL: http://www.postgresql.org/ .. _MySQL: http://www.mysql.com/ diff --git a/docs/howto/auth-remote-user.txt b/docs/howto/auth-remote-user.txt index 05532da0b0..b7987e14a7 100644 --- a/docs/howto/auth-remote-user.txt +++ b/docs/howto/auth-remote-user.txt @@ -12,7 +12,7 @@ Windows Authentication or Apache and `mod_authnz_ldap`_, `CAS`_, `Cosign`_, `WebAuth`_, `mod_auth_sspi`_, etc. .. _mod_authnz_ldap: http://httpd.apache.org/docs/2.2/mod/mod_authnz_ldap.html -.. _CAS: http://www.ja-sig.org/products/cas/ +.. _CAS: http://www.jasig.org/cas .. _Cosign: http://weblogin.org .. _WebAuth: http://www.stanford.edu/services/webauth/ .. _mod_auth_sspi: http://sourceforge.net/projects/mod-auth-sspi diff --git a/docs/howto/deployment/modpython.txt b/docs/howto/deployment/modpython.txt index 50dadf9854..143a6d5ae3 100644 --- a/docs/howto/deployment/modpython.txt +++ b/docs/howto/deployment/modpython.txt @@ -375,9 +375,9 @@ set of imports until it stops crashing, so as to find the specific module that causes the problem. Drop down further into modules and look into their imports, as necessary. -.. _Expat Causing Apache Crash: http://www.dscpl.com.au/articles/modpython-006.html +.. _Expat Causing Apache Crash: http://www.dscpl.com.au/wiki/ModPython/Articles/ExpatCausingApacheCrash .. _mod_python FAQ entry: http://modpython.org/FAQ/faqw.py?req=show&file=faq02.013.htp -.. _Getting mod_python Working: http://www.dscpl.com.au/articles/modpython-001.html +.. _Getting mod_python Working: http://www.dscpl.com.au/wiki/ModPython/Articles/GettingModPythonWorking If you get a UnicodeEncodeError =============================== diff --git a/docs/howto/outputting-pdf.txt b/docs/howto/outputting-pdf.txt index 3cbab555e4..94acab8311 100644 --- a/docs/howto/outputting-pdf.txt +++ b/docs/howto/outputting-pdf.txt @@ -16,13 +16,13 @@ For example, Django was used at kusports.com_ to generate customized, printer-friendly NCAA tournament brackets, as PDF files, for people participating in a March Madness contest. -.. _ReportLab: http://www.reportlab.org/rl_toolkit.html +.. _ReportLab: http://www.reportlab.org/oss/rl-toolkit/ .. _kusports.com: http://www.kusports.com/ Install ReportLab ================= -Download and install the ReportLab library from http://www.reportlab.org/downloads.html. +Download and install the ReportLab library from http://www.reportlab.org/oss/rl-toolkit/download/. The `user guide`_ (not coincidentally, a PDF file) explains how to install it. Test your installation by importing it in the Python interactive interpreter:: @@ -138,17 +138,15 @@ Further resources * PDFlib_ is another PDF-generation library that has Python bindings. To use it with Django, just use the same concepts explained in this article. - * `Pisa HTML2PDF`_ is yet another PDF-generation library. Pisa ships with + * `Pisa XHTML2PDF`_ is yet another PDF-generation library. Pisa ships with an example of how to integrate Pisa with Django. * HTMLdoc_ is a command-line script that can convert HTML to PDF. It doesn't have a Python interface, but you can escape out to the shell using ``system`` or ``popen`` and retrieve the output in Python. - * `forge_fdf in Python`_ is a library that fills in PDF forms. .. _PDFlib: http://www.pdflib.org/ -.. _`Pisa HTML2PDF`: http://www.htmltopdf.org/ +.. _`Pisa XHTML2PDF`: http://www.xhtml2pdf.com/ .. _HTMLdoc: http://www.htmldoc.org/ -.. _forge_fdf in Python: http://www.accesspdf.com/article.php/20050421092951834 Other formats ============= diff --git a/docs/internals/contributing.txt b/docs/internals/contributing.txt index 3900ddba87..dd66ecfe92 100644 --- a/docs/internals/contributing.txt +++ b/docs/internals/contributing.txt @@ -823,7 +823,8 @@ dependencies: * Textile_ * Docutils_ * setuptools_ - * memcached_, plus the either the python-memcached_ or cmemcached_ Python binding + * memcached_, plus the either the python-memcached_ or cmemcached_ + Python binding If you want to test the memcached cache backend, you will also need to define a :setting:`CACHE_BACKEND` setting that points at your memcached instance. @@ -838,7 +839,7 @@ associated tests will be skipped. .. _setuptools: http://pypi.python.org/pypi/setuptools/ .. _memcached: http://www.danga.com/memcached/ .. _python-memcached: http://pypi.python.org/pypi/python-memcached/ -.. _cmemcached: http://pypi.python.org/pypi/cmemcache +.. _cmemcached: http://gijsbert.org/cmemcache/index.html To run a subset of the unit tests, append the names of the test modules to the ``runtests.py`` command line. See the list of directories in @@ -933,9 +934,9 @@ for feature branches: If you want a feature branch in SVN, you'll need to ask in `django-developers`_ for a mentor. -.. _git: http://git.or.cz/ -.. _mercurial: http://www.selenic.com/mercurial/ -.. _bazaar: http://bazaar-vcs.org/ +.. _git: http://git-scm.com/ +.. _mercurial: http://mercurial.selenic.com/ +.. _bazaar: http://bazaar.canonical.com/ .. _django branches: http://code.djangoproject.com/wiki/DjangoBranches Branch rules @@ -1067,7 +1068,7 @@ If you're using Django 0.95 or earlier and installed it using file. Then copy the branch's version of the ``django`` directory into ``site-packages``. -.. _path file: http://docs.python.org/lib/module-site.html +.. _path file: http://docs.python.org/library/site.html Deciding on features ==================== @@ -1133,6 +1134,6 @@ requests for commit access are potential flame-war starters, and will be ignored .. _django-users: http://groups.google.com/group/django-users .. _`#django`: irc://irc.freenode.net/django .. _list of tickets with patches: http://code.djangoproject.com/query?status=new&status=assigned&status=reopened&has_patch=1&order=priority -.. _pep8.py: http://svn.browsershots.org/trunk/devtools/pep8/pep8.py +.. _pep8.py: http://pypi.python.org/pypi/pep8/ .. _i18n branch: http://code.djangoproject.com/browser/django/branches/i18n .. _`tags/releases`: http://code.djangoproject.com/browser/django/tags/releases diff --git a/docs/internals/documentation.txt b/docs/internals/documentation.txt index f33af32597..300728df98 100644 --- a/docs/internals/documentation.txt +++ b/docs/internals/documentation.txt @@ -10,7 +10,7 @@ based on docutils__. The basic idea is that lightly-formatted plain-text documentation is transformed into HTML, PDF, and any other output format. __ http://sphinx.pocoo.org/ -__ http://docutils.sf.net/ +__ http://docutils.sourceforge.net/ To actually build the documentation locally, you'll currently need to install Sphinx -- ``easy_install Sphinx`` should do the trick. diff --git a/docs/intro/tutorial01.txt b/docs/intro/tutorial01.txt index afda1f28a2..74c86c6e90 100644 --- a/docs/intro/tutorial01.txt +++ b/docs/intro/tutorial01.txt @@ -102,7 +102,7 @@ These files are: contents" of your Django-powered site. You can read more about URLs in :ref:`topics-http-urls`. -.. _more about packages: http://docs.python.org/tut/node8.html#packages +.. _more about packages: http://docs.python.org/tutorial/modules.html#packages The development server ---------------------- @@ -361,7 +361,7 @@ Finally, note a relationship is defined, using to a single Poll. Django supports all the common database relationships: many-to-ones, many-to-manys and one-to-ones. -.. _`Python path`: http://docs.python.org/tut/node8.html#SECTION008110000000000000000 +.. _`Python path`: http://docs.python.org/tutorial/modules.html#the-module-search-path Activating models ================= diff --git a/docs/ref/contrib/flatpages.txt b/docs/ref/contrib/flatpages.txt index 875a1c05e5..f934919412 100644 --- a/docs/ref/contrib/flatpages.txt +++ b/docs/ref/contrib/flatpages.txt @@ -26,7 +26,6 @@ content in a custom template. Here are some examples of flatpages on Django-powered sites: - * http://www.chicagocrime.org/about/ * http://www.everyblock.com/about/ * http://www.lawrence.com/about/contact/ diff --git a/docs/ref/contrib/index.txt b/docs/ref/contrib/index.txt index 3d04dbfc84..24c74c3517 100644 --- a/docs/ref/contrib/index.txt +++ b/docs/ref/contrib/index.txt @@ -19,7 +19,7 @@ those packages have. ``'django.contrib.admin'``) to your ``INSTALLED_APPS`` setting and re-run ``manage.py syncdb``. -.. _"batteries included" philosophy: http://docs.python.org/tut/node12.html#batteries-included +.. _"batteries included" philosophy: http://docs.python.org/tutorial/stdlib.html#batteries-included .. toctree:: :maxdepth: 1 diff --git a/docs/ref/contrib/localflavor.txt b/docs/ref/contrib/localflavor.txt index d63d546efa..c51740754b 100644 --- a/docs/ref/contrib/localflavor.txt +++ b/docs/ref/contrib/localflavor.txt @@ -166,7 +166,7 @@ Austria (``at``) .. class:: at.forms.ATStateSelect - A ``Select`` widget that uses a list of Austrian states as its choices. + A ``Select`` widget that uses a list of Austrian states as its choices. .. class:: at.forms.ATSocialSecurityNumberField @@ -516,7 +516,7 @@ Romania (``ro``) .. class:: ro.forms.ROIBANField - A form field that validates its input as a Romanian International Bank + A form field that validates its input as a Romanian International Bank Account Number (IBAN). The valid format is ROXX-XXXX-XXXX-XXXX-XXXX-XXXX, with or without hyphens. @@ -627,7 +627,7 @@ United Kingdom (``uk``) A form field that validates input as a UK postcode. The regular expression used is sourced from the schema for British Standard BS7666 - address types at http://www.govtalk.gov.uk/gdsc/schemas/bs7666-v2-0.xsd. + address types at http://www.cabinetoffice.gov.uk/media/291293/bs7666-v2-0.xml. .. class:: uk.forms.UKCountySelect diff --git a/docs/ref/contrib/syndication.txt b/docs/ref/contrib/syndication.txt index cb9c22b8bd..c27666303c 100644 --- a/docs/ref/contrib/syndication.txt +++ b/docs/ref/contrib/syndication.txt @@ -940,7 +940,7 @@ attributes. Thus, you can subclass the appropriate feed generator class (``Atom1Feed`` or ``Rss201rev2Feed``) and extend these callbacks. They are: .. _georss: http://georss.org/ -.. _itunes podcast format: http://www.apple.com/itunes/store/podcaststechspecs.html +.. _itunes podcast format: http://www.apple.com/itunes/podcasts/specs.html ``SyndicationFeed.root_attributes(self, )`` Return a ``dict`` of attributes to add to the root feed element diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 0cb5be4b92..6204065958 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -543,7 +543,7 @@ By default, :class:`FileField` instances are created as ``varchar(100)`` columns in your database. As with other fields, you can change the maximum length using the :attr:`~CharField.max_length` argument. -.. _`strftime formatting`: http://docs.python.org/lib/module-time.html#l2h-1941 +.. _`strftime formatting`: http://docs.python.org/library/time.html#time.strftime ``FilePathField`` ----------------- diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index efd7c549b8..321ad0107f 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -94,7 +94,7 @@ the query construction and is not part of the public API. However, it is safe (and fully supported) to pickle and unpickle the attribute's contents as described here. -.. _pickle: http://docs.python.org/lib/module-pickle.html +.. _pickle: http://docs.python.org/library/pickle.html .. _queryset-api: diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index fa11049e9f..ffc6d4b659 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -534,7 +534,7 @@ system's standard umask. get totally incorrect behavior. -.. _documentation for os.chmod: http://docs.python.org/lib/os-file-dir.html +.. _documentation for os.chmod: http://docs.python.org/library/os.html#os.chmod .. setting:: FIXTURE_DIRS diff --git a/docs/ref/unicode.txt b/docs/ref/unicode.txt index 2f23354914..a6149119bf 100644 --- a/docs/ref/unicode.txt +++ b/docs/ref/unicode.txt @@ -21,8 +21,8 @@ data. Normally, this means giving it an encoding of UTF-8 or UTF-16. If you use a more restrictive encoding -- for example, latin1 (iso8859-1) -- you won't be able to store certain characters in the database, and information will be lost. - * MySQL users, refer to the `MySQL manual`_ (section 10.3.2 for MySQL 5.1) for - details on how to set or alter the database character set encoding. + * MySQL users, refer to the `MySQL manual`_ (section 9.1.3.2 for MySQL 5.1) + for details on how to set or alter the database character set encoding. * PostgreSQL users, refer to the `PostgreSQL manual`_ (section 21.2.2 in PostgreSQL 8) for details on creating databases with the correct encoding. @@ -30,7 +30,7 @@ able to store certain characters in the database, and information will be lost. * SQLite users, there is nothing you need to do. SQLite always uses UTF-8 for internal encoding. -.. _MySQL manual: http://www.mysql.org/doc/refman/5.1/en/charset-database.html +.. _MySQL manual: http://dev.mysql.com/doc/refman/5.1/en/charset-database.html .. _PostgreSQL manual: http://www.postgresql.org/docs/8.2/static/multibyte.html#AEN24104 All of Django's database backends automatically convert Unicode strings into diff --git a/docs/releases/0.96.txt b/docs/releases/0.96.txt index 186a0e8da9..fe69171494 100644 --- a/docs/releases/0.96.txt +++ b/docs/releases/0.96.txt @@ -227,8 +227,8 @@ start of your tests. This makes testing with real data much easier. See `the testing documentation`_ for the full details. -.. _doctest: http://docs.python.org/lib/module-doctest.html -.. _unittest: http://docs.python.org/lib/module-unittest.html +.. _doctest: http://docs.python.org/library/doctest.html +.. _unittest: http://docs.python.org/library/unittest.html .. _the testing documentation: http://www.djangoproject.com/documentation/0.96/testing/ .. _serialization formats: http://www.djangoproject.com/documentation/0.96/serialization/ diff --git a/docs/topics/db/queries.txt b/docs/topics/db/queries.txt index 968ea7fbc8..5e3669bdbb 100644 --- a/docs/topics/db/queries.txt +++ b/docs/topics/db/queries.txt @@ -327,7 +327,7 @@ translates (roughly) into the following SQL:: arguments whose names and values are evaluated at runtime. For more information, see `Keyword Arguments`_ in the official Python tutorial. - .. _`Keyword Arguments`: http://docs.python.org/tut/node6.html#SECTION006720000000000000000 + .. _`Keyword Arguments`: http://docs.python.org/tutorial/controlflow.html#keyword-arguments If you pass an invalid keyword argument, a lookup function will raise ``TypeError``. diff --git a/docs/topics/db/sql.txt b/docs/topics/db/sql.txt index 9c534709ca..36ba1b9a90 100644 --- a/docs/topics/db/sql.txt +++ b/docs/topics/db/sql.txt @@ -85,5 +85,4 @@ A final note: If all you want to do is a custom ``WHERE`` clause, you can just use the ``where``, ``tables`` and ``params`` arguments to the :ref:`extra clause ` in the standard queryset API. -.. _Python DB-API: http://www.python.org/peps/pep-0249.html - +.. _Python DB-API: http://www.python.org/dev/peps/pep-0249/ diff --git a/docs/topics/files.txt b/docs/topics/files.txt index 8e17db20fb..45aca5488a 100644 --- a/docs/topics/files.txt +++ b/docs/topics/files.txt @@ -55,7 +55,7 @@ Internally, Django uses a ``django.core.files.File`` any time it needs to represent a file. This object is a thin wrapper around Python's `built-in file object`_ with some Django-specific additions. -.. _built-in file object: http://docs.python.org/lib/bltin-file-objects.html +.. _built-in file object: http://docs.python.org/library/stdtypes.html#bltin-file-objects Most of the time you'll simply use a ``File`` that Django's given you (i.e. a file attached to a model as above, or perhaps an uploaded file). diff --git a/docs/topics/http/file-uploads.txt b/docs/topics/http/file-uploads.txt index 428b390a2f..b3d520b3ee 100644 --- a/docs/topics/http/file-uploads.txt +++ b/docs/topics/http/file-uploads.txt @@ -30,7 +30,7 @@ is a dictionary containing a key for each ``FileField`` (or ``ImageField``, or other ``FileField`` subclass) in the form. So the data from the above form would be accessible as ``request.FILES['file']``. -Note that ``request.FILES`` will only contain data if the request method was +Note that ``request.FILES`` will only contain data if the request method was ``POST`` and the ``
`` that posted the request has the attribute ``enctype="multipart/form-data"``. Otherwise, ``request.FILES`` will be empty. @@ -140,19 +140,19 @@ Three settings control Django's file upload behavior: Defaults to your system's standard temporary directory (i.e. ``/tmp`` on most Unix-like systems). - + :setting:`FILE_UPLOAD_PERMISSIONS` The numeric mode (i.e. ``0644``) to set newly uploaded files to. For more information about what these modes mean, see the `documentation for os.chmod`_ - + If this isn't given or is ``None``, you'll get operating-system dependent behavior. On most platforms, temporary files will have a mode of ``0600``, and files saved from memory will be saved using the system's standard umask. - + .. warning:: - + If you're not familiar with file modes, please note that the leading ``0`` is very important: it indicates an octal number, which is the way that modes must be specified. If you try to use ``644``, you'll @@ -173,7 +173,7 @@ Three settings control Django's file upload behavior: Which means "try to upload to memory first, then fall back to temporary files." -.. _documentation for os.chmod: http://docs.python.org/lib/os-file-dir.html +.. _documentation for os.chmod: http://docs.python.org/library/os.html#os.chmod ``UploadedFile`` objects ======================== @@ -197,17 +197,17 @@ define the following methods/attributes: ``UploadedFile.temporary_file_path()`` Only files uploaded onto disk will have this method; it returns the full path to the temporary uploaded file. - + .. note:: Like regular Python files, you can read the file line-by-line simply by iterating over the uploaded file: - + .. code-block:: python - + for line in uploadedfile: do_something_with(line) - + However, *unlike* standard Python files, :class:`UploadedFile` only understands ``\n`` (also known as "Unix-style") line endings. If you know that you need to handle uploaded files with different line endings, you'll diff --git a/docs/topics/install.txt b/docs/topics/install.txt index b66c8aef15..b10c1d1d6c 100644 --- a/docs/topics/install.txt +++ b/docs/topics/install.txt @@ -53,7 +53,7 @@ for each platform. .. _Apache: http://httpd.apache.org/ .. _mod_wsgi: http://code.google.com/p/modwsgi/ -.. _WSGI: http://www.python.org/peps/pep-0333.html +.. _WSGI: http://www.python.org/dev/peps/pep-0333/ .. _server-arrangements wiki page: http://code.djangoproject.com/wiki/ServerArrangements .. _database-installation: @@ -125,7 +125,7 @@ Django will need permission to create a test database. .. _compiled Windows version: http://stickpeople.com/projects/python/win-psycopg/ .. _MySQLdb: http://sourceforge.net/projects/mysql-python .. _SQLite: http://www.sqlite.org/ -.. _pysqlite: http://pysqlite.org/ +.. _pysqlite: http://trac.edgewall.org/wiki/PySqlite .. _cx_Oracle: http://cx-oracle.sourceforge.net/ .. _Oracle: http://www.oracle.com/ .. _Sybase SQL Anywhere: http://code.google.com/p/sqlany-django/ diff --git a/docs/topics/testing.txt b/docs/topics/testing.txt index 1a826b974f..8247f970f9 100644 --- a/docs/topics/testing.txt +++ b/docs/topics/testing.txt @@ -147,7 +147,7 @@ as must have ``CREATE DATABASE`` rights. For more details about how doctest works, see the `standard library documentation for doctest`_. -.. _doctest: http://docs.python.org/lib/module-doctest.html +.. _doctest: http://docs.python.org/library/doctest.html .. _standard library documentation for doctest: doctest_ Writing unit tests @@ -197,9 +197,9 @@ suite. For more details about ``unittest``, see the `standard library unittest documentation`_. -.. _unittest: http://docs.python.org/lib/module-unittest.html +.. _unittest: http://docs.python.org/library/unittest.html .. _standard library unittest documentation: unittest_ -.. _suggested organization: http://docs.python.org/lib/organizing-tests.html +.. _suggested organization: http://docs.python.org/library/unittest.html#organizing-tests Which should I use? ------------------- @@ -412,7 +412,7 @@ a different focus. In short: A comprehensive test suite should use a combination of both test types. .. _Twill: http://twill.idyll.org/ -.. _Selenium: http://www.openqa.org/selenium/ +.. _Selenium: http://seleniumhq.org/ Overview and a quick example ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -465,8 +465,8 @@ Note a few important things about how the test client works: This black magic (essentially a patching of Django's template system in memory) only happens during test running. -.. _urllib: http://docs.python.org/lib/module-urllib.html -.. _urllib2: http://docs.python.org/lib/module-urllib2.html +.. _urllib: http://docs.python.org/library/urllib.html +.. _urllib2: http://docs.python.org/library/urllib2.html Making requests ~~~~~~~~~~~~~~~ @@ -807,7 +807,7 @@ can access these properties as part of a test condition. A dictionary-like object containing session information. See the :ref:`session documentation` for full details. -.. _Cookie module documentation: http://docs.python.org/lib/module-Cookie.html +.. _Cookie module documentation: http://docs.python.org/library/cookie.html Example ~~~~~~~