Return-Path: X-Original-To: apmail-brooklyn-commits-archive@minotaur.apache.org Delivered-To: apmail-brooklyn-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 7ABF410A82 for ; Mon, 12 Jan 2015 14:52:37 +0000 (UTC) Received: (qmail 9758 invoked by uid 500); 12 Jan 2015 14:52:38 -0000 Delivered-To: apmail-brooklyn-commits-archive@brooklyn.apache.org Received: (qmail 9734 invoked by uid 500); 12 Jan 2015 14:52:38 -0000 Mailing-List: contact commits-help@brooklyn.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@brooklyn.incubator.apache.org Delivered-To: mailing list commits@brooklyn.incubator.apache.org Received: (qmail 9725 invoked by uid 99); 12 Jan 2015 14:52:38 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 Jan 2015 14:52:38 +0000 X-ASF-Spam-Status: No, hits=-1996.0 required=5.0 tests=ALL_TRUSTED,T_RP_MATCHES_RCVD,URIBL_SBL X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO mail.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with SMTP; Mon, 12 Jan 2015 14:52:37 +0000 Received: (qmail 8524 invoked by uid 99); 12 Jan 2015 14:52:17 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 Jan 2015 14:52:17 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 43A60A011A1; Mon, 12 Jan 2015 14:52:17 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: heneveld@apache.org To: commits@brooklyn.incubator.apache.org Date: Mon, 12 Jan 2015 14:52:19 -0000 Message-Id: In-Reply-To: <89b6adc26ec74ff38b57b94f024939fb@git.apache.org> References: <89b6adc26ec74ff38b57b94f024939fb@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [3/9] incubator-brooklyn git commit: updated readme for docs to describe how to fix more ruby problems X-Virus-Checked: Checked by ClamAV on apache.org updated readme for docs to describe how to fix more ruby problems Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/commit/28c71164 Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/tree/28c71164 Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/diff/28c71164 Branch: refs/heads/master Commit: 28c711648128b68e8805b1fcf165d303ec804714 Parents: 5392b88 Author: Alex Heneveld Authored: Fri Jan 9 20:33:26 2015 +0000 Committer: Alex Heneveld Committed: Fri Jan 9 20:35:03 2015 +0000 ---------------------------------------------------------------------- docs/README.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/blob/28c71164/docs/README.md ---------------------------------------------------------------------- diff --git a/docs/README.md b/docs/README.md index 4d7c6d5..7c07075 100644 --- a/docs/README.md +++ b/docs/README.md @@ -50,9 +50,14 @@ return to the `_build` directory and re-run the above command. On some platforms there may be some fiddling required before `jekyll` runs without errors, but the ecosystem is fairly mature and most problems can be resolved with a bit of googling. -For instance on Ubuntu, there may be additional dependencies required: - - sudo apt-get install libxslt-dev libxml2-dev +Some issues we've encountered are: + + * on Mac, install xcode and its command-line tools + * if ruby gets confused about versions, + [clean out your gems](http://judykat.com/ken-judy/force-bundler-rebuild-ruby-rails-gemset/) + * if `libxml2` fails, set `bundle config build.nokogiri --use-system-libraries` before the install + (more details [here](http://www.nokogiri.org/tutorials/installing_nokogiri.html)) + * on Ubuntu, `sudo apt-get install libxslt-dev libxml2-dev` Seeing the Website and Docs