Renamed "Mac OS X" to "macOS" in docs.
This commit is contained in:
parent
9f2e8b5bb7
commit
5e8625ba64
|
@ -52,7 +52,7 @@ class Command(BaseCommand):
|
||||||
# we already know 'readline' was imported successfully.
|
# we already know 'readline' was imported successfully.
|
||||||
import rlcompleter
|
import rlcompleter
|
||||||
readline.set_completer(rlcompleter.Completer(imported_objects).complete)
|
readline.set_completer(rlcompleter.Completer(imported_objects).complete)
|
||||||
# Enable tab completion on systems using libedit (e.g. Mac OSX).
|
# Enable tab completion on systems using libedit (e.g. macOS).
|
||||||
# These lines are copied from Python's Lib/site.py.
|
# These lines are copied from Python's Lib/site.py.
|
||||||
readline_doc = getattr(readline, '__doc__', '')
|
readline_doc = getattr(readline, '__doc__', '')
|
||||||
if readline_doc is not None and 'libedit' in readline_doc:
|
if readline_doc is not None and 'libedit' in readline_doc:
|
||||||
|
|
|
@ -24,12 +24,12 @@ If ``django-admin`` doesn't work but ``django-admin.py`` does, you're probably
|
||||||
using a version of Django that doesn't match the version of this documentation.
|
using a version of Django that doesn't match the version of this documentation.
|
||||||
``django-admin`` is new in Django 1.7.
|
``django-admin`` is new in Django 1.7.
|
||||||
|
|
||||||
Mac OS X permissions
|
macOS permissions
|
||||||
--------------------
|
-----------------
|
||||||
|
|
||||||
If you're using Mac OS X, you may see the message "permission denied" when
|
If you're using macOS, you may see the message "permission denied" when
|
||||||
you try to run ``django-admin``. This is because, on Unix-based systems like
|
you try to run ``django-admin``. This is because, on Unix-based systems like
|
||||||
OS X, a file must be marked as "executable" before it can be run as a program.
|
macOS, a file must be marked as "executable" before it can be run as a program.
|
||||||
To do this, open Terminal.app and navigate (using the ``cd`` command) to the
|
To do this, open Terminal.app and navigate (using the ``cd`` command) to the
|
||||||
directory where :doc:`django-admin </ref/django-admin>` is installed, then
|
directory where :doc:`django-admin </ref/django-admin>` is installed, then
|
||||||
run the command ``sudo chmod +x django-admin``.
|
run the command ``sudo chmod +x django-admin``.
|
||||||
|
|
|
@ -258,7 +258,7 @@ a dependency for one or more of the Python packages. Consult the failing
|
||||||
package's documentation or search the Web with the error message that you
|
package's documentation or search the Web with the error message that you
|
||||||
encounter.
|
encounter.
|
||||||
|
|
||||||
Now we are ready to run the test suite. If you're using GNU/Linux, Mac OS X or
|
Now we are ready to run the test suite. If you're using GNU/Linux, macOS, or
|
||||||
some other flavor of Unix, run:
|
some other flavor of Unix, run:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
|
@ -34,8 +34,8 @@ features include:
|
||||||
may be used outside of a Django project/application. In other words,
|
may be used outside of a Django project/application. In other words,
|
||||||
no need to have ``DJANGO_SETTINGS_MODULE`` set or use a database, etc.
|
no need to have ``DJANGO_SETTINGS_MODULE`` set or use a database, etc.
|
||||||
* Mutability: :class:`GEOSGeometry` objects may be modified.
|
* Mutability: :class:`GEOSGeometry` objects may be modified.
|
||||||
* Cross-platform and tested; compatible with Windows, Linux, Solaris, and Mac
|
* Cross-platform and tested; compatible with Windows, Linux, Solaris, and
|
||||||
OS X platforms.
|
macOS platforms.
|
||||||
|
|
||||||
.. _geos-tutorial:
|
.. _geos-tutorial:
|
||||||
|
|
||||||
|
|
|
@ -65,7 +65,7 @@ Optional packages to consider:
|
||||||
* ``libgeoip1``: for :doc:`GeoIP <../geoip2>` support
|
* ``libgeoip1``: for :doc:`GeoIP <../geoip2>` support
|
||||||
* ``python-gdal`` for GDAL's own Python bindings -- includes interfaces for raster manipulation
|
* ``python-gdal`` for GDAL's own Python bindings -- includes interfaces for raster manipulation
|
||||||
|
|
||||||
Please also consult platform-specific instructions if you are on :ref:`macosx`
|
Please also consult platform-specific instructions if you are on :ref:`macos`
|
||||||
or :ref:`windows`.
|
or :ref:`windows`.
|
||||||
|
|
||||||
.. _build_from_source:
|
.. _build_from_source:
|
||||||
|
@ -88,11 +88,9 @@ is required.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
OS X users are required to install `Apple Developer Tools`_ in order
|
macOS users must install `Xcode`_ in order to compile software from source.
|
||||||
to compile software from source. This is typically included on your
|
|
||||||
OS X installation DVDs.
|
|
||||||
|
|
||||||
.. _Apple Developer Tools: https://developer.apple.com/technologies/tools/
|
.. _Xcode: https://developer.apple.com/xcode/
|
||||||
|
|
||||||
.. _geosbuild:
|
.. _geosbuild:
|
||||||
|
|
||||||
|
|
|
@ -16,7 +16,7 @@ Details for each of the requirements and installation instructions
|
||||||
are provided in the sections below. In addition, platform-specific
|
are provided in the sections below. In addition, platform-specific
|
||||||
instructions are available for:
|
instructions are available for:
|
||||||
|
|
||||||
* :ref:`macosx`
|
* :ref:`macos`
|
||||||
* :ref:`windows`
|
* :ref:`windows`
|
||||||
|
|
||||||
.. admonition:: Use the Source
|
.. admonition:: Use the Source
|
||||||
|
@ -181,12 +181,12 @@ Similarly, on Red Hat and CentOS systems::
|
||||||
Platform-specific instructions
|
Platform-specific instructions
|
||||||
==============================
|
==============================
|
||||||
|
|
||||||
.. _macosx:
|
.. _macos:
|
||||||
|
|
||||||
Mac OS X
|
macOS
|
||||||
--------
|
-----
|
||||||
|
|
||||||
Because of the variety of packaging systems available for OS X, users have
|
Because of the variety of packaging systems available for macOS, users have
|
||||||
several different options for installing GeoDjango. These options are:
|
several different options for installing GeoDjango. These options are:
|
||||||
|
|
||||||
* :ref:`postgresapp` (easiest and recommended)
|
* :ref:`postgresapp` (easiest and recommended)
|
||||||
|
@ -197,17 +197,17 @@ several different options for installing GeoDjango. These options are:
|
||||||
* :ref:`build_from_source`
|
* :ref:`build_from_source`
|
||||||
|
|
||||||
This section also includes instructions for installing an upgraded version
|
This section also includes instructions for installing an upgraded version
|
||||||
of :ref:`macosx_python` from packages provided by the Python Software
|
of :ref:`macos_python` from packages provided by the Python Software
|
||||||
Foundation, however, this is not required.
|
Foundation, however, this is not required.
|
||||||
|
|
||||||
.. _macosx_python:
|
.. _macos_python:
|
||||||
|
|
||||||
Python
|
Python
|
||||||
~~~~~~
|
~~~~~~
|
||||||
|
|
||||||
Although OS X comes with Python installed, users can use `framework
|
Although macOS comes with Python installed, users can use `framework
|
||||||
installers`__ provided by the Python Software Foundation. An advantage to
|
installers`__ provided by the Python Software Foundation. An advantage to
|
||||||
using the installer is that OS X's Python will remain "pristine" for internal
|
using the installer is that macOS's Python will remain "pristine" for internal
|
||||||
operating system use.
|
operating system use.
|
||||||
|
|
||||||
__ https://www.python.org/ftp/python/
|
__ https://www.python.org/ftp/python/
|
||||||
|
@ -247,8 +247,8 @@ Homebrew
|
||||||
|
|
||||||
`Homebrew`__ provides "recipes" for building binaries and packages from source.
|
`Homebrew`__ provides "recipes" for building binaries and packages from source.
|
||||||
It provides recipes for the GeoDjango prerequisites on Macintosh computers
|
It provides recipes for the GeoDjango prerequisites on Macintosh computers
|
||||||
running OS X. Because Homebrew still builds the software from source, the
|
running macOS. Because Homebrew still builds the software from source, `Xcode`_
|
||||||
`Apple Developer Tools`_ are required.
|
is required.
|
||||||
|
|
||||||
Summary::
|
Summary::
|
||||||
|
|
||||||
|
@ -258,7 +258,7 @@ Summary::
|
||||||
$ brew install libgeoip
|
$ brew install libgeoip
|
||||||
|
|
||||||
__ http://brew.sh/
|
__ http://brew.sh/
|
||||||
.. _Apple Developer Tools: https://developer.apple.com/technologies/tools/
|
.. _Xcode: https://developer.apple.com/xcode/
|
||||||
|
|
||||||
.. _kyngchaos:
|
.. _kyngchaos:
|
||||||
|
|
||||||
|
@ -266,14 +266,13 @@ KyngChaos packages
|
||||||
~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
William Kyngesburye provides a number of `geospatial library binary packages`__
|
William Kyngesburye provides a number of `geospatial library binary packages`__
|
||||||
that make it simple to get GeoDjango installed on OS X without compiling
|
that make it simple to get GeoDjango installed on macOS without compiling
|
||||||
them from source. However, the `Apple Developer Tools`_ are still necessary
|
them from source. However, `Xcode`_ is still necessary for compiling the
|
||||||
for compiling the Python database adapters :ref:`psycopg2_kyngchaos` (for
|
Python database adapters :ref:`psycopg2_kyngchaos` (for PostGIS).
|
||||||
PostGIS).
|
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
SpatiaLite users should consult the :ref:`spatialite_macosx` section
|
SpatiaLite users should consult the :ref:`spatialite_macos` section
|
||||||
after installing the packages for additional instructions.
|
after installing the packages for additional instructions.
|
||||||
|
|
||||||
Download the framework packages for:
|
Download the framework packages for:
|
||||||
|
@ -336,9 +335,9 @@ __ http://pdb.finkproject.org/pdb/browse.php?summary=django-gis
|
||||||
MacPorts
|
MacPorts
|
||||||
~~~~~~~~
|
~~~~~~~~
|
||||||
|
|
||||||
`MacPorts`__ may be used to install GeoDjango prerequisites on Macintosh
|
`MacPorts`__ may be used to install GeoDjango prerequisites on computers
|
||||||
computers running OS X. Because MacPorts still builds the software from source,
|
running macOS. Because MacPorts still builds the software from source,
|
||||||
the `Apple Developer Tools`_ are required.
|
`Xcode`_ is required.
|
||||||
|
|
||||||
Summary::
|
Summary::
|
||||||
|
|
||||||
|
|
|
@ -14,7 +14,7 @@ On Debian/Ubuntu, you are advised to install the following packages:
|
||||||
postgresql-x.x, postgresql-x.x-postgis, postgresql-server-dev-x.x,
|
postgresql-x.x, postgresql-x.x-postgis, postgresql-server-dev-x.x,
|
||||||
python-psycopg2 (x.x matching the PostgreSQL version you want to install).
|
python-psycopg2 (x.x matching the PostgreSQL version you want to install).
|
||||||
Alternately, you can `build from source`_. Consult the platform-specific
|
Alternately, you can `build from source`_. Consult the platform-specific
|
||||||
instructions if you are on :ref:`macosx` or :ref:`windows`.
|
instructions if you are on :ref:`macos` or :ref:`windows`.
|
||||||
|
|
||||||
.. _PostGIS: https://postgis.net/
|
.. _PostGIS: https://postgis.net/
|
||||||
.. _psycopg2: http://initd.org/psycopg/
|
.. _psycopg2: http://initd.org/psycopg/
|
||||||
|
|
|
@ -11,7 +11,7 @@ For example, on Debian-based distributions, try to install the
|
||||||
``spatialite-bin`` package. For distributions that package SpatiaLite 4.2+,
|
``spatialite-bin`` package. For distributions that package SpatiaLite 4.2+,
|
||||||
install ``libsqlite3-mod-spatialite``.
|
install ``libsqlite3-mod-spatialite``.
|
||||||
|
|
||||||
For Mac OS X, follow the :ref:`instructions below<spatialite_macosx>`.
|
For macOS, follow the :ref:`instructions below<spatialite_macos>`.
|
||||||
|
|
||||||
For Windows, you may find binaries on the `Gaia-SINS`__ home page.
|
For Windows, you may find binaries on the `Gaia-SINS`__ home page.
|
||||||
|
|
||||||
|
@ -81,19 +81,19 @@ Get the latest SpatiaLite library source bundle from the
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
For Mac OS X users building from source, the SpatiaLite library *and* tools
|
For macOS users building from source, the SpatiaLite library *and* tools
|
||||||
need to have their ``target`` configured::
|
need to have their ``target`` configured::
|
||||||
|
|
||||||
$ ./configure --target=macosx
|
$ ./configure --target=macosx
|
||||||
|
|
||||||
__ https://www.gaia-gis.it/gaia-sins/libspatialite-sources/
|
__ https://www.gaia-gis.it/gaia-sins/libspatialite-sources/
|
||||||
|
|
||||||
.. _spatialite_macosx:
|
.. _spatialite_macos:
|
||||||
|
|
||||||
Mac OS X-specific instructions
|
macOS-specific instructions
|
||||||
==============================
|
==============================
|
||||||
|
|
||||||
To install the SpatiaLite library and tools, Mac OS X users can choose between
|
To install the SpatiaLite library and tools, macOS users can choose between
|
||||||
:ref:`kyngchaos` and `Homebrew`_.
|
:ref:`kyngchaos` and `Homebrew`_.
|
||||||
|
|
||||||
KyngChaos
|
KyngChaos
|
||||||
|
@ -103,7 +103,7 @@ First, follow the instructions in the :ref:`kyngchaos` section.
|
||||||
|
|
||||||
When creating a SpatiaLite database, the ``spatialite`` program is required.
|
When creating a SpatiaLite database, the ``spatialite`` program is required.
|
||||||
However, instead of attempting to compile the SpatiaLite tools from source,
|
However, instead of attempting to compile the SpatiaLite tools from source,
|
||||||
download the `SpatiaLite Binaries`__ for OS X, and install ``spatialite`` in a
|
download the `SpatiaLite Binaries`__ for macOS, and install ``spatialite`` in a
|
||||||
location available in your ``PATH``. For example::
|
location available in your ``PATH``. For example::
|
||||||
|
|
||||||
$ curl -O https://www.gaia-gis.it/spatialite/spatialite-tools-osx-x86-2.3.1.tar.gz
|
$ curl -O https://www.gaia-gis.it/spatialite/spatialite-tools-osx-x86-2.3.1.tar.gz
|
||||||
|
|
|
@ -355,7 +355,7 @@ Management Commands
|
||||||
accepts a command object as the first argument.
|
accepts a command object as the first argument.
|
||||||
|
|
||||||
* The :djadmin:`shell` command supports tab completion on systems using
|
* The :djadmin:`shell` command supports tab completion on systems using
|
||||||
``libedit``, e.g. Mac OSX.
|
``libedit``, e.g. macOS.
|
||||||
|
|
||||||
* The :djadmin:`inspectdb` command lets you choose what tables should be
|
* The :djadmin:`inspectdb` command lets you choose what tables should be
|
||||||
inspected by specifying their names as arguments.
|
inspected by specifying their names as arguments.
|
||||||
|
|
|
@ -717,7 +717,7 @@ If your tests make any database queries, use subclasses
|
||||||
``tearDownClass()`` are run. In the case of :class:`django.test.TestCase`,
|
``tearDownClass()`` are run. In the case of :class:`django.test.TestCase`,
|
||||||
this will leak the transaction created in ``super()`` which results in
|
this will leak the transaction created in ``super()`` which results in
|
||||||
various symptoms including a segmentation fault on some platforms (reported
|
various symptoms including a segmentation fault on some platforms (reported
|
||||||
on OS X). If you want to intentionally raise an exception such as
|
on macOS). If you want to intentionally raise an exception such as
|
||||||
:exc:`unittest.SkipTest` in ``setUpClass()``, be sure to do it before
|
:exc:`unittest.SkipTest` in ``setUpClass()``, be sure to do it before
|
||||||
calling ``super()`` to avoid this.
|
calling ``super()`` to avoid this.
|
||||||
|
|
||||||
|
|
|
@ -672,7 +672,7 @@ class MakeMigrationsTests(MigrationTestBase):
|
||||||
module = 'migrations.test_migrations_order'
|
module = 'migrations.test_migrations_order'
|
||||||
with self.temporary_migration_module(module=module) as migration_dir:
|
with self.temporary_migration_module(module=module) as migration_dir:
|
||||||
if hasattr(importlib, 'invalidate_caches'):
|
if hasattr(importlib, 'invalidate_caches'):
|
||||||
# importlib caches os.listdir() on some platforms like Mac OS X
|
# importlib caches os.listdir() on some platforms like macOS
|
||||||
# (#23850).
|
# (#23850).
|
||||||
importlib.invalidate_caches()
|
importlib.invalidate_caches()
|
||||||
call_command('makemigrations', 'migrations', '--empty', '-n', 'a', '-v', '0')
|
call_command('makemigrations', 'migrations', '--empty', '-n', 'a', '-v', '0')
|
||||||
|
@ -1200,7 +1200,7 @@ class MakeMigrationsTests(MigrationTestBase):
|
||||||
content = cmd("0001", migration_name_0001)
|
content = cmd("0001", migration_name_0001)
|
||||||
self.assertIn("dependencies=[\n]", content)
|
self.assertIn("dependencies=[\n]", content)
|
||||||
|
|
||||||
# importlib caches os.listdir() on some platforms like Mac OS X
|
# importlib caches os.listdir() on some platforms like macOS
|
||||||
# (#23850).
|
# (#23850).
|
||||||
if hasattr(importlib, 'invalidate_caches'):
|
if hasattr(importlib, 'invalidate_caches'):
|
||||||
importlib.invalidate_caches()
|
importlib.invalidate_caches()
|
||||||
|
|
Loading…
Reference in New Issue