From 976682b304003d018e1cf9a8609d18fc05f5d049 Mon Sep 17 00:00:00 2001
From: Jiwoong Lee <porce@google.com>
Date: Mon, 28 Aug 2017 11:21:26 -0700
Subject: [PATCH] Clarify the Fuchsia build pre-requisite

Magenta markdown doc "getting_started.md" is changed together.

DNO-142 #done

Change-Id: I6978a1666cc670e8abd9c314962d0ae6bcd0f2a3
---
 getting_source.md  | 13 +++----------
 getting_started.md | 44 +++++++++++++++++++++++++++++++++++++-------
 2 files changed, 40 insertions(+), 17 deletions(-)

diff --git a/getting_source.md b/getting_source.md
index ca98fb65d6a..bb8cbca0952 100644
--- a/getting_source.md
+++ b/getting_source.md
@@ -5,16 +5,9 @@ Fuchsia uses the `jiri` tool to manage git repositories
 [https://fuchsia.googlesource.com/jiri](https://fuchsia.googlesource.com/jiri).
 This tool manages a set of repositories specified by a manifest.
 
-## Prerequisites
-
-On Ubuntu:
-
- * `sudo apt-get install golang git build-essential curl unzip`
-
-On Mac:
-
- * Install Xcode Command Line Tools
- * `brew install golang`
+For how to build, see Fuchsia's
+[Getting Started](https://fuchsia.googlesource.com/docs/+/master/getting_started.md)
+doc.
 
 ## Creating a new checkout
 
diff --git a/getting_started.md b/getting_started.md
index 6b4bf5e3050..db18751bfb6 100644
--- a/getting_started.md
+++ b/getting_started.md
@@ -7,17 +7,47 @@ Welcome to Fuchsia! This is a top-level entry point for the project. From here
 we try to link to everything you need to get started, use, and develop for
 Fuchsia.
 
+*** note
+NOTE: The Fuchsia source includes
+[Magenta](https://fuchsia.googlesource.com/magenta/+/master/README.md),
+the core platform that underpins Fuchsia.
+The Fuchsia build process will build Magenta as a side-effect;
+to work on Magenta only, read and follow Magenta's
+[Getting Started](https://fuchsia.googlesource.com/magenta/+/master/docs/getting_started.md)
+doc.
+***
+
 ## Prerequisites
 
-### Prepare your build environment
+### Prepare your build environment (Once per build environment)
+
+### Ubuntu
+
+```
+sudo apt-get install texinfo libglib2.0-dev autoconf libtool libsdl-dev build-essential golang git build-essential curl unzip
+```
+
+### macOS
+Install the Xcode Command Line Tools:
+```
+xcode-select --install
+```
 
-The Fuchsia source
-includes [Magenta](https://fuchsia.googlesource.com/magenta/+/HEAD/README.md),
-the core platform that underpins Fuchsia. Click the link below, follow the
-steps under *Preparing the build environment*, and then return to this document.
-(Do not continue to the *Install Toolchains* section.)
+Install the other pre-reqs:
+* Using Homebrew:
+```
+# Install Homebrew
+/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+# Install packages
+brew install wget pkg-config glib autoconf automake libtool golang
+```
 
-* [Preparing the Magenta build environment](https://fuchsia.googlesource.com/magenta/+/master/docs/getting_started.md#Preparing-the-build-environment).
+* Using MacPorts:
+```
+# Install MacPorts
+# See https://guide.macports.org/chunked/installing.macports.html
+port install autoconf automake libtool libpixman pkgconfig glib2
+```
 
 ### [Googlers only] Goma
 
-- 
GitLab