servo: Update README macports instructions. Add latest working rust commit.
authorBrian J. Burg <burg@cs.washington.edu>
Tue, 18 Sep 2012 11:26:04 -0700
changeset 471081 5483f7c8ef49b3b33efbf949494df9f53b6806c3
parent 471080 38d9c01293eeca1bfaba669436f1e59b86caf337
child 471082 6ebb808cb993da764c5549d4a0844857bcdd4836
push id44079
push userbmo:gps@mozilla.com
push dateSat, 04 Feb 2017 00:14:49 +0000
servo: Update README macports instructions. Add latest working rust commit. Source-Repo: https://github.com/servo/servo Source-Revision: 197d5f440e140b6ca4aced0bbaa68830fe651176
servo/README.md
--- a/servo/README.md
+++ b/servo/README.md
@@ -1,19 +1,21 @@
 ## The Servo Parallel Browser Project
 
 Servo is a web browser engine written in the Rust language. It is
 currently developed on OS X and Linux.
 
-Note: Servo requires a bleeding-edge version of Rust. Sometimes this
-means working off of the Rust _master_ branch; sometimes this means
-the _incoming_ branch. Because Rust is still undergoing major changes
-the Servo build is very often broken. Somebody in #servo or #rust
-will usually know what magic is required to make Servo build on any
-given day. Good luck!
+Note: Servo requires a bleeding-edge version of Rust. The Rust commit
+most recently tested is listed below. Servo often doesn't build
+against Rust _incoming_ or _master_ branches, due to upstream language
+changes. If you want to unbreak Servo against the latest Rust build,
+somebody in #servo or #rust will usually know what magic is required
+to fix the build.
+
+* Last known-good rust commit: 0e584f2e741ad5c6a1aefefe6eec3e2dd9fff518
 
 ### Prerequisites
 
 On OS X (homebrew):
 
     brew install https://raw.github.com/Homebrew/homebrew-versions/master/autoconf213.rb
     brew install cairo
 
@@ -26,25 +28,23 @@ On Debian-based Linuxes:
     sudo apt-get install libcairo2-dev libpango1.0-dev autoconf2.13 freeglut3-dev
 
 ### Building
 
     git clone git://github.com/mozilla/servo.git
     cd servo
     mkdir -p build && cd build
     ../configure
-    make check && make
+    make check-servo && make
     ./servo ../src/test/test.html
 
 
 ### Build Workarounds
 
 #### MacPorts
 
-Currently, the Makefile for the rust-azure submodule has a hardcoded
-library path that assumes cairo has been installed with homebrew. If
-you have installed with MacPorts, you will need to change the library
-path to cairo. The following command should apply a patch with the fix:
-
-    cd src/rust-azure && git diff 1e811d44^1 1e811d44 | patch -p1
+Currently, the Makefile for the `rust-azure` submodule has hardcoded
+library paths that assumes cairo has been installed with homebrew or
+MacPorts. If you have installed cairo via another methods or a
+different version, you will need to change the library path.
 
 This problem should go away once Issue #40 is fixed, and an
 externally-built cairo is no longer needed.