Wiki page osx-start.md changed with summary [created] by Andrew Williams

2 files changed, 161 insertions, 113 deletions

diff --git a/pages/docs/distros/osx-start.md.txt b/pages/docs/distros/osx-start.md.txt
new file mode 100644
index 000000000..7e575bfd5
--- /dev/null
+++ b/pages/docs/distros/osx-start.md.txt
@@ -0,0 +1,161 @@
+---
+~~Title: Installing EFL on macOS~~
+~~NOCACHE~~
+---
+
+# Installing EFL on macOS #
+
+> **NOTE:**
+> The Enlightenment (Desktop Manager) is not supported on macOS and there are no plans to do so in the near future.  Please [contact us](https://www.enlightenment.org/contrib/start) if you'd like to help with this.
+
+[The *Enlightenment Foundation Libraries (EFL)*](/about-efl.md) power millions of systems from mobile phones to set-top boxes, desktops, laptops, game systems and more. You will need EFL if you want to develop apps for Enlightenment and for any of the devices that use Enlightenment for its visual interface. 
+
+This tutorial describes two ways of installing EFL on your system. You will only need one so use the index on the right to navigate to the most useful method for you.
+
+The Enlightenment Foundation's projects mostly targets Linux platforms therefore not everything work on macOS works the first time. This is due to the specific requirements of macOS (kernel+userland) and the fact that there are very few 'Englightened' macOS users.
+
+This document explains how to install EFL using either the [Homebrew package manager](https://brew.sh/) or by building from source via git.
+
+Whichever installation method you use, read through the section on [Compiling EFL Applications](#Compiling_EFL_Applications) to find out more about building apps. 
+
+## Install EFL with Homebrew ##
+
+Homebrew is an unofficial package manager for macOS which you can install a number of programs that aren't available in macOS by default. 
+
+To install Homebrew open Terminal in macOS and run:
+
+```bash
+/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+```
+
+The script will prompt you through the install process. Feel free to visit the [Homebrew website](https://docs.brew.sh/Installation.html) for more information on fine tuning the installation.
+
+Homebrew should run an update prior to installing any new software but double check this by running:
+
+```bash
+brew update
+```
+
+Next install EFL with:
+
+```bash
+brew install efl
+```
+
+The distributed version of EFL is [1.20.6](http://braumeister.org/formula/efl).
+
+## Installing from Git ##
+
+Installing EFL manually is broadly a three step process. Firstly you need to have the macOS *Command Line Tools (CLT)* installed on your system, then install the necessary software dependencies. You can then configure and compile the EFL source code. 
+
+### Step 1: Install Command Line Tools ###
+
+If you've already installed [XCode](https://developer.apple.com/xcode/) via the Mac App Store, the command line tools are already embedded in the *Integrated Development Environment (IDE)*. Failing this, install the CLT by opening Terminal then run:
+
+```bash
+xcode-select --install
+```
+
+### Step 2: Installing Dependencies ###
+
+The easiest way to install the necessary software dependencies is to use a package manager like Homebrew. If you haven't already installed it do so now by opening Terminal and running:
+
+```bash
+/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+```
+
+The script will prompt you through the install process. Feel free to visit the [Homebrew website](https://docs.brew.sh/Installation.html) for more information on fine tuning the installation.
+
+Homebrew should run an update prior to installing any new software but double check this by running:
+
+```bash
+brew update
+```
+
+Next install the dependencies with:
+
+```bash
+brew install autoconf automake libtool autoconf-archive gettext check pkg-config luajit jpeg freetype fribidi fontconfig giflib libtiff glib dbus libsndfile bullet libspectre libraw librsvg poppler gstreamer gst-plugins-good pulseaudio
+brew migrate dbus
+```
+If you're using a fresh install of macOS, create a 'LaunchAgents' folder for your own account if it doesn't exist already:
+
+```bash
+mkdir -p ~/Library/LaunchAgents
+```
+
+Next use ``launchctl`` to automatically start and stop ``dbus``:
+
+```bash
+ln -sfv /usr/local/opt/dbus/*.plist ~/Library/LaunchAgents
+launchctl load ~/Library/LaunchAgents/org.freedesktop.dbus-session.plist
+```
+
+If you want to use ``gettext`` you'll also need ''autopoint'' to your ''$PATH'' your in '~/.profile' file or similar. If the file doesn't exist user ``nano`` to create it, for instance:
+
+```bash
+cd ~/
+nano .profile
+export PATH="$(brew --prefix gettext)/bin:$PATH"
+```
+
+### Step 3: Install and configure SSL ###
+
+Since El Capitan, Apple no longer distributes OpenSSL headers. Fortunately you can install OpenSSL manually via Homebrew:
+
+```bash
+brew install openssl
+brew link openssl --force
+```
+
+To add flags to '~/.bashrc' or similar use:
+
+```bash
+export CFLAGS="-I/usr/local/opt/openssl/include $CFLAGS"
+export LDFLAGS="-L/usr/local/opt/openssl/lib $LDFLAGS"
+```
+
+### Step 4: Modify linker flags ###
+
+> **NOTE:**
+> This step is only necessary if you wish to build macOS App Bundles (.app). 
+
+You can do this using 'osx-packager', which is a python package for generating App Bundles and/or .dmg files for easy distribution. To download, open Terminal and run:
+
+```bash
+git clone https://git.enlightenment.org/devs/jayji/osx-packager.git
+```
+For osx-packager to work properly, you must provide custom linker flags:
+
+```bash
+export LDFLAGS="-Wl,-headerpad_max_install_names ${LDFLAGS}"
+```
+
+### Step 5: Configuring the Software ###
+
+Now that you've installed all the required packages, you can download EFL itself directly from the git repository. Open Terminal and run:
+
+```bash
+git clone https://git.enlightenment.org/core/efl.git
+```
+
+This will create a a directory called *efl/*. Use ``cd`` to switch to the new directory, then compile EFL:
+
+```bash
+./autogen.sh --disable-cxx-bindings
+make -j $(nproc)
+```
+
+Finally, install EFL with:
+
+```bash
+sudo make -j $(nproc) install
+```
+
+## Troubleshooting ##
+
+If you are having problems compiling with installing EFL, you can also find help on any of [our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
+
+## Installing on Other Operating Systems ##
+
+If you would like to install EFL on a different operating system visit the [Setting up a C Development Environment page](start.md).
diff --git a/pages/docs/distros/osx-start.txt b/pages/docs/distros/osx-start.txt
deleted file mode 100644
index 63c071502..000000000
--- a/pages/docs/distros/osx-start.txt
+++ /dev/null
@@ -1,113 +0,0 @@
-~~Title: EFL on Mac OS X~~
-
-<note warning>
-If you are coming here for Enlightenment (the desktop manager) on Mac OS X... sorry but Enlightenment is not supported on Mac OS X... and it is not planned in a near future (but any help is very welcomed).
-</note>
-
-The Enlightenment Foundation's projects mostly targets Linux platforms, therefore not everything work on Mac OS X works the first time. This is due to:
-  * the specificities of the Operating System (kernel+userland);
-  * the fact there are a very few Enlightened OS X users :-\
-
-This document explains how to install the EFL which are key projects to install anything else made by the Enlightenment Foundation.
-
-
-====== Mac OS X Homebrew Packages (for EFL USERS) ======
-
-Homebrew is a package manager for Mac OS X. See at http://brew.sh how to install Homebrew if it isn't already installed.
-Then, just execute:
-
-<code bash>
-brew update        # To make sure you have the latest versions
-brew install efl   # To install EFL
-</code>
-
-And that's it! Enjoy your freshly distributed EFL :-).
-The distributed version of EFL is [[http://braumeister.org/formula/efl|1.20.4]].
-
-
-====== Manual Installation (for EFL DEVELOPERS) ======
-
-===== Setting up the environment =====
-
-You need to have the OS X CLT (Command-Line Tools) first, then install the EFL dependancies. The easiest way is by using a package manager. [[http://brew.sh|Homebrew]] is assumed to be the package manager.
-
-<note important>
-The CTL are not bundled with Xcode. Don't assume that they are installed if Xcode is installed.
-</note>
-
-To install the CTL, you should process as it follows:
-  * download the latest version of Xcode on the Mac App Store;
-  * run ''xcode-select --install'' in a terminal to install the CLT.
-
-
-If you want to have the very latest version of EFL, here is the procedure:
-  * install the dependancies;
-  * configure the source;
-  * compile the sources and install them.
-
-===== Dependancies with Homebrew =====
-
-<code bash>
-brew install autoconf automake libtool autoconf-archive gettext check pkg-config luajit jpeg freetype fribidi fontconfig giflib libtiff glib dbus libsndfile bullet libspectre libraw librsvg poppler gstreamer gst-plugins-good pulseaudio
-brew migrate dbus
-mkdir -p ~/Library/LaunchAgents
-ln -sfv /usr/local/opt/dbus/*.plist ~/Library/LaunchAgents
-launchctl load ~/Library/LaunchAgents/org.freedesktop.dbus-session.plist
-</code>
-
-You need to add ''autopoint'' to your ''$PATH'' if you want to use gettext. Write the line below in your ''$HOME/.profile'' or similar file.
-
-<code bash>
-export PATH="$(brew --prefix gettext)/bin:$PATH"
-</code>
-
-===== OpenSSL handling =====
-
-Since Mac OS X El Capitan, Apple does not distribute OpenSSL headers anymore.
-It is necessary to install OpenSLL manually through homebrew:
-
-<code bash>
-brew install openssl
-brew link openssl --force
-</code>
-
-and to add flags to your bashrc (or equivalent):
-
-<code bash>
-export CFLAGS="-I/usr/local/opt/openssl/include $CFLAGS"
-export LDFLAGS="-L/usr/local/opt/openssl/lib $LDFLAGS"
-</code>
-
-===== Modifying your linker flags =====
-
-<note>
-This step is **required** if you wish to build Mac OS X App Bundles (i.e. ''.app''). Otherwise, you can safely ignore this section.
-</note>
-
-''osx-packager'' is a python package initially developed at Open Wide to
-generate App Bundles and/or DMG files for easy distribution.
-It is available at [[https://git.enlightenment.org/devs/jayji/osx-packager.git]].
-
-To make it work, you **MUST** provide custom linker flags:
-
-<code bash>
-export LDFLAGS="-Wl,-headerpad_max_install_names ${LDFLAGS}"
-</code>
-
-===== Configuring, Building and Installing EFL =====
-
-Installing dependancies on OS X is painful, but now you did it (congrats'), you can grab the sources from the git repository:
-
-<code bash>
-git clone https://git.enlightenment.org/core/efl.git # Get the sources
-cd efl # Go to repository you cloned
-./autogen.sh --disable-cxx-bindings
-make -j $(nproc) # Compile
-sudo make -j $(nproc) install # Install
-</code>
-
-
-======= Additional Resources =======
-
-  * Enlightenment Developer Days 2016 Slides (EFL & Mac OS X slides): https://phab.enlightenment.org/F36470.
-  * Internal Wiki Page. Contains “legacy” information: https://phab.enlightenment.org/w/osx/.
\ No newline at end of file