summaryrefslogtreecommitdiffstats
path: root/docs/source/initialsetup
diff options
context:
space:
mode:
author Vas Crabb <cuavas@users.noreply.github.com>2021-10-09 12:16:17 +1100
committer GitHub <noreply@github.com>2021-10-09 12:16:17 +1100
commit38082ccbee749d650ccea886ae376a5d1dec337c (patch)
tree9ba9a900ba826bda58832834278025ced17f42f5 /docs/source/initialsetup
parent34b3bf701098082feb9077db49987507962c1578 (diff)
Overdue internal UI enhancements (#8674)
* frontend: Added support for message context to localisations. * frontend: Added string_view versions of the message lookup functions. * frontend: Added a few more folder options to the internal UI. * emu/softlist.cpp: Use more appropriate containers. * Switched to Python 3 by default - this will become a requirement. * Updated msgfmt.py for message context support. * frontend: Show all software item info in the internal UI. * frontend: Search alternate titles in software selection menu. * 3rdparty/utf8proc: Updated to v2.6.1 (has several fixes). * frontend: Added software filters for common info fields. * frontend: Allow UI manager to hold onto persistent session data. * frontend: Cache software lists for eight machines. * frontend: Added support for loading localised system names. * frontend: Add UI for selecting localised system names.
Diffstat (limited to 'docs/source/initialsetup')
-rw-r--r--docs/source/initialsetup/compilingmame.rst41
1 files changed, 24 insertions, 17 deletions
diff --git a/docs/source/initialsetup/compilingmame.rst b/docs/source/initialsetup/compilingmame.rst
index 51d63588149..f5be3a636f9 100644
--- a/docs/source/initialsetup/compilingmame.rst
+++ b/docs/source/initialsetup/compilingmame.rst
@@ -269,14 +269,19 @@ Apple macOS
You’ll need a few prerequisites to get started. Make sure you’re on OS X 10.14
Mojave or later for Intel Macs or macOS 11.0 Big Sur for Apple Silicon. You will
-need SDL2 2.0.4 or later for Intel or SDL2 2.0.14 on Apple Silicon.
-
-* Install **Xcode** from the Mac App Store or `ADC <https://developer.apple.com/download/more/>`_ (AppleID required).
-* To find the corresponding Xcode for your MacOS release please visit `xcodereleases.com <https://xcodereleases.com>`_ to find the latest version of Xcode available to you.
+need SDL2 2.0.4 or later for Intel or SDL2 2.0.14 on Apple Silicon. You’ll also
+need to install Python 3.
+
+* Install **Xcode** from the Mac App Store or
+ `ADC <https://developer.apple.com/download/more/>`_ (AppleID required).
+* To find the corresponding Xcode for your MacOS release please visit
+ `xcodereleases.com <https://xcodereleases.com>`_ to find the latest version of
+ Xcode available to you.
* Launch **Xcode**. It will download a few additional prerequisites. Let this
run through before proceeding.
-* Once that’s done, quit **Xcode** and open a **Terminal** window
-* Type **xcode-select --install** to install additional tools necessary for MAME (also available as a package on ADC).
+* Once that’s done, quit **Xcode** and open a **Terminal** window.
+* Type **xcode-select --install** to install additional tools necessary for MAME
+ (also available as a package on ADC).
Next you’ll need to get SDL2 installed.
@@ -288,7 +293,18 @@ Next you’ll need to get SDL2 installed.
**SDL2.framework** folder from the SDL disk image into the **Frameworks**
folder. You will have to authenticate with your user password.
-Lastly to begin compiling, use Terminal to navigate to where you have the MAME
+Now get Python 3 set up:
+
+* Go to the `official Python site <https://www.python.org/>`_ and click the link
+ to the download page for the current version (this was
+ `Python 3.10.0 <https://www.python.org/downloads/release/python-3100/>`_ at
+ the time of writing).
+* Scroll down to the “Files” section, and download the macOS version (called
+ “macOS 64-bit universal2 installer” or similar).
+* Once the package downloads, open it and follow the standard installation
+ process.
+
+Finally to begin compiling, use Terminal to navigate to where you have the MAME
source tree (*cd* command) and follow the normal compilation instructions from
above in All Platforms.
@@ -405,15 +421,6 @@ and the **python3-pip/python-pip** packages:
sudo apt-get install python3-sphinx python3-pip
pip3 install sphinxcontrib-svg2pdfconverter
-or
-
-.. code-block:: bash
-
- sudo apt-get install python-sphinx python-pip
- pip install sphinxcontrib-svg2pdfconverter
-
-depending on whether you’re using Python 3 or Python 2.
-
On Debian, you’ll need to install the **librsvg2-bin** package:
.. code-block:: bash
@@ -480,7 +487,7 @@ OVERRIDE_LD
or C++ compiler command is used to invoke the linker. (This sets the target
linker command when cross-compiling.)
PYTHON_EXECUTABLE
- Set the Python interpreter command. You need Python 2.7 or Python 3 to build
+ Set the Python interpreter command. You need Python 3.2 or later to build
MAME.
CROSS_BUILD
Set to **1** to use separate host and target compilers and linkers, as