DOCS-1893: reorganizing os x tutorial.

Author: Sam Kleinman

source/tutorial/install-mongodb-on-os-x.txt

@@ -17,8 +17,8 @@ This tutorial outlines the basic installation process for deploying
 :term:`MongoDB` on Macintosh OS X systems. This tutorial provides two
 main methods of installing the MongoDB server
 (i.e. ":program:`mongod`") and associated tools: first using the
-community package management tools, and second using the official
-MongoDB builds.
+official MongoDB builds, and second using community package management
+tools.
 
 .. see:: Additional installation tutorials:
 
@@ -33,94 +33,6 @@ MongoDB builds.
    .. - :doc:`/getting-started`
    .. STUB - :doc:`/tutorial/insert-test-data-into-a-mongodb-database`
 
-Install with Package Management
--------------------------------
-
-Both community package management tools: `Homebrew
-<http://mxcl.github.com/homebrew/>`_ and `MacPorts
-<http://www.macports.org/>`_ require some initial setup and
-configuration. This configuration is beyond the scope of this
-document. You only need to use one of these tools.
-
-If you want to use package management, and do not already have a
-system installed, Homebrew is typically easier and simpler to use.
-
-Homebrew
-~~~~~~~~
-
-Homebrew installs binary packages based on published "formula." Issue
-the following command at the system shell to update the ``brew``
-package manager:
-
-.. code-block:: sh
-
-   brew update
-
-Use the following command to install the MongoDB package into your
-Homebrew system.
-
-.. code-block:: sh
-
-   brew install mongodb
-
-Later, if you need to upgrade MongoDB, you can issue the following
-sequence of commands to update the MongoDB installation on your
-system:
-
-.. code-block:: sh
-
-   brew update
-   brew upgrade mongodb
-
-MacPorts
-~~~~~~~~
-
-MacPorts distributes build scripts that allow you to easily build
-packages and their dependencies on your own system. The compilation
-process can take significant period of time depending on your system's
-capabilities and existing dependencies. Issue the following command in
-the system shell:
-
-.. code-block:: sh
-
-   port install mongodb
-
-Using MongoDB from Homebrew and MacPorts
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The packages installed with Homebrew and MacPorts contain no
-:term:`control scripts <control script>` or interaction with the
-system's process manager.
-
-If you have configured Homebrew and MacPorts correctly, including
-setting your ``PATH``, the MongoDB applications and utilities will be
-accessible from the system shell. Start the :program:`mongod` process
-in a terminal (for testing or development) or using a process
-management tool.
-
-.. code-block:: sh
-
-  mongod
-
-Then open the :program:`mongo` shell by issuing the
-following command at the system prompt:
-
-.. code-block:: sh
-
-   mongo
-
-This will connect to the database running on the localhost interface
-by default. At the :program:`mongo` prompt, issue the following two
-commands to insert a record in the "test" :term:`collection` of the
-(default) "test" database and then retrieve that record.
-
-.. code-block:: javascript
-
-   > db.test.save( { a: 1 } )
-   > db.test.find()
-
-.. seealso:: ":program:`mongo`" and ":doc:`/reference/method`"
-
 Install from Official Builds
 ----------------------------
 
@@ -229,3 +141,92 @@ commands to insert a record in the "test" :term:`collection` of the
    db.test.find()
 
 .. seealso:: ":program:`mongo`" and ":doc:`/reference/method`"
+
+Install with Package Management
+-------------------------------
+
+Both community package management tools: `Homebrew
+<http://mxcl.github.com/homebrew/>`_ and `MacPorts
+<http://www.macports.org/>`_ require some initial setup and
+configuration. This configuration is beyond the scope of this
+document. You only need to use one of these tools.
+
+If you want to use package management, and do not already have a
+system installed, Homebrew is typically easier and simpler to use.
+
+Homebrew
+~~~~~~~~
+
+Homebrew installs binary packages based on published "formula." Issue
+the following command at the system shell to update the ``brew``
+package manager:
+
+.. code-block:: sh
+
+   brew update
+
+Use the following command to install the MongoDB package into your
+Homebrew system.
+
+.. code-block:: sh
+
+   brew install mongodb
+
+Later, if you need to upgrade MongoDB, you can issue the following
+sequence of commands to update the MongoDB installation on your
+system:
+
+.. code-block:: sh
+
+   brew update
+   brew upgrade mongodb
+
+MacPorts
+~~~~~~~~
+
+MacPorts distributes build scripts that allow you to easily build
+packages and their dependencies on your own system. The compilation
+process can take significant period of time depending on your system's
+capabilities and existing dependencies. Issue the following command in
+the system shell:
+
+.. code-block:: sh
+
+   port install mongodb
+
+Using MongoDB from Homebrew and MacPorts
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The packages installed with Homebrew and MacPorts contain no
+:term:`control scripts <control script>` or interaction with the
+system's process manager.
+
+If you have configured Homebrew and MacPorts correctly, including
+setting your ``PATH``, the MongoDB applications and utilities will be
+accessible from the system shell. Start the :program:`mongod` process
+in a terminal (for testing or development) or using a process
+management tool.
+
+.. code-block:: sh
+
+   mongod
+
+Then open the :program:`mongo` shell by issuing the
+following command at the system prompt:
+
+.. code-block:: sh
+
+   mongo
+
+This will connect to the database running on the localhost interface
+by default. At the :program:`mongo` prompt, issue the following two
+commands to insert a record in the "test" :term:`collection` of the
+(default) "test" database and then retrieve that record.
+
+.. code-block:: javascript
+
+   > db.test.save( { a: 1 } )
+   > db.test.find()
+
+.. seealso:: ":program:`mongo`" and ":doc:`/reference/method`"
+